Installing Oracle® Solaris 11.2 Systems

Exit Print View

Updated: July 2014

Using the Manifest Creation Tool

You can use the svcbundle command to generate a valid service manifest. In the following example, notice that by default, a manifest generated by the svcbundle command specifies a transient service and specifies the multi-user dependency.

Example 13-3  Generated SMF Service Manifest

In the following command, the name of the script shown in Creating a Script to Run at First Boot is specified as the value of start-method. The name of the script is specified as /opt/site/ because the package created in Creating an IPS Package for the Script and Service installs the script into /opt/site/

In the following command, the completed property is specified by a colon-separated list of property group name, property name, property type, and initial property value.

$ svcbundle -s service-name=site/first-boot-script-svc \
-s start-method=/opt/site/ \
-s instance-property=config:completed:boolean:false \
> first-boot-script-svc-manifest.xml

In the generated service manifest shown below, the first-boot script, /opt/site/, is the value of the exec attribute of the start method. The completed property is specified in the instance element that defines the default instance of this service, first-boot-script-svc:default.

<?xml version="1.0" ?>
<!DOCTYPE service_bundle
  SYSTEM '/usr/share/lib/xml/dtd/service_bundle.dtd.1'>
    Manifest created by svcbundle (2014-Jan-14 16:39:30-0700)
<service_bundle type="manifest" name="site/first-boot-script-svc">
    <service version="1" type="service" name="site/first-boot-script-svc">
            The following dependency keeps us from starting until the
            multi-user milestone is reached.
        <dependency restart_on="none" type="service"
            name="multi_user_dependency" grouping="require_all">
            <service_fmri value="svc:/milestone/multi-user"/>
        <exec_method timeout_seconds="60" type="method" name="start"
            The exec attribute below can be changed to a command that SMF
            should execute to stop the service.  See smf_method(5) for more
        <exec_method timeout_seconds="60" type="method" name="stop"
            The exec attribute below can be changed to a command that SMF
            should execute when the service is refreshed.  Services are
            typically refreshed when their properties are changed in the
            SMF repository.  See smf_method(5) for more details.  It is
            common to retain the value of :true which means that SMF will
            take no action when the service is refreshed.  Alternatively,
            you may wish to provide a method to reread the SMF repository
            and act on any configuration changes.
        <exec_method timeout_seconds="60" type="method" name="refresh"
        <property_group type="framework" name="startd">
            <propval type="astring" name="duration" value="transient"/>
        <instance enabled="true" name="default">
            <property_group type="application" name="config">
                <propval type="boolean" name="completed" value="false"/>
                <loctext xml:lang="C">
                        Replace this comment with a short name for the
                <loctext xml:lang="C">
                        Replace this comment with a brief description of
                        the service