Setting your environment on Windows

We assume you are not already using Symphony DE.

Symphony provides batch files and the soamswitch command to facilitate the setup of either your current working environment or your global system environment. The environment setup method you choose depends on how you plan to run your client. If you only want to run your client from your current working command prompt window, use the batch files. If you want to run your client from the Windows desktop or you want to change the system environment permanently, use the soamswitch command.

Change your current working environment

If you want to change your current working environment to connect to a Symphony DE or a Symphony Cluster, run the appropriate batch file:

  • symclientenv.bat—resets your current command prompt session to connect to the Symphony cluster.

  • symdeenv.bat—resets your current command prompt session to connect to the DE cluster.

Tip:

When you open the Symphony DE command prompt, the environment is automatically set to DE in the window. You can run symclientenv.bat to change the environment to connect to a Symphony cluster from DE. Afterwards, you can run symdeenv.bat to change the environment back so that you can connect to a DE cluster.

Change your system environment

Connect to a Symphony DE cluster from the DE environment

This section describes how to set up your Symphony DE system environment so that you can connect to a Symphony DE cluster.

Note:

You must have local administrator privileges on the host to set the global environment.

Note:

soamswitch does NOT change the environment settings of the command prompt window from which you run soamswitch. The new environment settings only take effect when you open a new Windows command prompt window.

  1. At the command prompt, enter:

    soamswitch symde SymphonyDE_dir

    For example, soamswitch symde C:\SymphonyDE\DE40

  2. Open a new Windows command prompt window and run your client from there.
  3. Ensure that vem_resource.conf is configured properly in the %SOAM_HOME%\conf directory.

Connect to a Symphony cluster from the DE environment

This section describes how to set up your Symphony DE system environment so that you can connect to a Symphony cluster.

Note:

You must have local administrator privileges on the host to set the global environment.

Note:

soamswitch does NOT change the environment settings of the command prompt window from which you run soamswitch. The new environment settings will only take effect when you open a new Windows command prompt window.

  1. At the command prompt, enter:

    soamswitch sym SymphonyDE_dir

    For example, soamswitch sym C:\SymphonyDE\DE40

  2. Open a new Windows command prompt window and run your client from there.
    Note:

    Do not use the DE command prompt window to run your client since it will reset the environment to Symphony DE.

    Ensure that ego.conf is configured properly in%EGO_CONFDIR%, in other words, the %SOAM_HOME%\conf directory. Specify the master candidate host list and the EGO vemkd daemon port number.