Integrating X-Based Services

When the service application is installed on a computer in the network, 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 administration GUI. The information you need for the mcreg command is:

• The component identifier, a unique string that identifies the service application. Because they are unique, Solaris for ISPs recommends using package names as component identifiers. 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 file system path to the X-based administration interface executable on the service host.

• 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 an example of this form of the command.

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 to include it. The Sun Internet Administrator on-line help has full instructions on performing these tasks.

When an administrator invokes the X application from Sun Internet Administrator, the display is routed to display zero (hostname:0) on the client machine. Any stdout or stderr messages generated by the X application are displayed in the Sun Internet Administrator X Application Output screen.