Details of Hostfile

Hostfile is an XML file which has OmniRpcConfig at the top level. OmniRpcConfig's element is Host.

Host element

In the host element, you should describe the hosts which you use.

Name attribute:(Required)

You should specify the host name with the name attribute.

User attribute: (Optional, user name on client host if omitted)

You can set the user name when the user names are different on the client host and remote host. If the value of the user attribute is omitted, the user name on the client host is used.

Arch attribute, os attribute(Optional)

At this writing, you can specify the architecture (arch) and operating system (os), but these values are not used.

In the host, you can specify the attributes below.

Agent element: (Optional)

In OmniRPC, the omrpc-agent is invoked in initialization, and the agent element is a option for the agent. It has no elements. but you can specify the following attributes.

invoker attribute: rsh, ssh, gram, globus (Required if agent element used)

You should specify the method of the agent invocation. "gram" is an alternative name for globus. If the agent element is omitted, the default invoker is rsh.

mxio attribute: on, off (Optional, off if omitted)

You should specify whether or not you use multiplex communication. Set this value on if you want to use the relay of communication by the agent. If you don't specify the value of the mxio attribute, the default value is off.

path attribute: (Optional, /usr/local/omrpc/ if omitted)

On this host, if OmniRpc software is not installed in the default install path (/usr/local/omrpc), you should specify the path attribute as the install path.

JobScheduler element: (Optional)

Specify the jobscheduler of the omrpc-agent which executes the remote executable. There are some attributes. If this element is omitted, the default type is fork and maxjob is 1.

type attribute: fork, round_robin, rr, pbs, sge (Required if jobschedular element used)

You specify the type of jobscheduer. "rr" is an alternative name for "round_robin". "pbs" stands for portable batch system and sge stands for sun grid engine.

maxjob attribute: (Option. 1 if omitted)

You specify the number of maximum jobs which can be executed on the remote host. If the value is omitted, maxjob is set to 1.

Registry element: (Optional)

Specifys the path to the registry on the remote host. If this element is omitted, the registry path is the home directory on the remote host.

path attribute: (Required if registry element used)

You should specify the path to registry.

WorkingPath element: (Optional)

Specifys the directory on which worker program in remote side can store the file.

path attribute: (Required if registry element used)

You should specify the path that workers store temporary files .

Description element: (Optional)

You can describe information about host.

TimeOut element: (Optional)

Specifys the timeout seconds of connection between client program and OmniRPC agent. Default seconds is 15 .

second attribute: (Required if registry element used)

You can specify the timeout second when the client program invokes OmniRPC agent in remote nodes. Sometimes the client program fails because of long phease of authentication. If you meet that case, please increase that value.

Debug element: (Optional)

If you want OmniRPC client program to show debug message, please write Debug element in hostfile.