webwebMathematicaを使うためには，Java，Servletコンテナ，およびwebMathematicaがシステムにインストールされていなければなりません．このガイドでは，macOSにwebwebMathematicaをインストールして実行するステップについてご説明します．

1. Javaの設定
2. Tomcatの設定
3. webMathematicaの設定
4. webMathematicaユーザがライセンスファイルにアクセスできるようにする方法
5. webwebMathematicaをインストールして設定する方法

Javaの設定

Javaインストーラをダウンロードして実行します．
 

Tomcatの設定

インストール

1. 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. Webブラウザを開き，「localhost:8080」にアクセスします．Tomcatが正しく設定されている場合には，以下と同じようなページが開きます．
   
   
3. Tomcatサーバを終了するためには，同じディレクトリ内で以下を実行します．

   ./bin/shutdown.sh

考えられる問題

• コンピュータのファイアウォールがTomcatへのリクエストをブロックしている場合があります．Tomcatはデフォルトでポート8080上で実行されます．Tomcatサーバを実行しているシステム上でtcpパケットが受信できるようにポートが開かれているかどうかを確かめてください．
• OracleのWebサイトからJavaをダウンロードした場合に，TomcatサーバがJavaのインストールを見付けられないことがあります．そのような場合には，システム変数JAVA_HOMEをJavaのインストールディレクトリに設定してください．例えば，Javaが/usr/local/jdk1.8.0にインストールされているという場合には，bashコマンドラインで以下を実行，またはこれらのコマンドを.bashrcに追加してください．

  JAVA_HOME=/Applications/jdk1.8.0
  export JAVA_HOME

Tomcatアカウントの作成（推奨）

Tomcatサーバ（通常「tomcat」と呼ばれる）を実行するための専用のユーザアカウントを作成することをお勧めします．このアカウントはTomcatサーバを実行するための承認が必要です．

1. アカウントを作成するためには，ユーザを加えます．
2. apache-tomcatサーバをインストールした場所の親ディレクトリから以下のコマンドを実行して，Tomcatのインストールディレクトリの所有者を「tomcat」ユーザに変更します．

   sudo chown -R tomcat apache-tomcat-<version>

3. 新しいアカウントを使って，サーバを起動します．

   su tomcat
   cd apache-tomcat-<version>/bin
   ./startup.sh

4. Webブラウザを開き，「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. Licensingディレクトリがまだ存在しないという場合もあります．その場合には，以下のコマンドを実行してこのディレクトリを作成します．

    sudo mkdir -p /Library/Mathematica/Licensing

2. mathpassファイルをベースディレクトリのLicensingディレクトリにコピーします．

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

3. すべてのアカウントについて，mathpassファイルへの読取りアクセスを許可します．

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

webMathematicaをインストールして設定する方法

インストール

1. 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に対応する等です．現在サポートされている製品のバージョンと一緒に使うのに推奨されるバージョンはこちらでご覧ください．

正しいバージョンのMathematicaと一緒に使われるようにするには，webMathematicaを設定する必要があります．

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]