Activación por líneas de comandos © AUVESY GmbH & Co KG Fichtenstraße 38 B D-76829 Landau Deutschland Índice de contenidos Activación por líneas de comandos 3 Check-in 4 Check-out 9 Instalación semiautomática 12 Activar / desactivar el modo de mantenimiento 17 Sincronización con Active Directory 19 2 Activación por líneas de comandos Las siguientes funciones de versiondog pueden ser ejecutadas a través de líneas de comandos. Funciones descriptas en este tutorial: l Check-in l Check-out l Instalación semiautomática l Activar/desactivar el modo de mantenimiento l Sincronización con Active Directory Funciones descriptas en otros tutoriales: l Exportación de datos (vea el tutorial Módulo de exportación de versiondog* en versiondog INFO) l Comunicación con Legato (vea el tutorial Interfaz Legato en versiondog para S7* en versiondog INFO) *Extensión con costo adicional (Extensiones) Última actualización: 15 de noviembre de 2016 3 Check-in El AutoCheckIn de versiondog posibilita hacer el Check-In de los componentes a través de las líneas de comando y a la vez, crear una nueva versión. Para ello se debe ingresar la siguiente orden: C:\Programme\vdogClient\VDogAutoCheckIn.exe /at:c "/rd:{ClientArchive}" [/account:{Usuario} [/domain:{Dominio}] [/password:{Contraseña}] /CFile:d:{Archivo de configuración} Los parámetros necesarios y los valores para la activación a través de las líneas de comando pueden extraerse de la siguiente tabla. Parámetro /rd:{ClientArchive} Descripción Ruta distinguida del Clientarchiv. Nombre del usuario a realizar el Check-In /account:{Usuario} Solo se requiere, si el nombre de usuario no es asignado en el archivo de configuración. Dominio del usuario. /domain:{Dominio} Solo se requiere, si el nombre de usuario no es asignado en la línea de comando. Contraseña del usuario. /password:{Contraseña} Solo se requiere, si el nombre de usuario no es asignado en la línea de comando. /CFile:{Archivo de configuración} Ruta absoluta del archivo de configuración Archivo de configuración Para hacer el CheckIn o el versionado de un componente a través de las líneas de comandos, se necesita un archivo ini para la configuración. Las secciones, las claves y los valores necesarios del archivo de configuración pueden extraerse de la siguiente tabla. 4 Si un valor contiene espacios vacíos al comienzo o al final, debe estar escrito entre comillas en el archivo de configuración. Si a una clave se le asignó un valor estándar, esta clave no debe ser ingresada en el archivo de configuración. Sección ini Clave ini Descripción Nombre del usuario a realizar el Check-In Cuenta El valor estándar es una cadena de caracteres vacía. Solo es requerida si el nombre de usuario no es asignado en la línea de comando. Dominio del usuario. Domain El valor estándar es una cadena de caracteres vacía. Solo se requiere si el nombre de usuario es asignado en el archivo de configuración. Contraseña del usuario. [Usuario] Contraseña El valor estándar es una cadena de caracteres vacía. Solo se requiere si el nombre de usuario también es asignado en el archivo de configuración. Indica cómo la contraseña debe ser tratada. Valores posibles: 0: La contraseña es considerada como no codificada y es ingresada directamente. PasswordMode 2: La clave es ignorada y la contraseña debe ser ingresada a través de la línea de comando. Solo se requiere, si el nombre de usuario es asignado en el archivo de configuración. Ruta relativa al componente. [Component] Dir Al comienzo hay una barra invertida, al final, no. [Version] Enabled Especifica si se debe crear una versión antes de realizar el Check-In. Valores posibles: 5 Sección ini Clave ini Descripción Y: Se crea una nueva versión N: No se crea una nueva versión El valor estándar es "N". Dado el caso, número de versión de la versión creada. HversionUserDefined El valor estándar es una cadena de caracteres vacía. Comentario sobre la versión. Comment El valor estándar es una cadena de caracteres vacía. Razones de modificación de la versión. ChangeReason El valor estándar es una cadena de caracteres vacía. Especifica si se debe realizar una comparación. Valores posibles: Y: No se realiza una comparación. WhitoutComparison N: Se realiza una comparación. El valor estándar es "N". Si una comparación no se realiza (Y) y no hay ninguna diferencia con la versión anterior, una nueva versión será creada. Especifica si "VDogAutoCheckIn.exe" puede abrir las ventanas de avisos durante la comparación. Valores posibles: SilentMode Y: Las ventanas de avisos quedan abiertas N: Ninguna ventana de aviso queda abierta. El valor estándar es "N". Especifica si la versión del componente debe ser liberado luego de realizar el Check-In. Valores posibles: [CheckIn] ReleaseAfterCheckIn Y: La versión es liberada. N: La versión no es liberada. 6 Sección ini Clave ini Descripción El valor estándar es "Y". Especifica si "VDogAutoCheckIn.exe" puede abrir las ventanas de avisos durante el Check-In. Valores posibles: SilentMode Y: Las ventanas de avisos pueden aparecer. N: No aparece ninguna ventana de aviso. El valor estándar es "N". ErrorText{0..n} Aviso(s) de error(es) en caso de fallo Código(s) de error en caso de fallo. Formato: {Tipo de visualización}{Espacio vacío}{Código de error escrito en notación hexadecimal} Tipo de visualización 0: Código de error mostrado como [Result] ErrorCode{0..n} número con signo. Tipo de visualización 1: Código de error mostrado como número decimal sin signo. Tipo de visualización 2: Código de error mostrado como número hexadecimal. HVersion Número de versión de la versión creada correspondiente Ejemplos Ingreso del usuario y de la contraseña en la línea de activación: Activación a través de líneas de comandos: C:\Programme\vdogClient\VDogAutoCheckIn.exe /at:c "/rd:D:\vdClientArchive" /account:versiondog /domain:Testdomain /password:change-it /CFile:d:\AutoCheckIn.ini Archivo de configuración: [Component] Dir=\Werk 1\Halle 1\Bereich 1\110 S7 7 Ingreso del usuario y de la contraseña en el archivo de configuración: Activación a través de líneas de comandos: C:\Programme\vdogClient\VDogAutoCheckIn.exe /at:c "/rd:D:\vdClientArchive" /CFile:d:\AutoCheckIn.ini Archivo de configuración: [User] Cuenta=versiondog Dominio=Testdomain Contraseña=change-it [Componente] Dir=\Werk 1\Halle 1\Bereich 1\110 S7 Ingreso de la contraseña en la línea de activación y del usuario en el archivo de configuración: Activación a través de líneas de comandos: C:\Programme\vdogClient\VDogAutoCheckIn.exe /at:c "/rd:D:\vdClientArchive" /password:changeit /CFile:d:\AutoCheckIn.ini Archivo de configuración: [User] Account=versiondog Domain=Testdomain PasswordMode=2 [Componente] Dir=\Werk 1\Halle 1\Bereich 1\110 S7 8 Check-out El AutoCheckOut de versiondog posibilita el check-out de componentes a través de las líneas de comandos. Para ello se debe ingresar la siguiente orden: "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/dirR:{Ruta del componente relativa}" /Account:{Usuario} /Password:{Contraseña} [/domain:{Dominio}] [/WithBackups: {Y/N}] [/NumberOfArchives:{Cantidad}] A partir de la versión 4.5 de versiondog, el componente a descargar puede ser indicado alternativamente con su ID de componente, además de con su ruta relativa. Para ello se debe ingresar la siguiente orden: "C:\Programme\vdogClient\VDogAutoCheckOut.exe" /rd:{ClientArchive} "/CID:{Id de componentes}" /Account:{Usuario} /Password:{Contraseña} [/domain:{Dominio}] [/WithBackups:{S/N}] [/NumberOfArchives:{Cantidad}] Con AutoCheckOut se puede por ej. realizar el check-out de la versión actual de un componente de manera automática antes de cada inicio de sesión. Los parámetros necesarios y los valores para la activación por líneas de comandos pueden extraerse de la siguiente tabla. Durante el check-out realizado a través de las líneas de comandos, cuando los cambios locales sean sobrescritos ¡no se generan advertencias! Parámetro /rd:{ClientArchive} Descripción Ruta absoluta del Clientarchiv. Ruta relativa del componente / directorio que debe descargarse. Si no se asigna un valor, se realizará el check-out de todos los com- /dirR:{Ruta relativa del componente} ponentes disponibles. El usuario debe tener al menos el derecho de lectura para la ruta. Puede ser indicado alternativamente a "/CID:", uno de los dos parámetros debe ser indicado. Si los dos son entregados, "/dirR:" será ignorado. /CID:{ID del com- ID de componente del componente a descargar. 9 Parámetro Descripción El usuario debe tener como mínimo derechos de lectura para los com- ponente} ponentes. Puede ser indicado alternativamente a "/dirR:", uno de los dos parámetros debe ser indicado. Si los dos son entregados, "/dirR:" será ignorado. /account:{Usuario} Nombre del usuario a realizar el check-out. /domain:{Dominio} Dominio del usuario (opcional). /password:{Contraseña} Contraseña del usuario. Especifica si se debe realizar el check-out de las copias de seguridad (opcional). Valores posibles: /WithBackups:{Y/N} Y: También se realiza el check-out de las copias de seguridad. N: No se realiza el check-out de las copias de seguridad. El valor estándar es "N". /NumberOfArchives: {Cantidad} /Version:{Número de la versión} Especifica a cuántos archivos se debe realizar el check-out (opcional). El valor estándar es "0" (todos los archivos). Identifica la versión a la que se debe realizar el check-out (opcional). El valor estándar es el número de la versión actual. Ejemplos Activación por líneas de comandos "C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Plant 1\Area 1\SimaticS7" /Account:versiondog /Password:change-it /WithBackups:N /NumberOfArchives:0 check-out automático de un componente durante el registro: Archivo Bat con el siguiente contenido: Proceso REM de check-out 10 "C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive "/dirR:\Hall 1\Plant 1\Area 1\SimaticS7" /Account:versiondog /Password:change-it /WithBackups:N /NumberOfArchives:0 Inicio REM del UserClient "C:\Program Files\vdogClient\VDogClient.exe" /rd:d:\vdClientArchive /Account:versiondog /Password:change-it Check-out automático de todos los componentes durante el registro: Archivo bat con el siguiente contenido: Proceso REM de check-out "C:\Program Files\vdogClient\VDogAutoCheckOut.exe" /rd:d:\vdClientArchive /dirR: /Account:versiondog /Password:change-it /WithBackups:Y /NumberOfArchives:1 Inicio REM del UserClient C:\Program Files\vdogClient\VDogClient.exe /rd:d:\vdClientArchive /Account:versiondog /Password:change-it Valores de retorno Argumento Descripción 0 No ocurrió ningún error. Se realizó el check-out de al menos un componente. 1 No se pudo realizar ningún check-out o al menos un check-out generó un error. 2 1000 No se encontró ningún componente al que se le pueda realizar el check-out (por ej. debido a falta de derechos). Error al iniciar sesión 11 Instalación semiautomática La instalación de las aplicaciones de versiondog puede realizarse de manera semiautomática con el archivo "Setup.ini" haciendo algunos ajustes en el archivo. De esta manera, la instalación puede ejecutarse de manera rápida y sencilla en varias PC con las mismas configuraciones. Para ello, el archivo "Setup.ini" debe ser copiado en el directorio junto con el archivo "Setup.exe". Las claves y los valores disponibles pueden ser extraídos de la siguiente tabla. Si para la clave se usa el valor estándar, esta clave no debe ser ingresada. Clave Valor Tipo de instalación. Valores posibles: Mode l client_install l client_silentinstall l client_update l server_install La instalación normal se ejecuta de manera predefinida. En "client_silentinstall" y en "client_update" no se mostrará ningún asistente de instalación. Directorio de destino para el directorio de programa del cliente. Dst El valor estándar es "C:\Program Files\vdogClient" Directorio de destino para el directorio de programa del servidor. DstServer El valor estándar es "C:\Program Files\vdogServer" Ruta al archivo del cliente o al archivo del servidor local. RootDirAdmin El valor predefinido es "D:\vdClientArchive", o bien "D:\vdServerArchive" Ruta a los proyectos (vdServerArchive en la red compartida) RootDirProjct No hay ninguna ruta predefinida. Idioma Idioma para la instalación. Valores posibles: 12 Clave Valor l DE (alemán) l EN (inglés) Valores posibles: l Y l N AcceptLicense El valor estándar es "N" (La licencia no es aceptada) Directorio de destino para los archivos de instalación del cliente ClientSetupFiles El valor estándar es "D:\vdServerArchive\vdog client setup" Ruta al archivo de licencia LicenseBin No hay ninguna ruta predefinida. Valores posibles: l Y l N AllUserRight El valor estándar es "Y" (Derechos otorgados para todos los usuarios) Valores posibles: l Y l N DesktopShortcuts El valor estándar es "Y" (Crear enlaces en el escritorio) Valores posibles: l Y l N CommonPrograms El valor estándar es "Y" (Crear entrada en el menú "Programa") QuickLaunch Valores posibles: 13 Clave Valor l Y l N El valor estándar es "N" (Crear iconos de acceso rápido) Valores posibles: l Y l N NetShare El valor estándar es "N" (No crear una red compartida) Cuenta de usuario que será iniciada desde el "VDog MasterService“ User El valor estándar es "Cuenta de sistema" Valores posibles: l Y l N Ejemplos El valor estándar es "N" (No crear archivos de ejemplo) Valores posibles: l Y l N Remote El valor estándar es "N" (El Serverarchiv es creado en la PC local) Opción para la gestión de bibliotecas estándar. Valores posibles: l 0 (ocultar las casillas de verificación) l 7 (casillas de verificación ocultas; opción no preseleccionada) cbStateStdLib El valor estándar es "0" cbStateBackupClient Opción para el BackupClient. Valores posibles: 14 Clave Valor l 0 (casillas de verificación desactivadas) l 3 (casillas de verificación activadas; opción no preseleccionada) l 7 (casillas de verificación; opción preseleccionada) El valor estándar es "0" Ruta al BackupArchiv PathBackupArchive El valor estándar es "D:\vdBackupArchive" Ejemplos Instalación del cliente con asistente de instalación y sin preajuste para el BackupClient y la gestión de bibliotecas estándar. Las aplicaciones del cliente se instalan en "C:\Program Files (x86)\vdClient" y el Clientarchiv en "D:\vdCA". La licencia se extrae de "\\VDSERVER\vdog client setup\licence.bin" y es aceptada automáticamente. Los enlaces de escritorio son creados, salvo en la barra de inicio rápido. [Common] Mode=client_install Language=DE AcceptLicense=Y LicenseBin=\\VDSERVER\vdog client setup\licence.bin cbStateStdLib=0 cbStateBackupClient=0 Dst=C:\Program Files (x86)\vdClient RootDirAdmin=D:\vdCA AllUserRight=Y CommonPrograms=N DesktopShortcuts=Y 15 QuickLaunch=N Instalación del servidor con el asistente de instalación [Common] Mode=server_install Language=DE AcceptLicense=Y LicenseBin=D:\versiondog\Setup\Lizenz\licence.bin DstServer=C:\Programme\vdog_Server Remote=Y RootDirProject=\\Testserver\versiondog\Daten RootDirAdmin=D:\ClientArchive, D:\ServerArchive ClientSetupFiles=D:\ServerArchive\vdog client setup NetShare=Y User=Testuser Examples=Y 16 Activar / desactivar el modo de mantenimiento A través de las líneas de comando es posible desactivar, activar o finalizar el modo de mantenimiento del servidor de versiondog. Ingrese la siguiente orden para poner el servidor en modo de mantenimiento: <Unidad de disco:>\<Directorio de programa del servidor de versiondog>\VdogMasterService.exe /at:s /rd:<Unidad de disco:>\vdServerArchive /maintenance:on Ingrese la siguiente orden para finalizar el modo de mantenimiento: <Unidad de disco:>\<Directorio de programa del servidor versiondog>\VdogMasterService.exe /at:s /rd:<Unidad de disco:>\vdServerArchive /maintenance:off Las rutas que contengan espacios vacíos se deben escribir entre comillas. En Windows 7 y en Windows Server 2008 R2 la línea de comando se debe ejecutar con "Ejecutar como administrador". Si el modo de mantenimiento debe ser activado o desactivado con ayuda de un archivo batch (o bat), el estado del servidor se puede recuperar de la siguiente manera: if ERRORLEVEL 0 ECHO "Aviso de error" >> Protokolldatei.txt La acción fue exitosa if ERRORLEVEL 1 ECHO "Aviso de error" >> Protokolldatei.txt La acción ha fallado Ejemplos Activar el servidor en el modo de mantenimiento: "C:\Program Files\vdogServer\VDogMasterService.exe" /at:s /rd:C:\vdServerArchive /maintenance:on Desactivar el modo de mantenimiento: "C:\Program Files\vdogServer\VDogMasterService.exe" /at:s /rd:C:\vdServerArchive /maintenance:off Activar el modo de mantenimiento del servidor con un archivo bat: 17 Archivo bat con el siguiente contenido: @echo off Modo de mantenimiento REM en modo on "C:\Program Files\vdogServer\VDogMasterService.exe" /at:s /rd:C:\vdServerArchive /maintenance:on if ERRORLEVEL 1 ECHO "El modo de mantenimiento del servidor de versiondog no fue activado correctamente." >> d:\log.txt if ERRORLEVEL 0 ECHO "El modo de mantenimiento del servidor de versiondog fue activado correctamente." >> d:\log.txt Desactivar el modo de mantenimiento con un archivo bat: Archivo bat con el siguiente contenido: @echo off REM Maintenance Mode off "C:\Program Files\vdogServer\VDogMasterService.exe" /at:s /rd:C:\vdServerArchive /maintenance:off if ERRORLEVEL 1 ECHO "El servidor de versiondog no pudo ser recuperado correctamente del modo de mantenimiento." >> d:\log.txt if ERRORLEVEL 0 ECHO "El servidor de versiondog fue recuperado correctamente del modo de mantenimiento." >> d:\log.txt 18 Sincronización con Active Directory Las cuentas de usuarios pueden ser importadas de Active Directory en el sistema versiondog mediante las líneas de comandos. Para esto debe "ejecutar como administrador" las líneas de comandos en el directorio de programa de la instalación del servidor. Ingrese el siguiente comando: VDogLdapSynchronisation /rd:{ServerArchive} /at:s Parámetro Descripción /rd:{ServerArchive} Ruta absoluta del Clientarchiv /at:s Tipo de aplicación (<s>erver) Si fue exitosa, se devolverá el valor "0". Si falla, se devolverá el valor "1" y el error será registrado tanto en versiondog como en Windows, en el visor de eventos. Vea también: Conexión con Active Directory 19