doim.sh reference

doim.sh rspfile-create

Syntax
./doim.sh rspfile-create

Description
This doim.sh verb is used to interactively collect installation parameters from the user, validate them and store them in an RSPFILE and generates the initial DMCFG.


doim.sh dmcfg-validate

Syntax
./doim.sh dmcfg-validate [-dmcfg=<dmcfgFile>]

Where:

  • dmcfgFile is the optional DMCFG file to be validated

Description
This doim.sh verb validates the provided DMCFG, it can be used to quickly check a just modified DMCFG.


doim.sh node-list / service-list / node-start / node-stop / node-status

Syntax

  • ./doim.sh node-list
  • ./doim.sh service-list
  • ./doim.sh node-start -n nodeName
  • ./doim.sh node-stop -nnodeName
  • ./doim.sh node-status -n nodeName

Where:

  • nodeName is the name of the node to which the action must be applied

Description
These doim.sh verbs can be used to list nodes and services included in the current DMCFG and to apply start/stop/status actions to them. Internally, the commands simply orchestrate a remote execution of dataone.sh start|stop|status on the node.


doim.sh domain-install

Syntax
./doim.sh domain-install

Description
This doim.sh verb performs the actual installation of the product on all managed nodes, according to the directive contained in the specified configuration sources: either RSPFILE and DMCFG.


doim.sh domain-deploycfg

Syntax
./doim.sh domain-deploycfg

Description
This doim.sh verb simply copies DMCFG to each managed node impacted by the modifications vs the previously deployed DMCFG.


doim.sh domain-trace

Syntax

  • ./doim.sh domain-trace on serviceName [--nodeName=<nodeName>] tracespec1 [tracespec2 tracespec3...]
  • ./doim.sh domain-trace off serviceName [--nodeName=<nodeName]

Where:

  • serviceName is the name of the service to which the action must be applied.
    Possible values: AMQ. CEMAN, STENG, DMZ
  • nodeName: is the specific node hosting the serviceName to which the action must be applied. If no node is specified, the action will be applied to all the nodes hosting one serviceName instance (e.g. all peers in a STENG cluster, all CEMAN nodes etc).
  • tracespecX: is the trace specification clause typically in the form <packagename=levelName>.
    No exhaustive list of allowed values is provided, as a user you will always be instructed by the Primer Contact Center about which specific trace clauses to apply in order to perform a specific problem determination task.

Description
This doim.sh verb dynamically switches runtime traces on and off, runtime traces will be automatically switched off upon shutdown as well.


doim.sh license-install

Syntax
./doim.sh license-install

Description
This doim.sh verb copies license files from control node license <DOIM_HOME>/licenses folder to managed nodes.

It can be used at installation time to install the initial license files and also at any time after that to update them.

Supported license files are:

  • dataone-license
  • flowable-license
  • datashaper-license (only if Data Shaper is actually installed)

License files are provided by Primeur Orderdesk. The actual filenames received from Primeur contain a unique suffix added by Primeur to identify them. Just remove the suffix before using the licenses.

The newly installed license files will be picked up upon product restart.