ajsembdbinstl
- Organization of this page
Format
ajsembdbinstl -s embedded-database-installation-media-storage-directory [-mh logical-host-name] [-i embedded-database-installation-previous-directory] [-id setup-identifier] [-v9standard]
Description
The ajsembdbinstl command installs the JP1/AJS3 standard database (embedded database).
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3-installation-folder\tools\
- In UNIX:
-
/opt/jp1ajs2/tools/
Arguments
-s embedded-database-installation-media-storage-directory
Specify the absolute path name of the directory that will store the embedded database installation media.
You must specify the following directory:
- In Windows:
-
JP1/AJS3-installation-folder\tools\AJS3DB
- In UNIX:
-
/opt/jp1ajs2/tools/AJS3DB
If the absolute path name you specify contains a space or parenthesis, enclose the entire path name in double quotation marks (").
-mh logical-host-name
Specify the name of the logical host on which you want to install the embedded database. You can specify a character string of 1 to 32 bytes.
If you are using the physical host, you do not need to specify this option.
-i embedded-database-installation-previous-directory
Specify the absolute path name of the directory in which you want to install the embedded database. You can specify a character string of 1 to 118 bytes.
Make sure that you specify a path name that begins with a drive name.
The following shows the characters that can be used to specify the absolute path name.
- For Windows
-
Alphanumeric characters, space characters, path separators (\), periods (.), underscores (_), left parentheses ((), and right parentheses ())
- For UNIX
-
Alphanumeric characters, underscores (_), and slants (/)
If the absolute path name you specify contains a space or parenthesis, enclose the entire path name in double quotation marks (").
If this option is omitted, the following directory is assumed.
- In Windows:
-
JP1/AJS3-installation-folder\embdb\_JFn
- In UNIX:
-
JP1/AJS3-installation-directory/embdb/_JFn
For n above, the n value in the setup identifier specified for the -id option is used.
For the -id option, make sure that you specify a directory that exists on a local disk.
When executing this command, you need to secure sufficient free space in the disk for the directory in which the embedded database is to be installed. For details about the required free space, see the Release Notes.
-id setup-identifier
Specify a four-character setup identifier, _JFn (n: 0 to 9 or A to Z), which identifies the embedded database.
If you omit this option, the system assumes _JF0.
-v9standard
This option is provided for compatibility and is specified to configure an embedded database with the method used in a version earlier than 10-00. Normally, it is not necessary to specify this option.
The following are differences between when this option is specified and when it is omitted:
- In Windows:
-
- When the -v9standard option is specified
-
-
The JP1/AJS3 Database ClusterService service is created.
-
The startup type of the JP1/AJS3 Database service is automatic.
-
- When the -v9standard option is omitted
-
-
The JP1/AJS3 Database ClusterService service is not created
-
The startup type of the JP1/AJS3 Database service is manual.
-
- In UNIX:
-
- When the -v9standard option is specified
-
The pdprcd process starts from inittab.
- When the -v9standard option is omitted
-
The pdprcd process starts from the pdmgrd process.
If an overwrite installation is performed with the -v9standard option specified for an embedded database whose startup type for the JP1/AJS3 Database service is set to manual, the startup type does not change to automatic.
If an overwrite installation is performed with the -v9standard option omitted for an embedded database whose startup type for the JP1/AJS3 Database service is set to automatic, the startup type changes to manual.
Notes
-
If the return value of this command is not 0, the following message is output: Database install failed (error code=yy). In yy, the return value is indicated. If this message is output, take action appropriate for the indicated return value. For details, see 2.8.8(2) Action to be taken if an error occurs during installation of the embedded database in the manual Job Management Partner 1/Automatic Job Management System 3 Troubleshooting.
-
If Windows Firewall is used, you must add the embedded database to the Windows Firewall exceptions list.
After execution of the ajsembdbinstl command has been completed, execute the following command:
embedded-database-installation-previous-directory\bin\pdsetfw setup-identifier
-
In UNIX, when you install the embedded database by specifying the -v9standard option, the entry of the embedded database is registered in the /etc/inittab directory (in Linux, the /etc/init directory). When an overwrite installation is performed for the embedded database, the entry of the embedded database in the /etc/inittab directory is deleted and then re-registered. Therefore, the order of the entries in the /etc/inittab directory might change.
When you install the embedded database by omitting the -v9standard option, if the entry of the embedded database to be installed already exists, it is deleted and not re-registered.
-
If pd_mode_conf=AUTO is specified in the system common definition file of the embedded database, the embedded database might automatically start after the overwrite installation. When the embedded database starts, stop it before the JP1/AJS3 service starts.
-
Do not execute this command repeatedly in quick succession.
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |