Hitachi

Hitachi Advanced Database Setup and Operation Guide


11.14.2 Files required for the function for centrally managing client definitions

You need to create the following files to use the function for centrally managing client definitions.

Files necessary to be created on the HADB server
  • Client definition file used by the function for centrally managing client definitions

  • Client management definition file

Files necessary to be created on HADB clients
  • Client definition files managed by individual HADB clients

Organization of this subsection

(1) Client definition file used by the function for centrally managing client definitions

The client definition file used by the function for centrally managing client definitions specifies the values for the operands in the client definition that you want to apply to the authorization identifier managed by this function. The applicable authorization identifier connects to the HADB server, according to the definitions in the client definition file used by the function for centrally managing client definitions.

The template of the client definition file used by the function for centrally managing client definitions (client.def) is stored in the server directory $ADBDIR/sample/conf. Copy the template, and in the new file, specify the individual operands for the client definition. The specification rules for the client definition are the same as ones for the server definition. For details about the specification rules for the server definition, see 7.3 Syntax rules for the server definition.

Note
  • For details about individual operands in the client definition, see Contents of operands in the client definition in the HADB Application Development Guide.

  • You do not have to specify the operands in the client definitions that are not applied to the function for centrally managing client definitions. For details about individual operands in the client definitions that are not applied to this function, see Notes about using the function for centrally managing client definitions in the HADB Application Development Guide.

Important

The default values are assumed for the omitted operands in client definitions. Therefore, if you want to apply the definitions in the client definition file managed by an HADB client, specify the same definitions also in the client definition file used by the function for centrally managing client definitions.

After creating the client definition file to be used by the function for centrally managing client definitions, store the file in the server directory $ADBDIR/conf. You can rename the client definition file from the name of the template (client.def).

If you want to apply the definitions in different client definition files to multiple authorization identifiers, create as many client definition files as needed that are used by the function for centrally managing client definitions.

(2) Client management definition file

In the client management definition file, the adbclientmang operand in the client-managing definition is specified. For the adbclientmang operand, specify the following two items to associate them.

Items specified for the adbclientmang operand in the client-managing definition:
  • Name of the client definition file used by the function for centrally managing client definitions

  • Authorization identifier of the HADB user for which you want to apply the definitions in the client definition file

The template of the client management definition file (adbclientdefmang.def) is stored in the server directory $ADBDIR/sample/conf. Copy the template, and in the new file, specify the adbclientmang operand in the client-managing definition.

After creating the client management definition file, store the file in the server directory $ADBDIR/conf. Keep the file name the same as the template (adbclientdefmang.def).

In the following cases, the function for centrally managing client definitions is not applied:

In these cases, the definitions specified in the client definition file managed by the HADB client are applied.

(a) Specification format of the client-managing definition

{{
  [adbclientmang
     -f client-definition-file-used-by-the-function-for-centrally-managing-client-definitions
     -i authorization-identifier[,authorization-identifier]...]
}}

The specification rules for the client-managing definition are the same as ones for the server definition. For details about the specification rules for the server definition, see 7.3 Syntax rules for the server definition.

(b) Explanation of specification format of the client-managing definition

-f client-definition-file-used-by-the-function-for-centrally-managing-client-definitions

~<character string> ((1 to 255 bytes))

Specify the name of the client definition file used by the function for centrally managing client definitions.

For this option, specify only the name of the client definition file that is stored in the server directory $ADBDIR/conf. A specification example follows.

Specification example (when the client definition file name is client01.def)
-f client01.def

You can also specify the same file name for the -f option of multiple adbclientmang operands. A specification example follows. Specification example 1 and 2 are both dealt with as the same definition.

Specification example 1
adbclientmang -f client01.def -i ADBUSER01,ADBUSER02
Specification example 2
adbclientmang -f client01.def -i ADBUSER01
adbclientmang -f client01.def -i ADBUSER02

If one of the following conditions applies to the content specified for the -f option, an error occurs:

  • The specified file does not exist under the $ADBDIR/conf directory.

  • A directory name is specified in addition to a file name.

  • There is a mistake in the contents of the client definition file specified for this option.

-i authorization-identifier

~<character string> ((1 to 100 bytes))

Specify the authorization identifier of the HADB user who connects to the HADB server by applying the definitions in the client definition file specified for the -f option.

The authorization identifier specified for this option must be 1 to 100 bytes long. The double quotation marks enclosing the authorization identifier are excluded from the length of the authorization identifier.

For this option, you can specify multiple authorization identifiers by delimiting them with a comma. A specification example follows.

Specification example (when the authorization identifiers of the HADB users are ADBUSER01 and ADBUSER02)
-i ADBUSER01,ADBUSER02
Important

If there is a lowercase letter in the character string for the authorization identifier, be sure to check the specification rules for authorization identifier. For details about the specification rules for authorization identifiers, see 9.4.2 Authorization identifier specification rules.

If one of the following conditions applies to the content specified for the -i option, an error occurs:

  • The same authorization identifier is repeatedly specified for the -i options.

  • The same authorization identifier is specified for the -i options of multiple adbclientmang operands.

  • The total number of authorization identifiers specified for all -i options exceeds 30,000.

(3) Client definition files managed by HADB clients

Even when you use the function for centrally managing client definitions, you need to create the client definition files that are managed by individual HADB clients.

Note

For details about how to create the client definition file managed by an HADB client, see How to create a client definition in the HADB Application Development Guide.

For the client definition file managed by an HADB client, specify the operands in the client definition to which the function for centrally managing client definitions is not applied. Such operands include the host name and port number of the connection-target HADB server. For details about individual operands in the client definitions that are not applied to the function for centrally managing client definitions, see Notes about using the function for centrally managing client definitions in the HADB Application Development Guide.

For the client definition file managed by an HADB client, you do not have to specify the operands in the client definition to which the function for centrally managing client definitions is applied.

Specify the operands in the client definitions to which the function for centrally managing client definitions is applied, in the client definition file used by the function for centrally managing client definitions. If an operand is omitted, the default value is assumed.