O webMathematica precisa que o Java, um container de Servlet, e o Mathematica estejam instalados no seu sistema. Certas funcionalidades no Mathematica, e portanto no webMathematica, exigem o uso da interface do Mathematica. A interface exige também X Window System em Linux. Os passos para instalar o webMathematica são os seguintes:

1. Configurando Java
2. Configurando Tomcat
3. Configurando o Mathematica
4. Faça os arquivos de licença acessíveis para os usuários “Tomcat”.
5. Instalando e configurando o webMathematica
6. Configuração de Xvnc para edições Minimal ou Server de Linux

Configurando Java

O Java é necessário não somente para o webMathematica, mas também para qualquer container de Servlet de Java. Você pode acessar o Java do Oracle no link http://www.oracle.com/us/downloads/index.html.

Em várias distribuições de Linux, os pacotes de Java também podem ser instalados por meio de uma linha de comando ou por meio de seus centros de software:

RedHat / CentOS / Fedora

sudo yum install java-1.8.0-openjdk
sudo yum install java-1.8.0-openjdk-devel 

Debian / Ubuntu

sudo apt-get install openjdk-8-jre
sudo apt-get install openjdk-8-jdk

Para verificar que a instalação foi feita com sucesso, execute na linha de comando:

java -version

Configurando Tomcat

Instalação

O webMathematica foi projetado para operar de container Servlet de Java. Dentre vário containers de Servlet disponíveis, oferecemos um guia limitado somente para Apache Tomcat.

1. Vá até http://tomcat.apache.org/download-80.cgi..
2. Faça o download do instalador no formato apache-tomcat-N.M.QQ.tar.gz, onde N.M.QQ representa o número da versão Tomcat que você fez o download.
3. No local que você deseja instalar o servidor, execute:

   sudo tar -xvzf apache-tomcat-N.M.QQ.tar.gz

Criando uma conta Tomcat

É recomendável configurar uma conta separada para executar o servidor que chamamos de “tomcat”. Esta conta precisa de permissões para executar o webMathematica.

1. Para criar a conta, execute no terminal:

   sudo useradd tomcat
   sudo passwd tomcat

2. Mude a propriedade e o grupo do diretório de instalação de Tomcat para usuário “tomcat” executando esses comandos do diretório de origem onde você instalou o apache-tomcat server:

   sudo chown -R tomcat apache-tomcat-N.M.QQ
   sudo chgrp -R tomcat apache-tomcat-N.M.QQ

Testando o Tomcat

1. Para iniciar o servidor Tomcat, execute no diretório de instalação Tomcat:

   ./bin/startup.sh

2. Abra um navegador da web e escreva “localhost:8080”. Se o Tomcat foi configurado corretamente, uma página similar a esta abaixo aparecerá:

Problemas comuns:

• O firewall do computador está bloqueando a solicitação do Tomcat. O Tomcat, de forma padrão, se executa na porta 8080. Assegure-se de que a porta está aberta para aceitar pacotes tcp no sistema onde está sendo executado o servidor tomcat.
• Se você fizer o download do Java do website da Oracle, o servidor Tomcat pode não encontrar a instalação do Java. Neste caso, configure a variável de sistema JAVA_HOME como o diretório de instalação do Java, por exemplo, executando a seguinte linha de comando de bash ou adicionando essas linhas a .bashrc,se seu Java já foi instalado em /usr/local/jdk1.8.0.

  JAVA_HOME=/usr/local/jdk1.8.0
  export JAVA_HOME

Configurando o Mathematica

Para configurar o Mathematica é preciso que você instale e ative o programava com sua chave de ativação, e mova a informação de licença a um local globalmente acessível em seu computador.

Instalação

Instale o Mathematica executando o instalador de Linux com o seguinte comando:

sudo sh Mathematica_10.3_LINUX.sh

Anote o diretório de instalação se você não escolheu o diretório padrão.

Ativação

Ative o Mathematica on-line ou manualmente.

Em sistemas Linux sem o X Window instalado, a interface do Mathematica não estará disponível. Em vez disso, ative o Mathematica através do kernel.

1. Execute o seguinte comando:

   math

2. Insira sua chave de ativação. Observe que a chave de ativação tem o formato XXXX-XXXX-XXXXXX.

Faça os arquivos de licença acessíveis para os usuários “Tomcat”.

De forma padrão, o Mathematica coloca as informações de licença em um arquivo mathpass em um local específico do usuário. Para que a sua conta “tomcat” acesse suas informações de licença, copie o arquivo mathpass em um diretório base do Mathematica acessível globalmente, e configure suas permissões para que qualquer conta possa ler o arquivo.

1. Para idendificar o local do arquivo mathpass, execute no Mathematica:

   $PasswordFile

2. Para identificar o local do diretório base, execute:

   $BaseDirectory

   Por exemplo:

   Mathematica 11.x.x Kernel for Linux x86 (64-bit)
   Copyright 1988-2017 Wolfram Research, Inc.
   
   In[1]:= $PasswordFile                                                          
   
   Out[1]= /home/user/.Mathematica/Licensing/mathpass
   
   In[2]:= $BaseDirectory                                                          
   
   Out[2]= /usr/share/Mathematica
   

O local dessas pastas são usadas nas seguintes instruções.

1. O diretório de licença pode não existir ainda. Se este é o caso, crie o diretório executando o seguinte comando:

   sudo mkdir /usr/share/Mathematica/Licensing

2. Copie o arquivo mathpass no diretório de licença do diretório base:

   sudo cp /home/jasong/.Mathematica/Licensing/mathpass /usr/share/Mathematica/
   Licensing/. 

3. Conceda acesso de leitura ao arquivo mathpass para todas as contas:

   sudo chmod a+r /usr/share/Mathematica/Licensing/mathpass

Instalando e configurando o webMathematica

Instalação

A instalação de arquivos do webMathematica contém webMathematica Coloque no diretório de aplicações da web dos seus servidores do Apache Tomcat para garantir que esteja aberto e desempacotado quando for iniciado. Supondo que você já definiu $TOMCAT_INSTALL para representar o diretório de instalação do seu servidor Tomcat, execute o seguinte:

1. sudo mv webMathematica $TOMCAT_INSTALL/webapps

2. sudo chown tomcat $TOMCAT_INSTALL/webapps/webMathematica

3. sudo chgrp tomcat $TOMCAT_INSTALL/webapps/webMathematica

4. su tomcat

5. ./$TOMCAT_INSTALL/bin/shutdown.sh

6. ./$TOMCAT_INSTALL/bin/startup.sh

Testes e solução de problemas

O pacote webMathematica em com algumas páginas padrão que podem ser usadas para testar a configuração do webMathematica.

1. Acesse a página base colocando no navegador “localhost:8080/webMathematica”.
   
2. Como um primeiro teste, clique no exemplo Hello World. A página Hello World mostrando data e horário aparecerá.
   
3. Se a página Hello World não estiver funcionando, verifique o arquivo de log:

   less $TOMCAT_INSTALL/logs/webMathematica.log

Problemas comuns:

Procure o erro no arquivo de log ....com.wolfram.kerneltools.state.StateMachine [ERROR] Could not find MathLink executable. Neste caso, o webMathematica não pode encontrar o executável do kernel do Mathematica. Isso pode acontecer se você instalou o Mathematica em um local que não é padrão ou se a versão do webMathematica não estiver emparelhada com a versão recomendada do Mathematica; por exemplo, o webMathematica 3.4.2 foi lançado para o Mathematica 11.2 e aparece no diretório de instalação padrão do Mathematica em executáveis.

Para determinar corretamente a versão correspondente do Mathematica, configure o webMathematica.

1. Na linha de comando, vá até $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/ e localize o arquivo MSPConfiguration.xml.
2. Abra o MSPConfiguration.xml em um editor de texto e localize a seguinte seção:

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

3. Edite e troque esta seção para:

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <KernelExecutable>
         /usr/local/Wolfram/Mathematica/10.3/Executables/MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Note: Essas instruções supõem que o Mathematica 11.x foi instalado em /usr/local/Mathematica/11.x/. Se você tem um diretório de instalação diferente, subtitua pelo diretório de instalação utilizado.

Configuração de Xvnc para edições Minimal ou Server de Linux

Muitas distribuições “Server” ou “Minimal” de Linux não incluem um servidor X Window de forma padrão. Algumas funcionalidades do Mathematica e portanto do webMathematica requerem um servidor X Window disponível. Por exemplo, o exemplo de Plot não pode ser executado adequadamente sem algum sistema X Window. Por estas razões, é recomendável que você execute um servidor Xvnc.

1. Instale um Xvnc, que pode ser obtido por meio das linhas de comando para instalar aplicações como yum or apt-get.
2. Inicie uma tela vnc com o comando “vncserver”. Esta ação irá solicitar que você tenha um número de tela (normalmente 1).
3. Configure o webMathematica para usar a tela, editando o arquivo $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/MSPConfiguration.xml para incluir o seguinte código:

   <KernelPool>
   ....
   <FrontEndLaunchFlags>
   -display :1 -nogui 1000x500+10+10
   </FrontEndLaunchFlags>
   ....
   </KernelPool>

[English]