These instructions describe how to configure OpenSwitch manually by editing the interfaces file and the OpenSwitch configuration file.
In a UNIX system, go to the $SYBASE directory and source the SYBASE.csh or SYBASE.sh file. For the C shell, enter:
source SYBASE.csh
For the Bash, the Bourne, or the Korn shell, enter:
. ./SYBASE.sh
Setting up the interfaces file
Verify that the interfaces file exists in the $SYBASE directory. If it does not, create it by copying from interf.sample. Go to the $SYBASE directory, and enter:
cp interf.sample interfaces
Open the interfaces file in a text editor and modify or add entries to provide the server names and port numbers for each OpenSwitch server and each Adaptive Server in your installation. For example, if you installed two OpenSwitch servers and two Adaptive Servers, you must provide the server name, host name, and port number for each server. In addition, if you are implementing mutually-aware support, you must include the server name, host name, and port number for the companion OpenSwitch server as the last line in the other OpenSwitch server’s entry.
Enter the information in this format:
servername master tcp ether hostname port query tcp ether hostname port query tcp ether hostname port
The second “query” line is necessary
only for mutually-aware OpenSwitch servers. See the OpenSwitch
Administration Guide for details about this feature.
servername – enter the name of the OpenSwitch server or Adaptive Server.
master tcp ether hostname port
– enter
the name of the machine where the server is running, and the port
number from which the server is started.
query tcp ether hostname port
– (first “query” line)
enter the name of the machine where the server is running, and the
port number from which the server is started.
For mutually-aware OpenSwitch servers only:
query tcp ether hostname port
– (second “query” line)
enter the name of the machine where the mutually-aware
companion OpenSwitch server is running, and the port number from
which that server is started.
For example, if you install one OpenSwitch server (no mutually-aware support) and two Adaptive Servers all on the same machine, the entries in the interfaces file would look similar to this:
OSWITCH1 master tcp ether dev2 4000 query tcp ether dev2 4000 ASESRV1 master tcp ether dev2 5000 query tcp ether dev2 5000 ASESRV2 master tcp ether dev2 5001 query tcp ether dev2 5001
If you install two OpenSwitch servers that are mutually-aware on one machine and two Adaptive Servers each on a different machine, the entries in the interfaces file would look similar to this:
OSW1 master tcp ether dev2 5000 query tcp ether dev2 5000 query tcp ether dev2 5005 OSW2 master tcp ether dev2 5005 query tcp ether dev2 5005 query tcp ether dev2 5000 ASE1 master tcp ether dev1 7000 query tcp ether dev1 7000 ASE2 master tcp ether dev3 8000 query tcp ether dev3 8000
Save the interfaces file and close the text editor.
Setting up the OpenSwitch configuration file and logs directory
Create a new OpenSwitch configuration file by going to $OPENSWITCH/config and copying the sample.cfg file by entering:
cp sample.cfg cfg_file
where cfg_file is the name of your server configuration, for example, OpenSwitch_ServerName.cfg.
Use a text editor to set the values in the configuration file you just created. See the tables in “Configuring OpenSwitch using the GUI tool” for definitions of the values you should provide.
Save the file and close the text editor.
Go to $OPENSWITCH and create a logs directory:
mkdir logs