Flurry: mention how you import this

2023-02-19T23:22:10Z

mention how you import this

← Older revision		Revision as of 16:22, 19 February 2023
Line 97:		Line 97:
	</service_bundle>		</service_bundle>
	</syntaxhighlight>		</syntaxhighlight>

			== Okay, but how do I use this? ==

			That's the easy part! As root:

			<syntaxhighlight lang="text">
			# svccfg import your-manifest.xml
			</syntaxhighlight>

			You can now use it like every other service on your system. Use <code>svcs my_service</code> to see its status, <code>svcadm (enable\|disable\|refresh\|restart) my_service</code> to do all of those relevant things, etc etc.

Flurry: Created page with "Maybe I just suck at finding docs, but SMF feels like a bit of a mess. It seems like Solaris users get [https://docs.oracle.com/cd/E36784_01/html/E36871/svcbundle-1m.html#REFMAN1Msvcbundle-1m some nice tools] for creating manifests, but I'm guessing that's post-illumos fork. Refer to [https://www.oracle.com/technetwork/server-storage/solaris10/solaris-smf-manifest-wp-167902.pdf this PDF] for more in-depth info. This assumes you're using [https://illumos.org/man/8/svc.st..."

2023-02-19T23:07:58Z

Created page with "Maybe I just suck at finding docs, but SMF feels like a bit of a mess. It seems like Solaris users get [https://docs.oracle.com/cd/E36784_01/html/E36871/svcbundle-1m.html#REFMAN1Msvcbundle-1m some nice tools] for creating manifests, but I'm guessing that's post-illumos fork. Refer to [https://www.oracle.com/technetwork/server-storage/solaris10/solaris-smf-manifest-wp-167902.pdf this PDF] for more in-depth info. This assumes you're using [https://illumos.org/man/8/svc.st..."

New page

Maybe I just suck at finding docs, but SMF feels like a bit of a mess. It seems like Solaris users get [https://docs.oracle.com/cd/E36784_01/html/E36871/svcbundle-1m.html#REFMAN1Msvcbundle-1m some nice tools] for creating manifests, but I'm guessing that's post-illumos fork. Refer to [https://www.oracle.com/technetwork/server-storage/solaris10/solaris-smf-manifest-wp-167902.pdf this PDF] for more in-depth info.

This assumes you're using [https://illumos.org/man/8/svc.startd svc.startd(8)] as your "restarter", which mainly affects the <code>exec_method</code> elements (AIUI). If you (like me) don't know what that means, this is likely the case.

<syntaxhighlight lang="xml">
<?xml version="1.0"?>
<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">

<service_bundle type="manifest" name="service_name">

<service name="scarlet/my_service" type="service" version="1">

<single_instance />




<dependency name="net_fs" grouping="require_all" restart_on="refresh" type="service">
<service_fmri value="svc:/milestone/network:default" />
<service_fmri value="svc:/system/filesystem/local" />
</dependency>


<dependency name="config_file" grouping="require_all" restart_on="refresh" type="path">
<service_fmri value="file://localhost/etc/serviced.conf" />
</dependency>


<exec_method type="method"
name="start"
exec="/opt/local/bin/serviced --with-args "stuff""
timeout_seconds="60">
<method_context>

<method_credential user='svcuser' group='svcgrp' />
<method_environment>
<envvar name="HOME" value="/var/lib/service" />
</method_environment>
</method_context>


<exec_method type="method"
name="stop"
exec=":kill"
timeout_methods="60" />


<property_group name="startd" type="framework">

<propval name="duration" type="astring" value="child" />

<propval name="ignore_error" type="astring" value="core,signal" />

</property_group>

<template>

<common_name>
<loctext xml:lang="C">Sample Service Daemon</loctext>
</common_name>

<documentation>
<manpage title="serviced" section="8" manpath="/opt/local/share/man" />
<doc_link name="docs-home" uri="https://example.com/docs/" />
</documentation>
</template>
</service>
</service_bundle>
</syntaxhighlight>

SMF on illumos - Revision history

Flurry: mention how you import this