CSA: Utilidades de la línea de comandos Service y Admin (solo local)

ccppmop159
Para iniciar, detener o gestionar servicios fuera de la Administración del sistema de
PPM (versión clásica)
(CSA), se deben utilizar utilidades de la línea de comandos. Se pueden utilizar las utilidades de línea de comandos en scripts para automatizar varias tareas de administración del sistema.
3
Comando service
Utilice el comando de servicio para gestionar servicios desde la línea de comandos. Este comando tiene el formato siguiente:
service start|stop|status|add|clone|remove|deploy|destroy {all|service name} [-info] [-verbose] [-help]
start
Inicia todos los servicios o solamente los especificados.
Ejemplos:
service start nsa service start nsa bg
stop
Detiene todos los servicios o solamente los especificados. Esta opción se puede utilizar al mismo tiempo que la opción de inicio para detener y, a continuación, reiniciar uno o más servicios.
Ejemplos:
service stop beacon service stop start beacon service stop app bg nsa beacon
status
Muestra el estado de todos los servicios o solamente de los especificados.
Ejemplo:
service status all
add
Activa todos los servicios o solamente los especificados en un servidor local.
clone
Crea una copia del servicio app o bg en el mismo servidor que el original. Se pueden incrementar los puertos, los nombres del servicio y otras propiedades del servicio para evitar una colisión.
Ejemplo:
service clone app
remove
Desactiva todos los servicios o solamente los especificados en un servidor local.
Ejemplo:
service remove app bg nsa beacon
deploy
Dispersa los valores de configuración a servidores del clúster.
destroy
Elimina y destruye un servicio previamente clonado. No se pueden destruir los servicios originales.
{all | service name}
Indica si la tarea se realiza en todos los servicios o en uno de los servicios siguientes:
  • app
  • beacon
  • nsa
  • db
  • bg
  • reports (no disponibles en la versión 14.4 y versiones posteriores de
    PPM (versión clásica)
    )
-info
Muestra mensajes informativos.
-verbose
Muestra mensajes detallados.
-help
Muestra ayuda para los comandos para todas las opciones o para una especificada.
Ejemplo:
service -help service stop -help
Los comandos se pueden combinar. Por ejemplo, la combinación siguiente se puede utilizar para reiniciar los servicios app y bg:
service stop start app bg
Los siguientes comandos detienen y eliminan todos los servicios en el actual servidor único o agrupado:
service stop remove all
Comando admin
Utilice las utilidades de la línea de comandos
admin
para realizar las siguientes tareas de base de datos, índice y sistema:
  • Preparar el sistema antes y después de la actualización
  • Analizar, exportar e importar bases de datos
  • Leer metadatos de XDM y generar nuevos archivos y recursos.
  • Empaquetar archivos de archivado de Administración del sistema de
    Clarity
    .
  • Crear y volver a crear el índice de búsqueda
  • Migrar documentos desde el sistema de archivos hasta la base de datos.
Este comando tiene el formato siguiente:
admin xdm|search|package|[-info] [-verbose] [-help]
opción
xdm
Procesa el XDM de
PPM (versión clásica)
. Este comando está disponible solamente en sistemas actualizados que estaban utilizando XDM antes de actualizar. Estas son las opciones de XDM disponibles:
  • install
    Aplica cambios de configuración.
  • validate
    Valida la configuración de XDM.
  • gen-glossary
    Genera el archivo de glosario.
  • apply-glossary
    Aplica cambios del glosario.
  • force
    Finaliza el procesamiento, aunque se encuentren errores. Si no se especifica esta opción, un error detiene el procesamiento.
  • all
    Aplica cambios en la definición de XDM.
opción
search
Gestiona el índice. Están disponibles las opciones siguientes:
  • migrate
    Migra los documentos desde el sistema de archivos hasta la base de datos.
  • recreate-index-files
    Vuelve a crear los archivos en el almacén de archivos.
  • recreate-index-data
    Vuelve a crear el índice para todos los datos relacionales en la recopilación de cscoll.
  • index
    Indexa inmediatamente los archivos y todos los datos relacionales de las colas.
paquete {app | bg}
Empaqueta el servicio Aplicación de
Clarity
(app) o el servicio Fondo de
Clarity
(bg) en un archivo de archivado. El paquete resultante se denomina
app.ear
o
bg.ear
.
opción
db
Gestiona los objetos de la base de datos en el servidor de aplicaciones. Estas son las opciones disponibles:
  • compile
    Compila todos los objetos de base de datos válidos (Oracle solamente).
  • analyze
    Analiza el esquema de la base de datos (Oracle solamente).
  • upgrade
    Actualiza el esquema de base de datos desde la versión 13.0 o posterior a la versión actual.
  • compare -Dreport.file= report file path
    Compara la base de datos con el esquema de XML especificado (Oracle solamente). El archivo predeterminado es installdir/logs/compare-report.txt.
  • compare-any params
    Compara la base de datos con otro esquema de XML. Para obtener información detallada acerca de los parámetros necesarios, muestre la ayuda de línea de comandos (admin db compare-any -help).
  • post-install
    Realiza los procedimientos posteriores a la instalación de la base de datos.
backup
Cuando se le solicite, proporcione el directorio de destino para el archivo de copia de seguridad.
general
opción
Gestiona archivos de configuración y la propiedad de archivo. Estas son las opciones disponibles:
  • view-config
    Muestra la versión del archivo de configuración que está en la base de datos.
  • upload-all-config
    Carga todos los archivos de configuración necesarios en la base de datos. Los archivos incluyen properties.xml, tenants.xml, hosts.xml, logger.xml y components.xml.
  • upload-config
    Carga el archivo properties.xml en la base de datos.
  • upload-config -Dfile=<config filename>
    Sube los archivos de configuración a la base de datos. Por ejemplo, logger.xml.
  • download-config
    Descarga el archivo properties.xml de la base de datos.
  • download-config -Dfile=<config filename>
    Descarga los archivos de configuración de la base de datos. Por ejemplo, hosts.xml.
  • apply-ownership
    Aplica el propietario del grupo y el usuario correctos a todos los archivos del directorio especificado (Unix solamente).
opción
system-options
Las siguientes opciones del comando, disponibles en 15.3.0.5, 15.4.1.1, 15.5 y versiones más recientes, permiten agregar o suprimir valores y opciones del sistema:
admin system-options -add <option code> <option value>
-add
Agrega una nueva entrada de la opción del sistema y un valor.
-multi
: Agrega varios valores de opción para una única entrada nueva de la opción del sistema.
-force
Suprime y vuelve a crear la entrada de la opción y el valor. El indicador -force no funciona con -multi.
-list
Enumera los valores de la opción.
-delete
Suprime una entrada de la opción del sistema y un valor utilizando la sintaxis siguiente:
-delete <option code> <option value>
Ejemplo 1
: El siguiente comando agrega un nuevo valor de la opción
ca.com
para el valor de configuración
CONTENT_SECURITY_DOMAINS
en la tabla
cmn_option_values
:
admin system-options -add CONTENT_SECURITY_DOMAINS ca.com -multi
Ejemplo 2
: El primer comando suprime todos los dominios actuales y todos los datos iniciales y, a continuación, las líneas restantes agregan todos los dominios especificados:
admin system-options -delete CONTENT_SECURITY_DOMAINS
admin system-options -add CONTENT_SECURITY_DOMAINS "'self'" -multi admin system-options -add CONTENT_SECURITY_DOMAINS cppmxxxx.ca.com -multi admin system-options -add CONTENT_SECURITY_DOMAINS ca.com -multi admin system-options -add CONTENT_SECURITY_DOMAINS docops.ca.com -multi admin system-options -add CONTENT_SECURITY_DOMAINS fonts.googleapis.com -multi
Ejemplo 3
: El siguiente comando agrega un nuevo valor de la opción para el valor de configuración
CONTENT_SECURITY_DOMAINS
en la tabla
cmn_option_values
:
admin system-options -add CONTENT_SECURITY_DOMAINS ca.com -multi
Ejemplo 4
: El siguiente comando enumera los valores de la opción para el valor de configuración
CONTENT_SECURITY_DOMAINS
en la tabla
cmn_option_values
:
admin system-options -list CONTENT_SECURITY_DOMAINS
Después de emitir los comandos, actualice o vacíe todas las memorias caché, especialmente systemOptions y securityDomains.
Activación de los comandos de la opción del sistema para CORS
La siguiente información solo se aplica a 15.3.0.5, 15.4.1.1, 15.5 o 15.5.1. Si tiene
Clarity
15.6 o posterior, CORS es compatible y esta sección ya no se aplica. Consulte REST API en la sección Reference de la versión en inglés de la documentación.
El comando admin system-options permite CORS para la API de REST (todavía no es compatible, pero sí que está disponible exclusivamente para las integraciones de partners de Broadcom Service). Otras aplicaciones pueden hacer llamadas directas de la API a
Clarity
. Por ejemplo, CA Agile Central puede leer datos del proyecto de
Clarity
.
Estas opciones no están activadas de forma predeterminada.
  • Si está planificando utilizar la nueva función del canal del esquema,
    Clarity
    tiene una capacidad integrada para poner en la lista de permitidos un dominio después de definirlo en el canal. La inclusión en la lista blanca permite a
    Clarity
    visualizar las aplicaciones externas en el marco de
    Clarity
    , siempre que la otra aplicación no tenga restricciones de CORS integradas dado que
    Clarity
    no puede sobrescribir una política de seguridad externa.
  • Si tiene contenido existente que señala a otros dominios, puede implementar uno o más canales como un sustituto. Si desea seguir utilizando portlets HTML y otros vínculos a aplicaciones de terceros, y no utiliza los canales de la Nueva experiencia de usuario, active CORS con el siguiente comando de actualización de la base de datos para las opciones del sistema:
DECLARE
option_exists
INTEGER
; FEATURE_EXISTS
INTEGER
;
BEGIN
cmn_feature_delete_sp('CORS_ENABLEMENT_F18624'); cmn_feature_ins_sp('CORS_ENABLEMENT_F18624', 'CORS Enablement', 'This is the toggle for the CORS Enablement feature for rest api', 1);
END
;