Rhapsody partners require the ability to build a complete Rhapsody environment with minimal operator interaction. As a result, Rhapsody now includes a new command line tool that can:

  • Load and save local configurations
  • Install a Rhapsody license
  • Complete site registration
  • Manage users, groups and permissions
  • Manage Rhapsody variables
  • Rename folders, routes and communication points
  • Load certificates, private keys and symmetric keys

A 'master' machine controls the configuration process, and a 'target' machine receives a pre-configured installation of the Rhapsody engine that is ready to run. A single master machine can configure any number of target machines, and therefore only needs to be set up once.

The Rhapsody engine is installed on the target first. Refer to Installing the Rhapsody Engine Unattended for details. Once installation completes, the engine is started either by the installer, or by using a mechanism appropriate to the platform.

  • On *nix machines, the command is ./rhapsody.sh start.
  • On Windows® machines, the command is sc start Rhapsody6.

Rhapsody IDE is installed on the master machine. It includes a command line application that can automate a number of operations. The command line application takes the filename of an XML file as its sole parameter. The XML file contains a list of commands and associated parameters. When run, the application launches the IDE and uses it to connect to the target machine. Once connected, it performs the actions in the XML script. Refer to XML Script Elements for a list of elements the XML script may include.

Running Scripts

To execute the script, enter the following command:

"<RhapsodyInstallDirectory>\Rhapsody IDE\Rhapsody IDE\RhapAdmin6.exe" /script script.xml > log.txt  

Example Scripts for Typical Tasks

A simple script that logs in and leaves Rhapsody IDE running:

<script xmlns="http://www.orionhealth.com/rhapsody/ide/2010/09/command-script">
    <login username="administrator" password="Rhapsody" hostname="198.51.100.1" port="3041"/>
</script>


A simple script that logs in (administrator/rhapsody on localhost:3041), installs a license, loads an RLC and closes Rhapsody IDE:

<script xmlns="http://www.orionhealth.com/rhapsody/ide/2010/09/command-script">
    <login/>
    <license file="acme-v6.0.lic"/>
    <rlc-load file="example.rlc"/>
    <exit/>
</script>

XML Script Elements

The XML script may include the following elements:

Related Topics