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

1. Настройка Java
2. Настройка Tomcat
3. Настройка Mathematica
4. Обеспечение доступа к файлам лицензий для web Mathematica
5. Установка и настройка web Mathematica

Настройка Java

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

Настройка Tomcat

Установка

1. Перейдите по ссылке http://tomcat.apache.org/download-80.cgi.
2. Загрузите установщик в формате tar.gz.
3. Выберите расположение, в котором вы хотите установить сервер. Например, если вы хотите установить в /usr/local, выполните команду:

   cd /usr/local

4. Распакуйте программу установки в текущем расположении:

   tar -xvzf apache-tomcat-<version>.tar.gz

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

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

   ./bin/startup.sh

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

   ./bin/shutdown.sh

Типичные возможные проблемы:

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

  JAVA_HOME=/Applications/jdk1.8.0
  export JAVA_HOME

Создание учетной записи Tomcat (рекомендуется)

Для запуска сервера Tomcat рекомендуется настроить специальную учетную запись пользователя, обычно называемую “tomcat”. Эта учетная запись должна иметь разрешения для запуска сервера Tomcat.

1. Чтобы создать учетную запись, добавьте пользователя.
2. Измените права собственности каталога установки Tomcat на пользователя “tomcat”, выполнив эту команду из родительского каталога, в котором вы установили сервер apache-tomcat:

   sudo chown -R tomcat apache-tomcat-<version>

3. Используя новую учетную запись, запустите сервер:

   su tomcat
   cd apache-tomcat-<version>/bin
   ./startup.sh

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

Настройка Mathematica

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

Установка

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

Активация

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

Обеспечение доступа к файлам лицензий для web Mathematica

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

1. Чтобы определить расположение вашего файла mathpass, выполните в Mathematica:

   $PasswordFile

2. Чтобы определить расположение базового каталога, выполните:

   $BaseDirectory

Например:

In[1]:= $PasswordFile                                                          

Out[1]= /Users/<username>/Library/Mathematica/Licensing/mathpass

In[2]:= $BaseDirectory                                                          

Out[2]= /Library/Mathematica

Эти расположения папок используются в следующих инструкциях.

1. Возможно, каталог лицензий (Licensing) еще не существует. Если это так, создайте его, выполнив следующую команду:

    sudo mkdir -p /Library/Mathematica/Licensing

2. Скопируйте файл mathpass в каталог лицензий (Licensing) базового каталога:

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

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

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

Установка и настройка web Mathematica

Установка

1. Загрузите установочный файл web Mathematica с вашего пользовательского портала User Portal и распакуйте его, чтобы убедиться, что он открыт и распакован.
2. Поместите распакованный каталог web Mathematica в каталог «webapps» вашего сервера Apache Tomcat, где $TOMCAT_INSTALL это каталог установки вашего сервера Tomcat:

   sudo mv webMathematica $TOMCAT_INSTALL/webapps/

3. Если вы создали пользователя «tomcat» для запуска сервера, также измените права собственности на папку web Mathematica:

   sudo chown -R tomcat $TOMCAT_INSTALL/webapps/webMathematica

4. Перезагрузите сервер из учетной записи, которой принадлежит эта папка:

   su tomcat
   cd $TOMCAT_INSTALL/bin
   ./shutdown.sh
   ./startup.sh

Тестирование и устранение неполадок

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

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. В этом случае web Mathematica не смогла найти исполняемый файл ядра Mathematica. Это может произойти, если вы установили Mathematica в нестандартном месте или если ваша web Mathematica не совместима с рекомендуемой версией Mathematica, например, web Mathematica 3.5.3 с Mathematica 12.3. Рекомендуемые сочетания других поддерживаемых в настоящее время версий продукта приведены здесь.

Чтобы указать на правильно совместимую версию Mathematica, настройте web Mathematica.

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>
          /Applications/Mathematica.app/Contents/MacOS/MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Примечание: эти инструкции предполагают, что Mathematica была названа “Mathematica.app”. Если у вас другое имя приложения, подставьте имя, которое вы использовали.

[English]