4.3.9 Defining a logical server

Defines the configuration for each logical server that belongs to the physical tier specified in the <hosts-for> tag.

For example, if the <hosts-for> tag is the http-tier, you can define one logical server each for the Web server and for the performance tracer respectively. For defining multiple logical servers, specify the <define-server> tag for each logical server.

--

Can be omitted.

Can be omitted.

The <logical-server-name> tag specifies the name for identifying a logical server or a cluster.

Specify a string within 128 characters having alphanumeric characters or underscore (_) and hyphen (-).

Can be omitted.

Can be omitted.

The <display-name> tag specifies the display name of the logical server. There are no restrictions on the permitted characters.

Specify any string within 128 characters.

Can be omitted.

Can be omitted.

The <description> tag specifies the comments for a logical server. There are no restrictions on the permitted characters.

Specify any string within 1024 characters.

Can be omitted.

Can be omitted.

You must define this tag.

Specifies the types of logical servers for defining the configuration.

The types of logical server are as follows:

• web-server:Web server

• j2ee-server:J2EE server

• performance-tracer:Performance tracer

• ctm-domain-manager:CTM domain manager

• component-transaction-monitor:CTM

• smart-agent:Smart Agent

• naming-service:Naming service

• user-server:User server

The logical server that can define the configuration of the host varies according to the physical tier type. The types of physical tiers are as follows:

In combined-tier

Web server, J2EE server, performance tracer, and user server

In http-tier

Web server, performance tracer, and user server

In j2ee-tier

J2EE server, performance tracer, and user server

In ctm-tier

The logical servers that can be defined are different for each Web system.

• In the Web system for the integrated naming scheduler server

  CTM domain manager, CTM, Smart Agent, performance tracer, and user server

• Web system for CTM

  CTM domain manager, CTM, Smart Agent, J2EE server, performance tracer, and user server

In free-tier

Web server, J2EE server, CTM domain manager, CTM, Smart Agent, Naming Service, performance tracer, Web server cluster, J2EE server cluster, and user server

The following strings can be specified:

• web-server

• j2ee-server

• performance-tracer

• ctm-domain-manager

• component-transaction-monitor

• smart-agent

• naming-service

• user-server

Cannot be omitted.

Cannot be omitted.

Specifies the cluster name when setting up a logical server as a cluster member.

If the logical server to be set up as a cluster member is the J2EE server, this tag specifies the J2EE server cluster name, and for the Web server this tag specifies the Web server cluster name.

Logical servers other than the J2EE server and Web server cannot be set up as a cluster member.

This tag is defined only for the free-tier configuration.

Specify a string within 128 characters having alphanumeric characters or underscore (_) and hyphen (-).

Can be omitted.

Can be omitted.

Specifies the number for identifying the J2EE server when a configuration is specified for a specific J2EE server in the service unit.

Specify a unique number on the host. Make sure that you specify this tag when specifying the J2EE server configuration when <j2ee-server-count> tag is specified in the physical tier definition.

For 1 to the value specified for <j2ee-server-count>

Can be omitted.

Can be omitted.

Defines the configuration to be applied for each logical server.

If the environment settings defined in the physical tier definition are to be used for operation, there is no need to define the<configuration> tag.

This tag cannot be specified when J2EE server cluster or Web server cluster is specified in <logical-server-type>.

--

Can be omitted.

Can be omitted.