Changes between Version 16 and Version 17 of Windows_startstop_Service


Ignore:
Timestamp:
10/30/14 21:56:10 (5 years ago)
Author:
et
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Windows_startstop_Service

    v16 v17  
    22= Earthworm Windows Service = 
    33 
    4 (last revised 11 September, 2009) 
     4(last revised 28 October 2014) 
    55 
    66== Readme for startstop_service == 
     
    1010USGS - Golden, CO[[BR]] 
    1111 
    12 (Some additional edits or comments in these docs by Stefan Lisowski) 
     12(Additional edits to these docs by Stefan Lisowski and Eric Thomas, ISTI) 
    1313 
    1414== Setup of startstop_service == 
     
    2121- Open a command window. Switch to the directory containing the startstop executable (if it's not already in the Windows path). 
    2222 
    23 - Type: startstop_service -install[[BR]] 
     23- Type: `startstop_service -install`[[BR]] 
    2424This will install the service. You should get a message saying that installation was successful. 
    2525 
    2626- Open the Services Control Panel. (It's under Control Panel->Administrative Tools->Services.) You should see something listed as "Earthworm start-stop". Verify that this service is set to run in Automatic mode (meaning it automatically starts after a reboot, without waiting for user intervention.) 
    2727 
    28 - By default, startstop is set to run as the "Local Service" account. We need to change this to run as the Administrator, or else any Earthworm rings won't be accessible to other users, and typing "status" won't work. To change the user the service runs under, Select the Properties of the startstop service (double-clicking or selecting Properties from the toolbar). Select the Log On tab, select This account, and select Browse. For Win2000 machines, select the Administrator account from the list, then click OK. Type in the password twice, and click OK again. For WinXP machines, select Advanced, then click Find Now. The listbox at the bottom should show all the users locally set up on that computer. Select the Administrator, then click OK twice. Now type in the Administrator password twice, then click OK again. 
    29  
    30 NOTE: This whole rigamarole means that whenever the Administrator password is changed on a machine running startstop, the password must be changed again from the Services control panel. 
     28- The start-stop service needs to be setup to run using the "Local System" account, and with the "Allow service to interact with desktop" option disabled (checkbox cleared). To verify these settings, select the properties of the start-stop service (double-clicking or selecting Properties from the toolbar). Select the Log On tab, and verify that the settings are as just described. 
    3129 
    3230- There's no way I've been able to find that allows environment variables to be loaded via ew_nt.cmd (or a similar file) before startstop runs. So, any environment variables required for Earthworm functionality have to be loaded systemwide before starting the startstop service. To set environment variables, select the System control panel, select the Advanced tab, and select Environment Variables. Under the "System variables" window ('''NOT the "user variables for XXX User" window'''), make sure that any environment variables you'll need are defined here. A typical subset may include:[[BR]] 
    33 - EW_HOME[[BR]] 
    34 - EW_INSTALLATION[[BR]] 
    35 - EW_LOG[[BR]] 
    36 - EW_PARAMS[[BR]] 
    37 - SYS_NAME[[BR]] 
    38 - TZ[[BR]] 
     31  EW_HOME[[BR]] 
     32  EW_INSTALLATION[[BR]] 
     33  EW_LOG[[BR]] 
     34  EW_PARAMS[[BR]] 
     35  SYS_NAME[[BR]] 
     36  TZ[[BR]] 
    3937In addition, make sure \earthworm\bin directory (or whichever directory contains your earthworm binaries) is included somewhere in the "Path" variable. Once these are set, click OK, and reboot the machine. 
    4038 
     
    4745Apart from running as a Windows service, startstop_service behaves just as startstop_nt. One interesting note is that if you select startstop_service in the Services control panel and click Stop or Restart, then startstop will attempt to shut down all applications attached to its ring via an Earthworm TERMINATE message. 
    4846 
    49 [[BR]][[BR]] 
     47The running startstop_service can be difficult to access, especially on versions of Windows newer than Windows XP. The !StartstopPipeConsole tool provides a way to interact with the 'startstop' process using a console window. For more information, see the "[wiki:Windows_StartstopPipeConsole Earthworm StartstopPipeConsole]" documentation. 
     48 
     49== Removing startstop_service == 
     50 
     51If you ever need to remove startstop_service from your machine, first stop the service (as above), then open a command window and type: `startstop_service -uninstall`[[BR]] 
     52You should also perform this step if you ever need to move the startstop binary to another directory on your hard drive; otherwise, Windows will not know where to find the executable. 
     53 
     54== Old startstop_service notes == 
     55 
     56Below are older startstop_service notes that were created before the [wiki:Windows_StartstopPipeConsole StartstopPipeConsole] tool was available. They should only be referenced and used if the !StartstopPipeConsole tool does not operate on a given installation.[[BR]] 
     57{{{----}}}[[BR]] 
     58By default, startstop is set to run as the "Local Service" account. We need to change this to run as the Administrator, or else any Earthworm rings won't be accessible to other users, and typing "status" won't work. To change the user the service runs under, Select the Properties of the startstop service (double-clicking or selecting Properties from the toolbar). Select the Log On tab, select This account, and select Browse. For Win2000 machines, select the Administrator account from the list, then click OK. Type in the password twice, and click OK again. For WinXP machines, select Advanced, then click Find Now. The listbox at the bottom should show all the users locally set up on that computer. Select the Administrator, then click OK twice. Now type in the Administrator password twice, then click OK again. 
     59NOTE: This whole rigamarole means that whenever the Administrator password is changed on a machine running startstop, the password must be changed again from the Services control panel.[[BR]] 
     60{{{----}}}[[BR]] 
    5061If you want to look at the Status of Earthworm, or if you want to Restart an Earthworm module or Reconfigure Earthworm's modules and rings, a window may come up telling you that you have a message. If you run a 'cmd' prompt in startstop, you can switch to this layer, and run commands in your cmd prompt.  
    5162[[BR]][[BR]] 
     
    6677[[BR]][[BR]] 
    6778 
    68 Advertisement: Finally if all else fails; ISTI offers a not-free commercial web-based graphical tool http://www.isti.com/products/ezw/ EZW to administer your Earthworm system locally or remotely. It is compatible with !StarstopService. 
     79Advertisement: Finally if all else fails; ISTI offers a not-free commercial web-based graphical tool http://www.isti.com/products/ezw EZW to administer your Earthworm system locally or remotely. It is compatible with !StartstopService. 
    6980 
    7081 
    7182 
    72 == Removing startstop_service == 
    73  
    74 If you ever need to remove startstop_service from your machine, first stop the service (as above), then open a command window and type: startstop_service -uninstall[[BR]] 
    75 You should also perform this step if you ever need to move the startstop binary to another directory on your hard drive; otherwise, Windows will not know where to find the executable.[[BR]]