Archivos tool
Cuando instale otros servidores de Altova junto con FlowForce Server, se instalará un archivo .tool para cada aplicación que pueda ejecutarse bajo la gestión de FlowForce Server. Puede instalar estos productos de servidor seleccionándolos en el asistente de instalación de FlowForce Server o instalándolos posteriormente mediante sus programas de instalación independientes. Estos son los productos de Altova que pueden ejecutarse bajo el control de FlowForce Server:
No es necesario que configure los archivos .tool, a menos que necesite modificar las variables de entorno que requieren MapForce Server o StyleVision Server (por ejemplo, CLASSPATH).
Directorios de instalación y de datos de la instancia
FlowForce Server utiliza archivos .tool para localizar y configurar la ejecución de las demás aplicaciones de servidor bajo su gestión. FlowForce Server busca primero los archivos .tool en INSTANCEDIR y, a continuación, en INSTALLDIR. En las tablas que aparecen a continuación puede ver las rutas de acceso a esos directorios en distintos sistemas operativos. Los directorios que se muestran para INSTANCEDIR son rutas de acceso predeterminadas. Mientras esté configurando FlowForce Server, puede establecer una ruta de acceso personalizada para INSTANCEDIR.
Directorio de instancia de FlowForce Server (INSTANCEDIR) | |
|---|---|
Linux | /var/opt/Altova/FlowForceServer/data |
Windows | C:\ProgramData\Altova\FlowForceServer\data |
Directorio de instalación de FlowForce Server (INSTALLDIR) | |
|---|---|
Linux | /opt/Altova/FlowForceServer2027/ |
Windows | C:\Archivos de programa\Altova\FlowForceServer2027\ C:\Archivos de programa (x86)\Altova\FlowForceServer2027\ |
El directorio INSTANCEDIR\tools suele estar vacío. Puede guardar archivos de herramientas personalizados en este directorio. El directorio INSTALLDIR es gestionado por el proceso de instalación, y no se deben modificar los archivos .tool que contiene.
Secuencia de instalación
Podrá encontrar archivos .tool en el directorio INSTALLDIR si se ha instalado MapForce Server o StyleVision Server después de FlowForce Server. Si el archivo .tool no se encuentra ni en INSTANCEDIR ni en INSTALLDIR, es probable que FlowForce Server se haya instalado después de MapForce Server o StyleVision Server. En ese caso, el archivo .tool se encontrará en el directorio etc del directorio de instalación de MapForce Server o StyleVision Server.
Mensajes de información
FlowForce Server agrupa las instancias de proceso de las herramientas en ejecución y las gestiona conforme a la configuración de los archivos .tool. FlowForce Server gestiona los procesos que inicia para otras aplicaciones de servidor. Los siguientes eventos pueden generar mensajes de información en el registro:
Iniciando instancia {id} de {tool} para {session}. Iniciando {commandline}. La instancia {id} de {tool} para {session} está inactiva ahora. Cerrando la instancia {id} de {tool} para {session}; ha estado demasiado tiempo inactiva. Cerrando la instancia {id} de {tool} para {session}; se alcanzó el límite de reutilización. La instancia {id} de {tool} para {session} cortó la comunicación de forma inesperada. La instancia {id} de {tool} para {session} se anexó a la instancia de trabajo {instanceid}. |
Si algún paso o trabajo falla, se genera un mensaje de registro independiente.
Editar los archivos tool
Los archivos que tienen las extensión .tool se pueden editar en un editor de texto (por ejemplo, Notepad++). Estas son las partes que se pueden editar:
1.[Tool]: En esta sección, puede modificar la ruta de acceso al archivo ejecutable de la herramienta. Por ejemplo, es posible que tenga que actualizar la ruta para utilizar una versión diferente del ejecutable.
2.[Environment]: Puede añadir o modificar esta sección para definir las variables de entorno que requiere la herramienta. Para obtener más información, consulte la sección Variables de entorno que figura más abajo.
Nota:
•Cuando edite un archivo .tool en INSTANCEDIR, los cambios surtirán efecto de inmediato. No es necesario que reinicie FlowForce Server.
•No modifique ninguna opción de los archivos .tool que no hayamos mencionado más arriba a no ser que así se lo indique el equipo de atención técnica de Altova.
•No se pueden definir herramientas personalizadas.
Variables de entorno
Cuando las asignaciones de MapForce Server o las hojas de estilo de StyleVision Server se ejecutan bajo la gestión de FlowForce Server, es posible que sea necesario configurar variables de entorno. Por ejemplo, debe configurar CLASSPATH para especificar la ubicación de los controladores JDBC al conectarse a una base de datos.
Para configurar las variables de entorno que exigen las asignaciones de MapForce Server o las transformaciones de StyleVision Server, edite el archivo .tool del producto servidor de Altova correspondiente. Antes de editar el archivo .tool, compruebe si ya existe en el directorio INSTANCEDIR. Si no es así, cópielo desde el directorio INSTALLDIR de FlowForce Server.
CLASSPATH
Dentro del archivo .tool puede agregar variables de entorno bajo la sección [Environment]. Las variables de entorno definidas en el archivo .tool invalidan las variables de entorno definidas por otros medios El siguiente ejemplo de un archivo .tool (Linux) configura la variable CLASSPATH:
[Environment]
CLASSPATH=.:/usr/local/jdbc/oracle/ojdbc6.jar
PYTHONHOME y VIRTUAL_ENV
Para ejecutar una asignación que contenga funciones personales Python con FlowForce Server, configure el entorno de Python en el archivo .tool de MapForce Server y asegúrese de que el módulo Python esté disponible en el equipo en el que se ejecuta FlowForce Server.
Nota: El usuario con cuyas credenciales se ejecute el trabajo de FlowForce debe tener permiso de lectura en todos los directorios y archivos necesarios para la asignación.
Para obtener más información sobre el uso de funciones personales Python en MapForce, consulte el tema Bibliotecas personales Python en la documentación de MapForce (https://www.altova.com/es/documentation#mapforce).
De forma predeterminada, MapForce Server busca el módulo Python en el directorio desde el que se importó a MapForce en el momento de diseñar la asignación de datos. Si FlowForce Server se ejecuta en otro equipo y el módulo no está disponible en él, copie el módulo en dicho equipo y asegúrese de que Python pueda localizarlo. Para obtener información sobre cómo localiza Python los módulos, consulte la documentación de Python.
Windows
Si utiliza un entorno virtual Python, configure VIRTUAL_ENV con el entorno virtual y PYTHONHOME con la instalación base de Python en la sección [Environment] del archivo .tool de MapForce Server. Por ejemplo:
[Environment]
VIRTUAL_ENV=C:\Users\<User>\.venv
PYTHONHOME=C:\Python314
MapForce Server busca la instalación de Python siguiendo este orden:
1.VIRTUAL_ENV
2.PYTHONHOME
3.PATH
Linux
En Linux, cree un entorno virtual Python y especifíquelo en el archivo .tool de MapForce Server. Se recomienda utilizar un entorno virtual, ya que la instalación de módulos Python en los directorios del sistema puede requerir acceso de usuario root.
MapForce Server busca la instalación de Python siguiendo este orden:
1.VIRTUAL_ENV
2.PATH
Para crear un entorno virtual Python, utilice el siguiente comando:
python3 -m venv ./.venv
Para especificar el entorno virtual, edite el archivo .tool de MapForce Server de la siguiente manera:
[Environment]
VIRTUAL_ENV=/home/<user>/.venv
Puede colocar el módulo en el directorio site-packages del entorno virtual. Por ejemplo, en el caso de Python 3.14, el directorio en Linux podría ser:
~/.venv/lib/python3.14/site-packages/
Como alternativa, puede instalar el módulo Python usando pip, por ejemplo:
pip install -e .
Este comando requiere un archivo de configuración TOML que especifique la ubicación del código fuente de Python. La instalación añade automáticamente la ruta de acceso del módulo a sys.path.