• Sistema operacional: CentOS Linux 7.5.1804 (Core)
• JDK: versão 11.0.18 (LTS)
• Servidor de aplicações: TongWeb 7.0.4.9M4 (edição Enterprise)
• Plataforma GIS: SuperMap iServer 11.2.1

Connfiguração do Ambiente Java

Instale o JDK 11.0.18 no diretório /opt:

tar -zxf jdk-11.0.18_linux-x64_bin.tar.gz
mv jdk-11.0.18 jdk

Atualize as variáveis globais no arquivo /etc/profile:

export JAVA_HOME=/opt/jdk
export JRE_HOME=$JAVA_HOME/jre
export CLASSPATH=$JAVA_HOME/lib:$JRE_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

Recarregue e valide a configuração:

source /etc/profile
java -version

A saída deve indicar java version "11.0.18" com build LTS.

Instalação do TongWeb 7.0.4.9M4

Descompacte a distribuição autônoma:

chmod +x TongWeb7.0.4.9_M4_Enterprise_Linux.tar.gz
tar -zxf TongWeb7.0.4.9_M4_Enterprise_Linux.tar.gz

Copie o arquivo license.dat obtido oficialmente para o diretório raiz do TongWeb (/opt/TongWeb7.0.4.9_M4_Enterprise_Linux).

Inicie o servidor via script:

cd /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
./startservernohup.sh

Acesse a interface administrativa em http://<IP>:9060/console/ com credenciais padrão thanos/thanos123.com. Após o primeiro acesso, defina uma nova senha.

Preparação do SuperMap iServer 11.2.1

Extraia o pacote supermap-iserver-11.2.1-war.zip em /opt. Mantenha apenas os artefatos essenciais:

• iserver.war
• iserver#iClient.war → renomeado para iclient.war
• iserver#help.war → renomeado para help.war
• support_linux_x64.tar.gz

Instale dependências nativas:

tar -zxf support_linux_x64.tar.gz
cd support_linux_x64
./dependencies_check_and_install.sh install -y

Configure a licença de avaliação:

cd SuperMap_License/Support/
tar -xvf aksusbd-8.11.1.tar
cd aksusbd-8.11.1
sudo ./dinst

Extraia e integre as bibliotecas nativas:

cd /opt/support_linux_x64/objectsjava/
tar -zxf bin.tar.gz
mv Bin bin

Adicione ao /etc/profile as variáveis complementares:

export UGO_HOME=/opt/support_linux_x64/objectsjava
export SUPERMAP_ROOT=/opt/support_linux_x64
export LD_LIBRARY_PATH=$UGO_HOME/bin:$LD_LIBRARY_PATH
export PATH=$UGO_HOME/bin:$PATH

Valide a integridade das bibliotecas compartilhadas:

ldd $UGO_HOME/bin/libWrapjC*.so | grep "not found"

Uma saída vazia confirma que todas as dependências estão resolvidas.

Implantação dos Módulos no TongWeb

Copie os WARs renomeados para o diretório de implantação automática:

cp iserver.war /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/autodeploy/
cp iclient.war /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/autodeploy/
cp help.war /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/autodeploy/

Ajustes de Configuração Críticos no TongWeb

Antes de reiniciar, aplique as seguintes alterações:

1. Parâmetro JVM adicional

No arquivo /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/bin/startserver.sh, adicione ao final:

JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.jersey.server.impl.cdi.lookupExtensionInBeanManager=true"

2. Filtro de varredura de JARs

Em /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/conf/tongweb.properties, insira:

tongweb.util.scan.StandardJarScanFilter.jarsToSkip=jersey-*.jar,hadoop-*.jar,tyrus-server*.jar

3. Compatibilidade ZIP64 para JDK 11+

No arquivo /opt/TongWeb7.0.4.9_M4_Enterprise_Linux/bin/external.vmoptions, acrescente:

-Djdk.util.zip.disableZip64ExtraFieldValidation=true

4. Permissão de caracteres especiais nas URLs

No console administrativo do TongWeb, navegue até WEB Container → HTTP Channel Management → tongweb-http-listener → Other Properties e adicione duas entradas:

• relaxedPathChars = []|{}
• relaxedQueryChars = []|{}

5. Habilitação de métodos HTTP restritos

Na mesma tela de configuração de canal HTTP, localize Disabled HTTP Methods e desmarque DELETE e PUT.

6. Codificação UTF-8 para recursos estáticos

Na seção HTTP Channel Settings, altere URL Encoding de GBK para UTF-8 para garantir carregamento correto de ícones SVG.

Finalização e Validação

Reinicie o TongWeb:

./stopserver.sh && ./startservernohup.sh

No console administrativo, vá até Application Management e ajuste os context paths:

• help.war → /iserver/help
• iclient.war → /iserver/iclient

Após a implantação bem-sucedida, acesse:

• iServer principal: http://<IP>:9060/iserver
• Documentação: http://<IP>:9060/iserver/help
• Cliente web: http://<IP>:9060/iserver/iclient

Complete a inicialização do iServer configurando usuário administrador e importando workspaces via interface web.