Running BEXCollect

To run the BEXcollect utility, from the tools folder (Windows) or misc directory (UNIX) of the product directory, enter:

bexcollect <job_id> (if using the older module-based logging model)

The 10-digit Job_ID can be easily found by browsing the job monitor. See Monitoring Jobs in the User’s Guide.

The BEXcollect utility examines the Enterprise and collects log files in the Enterprise related to the specific job. Log files include information such as job tasks, task start-stop times, nodes involved, tape drives and disks involved, and tape status.

Other variations of this command are:

bexcollect -n <job_id> (if -n is inserted, the results will include common logs from client nodes)

bexcollect -x <client_node__name> (the results will encompass all logs from the specified client node). Note that the -x variation is only available for Windows.

Note that if one runs bexcollect from the command-line without specifying any options, instructional text is displayed. The options are further described in Catalogic Knowledge Base article 47223 BEXCollect Usage.

The result of bexcollect is a set of .tar files, which are placed in the logs directory of the product directory on the master server. The logs directory will contain two types of output files:

master-<jobid>.tar	This is the file for the master server.
<nodename>-<jobid>.tar	One file will appear for each node involved in the job.

The logs collection utility has the following system requirements:

The utility requires Perl on the master server and involved nodes. Therefore, the utility is supported on platforms that come with Perl pre-installed, which includes most platforms supported by DPX. If Perl is not present on a node, you will need to install it to run bexcollect, then update the system search PATH accordingly and restart cmagent. See Managing the CMAgent Service.

Note. A Perl installation executable can be found on nodes within the tools subdirectory. Note that this executable is provided as a convenience and is not a Catalogic product. Catalogic Software does not make any recommendation regarding the specific version and/or release of Perl and does not provide any warranty, implicit or otherwise, of this Perl product.