Actualizar mandato

Puede utilizar la interfaz de línea de mandatos (CLI) de update para actualizar el esquema de la base de datos de Registry Services de la versión anterior a la nueva.

Sintaxis del mandato

La sintaxis de CLI update varía según el entorno en el que se ejecuta:

Parámetros

Tabla 1 lista los parámetros utilizados con la CLI update y proporciona su descripción.

Tabla 1. Parámetros utilizados en la CLI update
Parámetro Valor Descripción
-type contenedor Este valor define que el mandato update debe actualizar la aplicación de Registry Services en IBM® WebSphere Application Server.

Debe exportar FRS_CLASSPATH para indicar el archivo JAR de WebSphere Application Server para su API de administración, tal como se muestra en este ejemplo de WebSphere Application Server V8:

  • WAS_HOME/runtimes/com.ibm.ws.admin.client_8.0.0.jar
  • WAS_HOME/plugins/com.ibm.ws.security.crypto.jar
bd Este valor define que el mandato actualizar debe actualizar la base de datos Servicios de registro que se ha desplegado en un RDBMS para el release actual versión.
[-properties] archivo_propiedades Este valor define que el archivo .properties debe actuar como el origen de las propiedades de actualización. Este parámetro es opcional. Si no especifica este parámetro, se utilizará el archivo predeterminado REGISTRY_HOME\etc\CLI.properties como el origen de las propiedades de actualización.
Al actualizar la aplicación Registry Services con la modalidad FIPS habilitada, pase estos parámetros SSL para especificar el certificado que se utilizará para crear una conexión SOAP en WebSphere Application Server:
Tabla 2. Parámetros SSL utilizados en la CLI update (modalidad FIPS habilitada)
Parámetro Valor Descripción
-keyStore nombre_archivo Este valor define el nombre del archivo de almacén de claves que contiene un certificado para un usuario que se correlaciona en un rol de Registry Services. Puede haber varios certificados. Este parámetro es necesario para fines de autenticación del certificado.

Si no especifica este parámetro, Registry Services lo lee desde la propiedad javax.net.ssl.keyStore en el archivo CLI.properties.

-keyStorePassword contraseña Este valor define la contraseña para el certificado que se especifica en el parámetro -keyStore. Este parámetro es necesario para fines de autenticación del certificado.

Si no especifica este parámetro, Registry Services lo lee de la propiedad javax.net.ssl.keyStorePassword en el archivo CLI.properties.

-trustStore nombre_archivo Este valor define el nombre del archivo de almacén de confianza que contiene el certificado del servidor al que se conecta Registry Services para procesar esta CLI. Puede haber varios certificados a varios servidores. Este parámetro es necesario para fines de autenticación del certificado.

Si no especifica este parámetro, Registry Services lo lee de la propiedad javax.net.ssl.trustStore en el archivo CLI.properties.

-trustStorePassword contraseña Este valor define la contraseña para el certificado que se especifica en el parámetro -trustStore. Este parámetro es necesario para fines de autenticación del certificado.

Si no especifica este parámetro, Registry Services lo lee de la propiedad javax.net.ssl.trustStorePassword en el archivo CLI.properties.

[-keyStoreType] nombre_tipo Este valor define el tipo del almacén de claves. El valor predeterminado para este parámetro opcional es el keystore.type especificado en el archivo java.security del JDK en uso.

Si no especifica este parámetro, Registry Services lo lee de la propiedad javax.net.ssl.keyStoreType en el archivo CLI.properties.

[-trustStoreType] nombre_tipo Este valor define el tipo del almacén de confianza. El valor predeterminado para este parámetro opcional es el truststore.type especificado en el archivo java.security del JDK en uso.

Si no especifica este parámetro, Registry Services lo lee de la propiedad javax.net.ssl.trustStoreType en el archivo CLI.properties.

Ejemplo

frs.bat update -type container -properties C:/etc/container.properties
./frs.sh update -type db

Códigos de retorno

El mandato update imprime un código de retorno cuando termina de ejecutarse de forma que pueda tener detalles sobre el resultado conseguido. Tabla 3 proporciona los códigos de retorno que puede obtener al final de la ejecución de update y de sus descripciones respectivas.

Tabla 3. Códigos de retorno de la ejecución del mandato update
Código de retorno Descripción
0 El mandato update ha ejecutado la operación satisfactoriamente.
1 El mandato update no se ha podido ejecutar debido a que falta un parámetro -type.
2 El mandato update no se ha podido ejecutar debido a que no se ha encontrado un archivo de propiedades.
3 El mandato update no se ha podido ejecutar debido a un parámetro -type no válido especificado en la línea de mandatos.
4 El mandato update no se ha podido ejecutar debido a un error de actualización.

99

El mandato update no se ha podido ejecutar porque la modalidad de operación sólo lectura está activa.

Este mandato se utiliza sólo para el mantenimiento de la instalación. No lo utilice a menos que se dirija estrictamente mediante el equipo de soporte.