Вікі Koha українською |
Усі команди необхідно встановлювати від користувача з привілеями sudo
або ж безпосередньо з адміністраторського облікового запису root
.
Варіанти:
Дещо про вимоги до сервера є тут, дивіться також Nabble-Koha
Перед встановленням у BIOS-і виставляємо завантаження зі CD. Заодно пошукайте опцію автовключення сервера після відключення та включення електроживлення.
Дебіен встановлена?
Якщо ні, то от варіант встановлення зі компакт-диску.
Завантажуємося зі CD і далі уважно відповідаємо на питання:
Після перезавантаження входимо до системи під користувачем sysadmin.
Встановимо сервер ssh
apt-get install ssh
Для операції встановлення потрібні привілеї головного адміністратора root, вводимо команду su та на запит пароль.
apt-get install sudo (sudo)
Командою visudo відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу sysadmin, додавши у кінці файлу рядок
sysadmin ALL=(ALL) ALL
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо
Після встановлення маємо дистанційний доступ до цього сервера для нашого користувача sysadmin (з можливістю через sudo виконувати адмін-функції)
Однією командою
sudo apt-get install mc genisoimage screen bzip2 unzip links phpmyadmin
або ж по окремо
sudo apt-get install mc — файловий менеджер Midnight Commander
sudo apt-get install genisoimage — для монтування iso-образів
sudo apt-get install screen — можливість мати у консольному доступі декілька віртуальних екранів з фоновим виконанням (що найкорисніше, наприклад, при діал-ап-доступі тощо)
sudo apt-get install bzip2 unzip — корисні архіватори
sudo apt-get install links — текстовий консольний броузер (для перевірок/навігації зсередини сервера)
sudo apt-get install phpmyadmin — керування базами даних MySQL через веб-інтерфейс
Вводимо команду
locale
Має бути UTF-8
Якщо ні, то налаштовуємо локаль
sudo dpkg-reconfigure locales
Однією командою
sudo apt-get install \ at \ apache2 \ cvs \ git \ git-core \ make \ gcc \ daemon \ perlmagick \ mysql-server \ phpmyadmin
При встановленні сервера MySQL вказуємо пароль адміністратора (користувач root) - «ПарольАдмінаMySQL».
Однією командою
sudo apt-get install \ libcgi-session-perl \ libclass-factory-util-perl \ libclass-factory-util-perl \ libdata-ical-perl \ libdate-calc-perl \ libdate-ical-perl \ libdate-manip-perl \ libdatetime-format-mail-perl \ libdatetime-format-strptime-perl \ libdatetime-format-w3cdtf-perl \ libdatetime-locale-perl \ libdatetime-perl \ libdatetime-timezone-perl \ libdbd-mysql-perl \ libdbi-perl \ libemail-date-perl \ libgd-barcode-perl \ libhtml-scrubber-perl \ libimage-magick-perl \ libjson-perl \ liblingua-ispell-perl \ liblingua-stem-perl \ liblist-moreutils-perl \ liblist-moreutils-perl \ liblocale-gettext-perl \ liblocale-po-perl \ libmail-sendmail-perl \ libmime-lite-perl \ libnet-ldap-perl \ libpdf-api2-perl \ libpoe-perl \ libtext-charwidth-perl \ libtext-csv-perl \ libtext-iconv-perl \ libtext-wrapi18n-perl \ libtimedate-perl \ libtime-duration-perl \ libtime-format-perl \ libunix-syslog-perl \ libxml-dom-perl \ libxml-dumper-perl \ libxml-libxml-perl \ libxml-libxslt-perl \ libxml-namespacesupport-perl \ libxml-parser-perl \ libxml-perl \ libxml-regexp-perl \ libxml-sax-writer-perl \ libxml-simple-perl \ libxml-xslt-perl \ libyaml-syck-perl \ libalgorithm-checkdigits-perl \ libbiblio-endnotestyle-perl \ libcgi-session-serialize-yaml-perl \ libhtml-template-pro-perl \ libmarc-charset-perl \ libmarc-crosswalk-dublincore-perl \ libmarc-xml-perl \ libmarc-record-perl \ libnet-z3950-zoom-perl \ libpdf-reuse-perl \ libpdf-reuse-barcode-perl \ libsms-send-perl \ libschedule-at-perl \ libxml-rss-perl \ libyaml-perl
Однією командою
sudo apt-get install \ idzebra-2.0-common \ idzebra-2.0-doc \ idzebra-2.0 \ idzebra-2.0-utils \ libidzebra-2.0-dev \ libidzebra-2.0 \ libidzebra-2.0-mod-alvis \ libidzebra-2.0-mod-grs-marc \ libidzebra-2.0-mod-grs-regx \ libidzebra-2.0-mod-grs-xml \ libidzebra-2.0-mod-text \ libidzebra-2.0-modules \ yaz \ yaz-doc \ libyaz3 \ libyaz3-dev
Однією командою
sudo apt-get install \ gettext \ libgcrypt11-dev \ libgcrypt11 \ libgd2-noxpm-dev \ libmysqlclient15-dev \ libxml2-dev \ libxml2 \ libxml2-utils \ libxslt1.1 \ libxslt1-dev
Ці модулі відсутні у вище-згаданих репозитаріях Дебіен але є на CPAN.
Далі виконуємо команди з оболонкою cpan, при цьому слідкуємо чи немає помилок, незадоволених залежностей. При першому запуску у Вас буде запитано чи налаштувати доступ до CPAN вручну, — відповідаємо ні(no) і пробуємо автоналаштування.
HTTP-OAI
(в Дебіен, ймовірно, має з’явитися пакунок libhttp-oai-perl
, слідкуємо):sudo cpan HTTP::OAI
IPC-Cmd
(в Дебіен, ймовірно, має з’явитися пакунок libipc-cmd-perl
, слідкуємо):sudo cpan IPC::Cmd
Зауваження: встановлення з CPAN вимагає під’єднання до Інтернет.
(Нижче замість АдміністраторСистемиKoha вводимо своє)
sudo adduser АдміністраторСистемиKoha
Деколи група автоматично не створюється — тоді потрібно ще
sudo addgroup АдміністраторСистемиKoha sudo adduser АдміністраторСистемиKoha АдміністраторСистемиKoha
Командою visudo відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу АдміністраторСистемиKoha, додавши у кінці файлу рядок
АдміністраторСистемиKoha ALL=(ALL) ALL
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо
У цьому керівництві розглядається встановлення Koha 3.0.5 (1).
Хоча можете спробувати найсвіжішу розробницьку нестабільну версію (2) з репозитарію Git (для цього випадку шлях встановлення може різнитися). Отож, якщо не лякає нестабільність розроблювальної версії, то спершу необхідно зконфіґурувати git
sudo update-alternatives --config git
і вибрати scm
Переходимо у середовище користувача АдміністраторСистемиKoha (вводимо пароль користувача АдміністраторСистемиKoha )
su АдміністраторСистемиKoha cd ~/
1) А далі отримати вихідні коди розробницької версії з репозитарію Git:
mkdir ~/koha; cd ~/koha kohaclone="koha_git_"$(date +%m-%d-%Y) git clone git://git.koha.org/pub/scm/koha.git $kohaclone tar -cvf $kohaclone".tar" $kohaclone"/";bzip2 -f $kohaclone".tar" cd $kohaclone git checkout -b myinstall origin
(див. також - http://wiki.koha.org/doku.php?id=en:development:git_usage)
2) А для отримання стабільної Koha 3.0.5 — звантажуємо її з http://download.koha.org та розпаковуємо
mkdir ~/koha; wget -O ~/koha/koha-3.00.05.tar.gz http://download.koha.org/koha-3.00.05.tar.gz; cd ~/koha; tar -xzf koha-3.00.05.tar.gz
(Нижче замість ПарольАдмінаMySQL, Koha3(назва БД), КористувачБДKoha3, ПарольКористувачаБДKoha3(його пароль) вводимо своє)
sudo mysqladmin password ПарольАдмінаMySQL
Утворюємо базу даних та привілеї користувачів щодо неї:
sudo mysqladmin -uroot -pПарольАдмінаMySQL create Koha3 sudo mysql -uroot -pПарольАдмінаMySQL
У середовищі mysql виконати наступне
grant all on Koha3.* to 'КористувачБДKoha3'@'localhost' identified by 'ПарольКористувачаБДKoha3';\ flush privileges; exit
[mysql] default-character-set=utf8 [mysqld] init-connect = 'SET NAMES utf8' default-character-set=utf8 character-set-server=utf8 collation-server=utf8_unicode_ci
Перезапускаємо сервер MySQL
sudo /etc/init.d/mysql restart
Переконуємося, що зміни внесені, виконавши
sudo mysql -uroot -pПарольАдмінаMySQL show variables; quit
У теці Koha виконати
~/koha/koha-3.00.05/misc/sax_parser_print.pl
Ви повинні побачити щось таке
XML::LibXML::SAX::Parser=HASH(0x81fe220)
Якщо ж є PurePerl чи Expat, то необхідно поправити файл /etc/perl/XML/SAX/ParserDetails.ini (запис щодо XML::LibXML::SAX::Parser має бути найнижче)
Зручно мати логічне посилання на теку з Koha
rm ~/koha/koha.local;ln -s ~/koha/koha-3.00.05 ~/koha/koha.local
Запускаємо встановлювач (у наступній команді вказуємо власні дані)
cd ~/koha/koha.local/ INSTALL_BASE=/usr/share/koha3 \ KOHA_USER=АдміністраторСистемиKoha \ KOHA_GROUP=АдміністраторСистемиKoha \ DB_NAME=Koha3 \ DB_USER=КористувачБДKoha3 \ DB_PASS=ПарольКористувачаБДKoha3 \ ZEBRA_MARC_FORMAT=unimarc \ ZEBRA_USER=КористувачZebra \ ZEBRA_PASS=ПарольКористувачаZebra \ INSTALL_PAZPAR2=yes \ perl Makefile.PL
Відповідаємо на питання:
By default, Koha can be installed in one of three ways: standard: Install files in conformance with the Filesystem Hierarchy Standard (FHS). This is the default mode and should be used when installing a production Koha system. On Unix systems, root access is needed to complete a standard installation. single: Install files under a single directory. This option is useful for installing Koha without root access, e.g., on a web host that allows CGI scripts and MySQL databases but requires the user to keep all files under the user's HOME directory. dev: Create a set of symbolic links and configuration files to allow Koha to run directly from the source distribution. This mode is useful for developers who want to run Koha from a git clone. Installation mode (dev, single, standard) [standard]
standard
Please specify the directory under which most Koha files will be installed. Note that if you are planning in installing more than one instance of Koha, you may want to modify the last component of the directory path, which will be used as the package name in the FHS layout. Base installation directory [/usr/share/koha]
/usr/share/koha3
Since you are using the 'standard' install mode, you should run 'make install' as root. However, it is recommended that a non-root user (on Unix and Linux platforms) have ownership of Koha's files, including the Zebra indexes if applicable. Please specify a user account. This user account does not need to exist right now, but it needs to exist before you run 'make install'. Please note that for security reasons, this user should not be the same as the user account Apache runs under. User account [koha]
АдміністраторСистемиKoha
Please specify the group that should own Koha's files. As above, this group need not exist right now, but should be created before you run 'make install'. Group [koha]
АдміністраторСистемиKoha
Please specify which database engine you will use to store data in Koha. The choices are MySQL and PostgreSQL; please note that at the moment PostgreSQL support is highly experimental. DBMS to use (Pg, mysql) [mysql]
mysql
Please specify the name or address of your database server. Note that the database does not have to exist at this point, it can be created after running 'make install' and before you try using Koha for the first time. Database server [localhost]
localhost
Please specify the port used to connect to the DMBS [3306]
3306
Please specify the name of the database to be used by Koha [koha]
Koha3
Please specify the user that owns the database to be used by Koha [kohaadmin]
КористувачБДKoha3
Please specify the password of the user that owns the database to be used by Koha [katikoan]
ПарольКористувачаБДKoha3
Koha can use the Zebra search engine for high-performance searching of bibliographic and authority records. If you have installed the Zebra software and would like to use it, please answer 'yes' to the following question. Otherwise, Koha will default to using its internal search engine. Please note that if you choose *NOT* to install Zebra, koha-conf.xml will still contain some references to Zebra settings. Those references will be ignored by Koha. Install the Zebra configuration files? (no, yes) [yes]
yes
Found 'zebrasrv' and 'zebraidx' in /usr/bin. Since you've chosen to use Zebra with Koha, you must specify the primary MARC format of the records to be indexed by Zebra. Koha provides Zebra configuration files for MARC 21 and UNIMARC. MARC format for Zebra indexing (marc21, unimarc) [marc21]
unimarc
Koha supplies Zebra configuration files tuned for searching either English (en) or French (fr) MARC records. Primary language for Zebra indexing (en, fr) [en]
en
Koha can use one of two different indexing modes for the MARC authorities records: grs1 - uses the Zebra GRS-1 filter, available for legacy support dom - uses the DOM XML filter; offers improved functionality. Authorities indexing mode (dom, grs1) [grs1]
grs1
Please specify Zebra database user [kohauser]
КористувачZebra
Please specify the Zebra database password [zebrastripes]
ПарольКористувачаZebra
Since you've chosen to use Zebra, you can enable the SRU/ Z39.50 Server if you so choose, but you must specify a few configuration options for it. Please note that if you choose *NOT* to configure SRU, koha-conf.xml will still contain some references to SRU settings. Those references will be ignored by Koha. Install the SRU configuration files? (no, yes) [yes]
yes
SRU Database host? [localhost]
localhost
SRU port for bibliographic data? [9998]
9998
SRU port for authority data? [9999]
9999
Since you've chosen to use Zebra, you can also choose to install PazPar2, which is a metasearch tool. With PazPar2, Koha can perform on-the-fly merging of bibliographic records during searching, allowing for FRBRization of the results list. Install the PazPar2 configuration files? [no] yes
yes
Zebra bibliographic server host? [localhost]
localhost
Zebra bibliographic port for PazPar2 to use? [11001]
11001
PazPar2 host? [localhost]
localhost
PazPar2 port? [11002]
11002
Would you like to run the database-dependent test suite? (no, yes) [no]
no
До речі, якщо Ви помилитеся, чи побачите наприкінці що ще не всі залежності задоволені, то можете поправити файл Makefile.PL, внісши в нього відповіді
Після завершення опитування Koha виводить список усіх параметрів (дивимося чи все добре)
AUTH_INDEX_MODE grs1 DB_HOST localhost DB_NAME Koha3 DB_PASS ПарольКористувачаБДKoha3 DB_PORT 3306 DB_TYPE mysql DB_USER КористувачБДKoha3 INSTALL_BASE /usr/share/koha3 INSTALL_MODE standard INSTALL_PAZPAR2 yes INSTALL_SRU yes INSTALL_ZEBRA yes KOHA_GROUP АдміністраторСистемиKoha KOHA_INSTALLED_VERSION 3.00.02.012 KOHA_USER АдміністраторСистемиKoha MERGE_SERVER_HOST localhost MERGE_SERVER_PORT 11001 PATH_TO_ZEBRA /usr/bin PAZPAR2_HOST localhost PAZPAR2_PORT 11002 RUN_DATABASE_TESTS no ZEBRA_LANGUAGE en ZEBRA_MARC_FORMAT unimarc ZEBRA_PASS ПарольКористувачаZebra ZEBRA_SRU_AUTHORITIES_POR9999 ZEBRA_SRU_BIBLIOS_PORT 9998 ZEBRA_SRU_HOST localhost ZEBRA_USER КористувачZebra
а також список усіх тек, куди передбачається встановлення
DOC_DIR $(DESTDIR)/usr/share/koha3/doc INTRANET_CGI_DIR $(DESTDIR)/usr/share/koha3/intranet/cgi-bin INTRANET_TMPL_DIR $(DESTDIR)/usr/share/koha3/intranet/htdocs/intranet-tmpl INTRANET_WWW_DIR $(DESTDIR)/usr/share/koha3/intranet/htdocs KOHA_CONF_DIR $(DESTDIR)/etc/koha3 LOG_DIR $(DESTDIR)/var/log/koha3 MAN_DIR $(DESTDIR)/usr/share/koha3/man MISC_DIR $(DESTDIR)/usr/share/koha3/misc OPAC_CGI_DIR $(DESTDIR)/usr/share/koha3/opac/cgi-bin OPAC_TMPL_DIR $(DESTDIR)/usr/share/koha3/opac/htdocs/opac-tmpl OPAC_WWW_DIR $(DESTDIR)/usr/share/koha3/opac/htdocs PAZPAR2_CONF_DIR $(DESTDIR)/etc/koha3/pazpar2 PERL_MODULE_DIR $(DESTDIR)/usr/share/koha3/lib SCRIPT_DIR $(DESTDIR)/usr/share/koha3/bin SCRIPT_NONDEV_DIR $(DESTDIR)/usr/share/koha3/bin ZEBRA_CONF_DIR $(DESTDIR)/etc/koha3/zebradb ZEBRA_DATA_DIR $(DESTDIR)/var/lib/koha3/zebradb ZEBRA_LOCK_DIR $(DESTDIR)/var/lock/koha3/zebradb ZEBRA_RUN_DIR $(DESTDIR)/var/run/koha3/zebradb
Перевірте, що у виводі встановлювальника немає помилок чи згадки про незадоволені залежності.
make
(тут не повинно бути помилок чи зауважень)
make test
(тут вискакує багацько помилок, але згідно розсилань це лиш проблема тестувальника, нехтуємо)
sudo make install
Від встановлювача було прохання додати наступне до змінних оточення, отож додаємо до /etc/environment два рядки
export KOHA_CONF=/etc/koha3/koha-conf.xml export PERL5LIB=/usr/share/koha3/lib
Підключаємо до Apache2 конфігурацію для Koha
sudo ln -s /etc/koha3/koha-httpd.conf /etc/apache2/sites-available/Koha3 sudo a2ensite Koha3
Та задіюємо модуль Rewrite
sudo a2enmod rewrite
а також модулі Expires та Deflate
sudo a2enmod expires sudo a2enmod deflate
Додаємо порти до /etc/apache2/ports.conf
Listen 8008 Listen 8888
А також підправляємо їх у файлі /etc/koha3/koha-httpd.conf на зразок
<VirtualHost 127.0.0.1:8008> ... ServerName 127.0.0.1:8008 ... <VirtualHost 127.0.0.1:8888> ... ServerName 127.0.0.1:8888
Перезапускаємо веб-сервер Apache 2
sudo /etc/init.d/apache2 restart
Для запуску Zebra-демона/сервера виконуємо на наступне
Zebra-сервер:
sudo ln -s /usr/share/koha3/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon sudo update-rc.d koha-zebra-daemon defaults sudo /usr/share/koha3/bin/koha-zebra-ctl.sh start
Zebraqueue-демон:
sudo ln -s /usr/share/koha3/bin/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon sudo update-rc.d koha-zebraqueue-daemon defaults sudo /usr/share/koha3/bin/koha-zebraqueue-ctl.sh start
У веб-оглядачі вводимо адресу нашого сервера
http://127.0.0.1:8888
* На жаль, у Koha 3.0.5 у офіційному встановлювачу все ще є некоректні sql-таблиці для українського та російського набору.
В українському наборі проблемними таблицями є:
В рос. наборі проблемними таблицями є:
Згадані таблиці (для Koha 3.0.5) краще зараз не вибирати, а пізніше, отримавши виправлені, вставити до БД Koha3 з допомогою інструменту phpmyadmin.
Далі у веб-встановлювачі:
ВСЕ - КОХА ВСТАНОВЛЕНА