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

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

Настройка Java

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

Настройка Tomcat

Установка

Загрузите и запустите программу установки Tomcat. Мы рекомендуем загрузить 32-bit/64-bit установщик служб Windows apache-tomcat-<version>.exe.

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

1. Чтобы запустить сервер Tomcat, в меню «Пуск» (Start Menu) в разделе Apache Tomcat, откройте приложение «Configure Tomcat» (Настройка Tomcat).
   
2. Нажмите кнопку «Start».
   
3. Откройте веб-браузер и введите “localhost:8080”. Если Tomcat настроен правильно, появится страница, похожая на следующую:
   
4. Чтобы временно выключить сервер Tomcat, нажмите кнопку «Stop»:
   

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

• Брандмауэр компьютера блокирует запросы к Tomcat. Tomcat по умолчанию работает на порту 8080. Откройте порт для приема TCP-пакетов в системе, где запущен сервер Tomcat.
• Если Java установлена ​​не в месте по умолчанию, задайте переменную окружения JAVA_HOME, чтобы сообщить Tomcat место установки Java.

1. Откройте панель управления (Control Panel) и найдите “System” (Система).
   
2. Нажмите “Edit the system environment variables” (Изменить системные переменные среды). Откроется диалоговое окно “System Properties”.
   
   

3. Нажмите кнопку «Environment Variables» (Переменные среды).
   
   
4. Нажмите кнопку «New» в «System Variables» (Системные переменные). Откроется окно «New System Variable» (Новая системная переменная).
   
5. Введите “JAVA_HOME” в качестве “Variable name” (Имя переменной) и место установки Java JDK в качестве “Variable value” (Значения переменной).
   
   
6. Нажмите кнопку «OK» в любом из окон, чтобы подтвердить и закрыть окна.

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

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

1. Чтобы создать учетную запись, добавьте пользователя.
2. В меню «Пуск» (Start Menu) в разделе Apache Tomcat откройте приложение «Настройка Tomcat» (Configure Tomcat).

   

3. Чтобы настроить информацию об учетной записи сервера Tomcat, выберите вкладку «Log On» (Вход в систему).

   

4. Выберите “This account” (Эта учетная запись) и введите данные учетной записи.

   

5. Нажмите «Apply», чтобы подтвердить изменения.
6. Чтобы запустить сервер Tomcat, используя новую учетную запись, вернитесь на вкладку «General».
   
7. Нажмите кнопку «Start».

   

8. Откройте веб-браузер и введите “localhost:8080”. Если пользователь настроен правильно, снова появится целевая страница Tomcat:
   
9. Нажмите «OK», чтобы закрыть приложение.

Настройка Mathematica

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

Установка

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

Активация

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

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

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

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

   $PasswordFile

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

   $BaseDirectory

3. Скопируйте файл mathpass в каталоге $PasswordFile и вставьте его в подкаталог Licensing каталога $BaseDirectory. Чтобы получить доступ к этим каталогам, вам может потребоваться включить просмотр скрытых файлов и папок в Windows.

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

Установка

1. Загрузите установочный файл web Mathematica с вашего пользовательского портала User Portal.
2. Извлеките его в подкаталог “webapps” каталога установки Tomcat, который обычно находится по адресу C:\Program Files (x86)\Apache Software Foundation\Tomcat 8.5.
3. Перезапустите сервер Tomcat в приложении «Configure Tomcat».

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

Пакет web Mathematica содержит несколько тестовых веб-страниц.

1. Откройте браузер на странице “localhost:8080/webMathematica”.
   
2. Нажмите на пример «Hello World».
   

Если «Hello World» не работает, проверьте файл web Mathematica.log в подкаталоге logs каталога установки Tomcat на наличие сообщений об ошибках.

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

Найдите ошибку в файле журнала ....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 в текстовом редакторе, где <Tomcat_Install> представляет собой каталог установки Tomcat.
2. Найдите следующий раздел:

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

3. Отредактируйте и измените этот раздел на:

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <KernelExecutable>
         C:\Program Files\Wolfram Research\Mathematica12.x\MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Примечание: В этих инструкциях предполагается, что Mathematica 12.x была установлена в C:\Program Files\Wolfram Research\Mathematica12.x\MathKernel. Если у вас другой каталог установки, замените его на тот, который вы использовали.

Тестирование интерфейса

На основной веб-странице web Mathematica, выберите «Plot Example» (Пример графика). Когда откроется страница, нажмите кнопку «Plot» (Построить).


В некоторых системах вместо графика может появиться ошибка FrontEndError: ExportString failed: -Graphics-. Это может означать, что интерфейс Mathematica не был запущен.

Windows ограничивает объем памяти, выделяемой неинтерактивным пользователям, таким как ядра Mathematica, запускаемые сервером Tomcat. Когда таким ядрам требуется выполнить вычисления, для которых требуется интерфейс Mathematica, настройка выделения памяти может препятствовать запуску интерфейса.

Чтобы увеличить объем доступной памяти, разрешите неинтерактивным пользователям использовать тот же объем памяти, что и интерактивным пользователям.

1. Найдите запись в реестре:

   HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager
   \SubSystems\Windows
   
   %SystemRoot%system32csrss.exe ObjectDirectory=Windows
   SharedSection=1024,3072,512 Windows=On SubSystemType=Windows
   ServerDll=basesrv,1 ServerDll=winsrv:UserServerDllInitialization,3
   ServerDll=winsrv:ConServerDllInitialization,2 ProfileControl=Off
   
   MaxRequestThreads=16 

2. Удалите третий параметр, указанный в переменной SharedSection, то есть замените “1024,3072,512” на “1024,3072” в примере выше.
3. Перезагрузите компьютер.

[English]