Interfaz de la línea de comandos
Como hemos mencionado con anterioridad, la solución de FlowForce consiste en dos servicios: FlowForce Server y FlowForce Web Server. Por cada uno de esos servicios hay un ejecutable que admite comandos administrativos que puede ejecutar desde la línea de comandos. Puede encontrar sendos ejecutables en esta ruta:
Linux | /opt/Altova/FlowForceServer2023/bin/ |
macOS | /usr/local/Altova/FlowForceServer2023/bin/ |
Windows | <ProgramFilesFolder>\Altova\FlowForceServer\bin\ |
Los nombres de los ejecutables son:
Linux | flowforceserver flowforcewebserver |
macOS | flowforceserver flowforcewebserver |
Windows | FlowForceServer.exe FlowForceWebServer.exe |
Comandos disponibles
La interfaz de la línea de comandos (ILC) se puede usar con fines administrativos (como asignación de licencias, resolución de problemas y copias de seguridad de bases de datos internas). A continuación enumeramos los comandos que admite la ILC. Las abreviaciones "FFS" y "FFW" indican si el comando se aplica al ejecutable de FlowForce Server o al de FlowForce Web Server.
Recuerde que antes de usar algunos de los comandos primero debe cerrar el servicio en FlowForce Server (véase la tabla siguiente).
Comando | FFS | FFW | Debe cerrar el servicio | Descripción |
Sí | Sí | Muestra la ayuda para el comando dado como argumento. | ||
Sí | Carga y asigna un archivo de licencia a FlowForce Server. (Solamente compatible con plataformas Windows.) | |||
Sí | Sí | Reduce el tamaño de los archivos .db de FlowForce si contienen registros eliminados. | ||
Sí | Sí | Crea una BD de FlowForce Server nueva. | ||
Sí | Sí | Sí | Inicia la aplicación en modo de depuración. | |
Sí | Sí | Exporta todos las cadenas de recursos de la aplicación en un archivo XML. | ||
Sí | Sí | Sí | Inicia la aplicación en primer plano. | |
Sí | Sí | Crea o actualiza la BD de FlowForce Server. | ||
Sí | Sí | Instala la aplicación como servicio Windows. | ||
Sí | Registra FlowForce Server con el servidor Altova LicenseServer de la red local. | |||
Sí | Sí | Migra los datos de FlowForce Server de una versión anterior a la versión más reciente. | ||
Sí | Sí | Inicia la aplicación en modo de reparación. | ||
Sí | Restaura la contraseña del usuario root con su valor predeterminado y concede al usuario root todos los privilegios. | |||
Sí | Sí | Establece el idioma predeterminado. | ||
Sí | Sí | Inicia la aplicación como servicio. | ||
Sí | Sí | Desinstala la aplicación como servicio Windows. | ||
Sí | Sí | Actualiza la BD de FlowForce Server con la versión más reciente. | ||
Sí | Comprueba si FlowForce Server tiene asignada una licencia o si ya tiene asignada determinada clave de licencia. (Solamente compatible con plataformas Windows.) |
Convenciones
Por convención, en esta documentación usamos una forma abreviada de la ruta de acceso del ejecutable al describir los comandos y usamos flowforceserver en lugar del nombre del ejecutable, por ejemplo:
flowforceserver help |
Donde flowforceserver es la ruta de acceso o el nombre del ejecutable. Observe que si usa una ruta absoluta podrá ejecutar comandos independientemente del directorio actual en el que esté su ventana (terminal) de la línea de comandos. Sin embargo, si quiere llamar al ejecutable tecleando su nombre, primero debe seguir uno de estos pasos:
•Cambie el directorio actual de la terminal al directorio de instalación de FlowForce Server
•Añada el directorio en el que está el ejecutable a la variable de entorno PATH.
A continuación describimos estos dos escenarios con más detalle.
Consejos
Si no está familiarizado con la línea de comandos, estos son algunos consejos que le pueden ayudar.
•Para averiguar el directorio en el que está actualmente la ventana de la línea de comandos introduzca pwd en Linux y en MacOS. En Windows debe introducir echo %CD%.
•Puede usar la tecla Tabulador para introducir varias rutas de acceso a archivos o directorios sin tener que escribirlos por completo. Por ejemplo, si teclea cd c:\prog en la línea de comandos y pulse Tabulador para que el comando se complete automáticamente a C:\Program Files (o a otro directorio de C:\ que comience por "Prog").
•Al introducir en Windows una ruta que contiene espacios en blanco, como C:\Program Files, debe escribirlos entre comillas.
•Si ve un mensaje parecido a "No se reconoce este comando como comando interno o externo" es probable que haya escrito mal alguna ruta o algún comando.
•En Linux debe asegurarse de que escribe la ruta o el nombre del directorio con mayúsculas si es que las contienen. Por ejemplo, si escribe la ruta /home/nikita/downloads verá que aparece un error si el nombre del directorio en realidad es /home/nikita/Downloads.
•Al escribir una ruta en Linux o en macOS debe usar barra en lugar de barra invertida, como hace en Windows.
Ejecutar un comando
1.Abra una ventana de la línea de comandos.
a.Para abrir la línea de comandos en Windows, pulse la tecla Windows y escriba cmd. Haga clic en la sugerencia que aparece: Símbolo del sistema.
b.Para abrirla en Mac, haga clic en el icono Finder y en el menú seleccione Ir > Utilidades. Haga doble clic en el icono Terminal de la ventana Utilidades.
c.Si usa Linux con una interfaz gráfica del usuario, elija y ejecute el comando Terminal según su distribución de Linux. Si ejecuta Linux desde la línea de comandos puede ignorar este paso.
2.Introduzca la ruta de acceso completa al ejecutable, seguida del comando que quiere ejecutar. Por ejemplo, el comando siguiente abre la ayuda en la línea de comandos.
Linux | /opt/Altova/FlowForceServer2023/bin/flowforceserver help |
macOS | /usr/local/Altova/FlowForceServer2023/bin/flowforceserver help |
Windows | C:\Archivos de programa (x86)\Altova\FlowForceServer2023\bin\FlowForceServer.exe help |
En el ejemplo anterior el comando help se ejecuta sin más opciones o argumentos. Otros comandos pueden tener argumentos y opciones, que pueden ser obligatorios u opcionales. Consulte la sección de referencia para más detalles sobre cada uno de los comandos.
Llamar a FlowForce Server en el directorio de instalación
Para llamar al ejecutable sin tener que teclear toda la ruta, cambie el directorio actual por el directorio en el que está instalado FlowForce Server, por ejemplo:
Linux | cd /opt/Altova/FlowForceServer2023/bin |
macOS | cd /usr/local/Altova/FlowForceServer2023/bin |
Windows | cd C:\Program Files (x86)\Altova\FlowForceServer2023\bin |
Ahora para ejecutar cualquier comando solo tiene que teclear el nombre del ejecutable, por ejemplo:
Linux | ./flowforceserver help |
macOS | ./flowforceserver help |
Windows | FlowForceServer.exe help |
Nota: | en Linux y macOS el prefijo ./ indica que el ejecutable está en el directorio actual. |
Llamar a FlowForce Server desde cualquier directorio
Para llamar al ejecutable desde cualquier directorio debe hacer referencia a este con una ruta absoluta. Otra alternativa para llamar al programa es teclear solamente el nombre del ejecutable si primero edita la variable de entorno de su sistema operativo PATH para que incluya la ruta completa de acceso al directorio de instalación de FlowForce Server. Hay varias maneras de cambiar la variable PATH, por ejemplo:
Nota: | una vez modificada la variable de entorno PATH, para que los cambios surtan efecto puede que sea necesario cerrar la ventana de la línea de comandos y abrir una nueva. |