vem_resource.conf

Defines the hosts in the Symphony DE cluster. This file is not used with Symphony on the grid.

Location

The vem_resource.conf configuration file exists on each host in the SymphonyDE cluster, including the management host, and all compute hosts.

The default locations for vem_resource.conf are
  • Windows—%SOAM_HOME%\conf

  • Linux—$SOAM_HOME/conf

Structure

Each line defines a single host.

The vem_resource.conf file must be updated on each host whenever hosts are added or removed, or when the configuration parameters of any host in the network changes.

There are five types of hosts you configure: session manager, compute host, session director, repository service, and GUI service.

Session manager host:

AGENT: port_number:host_name:max_SSMs:0:osType:CPU_factor

Compute host:

AGENT: port_number:host_name:0:max_SIMs:osType:CPU_factor

Session director host:

SD_SDK: port_number:host_name:sd_startCmd
SD_ADMIN: port_number:host_name:sd_startCmd

Repository service host:

RS_DEPLOY: port_number:host_name:rs_startCmd

GUI service host:

WEBGUI: port_number:host_name:startguiservice

Attributes

port_number

For AGENT, specifies the port number the Platform EGO emulator (start_agent) uses. The start_agent process runs on each Symphony host.

For SD_SDK, SD_ADMIN, specifies port numbers used by the session director.

For RS_DEPLOY, specifies the port number used by the repository service.

For WEBGUI, specifies the port number used by the GUI service. Port number for WEBGUI is 18080.

host_name

Specifies localhost in single-host environment.

In a multi-host environment, specify using dotted-decimal notation or as a DNS name. Hosts can also have dynamic IP addresses (DHCP).

max_SSMs

Specifies the maximum number of session managers that can be started on this host. For a compute host, specify 0.

max_SIMs

Specifies the maximum number of service instance managers that can be started on this host. Each service instance manager requires one (virtual) slot to run on, therefor the maximum number of sims the compute host can run is equal to the number of CPU slots on the machine. For a dedicated session manager host, specify 0 to prevent work from running on this host.

osType

Specifies the operating system type the host runs:

  • LINUX86—A Linux-based environment, such as RedHat Linux

  • NTX86—A Windows-based environment, such as Windows 2003, Windows 2000, Windows NT, and Windows XP

CPU_factor

Default=1.

The CPU factor is the speed of the host’s CPU relative to other hosts in the cluster. If one processor is twice the speed of another, its CPU factor should be twice as large. CPU factors are defined by the cluster administrator. For multiprocessor hosts, the CPU factor is the speed of a single processor.

sd_startCmd

Specifies the command that starts the session director.

Specify sd unless you have changed the name of the command or moved the session director executable from the installation directory. In this case, specify the absolute path to the session director executable.

rs_startCmd

Specifies the name of the command that starts the repository service.

Specify rs unless you have changed the name of the command or moved the respository service executable from the installation directory. In this case, specify the absolute path to the repository director executable.

GUI_startcmd

Specifies the name of the command that starts the WebGUI service.

Specify startguiservice unless you have changed the name of the command or moved the startguiservice script from the installation directory. In this case, specify the absolute path to the startguiservice script.

Examples

Management host also runs workload

In the following example, host1 runs the session director, repository service, GUI service, five session manager processes, and five service instance manager processes per application.

 # Resource configuration file
   #
   # File format:
   # <service name>:<port_number>:<host_name>:<max number of SSMs SD can start>:<max number of SIMs SSM can start>:<OS_type>:<CPU_factor>
   #
   AGENT:8000:host1:5:5:LINUX86:1
   #
   # SD service information
   # <service name>:<port_number>:<host_name>:<sd startcmd>
    SD_SDK:15051:host1:sd
    SD_ADMIN:15050:host1:sd
    #
   # RS service information
   # <service name>:<port_number>:<host_name>:<rs startcmd>
    RS_DEPLOY:15052:host1:rs
  #
 # GUI service information
   # <service name>:<port_number>:<host_name>:<gui startcmd>
 # Note:The port number of WEBGUI is fixed as 18080.
    WEBGUI:18080:host1:startguiservice

One management host and one compute host

In the following example, the host myfirsthost runs the session director, the repository service, five session manager processes and GUI service. The compute host, mysecondhost runs five service instance manager processes per application.

 # Resource configuration file
   #
   # File format:
   # <service name>:<port_number>:<host_name>:<max number of SSMs SD can start>:<max number of SIMs SSM can start>:<OS_type>:<CPU_factor>
   #
   AGENT:8000:myfirsthost:5:0:LINUX86:1
   AGENT:8000:mysecondhost:0:5:LINUX86:1
   #
   # SD service information
   # <service name>:<port_number>:<host_name>:<sd startcmd>
    SD_SDK:15051:myfirsthost:sd
    SD_ADMIN:15050:myfirsthost:sd
    #
   # RS service information
   # <service name>:<port_number>:<host_name>:<rs startcmd>
    RS_DEPLOY:15052:myfirsthost:rs
   # WebGUI service information
   # <service name>:<port_number>:<host_name>:<gui startcmd>
 # Note:The port number of WEBGUI is fixed as 18080.
    WEBGUI:18080:myfirsthost:startguiservice