Línea de comandos de MapForce Server
MapForce Server cuenta con una interfaz de la línea de comandos que puede usar para tareas administrativas como asignar licencias o ejecutar archivos de ejecución de asignaciones (.mfx). A continuación enumeramos los comandos disponibles.
•assignlicense: (solo para Windows) carga una licencia en LicenseServer y la asigna a MapForce Server.
•exportresourcestrings: exporta todas las cadenas de recursos de la aplicación a un archivo XML.
•help: muestra información sobre el comando que se da como argumento (o sobre todos los comandos si no se da ningún argumento).
•licenseserver: registra MapForce Server con un LicenseServer de la red local.
•run: ejecuta un archivo de ejecución de asignación compilado con MapForce.
•setdeflang: establece el idioma predeterminado de MapForce Server.
•verifylicense: (solo para Windows) comprueba si la versión actual de MapForce Server tiene asignada una licencia o, en su caso, si la clave de licencia dada es la que corresponde.
•version: muestra el número de versión de MapForce Server.
Para llamar a MapForce Server desde la línea de comandos necesita saber la ruta de acceso al ejecutable, que es distinta según el sistema operativo que use. Por defecto, el ejecutable de MapForce Server está instalado en:
Linux | /opt/Altova/MapForceServer2023/bin/mapforceserver |
macOS | /usr/local/Altova/MapForceServer2023/bin/mapforceserver |
Windows | C:\Program Files\Altova\MapForceServer2023\bin\MapForceServer.exe |
Nota: | si instala la versión de MapForce Server de 32 bits en una versión de Windows de 64 bits, cambie C:\Archivos de programa to C:\Archivos de programa (x86). |
Por convención, en esta documentación usamos una forma abreviada de la ruta de acceso del ejecutable al describir los comandos y usamos mapforceserver en lugar del nombre del ejecutable, por ejemplo:
mapforceserver help |
Donde mapforceserver 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 MapForce 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/MapForceServer2023/bin/mapforceserver help |
macOS | /usr/local/Altova/MapForceServer2023/bin/mapforceserver help |
Windows | C:\Archivos de programa (x86)\Altova\MapForceServer2023\bin\MapForceServer.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. Por ejemplo, el comando run tiene un argumento obligatorio que permite indicar la ruta de acceso o el nombre de archivo del archivo .mfx que quiere ejecutar. Consulte la sección de referencia para más detalles sobre cada uno de los comandos.
Llamar a MapForce 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 MapForce Server, por ejemplo:
Linux | cd /opt/Altova/MapForceServer2023/bin |
macOS | cd /usr/local/Altova/MapForceServer2023/bin |
Windows | cd C:\Program Files (x86)\Altova\MapForceServer2023\bin |
Ahora para ejecutar cualquier comando solo tiene que teclear el nombre del ejecutable, por ejemplo:
Linux | ./mapforceserver help |
macOS | ./mapforceserver help |
Windows | MapForceServer.exe help |
Nota: | en Linux y macOS el prefijo ./ indica que el ejecutable está en el directorio actual. |
Llamar a MapForce 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 MapForce 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. |