如何在 Windows 系统安装 web Mathematica？
使用 web Mathematica，需要您在系统上安装 Java、Servlet 容器和 Mathematica。请遵循该指南中步骤在 Mac OS X 上安装并运行 web Mathematica：
设置 Java
下载并运行 Java 安装程序。
设置 Tomcat
安装
下载并运行 Tomcat 安装程序。我们推荐下载 32-bit/64-bit Windows Service 安装程序 apache-tomcat-<version>.exe。
测试 Tomcat
- 在 Apache Tomcat 的 Start 菜单中，打开 Configure Tomcat 应用程序，启动 Tomcat 服务器
- 点击 Start 按钮。
- O打开一个网络浏览器并提交 “localhost:8080”。如果 Tomcat 设置正确便会出现以下类似网页页面：
- 若要暂时关闭 Tomcat 服务器，点击 Stop 按钮：
可能出现的常见问题：
- 计算机的防火墙屏蔽了到 Tomcat 的请求。默认情况下，Tomcat 在8080端口运行。请确保 Tomcat 服务器运行的系统上的8080端口可以接受 tcp 信息包。
- 如果将 Java 安装在非默认位置，设置环境变量 JAVA_HOME，让 Tomcat 知道 Java 的安装位置。
- 打开控制面板并搜索 “system”。
- 单击 “Edit the system environment variables”，显示系统属性对话框。
- 单击 “Environment Variables” 按键。
- 单击系统变量下的 New 按键。显示 New System Variable 窗口。
- 输入 “JAVA_HOME” 为 “Variable name”，并在 “Variable value” 输入 JDK 的安装。
- 在任意窗口单击 OK 按键确认并关闭。
创建 Tomcat 账号（推荐）
建议您设置一个专门的用户帐户来运行 Tomcat 服务器，通常称为“tomcat”。此帐户需要运行 Tomcat 服务器的权限。
- 若要创建账户并添加用户。
- 在 Apache Tomcat 下的开始菜单中，打开配置 Tomcat 应用程序。
- 要设置Tomcat 服务器的帐户信息，请选择“Log On”标签。
- 选择“This account”并输入帐户信息。
- 点击 Apply 确认更改。
- 要使用新帐户启动 Tomcat 服务器，请返回到 General 标签。
- 点击 Start 按钮。
- 打开网页浏览器并提交 “localhost:8080”。如果用户设置正确，会在此显示以下页面：
- 点击 OK 关闭应用程序。
设置 Mathematica
您需要安装激活 Mathematica 并将许可证信息移至您机器上可以全局使用的地址。
安装
请遵循在 Windows 上安装 Mathematica 步骤。
激活
在线或手动激活 Mathematica。
设置 web Mathematica 用户可访问许可证文件
默认情况下，Mathematica 将其许可证信息放置于用户指定位置的一个 mathpass 文件中。为使您的“Tomcat” 账户可以使用许可证信息，请复制该 mathpass 文件至 Mathematica 的全局可用根目录并设置其许可使任意账户可以读取。
- 请在 Mathematica 中运行下述指令来找到您的 mathpass 文件：
$PasswordFile - 请运行下述指令来找到根目录位置：
$BaseDirectory - 在 $PasswordFile 位置复制 mathpass 文件并粘贴至 $BaseDirectory 位置的许可证子目录。访问这些目录，您需要显示 Windows 系统中的隐藏文件和文件夹。
安装并设置 web Mathematica
安装
- 从 User Portal 下载 Web Mathematica 下载文件。
- 在您下载的 web Mathematica 中，找到 webMathematica.zip 文件并解压缩至 Tomcat 安装目录的 “webapps” 子目录，通常在
C:\Program Files (x86)\Apache Software Foundation\Tomcat 8.5。 - 在 Configure Tomcat 应用程序中重新启动 Tomcat server。
测试和和检修
web Mathematica 信息包包含多个测试网页。
- 在浏览器中指定 “localhost:8080/webMathematica”。
- 单击 Hello World 范例。
- 在文本编辑器打开
<Tomcat_Install>/webapps/webMathematica/WEB_INF/MSPConfiguration.xml，其中<Tomcat_Install>表示 Tomcat 安装路径。 - 找到以下部分：
- 编辑并更改该部分：
<KernelPool> <KernelPoolName>General</KernelPoolName> <KernelExecutable> C:\Program Files\Wolfram Research\Mathematica12.x\MathKernel </KernelExecutable> <URLPattern>/*</URLPattern> </KernelPool> - 查找注册表项：
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 - 删除 SharedSection 变量的第三个参数，例如，在以上例子中用 1024,3072” 更换 “1024,3072,512”。
- 重启计算机。
如果 Hello World 未工作，在 Tomcat 安装目录的错误信息日志中单击 web Mathematica.log 文件。
可能出现的常见问题：
在日志文件中查找错误 ....com.wolfram.kerneltools.state.StateMachine . 这种情况下，web Mathematica 无法找到 Mathematica 内核的可执行文件。如果您将 Mathematica 安装于非标准位置或 web Mathematica 版本与推荐的 Mathematica 版本不匹配，这种情况就可能发生，例如，web Mathematica 3.5.3 与 Mathematica 12.3 对应。有关当前支持的其他产品版本的推荐配对，请参阅此处。
需要配置 web Mathematica 来获取正确版本的 Mathematica 共同使用。
<KernelPool>
<KernelPoolName>General</KernelPoolName>
<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 限制非交互用户可占用的内存量，例如由 Tomcat server 开启的 Mathematica 内核。当该内核需要执行需要 Mathematica 前端的计算时，内存占用设定可能会限制前端的启动.
为增加可用内存，允许非交互用户可以使用与交互用户相同的内存量。
[English]
