📄 wtxregd.html
字号:
<html><head><!-- /vobs/wpwr/docs/tornado/tools/wtxregd.html - generated by refgen from wtxregd.c --> <title> wtxregd </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>Tornado Reference : Tornado Tools</i></a></p></blockquote><h1>wtxregd</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>wtxregd</strong> - the Tornado service registry </p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>wtxregd [-d.irectory registryDirectory] [-h.elp] [-pd <i>pingDelay</i>] [-pn <i>pingNumbers</i>] [-use_portmapper] [-V.erbose] [-v.ersion]</pre><p><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This daemon is a service registry that maintains a database oftarget servers, boards or any other item identifiers (see <b><a href="./tgtsvr.html#top">tgtsvr</a></b>) and RPC portnumbers.<p>Target-server identifiers are unique, and theyare based on the name of the target board (or an explicit alternatename supplied when the target server is launched) and the name of the hostwhere the target server runs. The two names are linked with thecharacter <b>@</b>, for example, <i>targetName</i>@<i>serverHost</i>.<p>This registry allows the Tornado tools to establish a connectionwith the target servers.<p>After accidental shutdown of the registry, recovery is done based on thedata saved in wtxregd.<i>hostName</i>. The data base file default directory is<b>$<b>WIND_BASE</b>/.wind</b> and can be specified through the <b>-d[irectory]</b> option.<p>On UNIX hosts, it is advisable to include the daemon in the <b>rc.local</b> file ofthe host where it runs for UNIX users, so that it starts and restores databaseautomatically after a reboot.<p>On Windows hosts the Tornado registry can also be used through the wtxregddaemon. Tornado installation adds it to yourAutomatic Startup if specified, or you can add the command line to the Start->Programs->Startup utilities.<p></blockquote><h4>TORNADO REGISTRY SERVICE</h4><blockquote><p><p>Windows NT users can add the wtxregds service to the startup services. Thisaddition to the Windows registry is done while installing Tornado.<p>The Tornado registry service does not accept any command line options; it starts with the registry default options.<p>Note that, if you install the Tornado registry as a service (on Windows NT), you will not be able to use Tornado 1.0.1 tools with your Tornado 2.0 installation.For more information, see<i>Tornado Getting Started: Installing Tornado. </i><p></blockquote><h4>DETECTING DEAD TARGET SERVERS</h4><blockquote><p><p>The registry daemon automatically detects target servers that are not responding. It dynamically removes target servers that are presumed dead from the registryqueue. This self-managing feature prevents you from having to manually unregister target servers that are not responding (see TARGET SERVERS PING section for further informations).<p>Tornado tools need to know the host on which the registry daemon runs.The host name of this machine or its IP address is published through theenvironment variable <b>WIND_REGISTRY</b>.<p></blockquote><h4>RESTORING THE DATA BASE</h4><blockquote><p><p>After an registry shutdown, a recovery of the data base is done from thedata base backup file whose location has been specified by the <b>-d</b> option.(The default location is $<b>WIND_BASE</b>/.wind.)<p>If the target servers registered on the same host as the registry arenot responding at restoration time, they will be removed from the registryqueue.<p></blockquote><h4>TARGET SERVERS PING</h4><blockquote><p><p>While processing a <b><i><a href="../../tornado-api/wtxc/wtx.html#wtxToolAttach" >wtxToolAttach</a></i>( )</b> on a target server, the registry pings thistarget server. If the ping is unsuccessfull (after 3 seconds of pending ping),the target server is considered to be not responding.<p>While processing a <b><i><a href="../../tornado-api/wtxc/wtx.html#wtxInfoQ" >wtxInfoQ</a></i>( )</b>, the target servers that are not responding are pingedif the <i>pingDelay</i> has expired (see PING DELAY section).<p>A not responding target server will be unregistered (and then considered to bedead) if it has been unsuccessfully pinged at least <i>pingNnumbers</i>times AND if the time between the first and last unsuccessfull ping time is atleast equal to <i>pingDelay</i>*<i>pingNnumbers</i>. This is to avoid having a single failedping lead to an unregistered target server.<p>This mechanism is used to allow the Tornado tools to survive network latenciesor short time failures.<p></blockquote><h4>PING DELAY</h4><blockquote><p><p>This delay (in seconds) can be specified through the <b>-pd</b> option, and itsdefault value is set to 120. It specifies after how many seconds atarget server that does not respond should be pinged again.<p>In compination with the <b>-pn</b> option (see PING NUMBER section), this value sets thetime after which a target server that does not respond is considered dead.<p>See the EXAMPLE section for examples on how to use the <b>-pd</b> option.<p></blockquote><h4>PING NUMBER</h4><blockquote><p><p>This number, set by the <b>-pn</b> option, fixes the number of times a target server that does not respond has to be unsuccessfully pinged to be considered dead.<p>See the EXAMPLE section for examples on how to use the <b>-pn</b> option.<p></blockquote><h4>WARNING</h4><blockquote><p><p>If either the <i>pingDelay</i> or <i>pingNumbers</i> variable is set to 0, the installation will not forgive any network latencies, and a target server could be unregistered justbecause the network was slow for a short time.<p></blockquote><h4>CAVEAT</h4><blockquote><p><p>The vertical tab character is not supported in any of the registry fields andshould never be used.<p></blockquote><h4>OPTIONS</h4><blockquote><p><dl><dt><b>-d | -directory</b><dd>Specify the directory containing the registry database file.<p><dt><b>-h | -help</b><dd>Display a help message summarizing target-registry usage and options.<p><dt><b>-pd <i>pingDelay</i></b><dd>Set the delay between two pings on a dead target server.<p><dt><b>-pn <i>pingNumbers</i></b><dd>Set the number of failed pings before considering a target server dead.<p><dt><b>-use_portmapper</b><dd>Use the local portmapper to register the target servers RPC services. This flagmust be set if version 1.x Tornado tools or target servers have to connectusing this registry.<p><dt><b>-V | -Verbose</b><dd>Turn on verbose mode. By default, the registry daemon is silent. Verbose mode displays information, warnings, and error messages. <p><dt><b>-v | -version</b><dd>Print the Tornado version. </dl><p></blockquote><h4>EXAMPLES</h4><blockquote><p>Display the Tornado registry on line help.<pre> wtxregd -h</pre>Start a Tornado registry in verbose mode.<pre> wtxregd -V</pre>Start a Tornado registry in verbose mode and save data base file in /tmp.<pre> wtxregd -V -d /tmp</pre>Start a Tornado registry using the local portmapper to register target servers.<pre> wtxregd -use_portmapper</pre>Start a Tornado registry with 30 seconds between two unsuccessful target serverpings.<pre> wtxregd -V -pd 30</pre>Start the Tornado registry with only two failed pings allowed.<pre> wtxregd -V -pn 2</pre>Start the Tornado registry so that it unregisters target servers as soon as theyseem to be unreachable.<pre> wtxregd -V -pn 0 wtxregd -V -pd 0</pre></blockquote><h4>ENVIRONMENT VARIABLES</h4><blockquote><p><p><dl><dt><b>WIND_BASE</b><dd>the root location of the Tornado tree. </dl><p></blockquote><h4>FILES</h4><blockquote><p><p><dl><dt><b>WINDBASE/.wind/wtxregd.<i>hostName</i></b><dd>default location for the backup registry file (can be changed through the<b>-d[irectory]</b> option). </dl><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./wtxregd.html#top">wtxregd</a></b>, <b><a href="./tgtsvr.html#top">tgtsvr</a></b>, <b><a href="./launch.html#top">launch</a></b>, <b><a href="./browser.html#top">browser</a></b>, <b><a href="./windsh.html#top">windsh</a></b>, <b><a href="./wtxreg.html#top">wtxreg</a></b> (UNIX only), <i>Tornado User's Guide </i><p></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -