<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- saved from url=(0029)http://www.helpandmanual.com/ -->
<head><script type="text/javascript" src="helpman_topicinit.js"></script>
<!-- Redirect browser to frame page if page is not in the content frame. -->
<script type="text/javascript">
<!--
if (top.location.search.lastIndexOf("toc=0")<=0) {
if (top.frames.length==0) { top.location.href="index.html?app_plain_server.htm"; }
else { parent.lazysync('app_plain_server.htm'); }
}
//-->
</script>
<script type="text/javascript" src="highlight.js"></script>
<title>Plain Server</title>
<meta name="generator" content="Help & Manual">
<meta name="keywords" content="Activation Timeout">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<link type="text/css" href="styles.css" rel="stylesheet">
<link type="text/css" href="custom.css" rel="stylesheet">
<script type="text/javascript" src="nsh.js"></script>
<!-- non-scrolling headers for CHM and browser-based help, local styles-->
<style TYPE="text/css" media="screen">
<!--
body {
margin:0;
padding:0;
overflow: auto;
background: #FFFFFF;
}
#idheader {
width:100%;
height:auto;
padding: 0;
margin: 0;
}
#idheaderbg {
background: #6F6F6F;
}
-->
</style>
<style TYPE="text/css" MEDIA="print">
<!--
/* Hide navigation links and add space between header
and text in the printed version. Not valid for eBooks. */
#idnav { display:none; }
.topichead { padding: 5px 5px 20px 5px; }
-->
</style>
</head>
<body onload="highlight();">
<div id="hmpopupDiv" style="visibility:hidden; position:absolute; z-index:1000; filter:progid:DXImageTransform.Microsoft.DropShadow(color='b0b0b0', Direction=135, OffX='3', OffY='3') progid:DXImageTransform.Microsoft.Fade(Overlap=1.00);"></div>
<!--ZOOMSTOP-->
<div id="idheader">
<div id="idheaderbg">
<table width="100%" border="0" cellspacing="0" cellpadding="0"
style="margin: 0px; color: #6F6F6F; background: url(header_bg.jpg);">
<tr valign="bottom">
<td align="left" valign="bottom" class="topichead">
<p class="crumbs" id="idnav"><b>Navigation:</b>
<a href="application.htm">Application</a> > <a href="app_descriptors.htm">Descriptors</a> > <a href="app_server.htm">Server</a> ></p>
<p class="p_Heading1"><span class="f_Heading1">Plain Server</span></p>
</td>
<td align="right" width="120" valign="middle" class="topichead" id="idnav">
<a href="javascript: print();"
onmouseover="document.images.prntr.src='print1.gif'"
onmouseout="document.images.prntr.src='print2.gif'"
><img name="prntr" border="0" alt="Print this Topic" title="Print this Topic" src="print2.gif"
></a>
<a href="app_server.htm"
onmouseover="document.images.prev.src='btn_prev_h.gif'"
onmouseout="document.images.prev.src='btn_prev_n.gif'"
><img name=prev src="btn_prev_n.gif" border=0 alt="Previous page"
></a><a href="app_server.htm"
onmouseover="document.images.main.src='btn_home_h.gif'"
onmouseout="document.images.main.src='btn_home_n.gif'"><img name=main src="btn_home_n.gif" border=0 alt="Return to chapter overview"
></a><a href="app_icebox_server.htm"
onmouseover="document.images.next.src='btn_next_h.gif'"
onmouseout="document.images.next.src='btn_next_n.gif'"><img name=next src="btn_next_n.gif" border=0 alt="Next page"
></a>
</td>
</tr>
<tr><td colspan="2" style="height: 3px; background: url(header_bg_shadow.gif)"></td></tr>
</table>
</div>
<!-- The following code displays Expand All/Collapse All links below the header in topics containing toggles -->
</div>
<div id="idcontent"><div id="innerdiv">
<!--ZOOMRESTART-->
<p class="p_Heading2"><span class="f_Heading2">Properties</span></p>
<p class="p_IndentList2"><span class="f_IndentList2">The Server Properties panel offers the following fields:</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Server ID</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The ID of the server; corresponds to the </span><span class="f_T_Code">Ice.ServerID</span><span class="f_IndentList3"> property. Each server must have a unique ID within an IceGrid deployment.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Description</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">A free-text description of this server.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Property Sets</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">List of property-set IDs; you refer to a property set to "include" all its properties in the server.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Properties</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">Ice properties private to this server.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Log Files</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">This table can be used to declare a number of log files used by this server. Path is the path to the log file (a relative path is relative to the IceGrid node working directory); when Property is set, IceGrid generates a property with this name and the log file path as value.</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">You declare log files to be able to conveniently retrieve them using IceGrid Admin (in the <a href="live_deployment.htm">Live Deployment</a> tab) or with the icegridadmin command-line utility.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Path to Executable</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">Path to the server's executable; cannot be blank. A relative path is relative to the IceGrid node working directory.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Ice Version</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The Ice version of this server. If you don't provide a value, IceGrid assumes it's the same version as the IceGrid registry.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Working Directory</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The working directory for the server when started by the IceGrid node.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Command Arguments</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The command-line arguments given to the server when started by the IceGrid node.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Run as</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">On Linux and Unix, when IceGrid node is running as root, it is possible to run the server under any username. Enter the desired username in this field.</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">When not set (the default), the server runs as the same user as the IceGrid node, except when IceGrid node runs as root. In this case, the server runs as nobody.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Environment Variables</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The environment variables for the server when started by the IceGrid node. These variables are in addition to variables defined in the IceGrid node own environment.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Activation Mode</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">The server's activation mode. Must be one of:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">always: IceGrid node keeps this server running all the time</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">manual: this server is started "manually", using IceGrid Admin or the icegridadmin command-line utility</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">on-demand: IceGrid starts this server when it resolves the object-adapter ID of an object adapter defined in this server</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">session: IceGrid starts a separate instance of this server for each IceGrid session that allocates this server </span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">a variable or combination of variables that resolves to one of the values above</span></td></tr></table></div><p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Activation Timeout</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">When activating a server, IceGrid gives </span><span class="f_T_Entry">timeout</span><span class="f_IndentList3"> seconds to object adapters with server lifetime to register their endpoints with the IceGrid registry. During this time, lookup for the corresponding adapter IDs are delayed.</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">If not set or set to 0, the IceGrid node uses the value of its</span><span class="f_T_Code"> IceGrid.Node.WaitTime</span><span class="f_IndentList3"> property.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Deactivation Timeout</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">When deactivating a server, IceGrid gives </span><span class="f_T_Entry">timeout</span><span class="f_IndentList3"> seconds to the server to exit gracefully. After this timeout, the server process is killed.</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">If not set or set to 0, the IceGrid node uses the value of its</span><span class="f_T_Code"> IceGrid.Node.WaitTime</span><span class="f_IndentList3"> property.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Allocatable</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">Specifies whether the server can be allocated. A server is allocated implicitly when one of its allocatable objects is allocated. This checkbox is ignored if the server activation mode is session; a server with this activation mode is always allocatable. Default: false.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Depends on the application distribution</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">A server that depends on the application distribution is stopped and disabled before any application distribution update, and re-enabled after such update. Default: true.</span></p>
<p class="p_Heading2Sub2"><span class="f_Heading2Sub2">IcePatch2 Proxy</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">A stringified (or well-known) proxy for the IcePatch2 server than contains this server's private distribution. Possible values:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">"None selected" (default) or blank: no private distribution defined</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_T_Code">${application}.IcePatch2/server</span><span class="f_IndentList3">: corresponds to the well-known proxy of an IcePatch2 server deployed in this application using the IcePatch2 default server-template (with a default instance-name parameter value).</span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 60px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList3">Your own value</span></td></tr></table></div><p class="p_Heading2Sub2"><span class="f_Heading2Sub2">Directories</span></p>
<p class="p_IndentList3"><span class="f_IndentList3">List of directories included in the server distribution. When blank, the entire IcePatch2 server repository is used as the distribution.</span></p>
<p class="p_Heading2"><span class="f_Heading2">Children</span></p>
<p class="p_IndentList2"><span class="f_IndentList2">A plain server can have two types of children:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 30px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList2"><a href="app_adapter.htm">Adapter</a></span></td></tr></table></div><div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 0px 0px 10px 30px;"><table border="0" cellpadding="0" cellspacing="0" style="line-height: normal;"><tr style="vertical-align:baseline" valign="baseline"><td width="13"><span style="font-size: 11pt; font-family: 'Arial Unicode MS', 'Lucida Sans Unicode', 'Arial'; color: #000000;">•</span></td><td><span class="f_IndentList2"><a href="app_dbenv.htm">Database Environment</a></span></td></tr></table></div>
<!--ZOOMSTOP-->
<p> </p><hr size="1"><p class="fsmall">Page url:
<a href="http://www.zeroc.com/doc/Ice-3.4.1/IceGridAdmin/index.html?app_plain_server.htm" target="_top">http://www.zeroc.com/doc/Ice-3.4.1/IceGridAdmin/index.html?app_plain_server.htm</a>
</p>
</div></div>
<script type="text/javascript">
<!--
var lastSlashPos = document.URL.lastIndexOf("/") >
document.URL.lastIndexOf("\\") ? document.URL.lastIndexOf("/") :
document.URL.lastIndexOf("\\");
if( document.URL.substring( lastSlashPos + 1, lastSlashPos + 4
).toLowerCase() != "~hh" )
{
nsrInit();
}
-->
</script>
</body>
</html>
