Configurar Tomcat para funcionar detrás de un proxy de Internet

Precaución

Le animamos a plantearse no configurar la conexión a Internet en servidores que están detrás de un proxy de Internet.

Tiene algunos inconvenientes, como:

• Tendrá que utilizar los datos de su proxy cada vez que actualice la aplicación con las herramientas de actualización automática de OpenKM.
• Es necesario configurar los parámetros de la JVM con los datos de su proxy de Internet para que la aplicación pueda conectarse a Internet.

No está muy claro cuáles son las ventajas de este tipo de configuración en servidores de producción, que no son el mismo escenario que los usuarios finales. Tómelo tal cual, es solo una sugerencia.

Linux

Nota

La configuración siguiente se basa en establecer los parámetros de configuración del proxy en el entorno de la JVM. Existe otra opción, que es configurar el proxy a nivel del sistema operativo; hay varias opciones, una de ellas es:

Edite su archivo “/etc/bash.bashrc” como root y ponga estas líneas al final de su archivo “/etc/bash.bashrc”:

export http_proxy=http://username:password@proxyserver.net:port/
export ftp_proxy=http://username:password@proxyserver.net:port/

• Detenga OpenKM.
• Edite el archivo $TOMCAT_HOME/bin/setenv.sh y añada las líneas:

Precaución

El valor http://proxy.url.com debe ser la URL de su propio host proxy.

El valor “user” debe ser el usuario para conectarse al proxy. Si su proxy no requiere autenticación, puede eliminar la línea completa donde se establecen estos parámetros.

El valor “password” debe ser la contraseña del usuario para conectarse al proxy. Si su proxy no requiere autenticación, puede eliminar la línea completa donde se establecen estos parámetros.

set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=http://proxy.url.com -Dhttps.proxyHost=http://proxy.url.com
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyUser=user -Dhttps.proxyUser=user
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyPassword=password -Dhttps.proxyPassword=password

Al final, su setenv.sh debería tener un aspecto similar a este:

JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx2048m -XX:+UseConcMarkSweepGC -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true"
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Dmail.mime.ignoreunknownencoding=true"
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=http://proxy.url.com -Dhttps.proxyHost=http://proxy.url.com
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyUser=user -Dhttps.proxyUser=user
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyPassword=password -Dhttps.proxyPassword=password
CATALINA_PID=$CATALINA_HOME/catalina.pid
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib/sigar

Nota

Si tiene problemas para resolver DNS, también puede probar con esta configuración, que intenta utilizar el DNS de Google:

set JAVA_OPTS=%JAVA_OPTS% -Dsun.net.spi.nameservice.nameservers=8.8.8.8
set JAVA_OPTS=%JAVA_OPTS% -Dsun.net.spi.nameservice.provider.1=dns,sun

• Inicie OpenKM.
• Vaya a Administration > Tools > Scripting y ejecute el script siguiente (debería mostrarse el código html de google).

import java.net.URL;
import java.net.HttpURLConnection;
import java.io.BufferedReader;

URL url = new URL("http://www.google.com");
HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
urlConn.setDoInput(true);
urlConn.setDoOutput(true);
urlConn.setUseCaches(false);
urlConn.setRequestMethod("GET");
BufferedReader input = new BufferedReader(new InputStreamReader(urlConn.getInputStream()));
String line;
StringBuilder sb = new StringBuilder();
while ((line = input.readLine()) != null) {
  sb.append(line);
}
input.close();
print(sb.toString().replaceAll("\n","<br/>"));

Windows

Nota

La configuración siguiente se basa en establecer los parámetros de configuración del proxy en el entorno de la JVM. Existe otra opción, que es configurar el proxy a nivel del sistema operativo; considere buscar esta información en el sitio web Microsoft TechNet.

Paso uno

Compruebe el inicio y la parada de OpenKM desde la línea de comandos.

• Primero detenga el servicio OpenKM.
• Edite el archivo $TOMCAT_HOME/bin/seten.bat y añada las líneas:

Precaución

El valor http://proxy.url.com debe ser la URL de su propio host proxy.

El valor “user” debe ser el usuario para conectarse al proxy. Si su proxy no requiere autenticación, puede eliminar la línea completa donde se establecen estos parámetros.

El valor “password” debe ser la contraseña del usuario para conectarse al proxy. Si su proxy no requiere autenticación, puede eliminar la línea completa donde se establecen estos parámetros.

set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=http://proxy.url.com -Dhttps.proxyHost=http://proxy.url.com
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyUser=user -Dhttps.proxyUser=user
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyPassword=password -Dhttps.proxyPassword=password

Al final, su setenv.bat debería tener un aspecto similar a este:

JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx2048m -XX:+UseConcMarkSweepGC -Djava.awt.headless=true -Djava.net.preferIPv4Stack=true"
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Dmail.mime.ignoreunknownencoding=true"
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=http://proxy.url.com -Dhttps.proxyHost=http://proxy.url.com
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyUser=user -Dhttps.proxyUser=user
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyPassword=password -Dhttps.proxyPassword=password
CATALINA_PID=$CATALINA_HOME/catalina.pid
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib/sigar

Nota

Si tiene problemas para resolver DNS, también puede probar con esta configuración, que intenta utilizar el DNS de Google:

set JAVA_OPTS=%JAVA_OPTS% -Dsun.net.spi.nameservice.nameservers=8.8.8.8
set JAVA_OPTS=%JAVA_OPTS% -Dsun.net.spi.nameservice.provider.1=dns,sun

• Inicie OpenKM desde la línea de comandos.

c:\tomcat-8.5.24\bin\> catalina.bat run

• Vaya a Administration > Tools > Scripting y ejecute el script siguiente (debería mostrarse el código html de google).

import java.net.URL;
import java.net.HttpURLConnection;
import java.io.BufferedReader;

URL url = new URL("http://www.google.com");
HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
urlConn.setDoInput(true);
urlConn.setDoOutput(true);
urlConn.setUseCaches(false);
urlConn.setRequestMethod("GET");
BufferedReader input = new BufferedReader(new InputStreamReader(urlConn.getInputStream()));
String line;
StringBuilder sb = new StringBuilder();
while ((line = input.readLine()) != null) {
  sb.append(line);
}
input.close();
print(sb.toString().replaceAll("\n","<br/>"));

Paso dos

Si todo ha ido bien en el paso uno, ya puede configurar los parámetros en el servicio OpenKM.

• Detenga OpenKM.
• Vaya a $TOMCAT_HOME/bin y ejecute la siguiente línea de comandos:

Precaución

Las líneas de comandos siguientes no registran los parámetros de resolución de DNS. Si los necesita, simplemente añádalos.

c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttp.proxyHost=http://proxy.url.com"
c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttps.proxyHost=http://proxy.url.com"
c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttp.proxyUser=user"
c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttps.proxyUser=user"
c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttp.proxyPassword=password"
c:\tomcat-8.5.24\bin\> OpenKM //US//OpenKM ++JvmOptions="-Dhttps.proxyPassword=password

• Inicie OpenKM desde los servicios.
• Vaya a Administration > Tools > Scripting y ejecute el script siguiente (debería mostrarse el código html de google).

import java.net.URL;
import java.net.HttpURLConnection;
import java.io.BufferedReader;

URL url = new URL("http://www.google.com");
HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
urlConn.setDoInput(true);
urlConn.setDoOutput(true);
urlConn.setUseCaches(false);
urlConn.setRequestMethod("GET");
BufferedReader input = new BufferedReader(new InputStreamReader(urlConn.getInputStream()));
String line;
StringBuilder sb = new StringBuilder();
while ((line = input.readLine()) != null) {
  sb.append(line);
}
input.close();
print(sb.toString().replaceAll("\n","<br/>"));