Hitachi

uCosminexus Application Server Definition Reference Guide


4.3.8 Defining a service unit

Organization of this subsection

(1) <unit>

Contents

You must define this tag.

Defines a service unit.

For defining the multiple service units, specify the <unit> tag for each service unit to be defined.

Specifiable value

--

Omitting tags

Cannot be omitted.

Omitting values

Cannot be omitted.

(2) <name>

Contents

You must define this tag.

The <name> tag specifies the name for identifying the service unit. This name must be unique within the Web system. Specify this name in the -unit option of the Smart Composer functionality commands.

Specifiable value

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

Omitting tags

Cannot be omitted.

Omitting values

Cannot be omitted.

(3) <display-name>

Contents

The <display-name> tag specifies the display name of the service unit. 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 the service unit. 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) <allocated-host>

Contents

You must define this tag.

Defines the reference to the host that configures a service unit. Specify only one <allocated-host> tag. You can specify multiple <allocated-host> tags in a Web system with free-tier configuration.

Specifiable value

--

Omitting tags

Cannot be omitted.

Omitting values

Cannot be omitted.

(6) <host-ref>

Contents

You must define this tag.

The <host-ref> tag specifies the host name specified in the <name> tag of the host definition, the host name defined in the built Web system, IP address, or @myhost.

When specifying @myhost, the value in the <host-name> tag in the host definition is automatically set up during the system setup.

If there are multiple hosts, the same host cannot be shared in the same service unit.

Specifiable value

The following strings can be specified:

  • Host name

  • IPv4 address

  • @myhost

Omitting tags

Cannot be omitted.

Omitting values

Cannot be omitted.

(7) <hosts-for>

Contents

You must define this tag.

Specifies the type of physical tier to which the host specified in the <host-ref> tag belongs. The types of physical tiers are as follows:

  • combined-tier

  • http-tier

  • j2ee-tier

  • ctm-tier

  • free-tier

Specifiable value

The following strings can be specified:

  • combined-tier

  • http-tier

  • j2ee-tier

  • ctm-tier

  • free-tier

Omitting tags

Cannot be omitted.

Omitting values

Cannot be omitted.