Instalação do Gateway

Instalar o Gateway em servidor Windows

Para o Gateway poder ser instalado on-premises em um servidor Windows, são necessários os pré-requisitos a seguir:

• Arquivos do Java baixados: jre1.8.0_241 e jdk1.8.0_241
• Arquivo do Tomcat 9 baixado (32 bits ou 64 bits, dependendo das configurações do servidor)
• Arquivo para criar o serviço Apache do Tomcat no Windows
• Arquivo taxrules-rep.jar do componente de regras a ser instalado.
• Arquivo taxgateway.war do componente de lógica a ser instalado.
• Arquivo taxcomponent.conf de configuração do Tax Determination.

Para instalar o Gateway no Windows, siga os passos abaixo:

1. Crie as pastas listadas abaixo no servidor:
   • C:\jdk
   • C:\jre
   • C:\tomcat
2. Descompacte os arquivos ZIP do Java e do Tomcat em suas respectivas pastas.
3. Crie a pasta C:\taxrules.
4. Edite as permissões da pasta para permitir a leitura e a gravação para todos.
5. Abra o arquivo CATALINA.BAT ou o STARTUP.BAT no diretório C:\tomcat\bin\catalina.bat.
6. Edite o arquivo e adicione estas linhas antes da primeira linha executável:
   

   set "JAVA_OPTS=-Dtaxcomponent.conf.basedir=C:\taxrules -Dtaxcomponent.rules.basedir=C:\taxrules -Xms64m -Xmx2300m -Duser.timezone=GMT-3"
   set JAVA_HOME=C:\jdk
   set JRE_HOME=C:\jre

7. Salve e feche o arquivo.
8. Copie o arquivo taxcomponent.conf na pasta C:\taxrules.
9. Copie o arquivo taxrules-rep.jar na pasta C:\taxrules.
10. Copie o arquivo taxgateway.war na pasta C:\tomcat\webapps.
11. Ative o Tomcat em C:\tomcat9\bin\startup.

Instalar o Gateway em servidor Linux

Para o Gateway poder ser instalado on-premises em um servidor Linux, são necessários os pré-requisitos a seguir:

• Arquivos do Java baixados: jre1.8.0_241 e jdk1.8.0_241
• Arquivo do Tomcat 9 baixado (32 bits ou 64 bits, dependendo das configurações do servidor)
• Arquivo taxrules-rep.jar do componente de regras a ser instalado.
• Arquivo taxgateway.war do componente de lógica a ser instalado.
• Arquivo taxcomponent.conf de configuração do Tax Determination.         

Para instalar o Gateway no Linux, siga os passos abaixo:

1. Crie as pastas listadas abaixo no servidor.
   • /opt/jdk
   • /opt/jre
   • /var/lib/tomcat9/bin/startup
2. Descompacte os arquivos ZIP do Java e do Tomcat em suas respectivas pastas.
3. Crie a pasta ~\taxrules.
4. Edite as permissões da pasta para permitir a leitura e a gravação para todos.
5. Abra o arquivo CATALINA.SHT ou o STARTUP.SH no diretório /var/lib/tomcat9/bin/catalina.sh.
6. Edite o arquivo e adicione estas linhas antes da primeira linha executável:

   export JAVA_OPTS="-Dtaxcomponent.conf.basedir=/home/usuario/taxrules -Dtaxcomponent.rules.basedir=/home/usuario/taxrules -Xmx2300m -Duser.timezone=GMT-3"export JAVA_HOME=/opt/java/jdk1.8/export JRE_HOME=/opt/java/jdk1.8/

7. Salve e feche o arquivo.
8. Copie o arquivo taxcomponent.conf na pasta ~\taxrules.
9. Copie o arquivo taxrules-rep.jar na pasta /home/usuários/taxrules.
10. Copie o arquivo taxgateway.war na pasta /var/lib/tomcat9/webapps.
11. Ative o Tomcat sudo servisse tomcat9 start.

Testar a instalação do Gateway

Após finalizar uma instalação do Gateway no Windows ou no Linux, é possível testá-la seguindo os passos abaixo:

1. Acesse a página http://localhost:9090/taxgateway.
2. Selecione o menu API e então selecione API REST
3. No endpoint "POST /Taxrules/calctaxes", clique no botão Try it out.
4. Clique no botão Execute e verifique a resposta da chamada.