CSA: Service and Admin Command-Line Utilities

To start, stop, or manage services outside cappm System Administration (CSA), use the command-line utilities. You can use the command-line utilities in scripts to automate various system administration tasks.
To start, stop, or manage services outside 
 System Administration (CSA), use the command-line utilities. You can use the command-line utilities in scripts to automate various system administration tasks.
Service Command
Use the service command to manage services from the command line. This command has the following format:
service start|stop|status|add|clone|remove|deploy|destroy {all|service name} [-info] [-verbose] [-help]
Starts all or specified services.
service start nsa service start nsa bg
Stops all or specified services. You can use this option with the start option to stop and then restart one or more services.
service stop beacon service stop start beacon service stop app bg nsa beacon
Displays the status of all or specified services.
service status all
Activates all or specified services on a local server.
Creates a copy of the app or bg service on the same server as the original. Ports, service names, and other properties of the service can be incremented to avoid a collision.
service clone app
Deactivates all or specified services on a local server.
service remove app bg nsa beacon
Disperses the settings to servers in the cluster.
Removes and destroys a previously cloned service. The original service cannot be destroyed.
{all | service name}
Indicates if the task is performed on all services or on one of the following services:
  • app
  • beacon
  • nsa
  • db
  • bg
  • reports (not available in 
    CA PPM
     14.4 and higher releases)
Displays informational messages.
Displays detailed messages.
Displays command Help for all or a specified option.
service -help service stop -help
: You can combine commands. For example, the following combination can be used to restart the app and bg services:
service stop start app bg
The following commands stop and remove all services on the current single or clustered server:
service stop remove all
Admin Command
Use the 
 command-line utilities to perform the following database, index, and system tasks:
  • Prepare the system before and after an upgrade.
  • Analyze, export, and import databases.
  • Read the XDM metadata and generate new files and resources.
  • Package CA PPM System Administration archive files.
  • Create and recreate the search index.
  • Migrate the documents from the file system to the database.
This command has the following format:
admin xdm|search|package|[-info] [-verbose] [-help]
Processes the 
 XDM. This command is available only on upgraded systems that use the XDM before upgrading. Here are the available XDM options:
  • install
    Applies configuration changes.
  • validate
    Validates the XDM configuration.
  • gen-glossary
    Generates the glossary file.
  • apply-glossary
    Applies glossary changes.
  • force
    Completes processing even if errors are encountered. If this option is not specified, an error stops the processing.
  • all
    Applies XDM definition changes.
Manages the index. The following options are available:
  • migrate
    Migrates the documents from the file system to the database.
  • recreate-index-files
    Recreates the files in the filestore.
  • recreate-index-data
    Recreates the index for all relational data in the cscoll collection.
  • index
    Immediately indexes files and all relational data in the queues.
package {app | bg}
Packages the CA PPM Application (app) or CA PPM Background (bg) service in an archive file. The resulting package is named 
Manages database objects on the application server. Here are the available options:
  • compile
    Compiles all valid database objects (Oracle only).
  • analyze
    Analyzes the database scheme (Oracle only).
  • upgrade
    Upgrades the database schema from version 13.0 or higher to the current release.
  • compare -Dreport.file= report file path
    Compares the database against the specified XML schema (Oracle only). The default file is installdir/logs/compare-report.txt.
  • compare-any params
    Compares the database against another XML schema. For detailed information about the required parameters, display the command-line Help (admin db compare-any -help).
  • post-install
    Performs the database post-install procedures.
When prompted, provide the target directory for the backup file.
Manages configuration files and the file ownership. Here are the available options:
  • view-config
    Displays the configuration file version that is in the database.
  • upload-all-config
    Uploads all the needed configuration files to the database. The files include properties.xml, tenants.xml, hosts.xml, logger.xml, and components.xml.
  • upload-config
    Uploads the properties.xml file to the database.
  • upload-config -Dfile=<config filename>
    Uploads the configuration file to the database. For example, logger.xml.
  • download-config
    Downloads the properties.xml file from the database.
  • download-config -Dfile=<config filename>
    Downloads the configuration file from the database. For example, hosts.xml.
  • apply-ownership
    Applies the correct user and group owner to all files in the specified directory (Unix only).