eduard93 Apr 29 2014 at 03:24

Настройка Apache для работы с СУБД Caché на Linux

3 min

5.4K

Tutorial

Вообще говоря, в поставку InterSystems Caché входит встроенный веб-сервер Apache. Встроенный сервер предназначен для разработки и администрирования инстанса Caché и собран с некоторыми ограничениями. Существуют рецепты по устранению этих ограничений, но более общий подход — использовать для продакшена полноценный веб-сервер. В статье рассмотрена настройка Apache для работы с Caché и организация https доступа. Все действия выполнялись на Ubuntu, но настройка на других Linux дистрибутивах ничем принципиально не отличается.

Выбираем Apache

Считаем, что Caché у вас уже установлена в каталог /InterSystems/Cache (как установить Caché на Linux читаем здесь).
Caché поставляется вместе с модулем для Apache, идём в папку /InterSystems/Cache/csp/bin и находим там один из файлов модулей:

CSPa22.so (Apache Version 2.2.x)
CSPa24.so (Apache Version 2.4.x)
CSPa20.so (Apache Version 2.0.x)
CSPa.so (Apache Version 1.3.x)

Теперь нужно установить Apache. Ищем подходящий репозиторий на сайте, например для CSPa24.so нужна любая версия 2.4.x, а репозиторий http://ru.archive.ubuntu.com/ubuntu/ saucy main содержит Apache версии 2.4.6. Добавляем его в лист репозиториев:

nano /etc/apt/sources.list
deb http://ru.archive.ubuntu.com/ubuntu/ saucy main

Обновляем список пакетов:

apt-get update

Установка Apache

Устанавливаем Apache, для этого добавляем необходимые пакеты:

 apt-get install apache2 zlib1g-dev

После установки убедитесь, что установленная версия Apache соответствует ожиданиям:

apache2 -v

Также надо убедиться, что в списке модулей Apache есть mod_so, список модулей выводится с помощью:

apache2 -l

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

Соединяем Caché и Apache

Для это нам нужно изменить конфигурацию Apache. Редактируем файлы:

/etc/apache2/envvars — содержит переменные окружения. Устанавливаем значения переменных APACHE_RUN_USER и APACHE_RUN_GROUP равными cacheusr
/etc/apache2/apache2.conf — основной файл конфигурации. Добавляем строчки в разделе конфигурации модулей (module configuration)
```
CSPModulePath /InterSystems/Cache/csp/bin/
LoadModule csp_module_sa /InterSystems/Cache/csp/bin/CSPa24.so
AddHandler csp-handler-sa csp cls cxw zen
```

/etc/apache2/sites-enabled/000-default.conf — конфигурация сайта.

<VirtualHost *:80>
    ServerName cachesys
    DocumentRoot "/InterSystems/Cache/csp"
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
    LogLevel debug
    <Location />
        CSP On
        SetHandler csp-handler-sa
    </Location>
    <Location "/csp/bin/Systems/">
        SetHandler csp-handler-sa
    </Location>
    <Location "/csp/bin/RunTime/">
        SetHandler csp-handler-sa
    </Location>
    DirectoryIndex  index.csp index.php index.html index.htm
</VirtualHost>

Перезапускаем Apache:

service apache2 restart

Теперь по адресу http://<ip>/csp/sys/UtilHome.csp должен открываться портал управления системой:

SSL

Далее добавим возможность подключаться используя ssl. Для этого сгенерируем сертификат сервера, подпишем его сами (не рекомендуется) или у CA. Очень подробный гайд здесь или здесь
В итоге, у нас есть 3 файла: приватный ключ сервера, сертификат сервера и сертификат CA.
Добавляем модуль ssl в Apache:

a2enmod ssl

Создаем файл с конфигурацией сайта: etc/apache2/sites-enabled/001-ssl.conf и добавляем в него:

<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
    ServerName <Server Certificate commonName>
    DocumentRoot /InterSystems/Cache/csp
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
    <Location />
        CSP On
        SetHandler csp-handler-sa
    </Location>
    <Location "/csp/bin/Systems/">
        SetHandler csp-handler-sa
    </Location>
    <Location "/csp/bin/RunTime/">
        SetHandler csp-handler-sa
    </Location>
    DirectoryIndex  index.csp index.php index.html index.htm

    SSLEngine on
    SSLCertificateKeyFile /InterSystems/Cache/mgr/SSLcert/server_key.pem
    SSLCertificateFile    /InterSystems/Cache/mgr/SSLcert/server_crt.crt
    SSLCACertificateFile  /InterSystems/Cache/mgr/SSLcert/cacert.crt
    SSLVerifyDepth  10
    SSLCipherSuite  TLSv1:SSLv3:!ADH:!LOW:!EXP:@STRENGTH
    SSLOptions +StdEnvVars
    DirectoryIndex index.csp index.php index.html index.htm
    </VirtualHost>
</IfModule>

Server Name должно соответствовать параметру commonName в сертификате сервера, также нужно указать корректные пути файлов ключа сервера, сертификата сервера и сертификата CA — SSLCertificateKeyFile, SSLCertificateFile, SSLCACertificateFile соответственно.
Перезапускаем Apache: