Sun GlassFish Enterprise Server 2.1 Administration Guide

Restarting Automatically on Solaris 10

Solaris 10 users can use the command asadmin create-service to create a service that restarts a node agent or Domain Administration Server (DAS). The service created uses the Solaris Service Management Facility (SMF).

The process that a service starts depends on whether the service is to restart a DAS or a node agent.

The service grants to the process the privileges of the user that runs the process. When you use the command asadmin create-service to create an SMF service, the default user is the superuser. If you require a different user to run the process, specify the user in method_credential.

If your process is to bind to a privileged port of the Solaris OS, the process requires the net_privaddr privilege. The privileged ports of the Solaris OS have a port numbers less than 1024.

To determine if a user has the net_privaddr privilege, log in as that user and type the command ppriv -l | grep net_privaddr.

To run the asadmin create-service command, you must have solaris.smf.* authorization. See the useradd and usermod man pages to find out how to set the authorizations. You must also have write permission in the directory tree: /var/svc/manifest/application/SUNWappserver. Usually, the superuser has both these permissions. Additionally, the Solaris 10 administration commands such as svccfg, svcs, and auths must be available in the PATH. For complete information on running this command, see create-service(1).

The syntax is as follows:

asadmin create-service [--name service-name] [--type das|node-agent]
--passwordfile password-file [--serviceproperties serviceproperties] 

    For example, to create a service called domain1 for domain1:

  1. Run the following:

    asadmin create-service --type das --passwordfile password.txt /appserver/domains/domain1

    This creates a service to restart the domain domain1 automatically. In the background, the command creates a manifest file from a template, validates the file, and imports it as a service.

    Note –

    If a particular Enterprise Server domain should not have default user privileges, modify the service's manifest and reimport the service. To determine a user's privileges, log in as that user and type the command ppriv -l.

  2. Once the service is created, enable it using the svacdm enable command:

    svacdm enable /appserver/domains/domain1

  3. Once enabled, if the domain goes down, SMF restarts it.

As you administer your service, the following Solaris commands are useful:

For more information on these commands, see the command manpages.