Для работы webMathematica необходимо наличие на вашей системе установленных Java, контейнера сервлетов и системы Mathematica. В этом руководстве указаны шаги для установки и конфигурирования webMathematica на Mac:

1. Установка Java
2. Установка Tomcat
3. Установка системы Mathematica
4. Предоставление доступа пользователю “Tomcat” к файлам лицензирования
5. Установка и конфигурирование webMathematica

Установка Java

Загрузите и запустите установочную программу Java.

Установка Tomcat

Установка

1. Откройте страницу http://tomcat.apache.org/download-80.cgi.
2. Загрузите установочное приложение в формате apache-tomcat-N.M.QQ.tar.gz, где N.M.QQ обозначает номер версии загружаемого приложения Tomcat.
3. В директории, в которой вы желаете установить сервер, выполните следующую команду:

   sudo tar -xvzf apache-tomcat-N.M.QQ.tar.gz

Тестирование Tomcat

1. Для того, чтобы запустить сервер Tomcat в директории, где установлен Tomcat выполните следующую команду:

   ./bin/startup.sh

2. Откройте веб-браузер, наберите в адресной строке “localhost:8080” и откройте эту страницу. При правильной установке сервера Tomcat открытая страница будет похожа на следующую:

Часто возникающие затруднения:

• Система сетевой защиты вашего компьютера блокирует запросы, направленные к серверу Tomcat. Сервер Tomcat по умолчанию работает с портом 8080. Проверьте, что на системе, где установлен сервер Tomcat по этому порту разрешен прием TCP пакетов.
• Если вы загрузили Java с вебсайта компании Oracle, сервер Tomcat может не находить где установлена Java. В таком случае установите значение системной переменной JAVA_HOME абсолютному адресу директории, где установлена Java, например, путем выполнения следующей команды или добавления ее в скрипт .bashrc в случае, если Java установлена в директории /Applications/jdk1.8.0 :

  JAVA_HOME=/Applications/jdk1.8.0
  export JAVA_HOME

Установка системы Mathematica

Вам нужно будет установить систему Mathematica, активировать ее и перенести информацию о лицензировании использования системы Mathematica в директорию с общими правами доступа на вашем компьютере.

Установка

Следуйте инструкциям по установке системы Mathematica на Mac.

Активация

Активируйте систему Mathematica, используя онлайн активацию или активируя ее вручную.

Предоставление доступа пользователю “Tomcat” к файлам лицензирования

По умолчанию система Mathematica размещает информацию лицензирования в файле mathpass, расположенном в директории, отведенной конкретному пользователю. Для того, чтобы пользователь “Tomcat” имел доступ к файлу, содержащему информацию лицензирования, скопируйте файл mathpass в основную директорию системы Mathematica и установите права доступа, дающие возможность всем пользователям читать его содержимое.

1. Для того, чтобы определить адрес файла mathpass file в системе Mathematica выполните следующую команду:

   $PasswordFile

2. Для того, чтобы определить адрес основной директории выполните команду:

   $BaseDirectory

Используйте абсолютные адреса этих директорий при выполнении следующих инструкций.

1. Директории Licensing может еще не существовать. В таком случае создайте ее, выполнив следующую команду:

   sudo mkdir /Library/Mathematica/Licensing

2. Скопируйте файл mathpass в директорию Licensing, расположенную в основной директории:

   sudo cp /Users/<username>/Mathematica/Licensing/mathpass /Library/Mathematica/
   Licensing/mathpass

3. Предоставьте права чтения файла mathpass всем пользователям:

   sudo chmod a+r /Library/Mathematica/Licensing/mathpass

Установка и конфигурирование webMathematica

Установка

Установочные файлы webMathematica содержат файл webMathematica.zip. Поместите его в директорию webapps вашего сервера Apache Tomcat для того, чтобы при запуске сервера этот файл открывался и распаковывался. Предполагая, что переменная $TOMCAT_INSTALL содержит абсолютный путь к директории установки вашего сервера Tomcat, выполните следующие команды:

1. sudo mv webMathematica $TOMCAT_INSTALL/webapps/

2. sudo chown tomcat $TOMCAT_INSTALL/webapps/webMathematica

3. sudo chgrp tomcat $TOMCAT_INSTALL/webapps/webMathematica

4. su tomcat

5. ./$TOMCAT_INSTALL/bin/shutdown.sh

6. ./$TOMCAT_INSTALL/bin/startup.sh

Тестирование, выявление и устранение неисправностей

Пакет webMathematica содержит несколько готовых страниц, которые можно использовать для проверки правильности работы webMathematica.

1. Откройте в браузере основную страницу по адресу “localhost:8080/webMathematica”.
   
2. В качестве первого теста щелкните по примеру Hello World. На странице Hello World должны отображаться сегодняшнее число и текущее время.
   
3. Если пример Hello World работает неправильно, проверьте запись в журнале запросов, выполнив следующую команду:

   less $TOMCAT_INSTALL/logs/webMathematica.log

Часто возникающие затруднения:

Просмотрите журнал на предмет наличия записи ....com.wolfram.kerneltools.state.StateMachine [ERROR] Could not find MathLink executable. Наличие такой записи означает, что webMathematica не может определить местоположение вычислительного ядра системы Mathematica. Это может случаться, если система Mathematica была установлена в нестандартную директорию или, если версия webMathematica не согласуется с рекомендованной версией системы Mathematica, например, webMathematica 3.4.3 был выпущен с работы с Mathematica 11.3, и проверяет директории, куда исполняемые файлы системы Mathematica устанавливаются по умолчанию.

Для того, чтобы указать местоположение подходящей версии системы Mathematica, укажите его в конфигурационном файле webMathematica.

1. Используя командную строку, перейдите в директорию $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/ и найдите там файл MSPConfiguration.xml.
2. Откройте файл MSPConfiguration.xml в текстовом редакторе и найдите следующий фрагмент:

<KernelPool>
      <KernelPoolName>General</KernelPoolName>
      <URLPattern>/*</URLPattern>
</KernelPool>

3. Измените его на следующее:

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <KernelExecutable>
          /Applciations/Mathematica.app/Contents/MacOS/MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Примечание: Эта инструкция предполагает, что система Mathematica 11.x установлена в директории /usr/local/Mathematica/11.x/. В случае установки в другую директорию, используйте соответствующий путь установочной директории.