Wolfram Computation Meets Knowledge

如何在 macOS 系统安装 webMathematica?

使用 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>
  4. 注意:该说明中假设 Mathematica 被命名为 “Mathematica.app”。如果您有不同的应用程序名称,请用您使用的名称替换。

[English]

该文档是否有帮助?

任何建议?

非常感谢您的反馈!

提交

联系支持团队

从账单到产品激活,以及任何技术相关内容,无论您遇到任何问题,我们都在此为您提供帮助。

1-800-WOLFRAM (+1-217-398-0700 美国境外用户)

客服支持

周一至周五
8am–5pm 美国中部时区

  • 产品注册或激活
  • 预售信息和订单
  • 安装帮助和首次启动

高级技术支持 (面向特定用户)

周一至周四
8am–7pm 美国中部时区

周五
8:30–10am & 11am–5pm 美国中部时区

  • 优先技术支持
  • Wolfram 专家助理专员
  • Wolfram 语言编程帮助
  • 高级安装支持