4.2.2. Para el sistema operativo Windows

4.2.2.1. Lanzamiento como una aplicación

El agente de servidor se puede ejecutar como una aplicación. Para ello, se debe ejecutar el siguiente comando:

ragent /port <puerto> /regport <puerto> /range <rangos>
/seclev <nivel> /d <directorio>
/pingPeriod <tiempo> /pingTimeout <tiempo>
/debug -<modo> /debugServerAddr <dirección> /debugServerPort <puerto> /debugServerPwd <contraseña>

¡ATENCIÓN! El nombre y el valor del parámetro deben estar separados por un "espacio en blanco".

En el comando de lanzamiento pueden utilizarse los siguientes comandos:

/port <puerto>

Número de puerto de red del agente de servidor (ragent). Este puerto se utiliza por la consola del clúster para acceder al servidor central. El puerto del agente de clúster también se especifica como el puerto de red del servidor de trabajo. Valor predeterminado: 1540.

/regport <puerto>

Número de puerto de red del gerente general de clúster (rmngr) creado de forma predeterminada cuando se ejecuta ragent por primera vez. Valor predeterminado: 1541.

/range <rangos>

Rangos de puertos de red para la selección dinámica. Se utilizan como el valor inicial del atributo Rangos de puertos IP del servidor de trabajo del clúster creado de forma predeterminada cuando se inicia por primera vez el agente de servidor (ragent). Valor predeterminado: 1560:1591. Ejemplos de valores de rangos: 4549:4567, 7072:7790.

/seclev <nivel>

Nivel de seguridad del proceso del agente de clúster. Especifica el nivel de seguridad de las conexiones establecidas con el proceso ragent. El nivel puede tomar valores:

0 (predeterminado) – conexiones inseguras;
1 – conexiones seguras solo durante la ejecución de la autenticación de los usuarios;
2 – conexiones con seguridad permanente.

Para obtener más información sobre el nivel de seguridad de la conexión, consulte la pág. Seguridad de los datos transferidos entre el cliente y el clúster de servidores.

/d <directorio>

El directorio donde se ubicarán (o se ubican) los archivos de servicio del clúster de servidores (incluida la lista de clústeres y la lista de bases de información del clúster). Si no se especifica el parámetro, se utiliza el directorio predeterminado: %USERPROFILE%\Local Settings\Application Data\1C\1Cv8 (%LOCALAPPDATA%\1C\1Cv8 para sistemas operativos Windows Vista y superiores). Si la ruta al directorio contiene espacios, la ruta debe estar entre comillas, por ejemplo:

/d "c:\Server data\cluster 2"

NOTA. El nombre del directorio no debe terminar con el símbolo "\" si está entre comillas. Correcto: "c:\my path", incorrecto: "c:\my path\".

/pingPeriod <tiempo>

Periodo de comprobación del sistema de seguimiento de la rotura de conexiones, milisegundos (ver pág. 2.2.5.6. Sistema de seguimiento de ruptura de conexiones).

Valor predeterminado: 1 000.

/pingTimeout <tiempo>

El tiempo de espera de la verificación del sistema de seguimiento de la ruptura de conexiones, milisegundos (consulte la pág. 2.2.5.6. Sistema de seguimiento de ruptura de conexiones).

Valor predeterminado: 5 000.

Los valores especificados para los comandos /pingPeriod y /pingTimeout se utilizan para todas las conexiones salientes de los procesos de clúster en este servidor que se iniciaron a través de este proceso del agente de servidor.

Si el clúster contiene varios servidores de trabajo y es recomendable cambiar el período y los valores de tiempo de espera predeterminados, se recomienda:

instalar el tiempo de espera de verificación 3-10 veces superior al tiempo de verificación;
no establecer el valor del período de verificación en menos de 1 000 milisegundos;
en todos los servidores incluidos en un clúster, especificar los mismos valores para el período y el tiempo de espera de verificación.

/debug -<modo>

Lanzamiento del clúster de servidores en el modo de depuración de las configuraciones. El parámetro <modo> especifica qué protocolo utilizará el depurador en este clúster de servidores:

-tcp – protocolo TCP/IP;
-http – protocolo HTTP.

Valor predeterminado: -tcp.

CONSEJO. Debido a que el rendimiento del servidor desciende en modo de depuración, se recomienda utilizar el modo de depuración solamente para los servidores en los que se realiza la depuración.

/debugServerAddr <dirección>

Especifica la dirección del ordenador en el que se ejecuta el servidor de depuración. Se recomienda utilizar esta clave en los casos cuando en el ordenador están instaladas varias tarjetas de red.

Si la clave no está especificada, se utilizará una dirección de red arbitraria perteneciente al ordenador en el cual se está ejecutando el servidor de depuración.

/debugServerPort <puerto>

Especifica qué puerto debe utilizarse por el servidor de depuración. El puerto predeterminado es 1550.

/debugServerPwd <contraseña>

Se especifica la contraseña que la aplicación de cliente deberá utilizar al establecer una conexión con el servidor de depuración de este clúster de servidores.

De forma predeterminada, no está establecida ninguna contraseña.

Para detener la ejecución del agente de servidor lanzado como una aplicación, se necesita presionar las teclas Ctrl + C.

4.2.2.2. Lanzamiento como un servicio

Si durante la instalación del clúster de servidores se seleccionó la opción de iniciar el agente del servidor central como un servicio, este servicio se iniciará automáticamente durante el proceso de instalación y también se ejecutará al inicio del sistema operativo.

Si el agente del servidor central se instaló como una aplicación, entonces existe la posibilidad de registrar el servicio manualmente y luego ejecutarlo.

El nombre del servicio es diferente en las versiones de 32- y 64 bits de "1C:Enterprise":

Versión de "1C:Enterprise"	Nombre del servicio
Versión de 32 bits	1C:Enterprise 8.3 Server Agent
Versión de 64 bits	1C:Enterprise 8.3 Server Agent (x86-64)

El registro del servicio se realiza mediante el siguiente comando:

ragent /instsrvc|/rmsrvc /usr <nombre> /pwd <contraseña>
/start|/stop
/port <puerto> /regport <puerto> /range <rangos>
/seclev <nivel> /d <directorio>
/pingPeriod <tiempo> /pingTimeout <tiempo>
/debug -<modo> /debugServerAddr <dirección> /debugServerPort <puerto> /debugServerPwd <contraseña>

¡ATENCIÓN! El nombre y el valor del parámetro deben estar separados por un espacio en blanco.

NOTA. Las operaciones de registro, cancelación de registro, inicio y detención del servicio del agente de clúster (ragent) deben ejecutarse en nombre del administrador. Durante el proceso de trabajo, se verifica la presencia de los privilegios necesarios para el trabajo y, en caso de ausencia, se realiza una solicitud de elevación de privilegios.

/instsrvc

Registro del agente de clúster como un servicio de Windows. Si ragent se ejecuta con esta clave, se registra en la lista de servicios de Windows y finaliza.

La clave /instsrvc no es compatible con la clave /rmsrvc.

/rmsrvc

Anulación del registro del agente de clúster como un servicio de Windows. Si ragent se ejecuta con esta clave, se cancela el registro en la lista de servicios de Windows y finaliza.

La clave /rmsrvc es incompatible con la clave /instsrvc.

/start

Ejecutar ragent registrado como un servicio de Windows. Se ejecuta ragent, previamente registrado como un servicio de Windows, y luego finaliza.

/stop

Detener ragent registrado y ejecutado como un servicio de Windows. Se detiene ragent, previamente registrado y ejecutado como un servicio de Windows, y luego finaliza.

/usr <nombre>, /pwd <contraseña>

Nombre y contraseña del usuario de Windows en cuyo nombre ragent debe ejecutarse como un servicio de Windows. Solo se puede usar junto con la clave /instsrvc al registrar ragent como un servicio de Windows.

/port <puerto>

/regport <puerto>

Número de puerto de red del gerente general de clúster (rmngr) creado de forma predeterminada cuando se ejecuta ragent por primera vez. Valor predeterminado: 1541.

/range <rangos>

/seclev <nivel>

Nivel de seguridad del proceso del agente de clúster. Especifica el nivel de seguridad de las conexiones establecidas con el proceso ragent. El nivel puede tomar valores:

0 (predeterminado) – conexiones inseguras;
1 – conexiones seguras solo durante la ejecución de la autenticación de los usuarios;
2 – conexiones con seguridad permanente.

Para obtener más información sobre el nivel de seguridad de la conexión, consulte la pág. Seguridad de los datos transferidos entre el cliente y el clúster de servidores.

/d <directorio>

NOTA. El nombre del directorio no debe terminar con el símbolo "\" si está entre comillas. Correcto: "c:\my path", incorrecto: "c:\my path\".

/pingPeriod <tiempo>

Periodo de comprobación del sistema de seguimiento de la rotura de conexiones, milisegundos (ver pág. Sistema de seguimiento de ruptura de conexiones).

Valor predeterminado: 1 000.

/pingTimeout <tiempo>

El tiempo de espera de la verificación del sistema de seguimiento de la ruptura de conexiones, milisegundos (consulte la pág. Sistema de seguimiento de ruptura de conexiones).

Valor predeterminado: 5 000.

Si el clúster contiene varios servidores de trabajo y es recomendable cambiar el período y los valores de tiempo de espera predeterminados, se recomienda:

instalar el tiempo de espera de verificación 3-10 veces superior al tiempo de verificación;
no establecer el valor del período de verificación en menos de 1 000 milisegundos;
en todos los servidores incluidos en un clúster, especificar los mismos valores para el período y el tiempo de espera de verificación.

/debug -<modo>

Lanzamiento del clúster de servidores en el modo de depuración de las configuraciones. El parámetro <modo> especifica qué protocolo utilizará el depurador en este clúster de servidores:

-tcp – protocolo TCP/IP;
-http – protocolo HTTP.

Valor predeterminado: -tcp.

/debugServerAddr <dirección>

Especifica la dirección del ordenador en el que se ejecuta el servidor de depuración. Se recomienda utilizar esta clave en los casos cuando en el ordenador están instaladas varias tarjetas de red.

Si la clave no está especificada, se utilizará una dirección de red arbitraria perteneciente al ordenador en el cual se está ejecutando el servidor de depuración.

/debugServerPort <puerto>

Especifica qué puerto debe utilizarse por el servidor de depuración. El puerto predeterminado es 1550.

/debugServerPwd <contraseña>

Se especifica la contraseña que la aplicación de cliente deberá utilizar al establecer una conexión con el servidor de depuración de este clúster de servidores.

De forma predeterminada, no está establecida ninguna contraseña.

De forma predeterminada, el servicio se inicia automáticamente cuando se enciende el ordenador. El servicio también se puede lanzar usando las herramientas de Windows: Mi ordenador – Gestión – Servicios y aplicaciones – Servicios – Agente de servidor de 1C:Enterprise 8 (My computer – Manage – Computer Management – Services and Applications – Services – 1C:Enterprise 8 Server Agent). La detención del servicio también se realiza a través de los medios de Windows.

Para cancelar el registro del servicio, se debe ejecutar el siguiente comando:

ragent /rmsrvc

Para simplificar el registro y la cancelación del registro del servicio del clúster de servidores, se pueden utilizar archivos de comando, el ejemplo de los cuales se encuentra en la pág. Herramientas auxiliares.

<< Prev Next >>