7.3.3. Ejecución de un servidor autónomo

<< Prev   Next >>

7.3.3.1. Información general

El inicio del servidor autónomo y el programa de utilidad de administración del servidor se realiza desde la línea de comandos. Todos los parámetros necesarios deben especificarse en el archivo de configuración del servidor autónomo o en la línea de comandos de inicio. La información sobre la ejecución de la acción especificada se envía al flujo de salida estándar (stdout). En caso de finalización exitosa, el código de retorno será igual a 0. De lo contrario, el código de salida será diferente de 0 y el mensaje de error se colocará en el flujo de error estándar (stderr).

La documentación contiene descripciones de la línea de comandos tanto del servidor como de la utilidad de administración. Tanto el servidor autónomo como el programa de utilidad de administración del servidor contienen un sistema de ayuda incorporado. Para obtener información de ayuda, se debe usar la siguiente variante de inicio de los programas de utilidad:

ibsrv help
ibcmd help

Si se necesita obtener una descripción del modo de operación seleccionado del programa de utilidad de administración del servidor (el ejemplo mostrará ayuda en el modo server), para esto se puede usar un comando como este:

ibcmd help server

Para guardar información de referencia para su uso posterior, se pueden usar las herramientas del sistema operativo para redirigir el flujo de salida estándar:

ibcmd help server > .\server.desc

Cuando se ejecuta un servidor autónomo (ibsrv), la conexión a la base de datos se realiza en modo compartido.

Consulte también:

• Línea de comandos del servidor autónomo.
• Línea de comandos de la utilidad de administración.

7.3.3.2. Ejecución de un servidor autónomo

Un servidor autónomo se puede ejecutar como una aplicación normal del sistema operativo, así como un servicio del sistema operativo (para el sistema operativo Windows) o en modo daemon (para el sistema operativo Linux).

Un servidor autónomo no proporciona herramientas integradas para registrarse como un servicio del sistema operativo. Tampoco se proporcionan controles (inicio y parada) por el servicio. Para estas operaciones, se deben utilizar las herramientas del sistema operativo (el programa de utilidad sc).

El archivo de configuración del servidor autónomo está destinado a especificar parámetros para una instancia del servidor autónomo. El archivo de configuración es utilizado tanto por el propio servidor como por el programa de utilidad de administración. Algunos parámetros del servidor se pueden configurar tanto a través de la línea de comandos (tanto del propio servidor como del programa de utilidad de administración) como a través del archivo de configuración, sin embargo, el archivo de configuración permite administrar todos los parámetros del servidor autónomo, excepto las rutas de la ubicación de los directorios de servicio del servidor autónomo. No existe una ubicación predeterminada para el archivo de configuración del servidor autónomo, por lo que cada vez que se ejecuta el servidor autónomo (o el programa de utilidad de administración), se debe especificar explícitamente la ubicación de este archivo. El archivo de configuración del servidor autónomo está generado en formato YAML.

Al ejecutar un servidor autónomo, se debe tener en cuenta lo siguiente:

• Al iniciar un servidor autónomo, los parámetros necesarios para su (del servidor) funcionamiento se definen de la siguiente manera:
  • Se obtienen los valores de todos los parámetros que se especifican en la línea de comandos de lanzamiento.
  • Se intenta obtener los valores de los parámetros restantes utilizando el archivo de configuración del servidor.
  • Si no fue posible obtener los valores de los parámetros restantes utilizando el archivo de configuración del servidor, se utilizarán los valores predeterminados.
  • Los valores de los parámetros especificados en la línea de comandos de inicio tienen prioridad sobre los valores del archivo de configuración.
• El archivo de configuración del servidor se crea mediante un comando especial (ibcmd server config init) o totalmente manual.
• Un directorio de datos puede ser manejado por una instancia del servidor autónomo o un programa de utilidad de administración del servidor. Especificar el directorio de datos (el parámetro --data) es obligatorio cuando se ejecutan varias copias de un servidor autónomo al mismo tiempo, así como cuando se realiza casi cualquier operación con un servidor autónomo.
• Solo una aplicación de la siguiente lista puede trabajar con una base de información en cada momento:
  • Servidor autónomo.
  • Programa de utilidad de administración del servidor (en modo fuera de línea).
  • Clúster de servidores de "1C:Enterprise".
  • Las aplicaciones de cliente que funcionan con el modo de archivo de la base de información cuando se conectan directamente (no a través de un servidor autónomo).

Al describir la línea de comandos de lanzamiento, se supone que el lanzamiento se realiza desde el directorio bin de la versión requerida del sistema "1C:Enterprise".

Se lanza un servidor autónomo para trabajar con el modo de archivo de una base de información cuyo directorio de datos se encuentra en la carpeta c:\db\standalone-server\demo. Todos los parámetros de funcionamiento del servidor independiente en este caso se establecerán en los valores predeterminados.

ibsrv --data="c:\db\standalone-server\demo"

En particular, el propio archivo de la base de información (1Cv8.1CD) se buscará en el directorio c:\db\standalone-server\demo\db-data.

Si se inicia un servidor autónomo sin ningún parámetro, el servidor autónomo intentará iniciar con el modo de archivo de la base de información, que se encuentra en el directorio de datos predeterminado.

Se lanza un servidor autónomo para trabajar con el modo cliente/servidor de una base de información que tiene los siguientes parámetros:

• Se utiliza el DBMS Microsoft SQL Server.
• Para acceder al DBMS se utilizará el usuario dbUser con la contraseña dbUserPassword.
• La base de datos se nombra en el DBMS dbName.
• Se supone que la base de datos existe y que, de hecho, es una base de datos de "1C:Enterprise".

ibsrv --dbms=mssqlserver --database-server=dbServerName --database-user=dbUser --database-password=dbUserPassword --database-name=dbName --data="D:\ss-data\dbName-data"

Si no se especifican ambos parámetros (--database-path y --dbms) al iniciar un servidor autónomo, entonces el servidor autónomo se iniciará con una base de información de archivos ubicada en el siguiente catálogo:

• Sistema operativo Windows: %LOCALAPPDATA%\1C\1cv8\standalone-server\db-data.
• Sistema operativo Linux: ~/.1cv8/standalone-server/db-data.

Para registrar un servidor autónomo como un servicio del sistema operativo Windows, se puede usar el siguiente archivo por lotes (o usarlo como base para la posterior modernización).

Archivo register-ss.bat:

@echo off
rem %1 - número de versión completo del sistema 1C:Enterprise
rem %2 - número de instancia del servicio registrado
rem %3 - ubicación del archivo de configuración del servidor
rem %4 - directorio de datos de la base de información
set SrvcUserName=<usuario del servidor autónomo>
set SrvcUserPwd=<contraseña de usuario del servidor autónomo>
set SrvcName="Standalone server %2"
set BinPath="\"C:\Program Files\1cv8\%1\bin\ibsrv.exe\" --service --config=\"%~3\"" --data=\"%~4\""
set Desctiption="Servidor autónomo 1C:Enterprise 8.3. Copia #%2. Directorio %4"
sc stop %SrvcName%
sc delete %SrvcName%
sc create %SrvcName% binPath= %BinPath% start= auto obj= %SrvcUserName% password= %SrvcUserPwd% displayname= %Desctiption%

Al ejecutar este archivo por lotes, se utilizan los siguientes parámetros:

1. El número de versión completo del sistema"1C:Enterprise" desde el que se utilizará el servidor autónomo.
2. El número de instancia del servicio a registrar. El ejemplo no verifica la existencia de un servicio con el número dado. Debido al hecho de que el servidor autónomo mantiene una base de información, con este parámetro puede registrar su servicio de sistema operativo para cada base de información servida.
3. La ruta completa al archivo de configuración para esta instancia del servidor autónomo (debe estar entre comillas dobles). Este archivo de configuración debe contener todos los parámetros con los que se inicia el servidor autónomo (incluidos los parámetros de la base de datos). Las diferentes instancias de servicio deben tener sus propios archivos de configuración.
4. Ruta completa al directorio de datos de la base de información. Este directorio contiene datos del servicio de la base de información (registro de eventos, índice de búsqueda de texto completo, directorio temporal, etc.).

Un ejemplo de ejecución de un archivo por lotes (requiere derechos de administrador):

register-ss.bat 8.3.20.100 2 "d:\1C DB\standalone-server\demo\demoma.yml" "d:\ss-data\demoma"

Después de ejecutar el archivo por lotes con estos parámetros, se realizarán las siguientes acciones:

• Nombre del servicio: Standalone server 2.
• Nombre que se muestra: Servidor autónomo 1C:Enterprise 8.3. Copia #2. Directorio d:\ss-data\demoma.
• Versión utilizada de "1C:Enterprise": 8.3.20.100.
• Línea de comando de inicio de servicio: "C:\Program Files\1cv8\8.3.20.100\bin\ibsrv.exe" --service --config="d:\1C DB\standalone-server\demo\demoma.yml" --data="d:\ss-data\demoma".
• Modo de inicio de servicio: Automático.

En este caso, se deben utilizar los siguientes comandos del sistema operativo para administrar el servicio:

• Inicio del servicio: sc start "Standalone server 2"
• Parada del servicio: sc stop "Standalone server 2"
• Eliminación del servicio: sc delete "Standalone server 2"

Para el momento de inicio del servicio, el archivo de configuración debe contener todos los parámetros necesarios para iniciar el servidor autónomo.

Para iniciar un servidor autónomo en modo daemon en el sistema operativo Linux, se debe ejecutar el siguiente comando:

ibsrv --daemon --config="ruta al archivo de configuración" --data="ruta al directorio de datos"

Para el momento de inicio del servidor autónomo en modo daemon, el archivo de configuración debe contener todos los parámetros necesarios para iniciar y ejecutar el servidor autónomo.

Consulte también:

• Archivo de configuración del servidor autónomo.

<< Prev   Next >>