diff options
| -rw-r--r-- | TAO/docs/implrepo/usersguide.html | 129 | ||||
| -rw-r--r-- | TAO/orbsvcs/tests/ImplRepo/README | 8 |
2 files changed, 133 insertions, 4 deletions
diff --git a/TAO/docs/implrepo/usersguide.html b/TAO/docs/implrepo/usersguide.html index 42cd8464968..e3ba716f837 100644 --- a/TAO/docs/implrepo/usersguide.html +++ b/TAO/docs/implrepo/usersguide.html @@ -181,6 +181,135 @@ This option must be used the first and every subsequent time the persistent IMR <hr> +<h4>How to run the Implementation Repository as an NT service</h4> + +<p>These conditions must be met:</p> + +<ul> +<li> +The user must be logged in as administrator, or have administrative priveleges +(in order to register an NT service). +</li> +<li> +ACE_ROOT must be set to the ACE_wrappers directory in the system environment. +</li> +<li> +ACE_ROOT/bin must be in the system path. +</li> +</ul> + +To set the options for the TAO NT ImplRepo Sevice, go to the Services icon +in the Settings group under the start menu (start menu -> settings -> +services). There, highlight "TAO NT ImplRepo Service", which is the name +used by the ImplRepo Service when it is registered. After it's +highlighted, you should see at the bottom of the dialog box an area to +specify options for ImplRepo_Service.exe. Just enter the options you wish in +that edit box and everything should just work. However, some options, such as +-ORBDebugLevel, won't work since an NT service can't write output to +standard out. + +<br><br> + +<ul> +<li> +Syntax<br> +<blockquote> + % NT_ImplRepo_Service [-i value] +<blockquote><blockquote><blockquote><blockquote><blockquote> + [-r]<br> + [-s]<br> + [-k]<br> + [-t n]<br> + [-d]<br> +</blockquote></blockquote></blockquote></blockquote></blockquote> +</blockquote> +</li> + +<li> +Optional Command-line Arguments<br> +<br> +<ul> +<li> + -i value<br> + Install this program as an NT service, with specified startup<br> +</li> +<li> + -r<br> + Remove this program from the Service Manager<br> +</li> +<li> + -s<br> + Start the service<br> +</li> +<li> + -k<br> + Kill the service<br> +</li> +<li> + -t value<br> + Set startup for an existing service<br> +</li> +<li> + -d<br> + Debug; run as a regular application<br> +</li> +</ul> +</li> +<br> +<li>Usage<br> +<blockquote> + To see different stages of an NT service application, you have<br> + to run the program several times, with different options.<br> + Please note: run with only one option at a time.<br> +<br> +<ul> +<li> + First, you must initialize the service in the NT Service Control<br> + Manager database. Run NT_ImplRepo_Service with -in, where n is<br> + one of the following startup options:<br> +<br> + // Start Type (from WinNT.h)<br> + //<br> + #define SERVICE_SYSTEM_START 0x00000001<br> + #define SERVICE_AUTO_START 0x00000002<br> + #define SERVICE_DEMAND_START 0x00000003<br> + #define SERVICE_DISABLED 0x00000004<br> + + If only -i is specified, SERVICE_DEMAND_START is default option.<br> +<br> +</li> +<li> + Now you are ready to run the actual service. Run<br> + NT_ImplRepo_Service again, this time with -s option. If the<br> + service starts successfully, it will ring the system<br> + bell every second or so until the service is stopped.<br> +<br> +</li> +<li> + To stop service execution, run NT_ImplRepo_Service with the<br> + -k option.<br> +<br> +</li> +<li> + To remove the service from the Service Control Manager<br> + database, run NT_ImplRepo_Service with -r.<br> +<br> +</li> +</ul> + In addition, once you have initialized this service (by using<br> + the -i option) you can change its startup type to one of the<br> + other values above. To do this, run NT_ImplRepo_Service with<br> + -tn option. n is as explained above for -i.<br> +<br> + In order to debug the service's execution itself, use the -d<br> + option.<br> +</blockquote> +</li> +</ul> +<br> + +<hr> + <p>Last update to this document: $Date$</p> <p>Back to <a href="index.html">Implementation Repository</a></p> diff --git a/TAO/orbsvcs/tests/ImplRepo/README b/TAO/orbsvcs/tests/ImplRepo/README index e1ec574e4c0..32da31f94b4 100644 --- a/TAO/orbsvcs/tests/ImplRepo/README +++ b/TAO/orbsvcs/tests/ImplRepo/README @@ -23,15 +23,15 @@ run successfully, these conditions must be met: -- ACE_ROOT/bin must be in the system path. -How to use the NT_ImplRepo_Service +How to use NT_ImplRepo_Service ================================== -To set the options for the TAO ImplRepo Sevice, go to the Services icon +To set the options for the TAO NT ImplRepo Sevice, go to the Services icon in the Settings group under the start menu (start menu -> settings -> -services). There, highlight the NT_ImplRepo_Service, which is the name +services). There, highlight "TAO NT ImplRepo Service", which is the name used by the ImplRepo Service when it is registered. After it's highlighted, you should see at the bottom of the dialog box an area to -specify options for ImplRepo_Service. Just enter the options you wish in +specify options for ImplRepo_Service.exe. Just enter the options you wish in that edit box and everything should just work. However, some options, such as -ORBDebugLevel, won't work since an NT service can't write output to standard out. |