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

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

Установка Java

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

Установка Tomcat

Установка

1. Загрузите и запустите установочную программу для Tomcat. Мы рекомендуем использовать Windows Service Installer apache-tomcat-N.M.QQ.exe, где N.M.QQ обозначает номер версии загружаемого приложения Tomcat.
2. Для работы сервера Tomcat рекомендуется создать отдельную учетную запись пользователя, как правило, с именем “tomcat”.
3. В меню Пуск в папке Apache Tomcat откройте приложение конфигурирования сервера Configure Tomcat.
   
4. Для указания информации пользователя для сервера Tomcat перейдите в закладку Log On.
   
5. Выберите “This account” и введите информацию о созданной учетной записи.
   
6. Нажмите кнопку Apply для подтверждения изменений.
7. Для того, чтобы запустить сервер Tomcat вернитесь в закладку General.
8. Нажмите кнопку Start.
   
9. Нажмите кнопку OK для того, чтобы завершить работу приложения.

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

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

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

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

1. Откройте Панель Управления и найдите иконку “Система”.
   
2. Нажмите на ссылку “Редактировать системные переменные среды”. Появится диалоговое окно “System Properties”.
   
3. Нажмите кнопку “Переменные среды”.
   
4. Нажмите кнопку “Новая” в категории “Системные переменные”. Появится окно добавления новой системной переменной. Введите “JAVA_HOME” в графе “Имя переменной” и абсолютный путь к директории, где установлен Java JDK в графе “Значение переменной”.
   
5. Нажмите кнопку OK в каждом из окон для подтверждения изменений и закрытия окна.
   

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

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

Установка

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

Активация

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

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

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

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

   $PasswordFile

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

   $BaseDirectory

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

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

Установка

1. Найдите файл webMathematica.zip в установочном файле webMathematica. Поместите его в директорию webapps вашего сервера Apache Tomcat для того, чтобы при запуске сервера этот файл открывался и распаковывался. Как правило, Tomcat будет установлен в следующей директории: C:Program FilesApache Software FoundationTomcat 8.0.
2. Перезапустите сервер Tomcat, используя приложение для конфигурирования сервера Tomcat.

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

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

1. Откройте в браузере основную страницу по адресу “localhost:8080/webMathematica”.
   
2. Щелкните по примеру Hello World.
   

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

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

3. Измените эту секцию следующим образом:

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <KernelExecutable>
         C:Program FilesWolfram ResearchMathematica11.xMathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

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

Тестирование работы интерфейса пользователя Front End

На основной веб-странице webMathematica выберите пример “Plot Example”. На открывшейся странице нажмите кнопку Plot (построить график).


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

Операционная система Windows ограничивает объём памяти, выделяемой для неинтерактивных процессов, каким является вычислительное ядро системы Mathematica, запущенное сервером Tomcat. Когда таким ядрам необходимо выполнить операции, требующие использования программы пользовательского интерфейса системы Mathematica, такие ограничения в объеме доступной памяти могут помешать успешному запуску программы front end.

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

1. Для этого найдите следующую запись в регистре системы:

   HKEY_LOCAL_MACHINESystemCurrentControlSetControlSession Manager
   SubSystemsWindows
   
   %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”.