Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also
create-service [--name name] [--serviceproperties serviceproperties] [--dry-run={false|true}] [--domaindir domaindir] [domain_name]
The create-service subcommand configures the starting of a domain administration server (DAS) on an unattended boot by using the Solaris 10 Service Management Facility (SMF). This subcommand must be run as the OS-level user with superuser privileges. After this subcommand creates the service, you must start, enable, disable, delete, or stop the service. The DAS configuration must be stored on a folder to which the superuser has access and cannot be stored on a network file system. The service is created such that it is controlled by the OS-level user who owns the folder where the configuration of the DAS resides. If no arguments are specified, the subcommand uses the default domain.
To run this subcommand, you must have solaris.smf.* authorization. (Refer to the useradd and usermod man pages.) On Solaris, the manifest file is created in the /var/svc/manifest/application/GlassFish/domain-name_domain-root-dir directory. You must also have write permission in the directory tree /var/svc/manifest/application/GlassFish. Usually, the superuser has both these permissions. To run these commands as non-root user, the system administrator must be contacted so that the relevant authorizations are granted. You need to also ensure that:
Solaris 10 administration commands such as svccfg, svcs, and auths are available in the PATH, so that these commands can be executed. A simple test to do so is to issue the subcommand, which svccfg on a bash shell.
You must have write permission for the path /var/svc/manifest/application/GlassFish.
This subcommand is supported in local mode only.
Displays the help text for the subcommand.
The directory where the domain is to be started. This is the absolute path of the directory on the disk that contains the configuration of the domain.
Previews your attempt to create a service. Indicates issues and the outcome that will occur if you run the command without using the --dry-run option. Nothing is actually configured. Default is false.
Tthe name of the service that you will use to run the Solaris SMF commands. If a default is present, this name overrides the default.
Specifies a : (colon)-separated list of various properties that are specific to the service. For Solaris 10, if you specify net_privaddr, the service's processes will be able to bind to the privileged ports (<1024) on the platform. You can bind to ports< 1024 only if the owner of the service is superuser, otherwise, this is not allowed.
The name of the domain to be started. If no domain is specified, the default domain is used.
This example creates a service for the default domain on a Solaris system.
asadmin> create-service The Service was created successfully. Here are the details: Name of the service:application/GlassFish/domain1 Type of the service:Domain Configuration location of the service:/home/gfuser/glassfish-installations /glassfishv3/glassfish/domains Manifest file location on the system:/var/svc/manifest/application /GlassFish/domain1_home_gfuser_glassfish-installations_glassfishv3 _glassfish_domains/Domain-service-smf.xml. You have created the service but you need to start it yourself. Here are the most typical Solaris commands of interest: * /usr/bin/svcs -a | grep domain1 // status * /usr/sbin/svcadm enable domain1 // start * /usr/sbin/svcadm disable domain1 // stop * /usr/sbin/svccfg delete domain1 // uninstall Command create-service executed successfully. |
Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also