Для работы web Mathematica требуется, чтобы в вашей системе были установлены Java, контейнер сервлетов и Mathematica. Некоторые функциональные возможности Mathematica и, следовательно, web Mathematica, требуют использования интерфейса Mathematica. Для интерфейса, в свою очередь, требуется система X Window в Linux. Для установки web Mathematica необходимо выполнить следующие действия:

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

Настройка Java

Java требуется не только для web Mathematica но и для любого контейнера Java-сервлетов. Вы можете получить доступ к Java Oracle из http://www.oracle.com/us/downloads/index.html.

В некоторых дистрибутивах Linux пакеты Java также могут быть установлены либо через командную строку, либо через их программные центры:

RedHat/CentOS/Fedora

sudo yum install java-1.8.0-openjdk
sudo yum install java-1.8.0-openjdk-devel 

Debian/Ubuntu

sudo apt install openjdk-8-jre
sudo apt install openjdk-8-jdk

Чтобы проверить успешность установки, выполните в командной строке команду:

java -version

Настройка Tomcat

Установка

web Mathematica предназначена для работы из контейнера Java-сервлетов. Среди различных доступных контейнеров сервлетов мы предоставляем ограниченное руководство только по Apache 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 была установлена в /usr/local/jdk1.8.0.

  JAVA_HOME=/usr/local/jdk1.8.0
  export JAVA_HOME

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

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

1. Для создания учетной записи выполните в терминале:

   sudo useradd tomcat
   sudo passwd tomcat

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

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

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

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

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

Настройка Mathematica

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

Установка

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

Убедитесь, что вы используете соответствующее имя файла:

sudo sh Mathematica_12.x_LINUX.sh

Обратите внимание на выбранный вами каталог установки, если вы не используете каталог по умолчанию.

Активация

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

В системах Linux без установленного X Window интерфейс Mathematica будет недоступен. Вместо этого активируйте Mathematica через ядро.

1. Выполните следующую команду:

   math

2. Введите ключ активации. Обратите внимание, что ключ активации имеет вид XXXX-XXXX-XXXXXX.

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

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

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

   $PasswordFile

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

   $BaseDirectory

Например:

In[1]:= $PasswordFile                                                          

Out[1]= /home/user/.Mathematica/Licensing/mathpass

In[2]:= $BaseDirectory                                                          

Out[2]= /usr/share/Mathematica

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

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

   sudo mkdir -p /usr/share/Mathematica/Licensing

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

   sudo cp /home/user/.Mathematica/Licensing/mathpass /usr/share/Mathematica/Licensing/. 

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

   sudo chmod a+r /usr/share/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
   sudo chgrp -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>
         /usr/local/Wolfram/Mathematica/12.x/Executables/MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Примечание: В этих инструкциях предполагается, что Mathematica 12.x была установлена в
/usr/local/Mathematica/12.x/. Если у вас другой каталог установки, замените его на тот, который вы использовали.

Настройка Xvnc для минимальных или серверных версий Linux

Многие “серверные” или “минимальные” дистрибутивы Linux по умолчанию не включают сервер X Window. Некоторые функции Mathematica и, соответственно, некоторые функции web Mathematica требуют наличия сервера X Window. Например, пример «Plot» не может быть выполнен должным образом без какой-либо системы X Window. Для этих целей рекомендуется запустить сервер Xvnc.

1. Установите сервер Xvnc, который обычно можно получить с помощью приложений для установки из командной строки, таких как yum или apt.
2. Запустите vnc-дисплей с помощью команды “vncserver”. Для этого вам сначала потребуется указать номер дисплея (обычно 1).
3. Настройте web Mathematica на использование отображения, отредактировав файл $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/MSPConfiguration.xml, включив в него следующий код:

   <KernelPool>
   ....
   <FrontEndLaunchFlags>
   -display :1 -nogui 1000x500+10+10
   </FrontEndLaunchFlags>
   ....
   </KernelPool>

[English]