====== Создание каталога ======

Каталоги - это основа Ampache. В них хранится информация обо всех ваших музыкальных файлах, видеозаписях и других данных. Существует 2 основных типа каталогов в Ampache: Удаленный и Локальный. [[Ru:Config:XmlRpc|Удаленные каталоги]] предназначены только для использования с XML-RPC, а также для того, чтобы можно было создать ссылку на другие сервера Ampache. Локальные же ссылаются на различные директории в файловой системе сервера, на котором Ampache установлен. Для того чтобы создать ваш первый каталог, зайдите в Ampache как администратор, после чего откройте вкладку меню '''Администратор''' и нажмите на '''Добавить''' в разделе '''Каталоги'''.  

===== Настройки локальных каталогов =====

  * Имя каталога -- Это то имя, которое будет отображаться в списке каталогов Ampache.
  * Путь -- Это директория в файловой системе сервера, на котором установлен Ampache. Это может быть как точка монтирования NFS, так и сетевой диск Windows, а также многое другое. Учтите, что требуется полный путь, а не относительный. 
  * XML-RPC ключ -- Рассматривать этот параметр не будем, так как он не имеет отношения к локальным каталогам. Оставьте его пустым.
  * Шаблон имени файла -- Данный параметр определяет шаблон, по которому Ampache попытается получить информацию об исполнителе и т.д. из имени файлов. Также он определяет, как Ampache будет сортировать/переименовывать файлы в этом каталоге. 
  * Шаблон папки -- Аналогично шаблону имени файла, за исключением того, что этот шаблон определяет поведение Ampache с папками, а не файлами.
  * Собрать обложки альбомов -- Данный параметр определяет будет ли Ampache после создания каталога искать и добавлять обложки альбомов.
  * Создавать списки воспроизведения из m3u файлов -- Данный параметр определяет будет ли Ampache искать .m3u файлы в вашем каталоге, пробовать распознавать их и создавать списки проигрывания на их основе.

===== Управление каталогом =====
Каждый администратор может управлять каталогами либо через веб-интерфейс, либо используя скрипт '''/bin/catalog_update.inc''' в командной строке. Этот скрипт в качестве аргумента принимает имя каталога, который надо обновить. Если каталог не указан, то скрипт проводит процедуру обновления над каждым каталогом. Далее следует список возможных операций, которые можно выполнять над каталогами, а также их поведение.

  * Добавить -- Ищет новые файлы в главной директории каталога (которая указывалась при его создании) и добавляет найденные.
  * Проверить -- Проверяет существующие файлы чтобы убедиться, что в тегах содержится правильная информация.
  * Очистить -- Удаляет всех артистов, альбомы, и так далее, на которые нет ссылок. Также удаляет из каталога те треки, которые Ampache не смог прочитать.
  * Обновить -- Выполняет очистку, проверку, а затем добавление. Это удобно, если требуется сделать всё вместе.
  * Собрать обложки -- Ищет обложки для альбомов и добавляет их в каталог.
  * Удалить -- Удаляет данный каталог.

===== Решение проблем при работе каталога =====

Каталоги в Ampache сделаны таким образом, что даже если процесс обновления оборвется во время выполнения любой из операций, ваш каталог останется целым и неповрежденным. Так что если вы столкнулись с ошибкой, не волнуйтесь! Если ваша проблема заключается в том, что Ampache неправильно считывает теги из треков, или как-то иначе связана с ними, посетите страницу [[Ru:Support:TagReading|Чтение тегов / мета информации]].

**Всегда включайте [[Ru:Support#Enabling Logging|журналирование]] когда решаете проблемы со своими каталогами.**

==== Права ====

Ampache необходимо иметь права на чтение всех файлов из каталога и права на чтение+исполнение для всех директорий. Если вы столкнетесь с тем, что Ampache не сможет прочитать какой-либо файл или директорию, дважды проверьте права файлов. Далее приведены команды, которые установят необходимые для работы Ampache права. Но прежде, перейдите в корневую директорию вашего каталога с музыкой или видео, так как эти команды будут рекурсивно изменять права, начиная с текущей директории.

  cd /путь/к/вашему/каталогу
  find . -type d -exec chmod 755 {} \;
  find . -type f -exec chmod 644 {} \;

Убедитесь, что параметр [[http://php.oregonstate.edu/manual/en/features.safe-mode.php#ini.open-basedir|Open Basedir в PHP]] не установлен, либо что он включает в себя директорию с вашей музыкой. Также проверьте, что в конфигурационном файле вашего веб-сервера нет параметров, запрещающих открытие скриптом директории с вашей музыкой.

При использовании сетевых дисков windows, убедитесь, что пользователь, запустивший　apache, также является владельцем этого сетевого диска и имеет достаточные права для чтения его содержимого.

Также, стоит отметить, что selinux при настройках по умолчанию может не позволять apache читать CIFS или NFS разделы. Прочтите man по booleans(8), getsebool(8), и setseool(8). Selinux также должен записывать нарушения прав доступа в системный журнал (обычно - /var/log/messages).

==== Права в Windows ====

Доступ к директориям и дискам общего доступа возможен, но требует небольшой предварительной настройки. Вот несколько аспектов, на которые надо обратить внимание:

  * Убедитесь, что служба Apache запущена с правами пользователя, а не системными (не из-под пользователя SYSTEM). Пользователь, под именем которого будет запущен сервис, должен иметь необходимые права для чтения файлов и директорий, которые нужно добавить в каталог Ampache.
    * В Windows откройте панель служб, нажмите '''Пуск >  Настройки >  Панель управления >  Администрирование >  Службы'''.
    * В этой панели, выберите службу Apache, нажмите правой кнопкой мыши по ней и выберите Свойства.
    * Выберите вкладку Вход в Систему и введите имя вашего пользователя. Если вы используете систему доменов Windows или Active Directory, измените поле учетной записи на <домен>\<имя_пользователя>. Например, mydomain\myaccount. Введите пароль, если он присутствует, после чего нажмите кнопку Разрешить, а затем, OK.
  * Когда будете добавлять каталог, не забудьте указать сетевой путь с двойными наклонными чертами, как в примере: ''%%\\192.168.0.1\folder\Музыка%%''

===== Решение проблем связанных с памятью/временем =====

Несмотря на то, что Ampache использует [[http://php.oregonstate.edu/set_time_limit|set_time_limit(0)]] для того, чтобы переопределить любые лимиты времени выполнения PHP скрипта, иногда использование этой функции запрещено в файле настройки PHP. Если вы сталкиваетесь с проблемой нехватки памяти (По умолчанию 32Мб) или же превышается лимит времени исполнения скрипта, измените вручную файл php.ini и увеличьте соответствующие параметры. Если PHP запущен в качестве модуля веб-сервера, потребуется перезапустить его. Не волнуйтесь, если память кончится во время создания каталога. Вам не нужно будет удалять его и начинать все заново, просто запустите процесс заново, и Ampache начнет с того места, на котором остановился. Для получения большей информации соответствующих проблемах и их возможных причинах прочтите следующие статьи:

  * [[http://php.oregonstate.edu/manual/en/ref.info.php#ini.max-execution-time|Лимит времени исполнения в PHP]]
  * [[http://php.oregonstate.edu/manual/en/features.safe-mode.php#ini.safe-mode|Безопасный режим в PHP]]
  * [[http://httpd.apache.org/docs/2.0/mod/core.html#timeout|Директива Timeout в Apache2]]
  * [[http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/31a2f39c-4d59-4cba-905c-60e7af657e49.mspx?mfr=true|Настройка предельного времени в IIS 6.0]]
  * [[Ru:support#Enabling Logging|Включение журналирования в Ampache]]

==== Поврежденные файлы ====

Функция Getid3() не должна занимать более 32Мб программной памяти, если она работает корректно, однако если в процессе обработки встретится файл, который не будет распознан корректно и затребуется слишком много памяти, то в таком случае процесс создания каталога может зависнуть. Единственный способ решить эту проблему - либо вручную перекодировать и перепрописать теги в этот файл, либо просто-напросто убрать его из вашей коллекции. Чтобы выяснить, с каким файлом проблема [[Ru:support#Enabling Logging|включите журналирование]] и посмотрите на имя последнего обработанного файла. 

==== Некорректные символы в именах файлов ====

Начиная с 3.4-Beta2, Ampache позволяет добавлять только файлы, имена которых содержат символы из кодировки, указанной в ///config/ampache.cfg.php// в параметре site_charset. Если какие-либо из ваших файлов корректно в каталог не добавляются или Ampache сообщает об ошибке кодировки, либо переименуйте этот файл вручную, либо воспользуйтесь скриптом, находящимся в /bin - **fix_filenames.inc**.