使用 webMathematica，需要您的系统上安装 Java、Servlet 集合和 Mathematica。请遵循这篇指南在 macOS 上安装并运行 webMathematica：

1. 设置 Java
2. 设置 Tomcat
3. 设置 Mathematica
4. 让 webMathematica 可以访问许可证文件
5. 安装并设置 webMathematica

设置 Java

下载并运行 Java 安装程序。
 

设置 Tomcat

安装

1. Go to 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端口运行。请确保 Tomcat 服务器运行的系统上的8080端口可以接受 tcp 信息包。
• 如果您是从 Oracle 网站上下载的 Java，Tomcat 服务器可能无法找到 Java 安装程序。这种情况下，请将系统变量 JAVA_HOME 设为 Java 的安装目录，例如，如果您的 Java 安装在 /Applications/jdk1.8.0，请在 bash 指令行上执行下述指令或将下述指令加入.bashrc：

  JAVA_HOME=/Applications/jdk1.8.0
  export JAVA_HOME

创建 Tomcat 账户（推荐）

建议您设置一个专门的用户帐户来运行 Tomcat 服务器，通常称为 “tomcat”。此帐户需要运行 Tomcat 服务器的权限。

1. 若要创建账号， add a user.
2. 通过从安装 apache-tomcat 服务器的父目录执行以下命令，将 Tomcat 安装目录的所有权更改为 “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 的许可证信息移至您机器上可以全局使用的地址。

安装

请遵循 在 macOS 上安装 Mathematica 的指南。

激活

用在线或手动方式 激活 Mathematica。

使许可文件可访问 webMathematica

默认情况下，Mathematica 将其许可信息放在用户特定位置的 mathpass 文件中。为了让您的 webMathematica 可以访问您的许可信息，请将 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. 许可证目录可能尚不存在。如果是这样的，请执行下述指令来创建该目录：

    sudo mkdir -p /Library/Mathematica/Licensing

2. 将这个 mathpass 文件复制至根目录的许可证目录：

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

3. 为所有账户授权 mathpass 文件的读取：

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

安装并设置 webMathematica

安装

1. 从您的User Portal下载 webMathematica 的安装文件并解压缩以确保它已打开和解压。
2. 将解压后的 webMathematica 目录放入 Apache Tomcat 服务器的 webapps 目录中，其中 $TOMCAT_INSTALL 是 Tomcat 服务器的安装目录：

   sudo mv webMathematica $TOMCAT_INSTALL/webapps/

3. 如果您创建了一个 tomcat 用户来运行服务器，还需要更改 webMathematica 文件夹的所有权：

   sudo chown -R tomcat $TOMCAT_INSTALL/webapps/webMathematica

4. 从拥有该文件夹的帐户重新启动服务器：

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

测试和和检修

webMathematica 包带有一些默认页面，可用于测试 webMathematica 的设置。

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。这种情况下，webMathematica 无法找到 Mathematica 内核的可执行文件。如果您将 Mathematica 安装于非标准位置或 webMathematica 版本与推荐的 Mathematica 版本不匹配，这种情况就可能发生；例如，webMathematica 3.5.2 用于 Mathematica 12.2。有关当前支持的其他产品版本的推荐配对，请参阅此处。

需要配置 webMathematica 来获取正确版本的 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]