solaris 10: add new svc

blowtorch · #1 11-15-2006

Hi guys,
I want to add a new 'service' to Solaris 10. Does anyone have any documentation that tells how to do that?

I have gone through a bunch of stuff on the net that tells how to enable, disable services, find whats wrong with a service and so on. All conveniently skip mention of how to actually add a new service of your own.

I checked the files in /var/svc/manifest, and I know that they are the xmls that are used by the svcadm and its ilk, but does adding a new 'service' mean writing one of those xml files yourself?

-edit
Don't like the word service - feels too Windowsy
-/edit

Tornado · #2 11-16-2006

Yes you have to create the xml file yourself..

- Create your shell start stop script and save it in /usr/local/svc/method/myservice
- chmod 755 /usr/local/svc/method/myservice
- Create your xml file and save it in /var/svc/manifest/site/myservice.xml
- Incorporate the script into the SMF using svccfg utility

Code:

svccfg import /var/svc/manifest/site/myservice.xml

blowtorch · #3 11-16-2006

Thanks. Do you have any documentation that says what those xml tags mean? That would really help out.

Tornado · #4 11-16-2006

Quote:

Originally Posted by blowtorch

Thanks. Do you have any documentation that says what those xml tags mean? That would really help out.

Yes I do, But thats at work. I will post them up tomorrow.

Tornado · #5 11-16-2006

This bit of info might be of use to you..
http://www.sun.com/bigadmin/content/...dev_intro.html

I am going through the doco I have, I will have to type a couple of pages worth inbetween doing my other work so it will take me a while to type it up for you..

Tornado · #6 11-16-2006

The general steps required are:
o Determine the proccess for starting and stopping your service.
o Establish a name for the service, and the category this service falls into.
o Determine whether your service runs multiple instances.
o Identify any dependency relationships between this service and any other service.
o If a script is required to start and stop the process, create the script and place it in a local directory such as /usr/local/svc/method
o Create a service manifest file for your service. This file describes the service and any dependency relationships. Service manifests are pulled into the repository either by using svccfg command or at boot time.
o Incorporate the scripts into SMF using the svccfg utility.

The following displays an example.

Code:

# vi /usr/local/svc/method/newservice
#!/sbin/sh
#
# Copyright (c) 1995, 1997-1999 by Sun Microsystems, Inc.
# All rights reserved.
#
#ident  "@(#)newservice    1.14    06/11/17 SMI"

case "$1" in
'start')
	/usr/bin/newservice &
	;;

'stop')
        /usr/bin/pkill -x -u 0 newservice
	;;

*0
	echo "Usage: $0 { start | stop }"
	;;
esac
exit 0

# chmod 544 /usr/local/svc/method/newservice

# cd /var/svc/manifest/site
# vi newservice.xml
<?xml version="1.0"?>
<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
<!--
    Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
    Use is subject to license terms.

    pragma ident        "@(#)newservice.xml 1.2     04/08/09 SMI"
-->

<service_bundle type='manifest' name='OPTnew:newservice'>

<service
    name='site/newservice'
    type='service'
    version='1'

    <single_instance/>
	<dependency
            name='usr'
            type='service'
            grouping='require_all'
            restart_on='none'>
                <service_fmri value='svc:/system/filesystem/local'/>
        </dependency>

        <dependency
            name='newservice'
            grouping='require_all'
            restart_on='none'>
            <service_fmri value='svc:/milestone/multi-user'/>
        </dependency>

        <exec_method
            type='method'
            name='start'
            exec='/lib/svc/method/newservice start'
            timeout_seconds='30' />

        <exec_method
            type='method'
            name='stop'
            exec='/lib/svc/method/newservice stop'
            timeout_seconds='30' />

        <property_group name='startd' type='framework'>
                <propval name='duration' type='astring' value='transient' />
        </property_group>

        <instance name='default' enabled='true' />

        <stability value='Unstable' />

        <template>
                <common_name>
                        <loctext xml:lang='C'>
                                New Service
                        </loctext>
                </common_name>
        </template>
</service>

</service_bundle>

blowtorch · #7 11-16-2006

Hey! Thanks a ton mate!

Thread Tools	Search this Thread
Show Printable Version Email this Page Subscribe to this Thread	Search this Thread: Advanced Search
Display Modes
Linear Mode Switch to Hybrid Mode Switch to Threaded Mode

The Following User Says Thank You to Tornado For This Useful Post:
biafran (05-11-2012)

The Following User Says Thank You to Tornado For This Useful Post:
jd0694 (06-28-2011)

The Following 4 Users Say Thank You to Tornado For This Useful Post:
biafran (05-11-2012), bluescreen (04-04-2011), kreno (04-08-2011), olam (11-04-2011)