4.6.9 Defining a logical server
(1) <define-server>
- Contents
- 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.
- Specifiable value
- --
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(2) <logical-server-name>
- Contents
- The <logical-server-name> tag specifies the name for identifying a logical server or a cluster.
- Specifiable value
- Specify a string within 128 characters having alphanumeric characters or underscore (_) and hyphen (-).
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(3) <display-name>
- Contents
- The <display-name> tag specifies the display name of the logical server. There are no restrictions on the permitted characters.
- Specifiable value
- Specify any string within 128 characters.
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(4) <description>
- Contents
- The <description> tag specifies the comments for a logical server. There are no restrictions on the permitted characters.
- Specifiable value
- Specify any string within 1024 characters.
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(5) <logical-server-type>
- Contents
- 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
- sfo-server:Session failover server (SFO 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 sfo-tier
- Session failover server (SFO 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, session failover server (SFO server), CTM domain manager, CTM, Smart Agent, Naming Service, performance tracer, Web server cluster, J2EE server cluster, and user server
- Specifiable value
- The following strings can be specified:
- web-server
- j2ee-server
- sfo-server
- performance-tracer
- ctm-domain-manager
- component-transaction-monitor
- smart-agent
- naming-service
- user-server
- Omitting tags
- Cannot be omitted.
- Omitting values
- Cannot be omitted.
(6) <cluster-ref>
- Contents
- 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.
- Specifiable value
- Specify a string within 128 characters having alphanumeric characters or underscore (_) and hyphen (-).
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(7) <server-no>
- Contents
- 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.
- Specifiable value
- For 1 to the value specified for <j2ee-server-count>
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.
(8) <configuration>
- Contents
- 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>.
- Specifiable value
- --
- Omitting tags
- Can be omitted.
- Omitting values
- Can be omitted.