Summary

This article clarifies how to set up and use one installation of Orbix 3.3 for multiple environments, each running under it's own configuration with it's own orbix daemon, NS, etc. on the same host machine.

This is the recommended approach rather than installing Orbix 3.3 multiple times in different directories.

Environment

Orbix 3.3, All Supported OS

Question/Problem Description

Often, especially in Unix environments, multiple users need to use their own instance or installation of Orbix 3.3 e.g. for development or testing purposes, or multiple Orbix 3.3 environments might need to run in parallel each with it's own orbix daemon, NS, etc.

The question arises then whether it is necessary to have multiple installations of Orbix 3.3 in different directories or whether it is possible to use the same installation for different environments.

Clarifying Information

Each Orbix 3.3 environment consists of one Orbix daemon process and the CORBA servers running under this daemon process.

Resolution

Please follow the the steps below:

1) Install Orbix 3.3, e.g. in /opt/orbix-3.3

- ensure you are using a supported platform and JDK according to http://supportline.microfocus.com/supportresources/CORBAPlatformInfo.aspx

2) Assuming a new configuration is required e.g. for user orbixusr in the directory /users/orbixusr/orbix-3.3-config, ensure the following:

- copy the configuration files from the default Orbix 3.3 installation to this new configuration directory:
    cp /opt/orbix/config/* /users/orbixusr/orbix-3.3-config

The above step will copy the following files from the default installation:
    common.cfg
    ErrorMsgs
    ErrorMsgs.java
    iona.cfg
    Orbix.hostgroups
    Orbix.hosts
    orbix3.cfg
    orbixnames3.cfg
    orbixweb3.cfg

- create new repository directories for this configuration:
    mkdir /users/orbixusr/orbix-3.3-config/Repositories
    mkdir /users/orbixusr/orbix-3.3-config/Repositories/IFR
    mkdir /users/orbixusr/orbix-3.3-config/Repositories/ImpRep
    mkdir /users/orbixusr/orbix-3.3-config/Repositories/NamesRep

- copy the environment script setenvs.sh file from the default installation to this new configuration directory:
    cp /opt/orbix/setenvs.sh /users/orbixusr/orbix-3.3-config

- change the above new environment script /users/orbixusr/orbix-3.3-config/setenvs.sh to source the default environment script from the Orbix 3.3 installation and reset the IT_CONFIG_PATH environment variable to the new configuration directory, e.g:

    # source the environment script from the Orbix installation
    #
    . /opt/orbix/setenvs.sh

    # reset the configuration directory
    IT_CONFIG_PATH=/users/orbixusr/orbix-3.3-config ; export IT_CONFIG_PATH

- in /users/orbixusr/orbix-3.3-config/iona.cfg change cfg_dir value to point to the new configuration directory:
    cfg_dir = "/users/orbixusr/orbix-3.3-config/";

- in /users/orbixusr/orbix-3.3-config/common.cfg ensure to adjust the value for IT_DAEMON_PORT to a new value (if needed also IT_DAEMON_SERVER_BASE, IT_DAEMON_SERVER_RANGE)

3) Start using this new configuration by

- sourcing the new environment file
    . /users/orbixusr/orbix-3.3-config/setenvs.sh

- checking the Orbix daemon is using this new configuration:
    orbixd -v

- running the Orbix daemon:
    orbixd -t

Support Incidents

2820898

Notes

For further details on using Orbix 3.3 please see the documentation available below:

http://supportline.microfocus.com/productdoc.aspx

by selecting

Product Family: CORBA Middleware

Product: Orbix 3