Command line interface for OSLCAgent

You can use the OSLCAgent command line interface (CLI) to manually export configuration item (CI) information to Registry Services.

For the OSLCAgent, you can pass a combination of commands and switches to the runtopobuild script or batch file. Each command and switch has a short, single-letter format, and a longer, more descriptive format. You can use any combination of command and switch formats.
The following commands are available:
  • -R | –refreshAll true|false

    This command registers all eligible CIs, even if they have been registered already.

  • -r | -refreshGuid guid

    This command registers the CI that has the specified GUID, even if it has been registered already.

  • -l | -refreshIgnored true|false

    If a CI is discovered in a position that is not deep enough, it might not have correctly formed naming rules. By default, the OSLCAgent ignores such CIs. This command forces the OSLCAgent to process these CIs again.

To specify particular actions, you can pass a switch with any command. There are two types of switches available.
You can use the following switches to enable or disable the processing of particular CRTV types:
  • -c | --enableComputerSystem true|false
  • -d | --enableDatabase true|false
  • -i | --enableServiceInstance true|false
  • -m | --enableSoftwareModule true|false
  • -s | --enableSoftwareServer true|false

For example, if you don’t want to re-register computer systems, use the -c false switches.

You can use the following switches to enable or disable the configuration and change history roles:
  • -h | --enableChangeHistoryProvider true|false
  • -p | --enableConfigurationProvider true|false

For example, if you don’t want to perform re-registration as a change history provider, use the -h false switches.

If you want default values to be used if you do not pass a command or a switch when running the runtopobuild script or batch file, configure the following properties in the collation.properties file:
  • com.ibm.cdb.topobuilder.integration.oslc.refreshAll=true|false
  • com.ibm.cdb.topobuilder.integration.oslc.refreshGuid=guid
  • com.ibm.cdb.topobuilder.integration.oslc.enablecrtvtype.crtv_type
For a full list of the available parameters and switches, go to $COLLATION_HOME/support/bin and run the runtopobuild script or batch file with the -H switch. for example,
./runtopobuild.sh -H