<html>

<head>

<title>Configuring Servers</title></head>

<body  BGCOLOR="#ffffff">

<table border="0">

<td width="10">&nbsp;</td>

<td>

 <a href="Admin196.htm"><img src="./prev.gif" border="0" alt="Previous" WIDTH="32" HEIGHT="32"></a><a href="Admin198.htm"><img src="./next.gif" border="0" alt="Next" WIDTH="32" HEIGHT="32"></a><p>

<h3>     Configuring Servers<p>

</h3>Use the <b>server create</b> operation to make an application server accessible to the server control facility.  Configuring a server means creating the information needed to start 

and control the server.  Typically this includes a server's starting command line and arguments, along with other information needed to start DCE applications. 

</b><p>

Some servers need to be available whenever a host system is running.  For instance, you might want a server that provides information on host activity to start at the host boot time and run until the 

host shuts down.  Other kinds of services might be needed or only for brief periods.  The server control facility has an administrative interface that lets you specify some conditions for starting 

and stopping servers: 

<p>

· 	<b>Explicit</b>  -  You can set a server so that you can explicitly start it whenever you want.  </b><p>

· 	<b>Boot</b>  -  You can set a server to start at boot time.  </b><p>

· 	<b>Automatic</b>  -  You can set a server to start on demand; that is, it starts whenever a client request for its services is received at the host system.</b><p>

· 	<b>Failure</b>  -  You can set a server to start automatically if it exits unexpectedly.</b><p>

The following example creates an entry for a fictitious video clip server named <b>video_clip</b> on the local host.  For a remote host or a host in another cell, use the cell-relative or the 

global name.  The program name <b>vclip</b> invokes the server which is located in the <b>/usr/local/bin</b> working directory.  The server has a catalog mode that we set by specifying 

<b>-catalog</b> as the argument.  The server uses DCE security so the server has a principal name <b>Vclip_Srv_1</b>.  The <b>-entryname</b> option specifies the entry name in CDS where the 

server stores its binding information.  The <b>-starton</b> option sets the server to start when the <b>dced</b> receives an explicit <b>server start</b> operation that names the video_clip 

server.  The <b>failure</b> attribute further specifies to restart the server if it exits with a status that is not successful.  The <b>-services</b> option has annotation information to help 

administrators identify servers when this information is returned with <b>server show</b> operations.  The <b>interface</b> attribute is needed because the DCE daemon copies this information into 

the host endpoint map when the server starts.  

</b><p>

dcecp&gt; <b>server create /.:/hosts/silver/config/srvrconf/video_clip \</b></b><p>

&gt; <b>-program {/usr/local/bin/vclip} \</b></b><p>

&gt; <b>-directory {/tmp} -arguments {-catalog} \</b></b><p>

&gt; <b>-principal {Vclip_Srv_1} \</b></b><p>

&gt; <b>-entryname {/.:/subsys/applications/video_clip_1} \</b></b><p>

&gt; <b>-starton {explicit failure} \</b></b><p>

&gt; <b>-services {{annotation {Video Clip Catalog and Server}} \</b></b><p>

&gt; <b>{interface {d860322b-d499-11cd-9dfb-0000c08adf56 1.0}}} </b><p>

<b></b>dcecp&gt;</b><p>

The next example configures the same server to start whenever the host system boots.  The only difference from the preceding example is that the <b>-starton</b>
 option has a value of <b>boot</b>
.</b>
<p>

dcecp&gt; <b>server create /.:/hosts/silver/config/srvrconf/video_clip \</b></b><p>

&gt; <b>-program {/usr/local/bin/vclip} \</b></b><p>

&gt; <b>-directory {/tmp} -arguments {-catalog} \</b></b><p>

&gt; <b>-principal {Vclip_Srv_1} \</b></b><p>

&gt; <b>-entryname {/.:/subsys/applications/video_clip_1} \</b></b><p>

&gt; <b>-starton {boot} \</b></b><p>

&gt; <b>-services {{annotation {Video Clip Catalog and Server}} \</b></b><p>

&gt; <b>{interface {d860322b-d499-11cd-9dfb-0000c08adf56 1.0}}} </b><p>

<b></b>dcecp&gt;</b><p>

The final configuration example sets the <b>video_clip</b> server to start whenever a client request for its services is received at the host system.  The <b>-starton</b> option value is 

<b>auto</b>.  <a href="Admin199.htm">Unconfiguring Servers</a> discusses the steps for disabling and enabling services. 

</b><p>

dcecp&gt; <b>server create /.:/hosts/silver/config/srvrconf/video_clip \</b></b><p>

&gt; <b>-program {/usr/local/bin/vclip} \</b></b><p>

&gt; <b>-directory {/tmp} -arguments {-catalog} \</b></b><p>

&gt; <b>-principal {Vclip_Srv_1} \</b></b><p>

&gt; <b>-entryname {/.:/subsys/applications/video_clip_1} \</b></b><p>

&gt; <b>-starton {auto} \</b></b><p>

&gt; <b>-services {{annotation {Video Clip Catalog and Server}} \</b></b><p>

&gt;<b>  {interface {d860322b-d499-11cd-9dfb-0000c08adf56 1.0}}} </b><p>

<b></b>dcecp&gt;</b><p>

<h3><b></h3></b><p>

<b></b></b><p>

</td>

</table>

</body></html>

