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

Вообще говоря, в поставку 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:

service apache2 restart 

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

Полезные ссылки

Файлы конфигурации Apache
Документация Caché
Caché и Apache
Caché и SSL