jbsrt_distrib
- Organization of this page
Function
The jbsrt_distrib command is executed on a manager host (i.e. host on which JP1/IM - Manager is installed).
This command distributes information defined in the configuration definition file from the host on which the command is executed to lower-level hosts, and then the definitions are enabled.
If the configuration definition information has already been set, the existing configuration definition is deleted, and then the new configuration definition is distributed.
Before executing this command, JP1/Base must have started on the target lower-level hosts to which the configuration definition is distributed. If JP1/Base has not started yet on a target host, the configuration definition will not be distributed to the host. If this happens, a message is displayed during command execution, notifying you that the configuration information cannot be set. By continuing the process, the configuration definition is distributed to other hosts on which JP1/Base has started. To distribute the configuration definition to a host to which it cannot be distributed, start JP1/Base on the host, and then re-execute the jbsrt_distrib command. When a message asking you to delete the configuration definition information appears, enter N to distribute the configuration definition to the host. This completes the distribution of the configuration definition in the entire system.
The following configuration definition file is referenced by this command:
- In Windows:
-
installation-folder\conf\route\jbs_route.conf
shared-folder\jp1base\conf\route\jbs_route.conf (when the -h option is specified)
- In UNIX:
-
/etc/opt/jp1base/conf/route/jbs_route.conf
shared-directory/jp1base/conf/route/jbs_route.conf (when the -h option is specified)
For details on the format of the definition file, see the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.
Format
jbsrt_distrib [-h logical-host-name]
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-h logical-host-name
When using JP1/Base in a cluster system, specify the logical host for which you will execute the command. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed. There is no need to specify this argument unless you are running a cluster system.
Note
If configuration information is deleted during system operation, the following problems might occur between the time the file was deleted and the time the file finishes being distributed:
-
An event transfer might fail.
-
Command execution might fail.
-
Automatic action execution might fail.
When a management-target host is added but no hosts are deleted, follow the procedure below to distribute the configuration files without deleting any configuration information. The following procedure allows you to change the system configuration without affecting the existing configuration information.
-
If the message Delete the current configuration definition? is output, enter N.
-
If the message Distribute the configuration definition? is output, enter Y.
When you execute this command to delete configuration definition information, the configuration definition information after a host with an asterisk (*), if any, in the configuration definition file will not be deleted. If you want to delete the existing configuration definition information, confirm that there is no asterisk (*) in the configuration definition file.
If you are using the IM configuration management and execute this command, configuration definition information will be different in the IM configuration management and in JP1/Base. Therefore, if you are using the IM configuration management, we recommend that you do not execute this command, and instead use the IM configuration management to perform integrated configuration management. For details, see the chapter that explains management of hierarchical structure of a system using the IM configuration management in the Job Management Partner 1/Integrated Management - Manager Overview and System Design Guide.
Return values
|
0 |
Normal end |
|
1 |
Abnormal end |