versiondog INFO - my versiondog

Anuncio
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
Descargar