Main -> Documentation -> WebZ System Administration -> WebZ Configuration Files -> HostMap.ini Configuration File

HostMap.ini Configuration File

The HostMap.ini file defines the ID, name, load distribution percentage, and Internet Protocol (IP) address of the servers used to host the Open SiteSearch system. Each server used as a host in the Open SiteSearch WebZ system must have its own [Host] section in the HostMap.ini file. The [Host] section and its respective variables are defined in the following table. A HostMap.ini file example appears after the table.

Location: The HostMap.ini file is located in the <WebZ_root>/ini directory of your installation.


Sections and Variables in HostMap.ini


[Host1]
Section

Note:

[Host] sections in HostMap.ini are named sequentially as [Host1], [Host2], [Host3], etc.

Variable

Description

HostID

Defines a string that uniquely identifies the host within the WebZ software. Typically, this number is written as 01, 02, 03, etc. For WebZ software running on multiple hosts, HostID must be unique for each host.

HostID is included in the session ID to route transactions to the correct host. For example, session ID 01-26013-882538515856 indicates that the transaction is assigned to host 01.

HostName

Specifies the name of the host. This name must match the name defined by the Host variable in the OpServe.ini file.

LoadDist

Defines the distribution percentage of user load the host will handle during system operation. For single server configurations, set LoadDist=100 (or, 100% of the load). For a multiple host configuration, the total value of LoadDist for all servers must equal 100.

IP1

Specifies the IP address of the host. If you have multiple network cards, specify all of the possible IP addresses for the host using additional variables - IP2, IP3, etc. By identifying the host's IP address in addition to supplying the name of the host, the OpServe can register the host with the WebZ system.

HostMap.ini File Examples

Single Host Configuration

In the following example, the WebZ system is configured to run on a single host, pluto.

[Host1]
HostID = 01
HostName = pluto
LoadDist = 100
IP1 = 999.999.99.99



[Host2]
HostID = 02
HostName=jupiter.any.area.org
LoadDist = 0
IP2 = 888.888.88.88


Multiple Host Configuration

In the following example, the WebZ system is configured to run on multiple hosts, pluto and jupiter.any.area.org. Notice that pluto is configured to handle 60% of the system load.

[Host1]
HostID = 01
HostName = pluto
LoadDist = 60
IP1 = 999.999.99.99



[Host2]
HostID = 02
HostName = jupiter.any.area.org
LoadDist = 40
IP1 = 888.888.88.88

See Also

WebZ Configuration Files
OpServe.ini Configuration File
WebZ System Administration


[Main][Documentation][Technical Reference][Glossary][Search]