Configuring, Starting, and Stopping the FOCUS Database Server

The following odin.cfg file configures the default names for the FOCUS Database Server. The default server node name is FOCSU. The default client node name is FOCSU01.

;FOCUS Database Server
NODE = FOCSU
BEGIN
  PROTOCOL = TCP
  CLASS = SUSERVER
  PORT = 8102
END

;FOCUS Database Client
NODE = FOCSU01
BEGIN
  PROTOCOL = TCP
  CLASS = SUCLIENT
  HOST = host
  PORT = 8102
END

where:

host

Is the host name or IP address for the FOCUS Database Server.

To start the FOCUS Database Server, issue the focus command with the -sinkstart option:

focus -sinkstart [snodename]

where:

snodename

Is the server node name from the odin.cfg file. If you are using the default node name, it can be omitted.

To stop the FOCUS Database Server, issue the focus command with the -sinkstop option:

focus -sinkstop [cnodename]

where:

cnodename

Is the client node name from the odin.cfg file. If you are using the default node name, it can be omitted.

Each instance of FOCUS can only have one FDS associated with it. In order to run multiple FOCUS Database Servers, multiple instances of FOCUS must be installed and started. Each instance of FOCUS needs its own set of port numbers, which are defined in the odin.cfg file.

Check with your Network Administrator to determine which port numbers you should use for additional sink machines.

One of the FOCUS instances will be considered the primary server and will be the one that the FOCUS Clients will use. The other server instances will be used only for the FDS component.

Running isetup and Creating New Directory Locations

To create the new FOCUS instance, run the isetup process and install the secondary FOCUS instance to a unique EDACONF name.

During the installation process you will be prompted to review the following default settings.

EDAHOME = …/ibi/srv77/foc/home  
 EDACONF = …/ibi/srv77/foc/wfs  
 EDAPRFU = …/ibi/foc/profiles
 APPROOT = …/ibi/apps
 HTTP_BASE_PORT = 8121

where:

…/

References the absolute path where FOCUS was installed.

When asked to proceed with the defaults, enter N (for No) and edit the following directory locations:

1. Create a new EDAHOME for the new instance. For example:

   /group1/user1/ibi/srv77/foc/home2

2. Create a new EDACONF for the new instance. For example:

   /group1/user1/ibi/srv77/foc/wfs2

3. Create a new EDAPRFU for the new instance. For example:

   /group1/user1/ibi/srv77/foc/profiles2

4. Enter the new port for the HTTP Listener. This is the second of six consecutive port numbers that must be open and available for FOCUS IP-based services.
5. If prompted for a mail server, press Enter, as this feature is optional.

Leave APPROOT and HOMEAPPS (if prompted) pointing to the APPROOT and HOMEAPPS path of your initial FOCUS installation.

Re-verify the configuration options, and if everything looks good, enter Y to Accept and Proceed.

Editing odin.cfg for the New Installation

Edit the secondary odin.cfg in ibi/srv77/foc/wfs2/etc. You only need to change the FOCUS Database Client name. The port numbers should already be set to the new port numbers configured during the installation process (Step 4). The FOCUS Database Server and Client sections should be similar to:

;FOCUS Database Server
NODE = FOCSU
BEGIN
  PROTOCOL = TCP
  CLASS = SUSERVER
  PORT = nnnn
END
;FOCUS Database Client
NODE = SINKB01
BEGIN
  PROTOCOL = TCP
  CLASS = SUCLIENT
  HOST = 127.0.0.1
  PORT = nnnn
END

Note that the FOCUS Database Server name is still FOCSU, but the port number is different from the primary server and the client node name is different.

Edit the secondary suprof.prf to allocate the files that will be used by this FDS, or use the APP PATH command to set the PATH where the alternate sink files are located.

Editing odin.cfg for the Original Installation

In the primary odin.cfg file for the original installation (in ibi/srvxx/wfs/etc/odin.cfg) you must add a FOCUS Database Client section that is identical to the FOCUS Database Client entry in the odin.cfg of the secondary server. This entry will point to your secondary (alterantive) sink:

;FOCUS Database Client
NODE = SINKB01
BEGIN
  PROTOCOL = TCP
  CLASS = SUCLIENT
  HOST = 127.0.0.1
  PORT = nnnn
END

Starting and Stopping the New Instance and the Secondary FOCUS Database Server

To start the secondary FOCUS instance and FDS, issue the following command:

ibi/srv77/foc/wfsalt/bin/focus -sinkstart

To stop the secondary FOCUS instance and FDS, issue the following command:

ibi/srv77/foc/wfsalt/bin/focus -sinkstop SINKB01