Chapter 3: Starting and Stopping OpenSwitch and RCMs

Starting and stopping OpenSwitch on Windows

OpenSwitch starts automatically after you install and configure the product.

You cannot start OpenSwitch until you have configured the product. If you chose not to configure OpenSwitch during installation, see Chapter 4, “Using the Configuration File,” in this guide, and the OpenSwitch Installation Guide, Chapter 3, Configuring OpenSwitch.”

Starting OpenSwitch from the Start menu

If you added OpenSwitch to the Windows Start menu (see Chapter 4, “Post Installation Tasks” in the OpenSwitch Installation Guide), use these instructions to start the product.

Select Start | Programs | OpenSwitch | OpenSwitch.

Starting OpenSwitch from a command prompt

Open a Command Prompt window, and go to the %SYBASE% directory.
In the same window, enter:
```
SYBASE.bat
```
At the command prompt, enter:
```
cd %SYBASE%\OpenSwitch-15_0\bin
```
In the same window, enter the following command, then press Enter the following, where -c is the name of the OpenSwitch configuration file to use during start-up:
```
start OpenSwitch.bat -c ..\config\OpenSwitch.cfg
```

You can configure OpenSwitch to use encrypted user names and passwords for the user name and password entries that are in the OpenSwitch configuration file. See “Using encrypted user names and passwords”.

Stopping OpenSwitch from the command line on Windows

Open a Command Prompt window and go to %SYBASE%.
Enter:
```
.\SYBASE.bat
```
At the command prompt, log in to OpenSwitch as an administrator enter the following, where <OpenSwitch_server_name> is the name of the OpenSwitch server you want to stop:
```
isql -Usa -Psa -S<OpenSwitch_server_name>
```
Issue this command:
```
rp_shutdown
go
```

Starting OpenSwitch as a Windows service

Go to %OPENSWITCH%\bin and use a text editor to set the OPENSWITCH and SYBASE_OCS variables to the correct path in the OpenSwitch.bat file. Save the file and close the text editor.
From %OPENSWITCH%\bin, open a Command Prompt window, enter the following, where <OpenSwitch configuration file path> is the location of the OpenSwitch configuration file:
```
.\OpenSwitch.bat -c <OpenSwitch configuration file path> -R install
```
For example:
```
D:\Sybase\OpenSwitch-15.0\config\OpenSwitch.cfg
```
Open the Registry Editor. Select Start | Run, enter regedit in the Open text field, then click OK.
In the Registry Editor window, go to HKEY_LOCAL_MACHINE | SYSTEM | CurrentControlSet | Services and click the OpenSwitch server name.
1. Select Edit | New | Key, then enter “Parameters” as the key name.
2. Click the new Parameters key, select Edit | New | String Value, then enter “Application” as the new string value.
3. Double-click Application. When the Edit String dialog box appears, enter the following text on one line in Value Data field:
```
<OpenSwitch installation directory>\bin\OpenSwitch.bat -c
   <OpenSwitch configuration file path> -l <OpenSwitch log file path>
```
  Where:
  - <OpenSwitch installation directory> – is the drive and directory in which OpenSwitch is installed; for example:
```
D:\Sybase\OpenSwitch-15_0
```
  - <OpenSwitch configuration file path> – is the location of the OpenSwitch configuration file; for example:
```
D:\Sybase\OpenSwitch-15.0\config\OpenSwitch.cfg
```
  - <OpenSwitch log file path> – is the file location of the OpenSwitch log file; for example:
```
D:\Sybase\OpenSwitch-15_0\bin\OSWServer.log
```
  Use the name of your actual OpenSwitch configuration file and log file when entering this information.
  
  Click OK.
4. In the left pane of the Registry Editor window, click your service name. In the right pane of the Registry Editor, double-click the “ImagePath” string and delete the text in the Edit String dialog box.
  
  Enter the full path to the srvany.exe file. For example:
```
D:\engapps\NTResKit\srvany.exe
```
  Click OK.
  
  srvany.exe is installed on Windows operating systems as part of the Resource Kit. If servany.exe is not on your machine, download the file as part of the Windows Resource Kit for your platform at the Microsoft Windows Resource Kit Web page.
5. Select Registry | Exit to close the Registry Editor.
Select Start | Settings | Control Panel | Administrative Tools | Services, right-click OpenSwitch <OpenSwitch server name> in the Services right pane, then click Properties.
In the Properties dialog box:
1. Select the Log On tab.
2. Select Local System Account and Allow Service To Interact With Desktop.
3. Select the General tab.
4. In the Startup Type box, select Automatic.
  
  If you do not want OpenSwitch to start automatically the next time the Windows machine is restarted, change the Startup Type to Manual.
5. Click Apply, then click OK to close the Properties dialog box.
In the Services right pane, right-click the OpenSwitch service and select Start.
Close the Services window.

Stopping the OpenSwitch service on WIndows

Right-click an empty space on the Windows taskbar, then click Task Manager.
Select the Processes tab.
Click on the OpenSwitch process and select End Process.
Close the Windows Task Manager window.
If this fails because the process is being used by an application, select Start | Settings | Control Panel | Administrative Tools | Services.
In the Services window, right-click the OpenSwitch service and select Stop.
Close the Services window.

Removing OpenSwitch as a service

Shut down OpenSwitch if it is running.
Open a Command Prompt window and go to %OPENSWITCH%\bin.
At a command prompt, enter the following, where <OpenSwitch configuration file path> is the location of the OpenSwitch configuration file:
```
.\OpenSwitch.bat -c <OpenSwitch configuration file path> -R remove
```
For example:
```
D:\Sybase\OpenSwitch-15.0\config\OpenSwitch.cfg
```

This stops the service and removes it from the Windows Registry.

Using encrypted user names and passwords

View this book as PDF