Configuring OpenSwitch manually

These instructions describe how to configure OpenSwitch manually by editing the interfaces file and the OpenSwitch configuration file.

  1. 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
    

StepsSetting up the interfaces file

  1. 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
    
  2. 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
    

    NoteThe 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
    
  3. Save the interfaces file and close the text editor.

StepsSetting up the OpenSwitch configuration file and logs directory

  1. 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.

  2. 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.

  3. Save the file and close the text editor.

  4. Go to $OPENSWITCH and create a logs directory:

    mkdir logs