soamswitch

Windows only. Resets the system environment for the application client: connecting to a DE cluster from the DE installation environment; connecting to a Symphony cluster from the DE installation environment; or connecting to a Symphony cluster using the Symphony installation environment.

Synopsis

soamswitch sym
soamswitch symde
soamswitch sym Symphony_dir [-v version ] [-h ]
soamswitch sym SymphonyDE_dir [-v version ] [-h ]
soamswitch symde SymphonyDE_dir [-v version ] [-h ]
soamswitch info
soamswitch -h |-V

Description

You must have local administrator privileges on the host to use soamswitch.

Resets the system environment for this machine, specifying both the installation environment to use, and the cluster to connect to.

After the soamswitch command is issued, environment changes take effect on all subsequent command sessions—the environment in the current command session is not affected.

Options

soamswitch sym

Use this command to reset your environment to connect to the Symphony cluster instead of the DE cluster. Continue to connect from the DE installation environment.

You can only use this command when the current installation environment is set to DE.

Your environment uses the DE libraries, and work submitted from client applications or commands issued runs on the Symphony cluster in subsequent command sessions.

soamswitch symde

Use this command to reset your environment to connect to the DE cluster instead of the Symphony cluster. Continue to connect from the DE installation environment.

You can only use this command when the current installation environment is set to DE.

Your environment uses the DE libraries, and work submitted from client applications or commands issued runs on the DE cluster in subsequent command sessions.

soamswitch sym Symphony_dir -v version

Use this command to reset your environment to connect to the Symphony cluster from the Symphony installation environment, regardless of your current environment.

You can only use this command if Symphony is installed on this machine.

Your environment uses the Symphony libraries, and work submitted from client applications or commands issued runs on the Symphony cluster in subsequent command sessions.

Symphony_dir

Specify the path to the directory in which Symphony is installed.

Note:

You cannot specify a UNC path. For example, do not specify \\hosta\share\.

-v version

Specifies the version of Symphony to switch to.

Use this option when multiple versions of Symphony are installed on the same machine.

Reset from DE environment and cluster to Symphony grid environment and cluster

soamswitch sym C:\EGO -v 4.1

soamswitch sym SymphonyDE_dir -v version

Use this command to reset your environment to connect to the Symphony cluster from the DE installation environment, regardless of your current environment.

You can only use this command if DE is installed on this machine.

Your environment uses the DE libraries, and work submitted from client applications or commands issued runs on the Symphony cluster in subsequent command sessions.

SymphonyDE_dir

Specify the path to the directory in which DE is installed.

Note:

You cannot specify a UNC path. For example, do not specify \\hosta\share\.

-v version

Specifies the version of Symphony DE to switch to.

Use this option when multiple versions of Symphony DE are installed on the same machine.

Reset from Symphony environment to the DE environment while connecting to the Symphony cluster

soamswitch sym C:\SymphonyDE\DE4.1

soamswitch symde SymphonyDE_dir -v version

Use this command to reset your environment to connect from the DE installation environment to the DE cluster, regardless of your current environment.

Your environment uses the DE libraries, and work submitted from client applications or commands issued runs on the DE cluster in subsequent command sessions.

SymphonyDE_dir

Specify the path to the directory in which Symphony DE is installed.

Note:

You cannot specify a UNC path. For example, do not specify \\hosta\share\.

-v version

Specifies the version of Symphony DE to switch to.

Use this option when multiple versions of Symphony DE are installed on the same machine.

Reset from Symphony grid environment and cluster to the DE environment and cluster

soamswitch symde C:\SymphonyDE\DE4.1

soamswitch info

The output of the command indicates your current environment and whether you are connecting to DE cluster or a Symphony cluster.

The output of the command indicates whether your installation environment is set to Symphony or DE.

View my current environment

View whether the environment is currently set to connect to a Symphony cluster.

soamswitch info

-h

Prints command usage to stdout and exits.

-V

Prints product version to stdout and exits.

Related files

The following configuration files specify which cluster to connect to. The paths shown result from using the default installation directories.

  • C:\SymphonyDE\DE41\conf\ego.conf—specifies which Symphony cluster to connect to from a DE installation environment

  • C:\SymphonyDE\DE41\conf\vem_resource.conf—specifies which DE cluster to connect to from a DE installation environment

  • C:\EGO\kernel\conf\ego.conf—specifies which Symphony cluster to connect to from a Symphony installation environment