Configurar el servidor

Temas de este apartado:

Archivo de configuración del servidor: configuración inicial

Archivo de configuración del servidor: modificar configuración inicial, volver a la configuración inicial

Archivo de configuración del servidor: ejemplo y opciones de configuración

Archivo de configuración del servidor: descripción de las opciones de configuración Configurar la dirección del servidor

Archivo de configuración del servidor: configuración inicial

RaptorXML Server se configura por medio de un archivo de configuración llamado

server_config.xml, que se coloca por defecto en esta carpeta:

C:\Program Files (x86)\Altova\RaptorXMLServer2014\etc\server_config.xml

La configuración inicial para RaptorXML Server define: El número de puerto 8087 como puerto del servidor

Que el servidor solamente escucha a conexiones locales (localhost). Que el servidor escribe los resultados en la carpeta C:\ProgramData\Altova \RaptorXMLServer2014\Output\.

Las demás opciones de configuración predeterminadas aparecen más abajo en el fragmento del archivo de configuración server_config.xml.

Archivo de configuración del servidor: modificar o volver a la configuración inicial Si quiere cambiar la configuración inicial, edite el archivo de configuración del servidor

server_config.xml (ver más abajo), guárdelo y después reinicie RaptorXML Server como

servicio.

Si quiere recrear el archivo de configuración original (para volver a la configuración inicial), ejecute el comando createconfig:

RaptorXML.exe createconfig

Al ejecutar este comando, el archivo de configuración inicial se recrea y sobrescribe el archivo

server_config.xml. Por tanto, el comando createconfig sirve para devolver al servidor a su

configuración inicial de fábrica.

© 2014 Altova Gmb H

Preparar el servidor 127 Interfaz HTTP

Altova RaptorXML Server 2014

A continuación puede ver el archivo de configuración del servidor server_config.xml en su

versión original. Las opciones de configuración se explican más abajo.

server_config.xml <config xmlns="http://www.altova.com/schemas/altova/raptorxml/config" xsi:schemaLocation="http://www.altova.com/schemas/altova/raptorxml/config http://www.altova.com/schemas/altova/raptorxml/config.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <language>en</language>

<server.unrestricted-filesystem-access>true</server.unrestricted-filesystem- access>

<server.output-root-dir>C:\ProgramData\Altova\RaptorXMLServer2014\Output\</ server.output-root-dir>

<server.script-root-dir>C:\Program Files (x86)\Altova\RaptorXMLServer2014\etc \scripts\</server.script-root-dir>

<!--<server.catalog-file>catalog.xml</server.catalog-file>-->

<server.log-file>C:\ProgramData\Altova\RaptorXMLServer2014\Log\server.log</ server.log-file>

<http.environment>production</http.environment> <!--<http.socket-host>localhost</http.socket-host>--> <http.socket-port>8087</http.socket-port>

<http.log-screen>true</http.log-screen>

<http.access-file>C:\ProgramData\Altova\RaptorXMLServer2014\Log\access.log</ http.access-file> <http.error-file>C:\ProgramData\Altova\RaptorXMLServer2014\Log\error.log</ http.error-file> </config> Opciones de configuración language

Define el idioma de los mensajes del servidor, en el elemento opcional language. El valor

predeterminado es es (español) y los valores permitidos son en|de|es|ja (inglés, alemán,

español y japonés respectivamente). Para aprender a localizar (=traducir) RaptorXML, consulte el apartado Comandos de localización.

server.unrestricted-filesystem-access

Si el valor es true (valor predeterminado), los archivos de salida se escriben directamente en la

ubicación especificada por el cliente y en los scripts Python (y posiblemente sobrescriben los archivos ya existentes del mismo nombre). Si el valor es false, los archivos se escriben en el

directorio del trabajo del directorio de salida y el URI del archivo se incluye en el documento de resultados. Por tanto, el valor false aporta mayor seguridad, porque los archivos solo se pueden

escribir en el disco en un directorio del trabajo especializado y conocido. Los archivos de salida del trabajo se pueden copiar después en otras ubicaciones.

128 Interfaz HTTP Preparar el servidor

© 2014 Altova Gmb H

Altova RaptorXML Server 2014

server.output-root-dir

Directorio en el que se guardan los documentos de salida de todos los trabajos.

server.script-root-dir

Directorio en el que se deben guardar los scripts Python de confianza. Cuando se usa con la interfaz HTTP, la opción script solamente funciona si se utilizan scripts del directorio de

confianza. Si especifica un script Python de otro directorio, se produce un error. Para más información consulte el apartado Trabajar con scripts Python seguros.

server.catalog-file

La URL del archivo de catálogo XML que se debe usar. El archivo de catálogo RootCatalog.xml

está por defecto en la carpeta <CarpetaArchivosProgramas>\Altova\RaptorXMLServer2014 \etc. Solamente debe utilizar la opción server.catalog-file si quiere cambiar de archivo catálogo.

server.log-file

Nombre y ubicación del archivo de registro del servidor. Los eventos del servidor, como Se inició/

Se detuvo el servidor, se registran continuamente en el registro de eventos del servidor y

aparecen en un visor de eventos del sistema, como el visor de eventos de Windows. Además, los mensajes del registro se pueden escribir en el archivo indicado por medio de la opción

server.log-file. El archivo de registro del servidor, por tanto, contiene información sobre todas las actividades del servidor, incluidos los errores de inicio del servidor, el archivo de configuración utilizado y los errores de licencia.

http.environment

Entornos internos de raptorxml: production | development. El entorno de desarrollo

development está enfocado a los requisitos de los desarrolladores y permite realizar tareas de depuración con mayor facilidad que el entorno de producción production.

http.socket-host

Interfaz por la que se accede a RaptorXML Server. Si quiere que RaptorXML Server acepte conexiones desde equipos remotos, quite la marca de comentario de este elemento y defina su contenido como 0.0.0.0, es decir: <http.socket-host>0.0.0.0</http.socket-host>. Esto almacena el servicio en cada interfaz direccionable del equipo servidor. En este caso, compruebe que las opciones del servidor de seguridad están configuradas correctamente. Las excepciones de entrada del servidor de seguridad para los productos de Altova deben registrarse de la siguiente manera:

Altova LicenseServer: puerto 8088

Altova RaptorXML Server: puerto 8087

Altova FlowForce Server: puerto 8082

http.socket-port

El puerto por el que se accede al servicio. El puerto debe ser fijo y conocido para que las solicitudes HTTP se puedan direccionar correctamente al servicio.

© 2014 Altova Gmb H

Preparar el servidor 129 Interfaz HTTP

Altova RaptorXML Server 2014

Si inició RaptorXML Server con el comando RaptorXMLServer.exe debug, (ver Iniciar el servidor)

y el valor de http.log-screen es true,

la actividad del servidor aparece en la consola de la línea de comandos. De lo contrario, la actividad del servidor no se muestra en la consola. Además de aparecer en pantalla, la actividad se registra en archivos de registro.

http.access-file

Nombre y ubicación del archivo de acceso HTTP. El archivo de acceso contiene información sobre la actividad relacionada con el acceso que puede ayudarle a resolver posibles problemas de conexión.

http.error-file

Nombre y ubicación del archivo de errores HTTP. El archivo de errores contiene errores

relacionados con el tráfico entrante y saliente del servidor. Si hay problemas de conexión, este archivo puede ayudarle a resolverlos.

La dirección de RaptorXML Server

La dirección HTTP del servidor está formada por el host y el puerto del socket:

http://{socket-host}:{socket-puerto}/

La dirección de la configuración inicial es:

http://localhost:8087/

Para cambiar de dirección, cambie las opciones http.socket-host y http.socket-port

del archivo de configuración del servidor server_config.xml. Por ejemplo, si el equipo servidor tiene la dirección IP 100.60.300.6 y se cambiaron las opciones de configuración por:

<http.socket-host>0.0.0.0</http.socket-host>

<http.socket-port>8087</http.socket-port>

Puede dirigirse a RaptorXML Server con:

http://100.60.300.6:8087/

Nota: tras modificar el archivo de configuración del servidor server_config.xml, es necesario

reiniciar RaptorXML Server para que los cambios se apliquen.

Nota: si tiene problemas para conectarse con RaptorXML Server, puede que los archivos

http.access-file y http.error-file le ayuden a resolver el problema.

Nota: los mensajes enviados a RaptorXML Server deben incluir nombres de ruta de acceso

válidos en el equipo servidor. A los documentos del equipo servidor se puede acceder de forma local o remota (en el último caso mediante URI HTTP, por ejemplo).

130 Interfaz HTTP Solicitudes cliente

© 2014 Altova Gmb H

Altova RaptorXML Server 2014