Integrating Command-Line Programs

To integrate a command-line administration program with Sun Internet Administrator, run the mcreg(1m) command to store information about the application. This information is used by Sun Internet Administrator to correctly handle the presentation and launch of the command. The information you need for the mcreg command is:

• The component identifier, a unique string that identifies the service application. The service application developer chooses the component identifier.

• A user-friendly name, appropriate for presentation to the administrator. This is the service name that Sun Internet Administrator displays in its Manage Services screen, where the administrator accesses all services. The service application developer chooses the application name.

• The version number of the application being registered. The recommended format for the version number is major.minor (for example, 1.2). The service application developer chooses the version number.

• The complete path to the command-line program, plus information about its parameters and documentation. Enclose this command option in quotes ("). There are three fields:

  • The full path to the executable, with any static parameters. For example, -p "/usr/bin/ps -ef". This field is required.

  • A -a indicates that this command takes parameters from the user at run time. This field is optional

  • A -h helpfile indicates the on-line documentation associated with this command. This field is optional.

• The user name under which the administration interface runs. This identifies the UNIX UID that Sun Internet Administrator uses to invoke the program.

• The group name under which the administration interface runs. This identifies the UNIX GID that Sun Internet Administrator uses to invoke the program.

When you have all required information, obtain root access and register the information as shown below. Run this command on the computer where the service administration interface is installed.

See the mcreg(1m) man page for examples of this and other forms of the command.

To record information about multiple command-line operations, enter multiple -p arguments.

After running mcreg, you can log into Sun Internet Administrator as a console administrator and register the new application for management. If you want other administrators to have rights to manage the new application, edit their administrator access lists to include it. The Sun Internet Administrator on-line help has full instructions on performing these tasks.