Network Deployment (Distributed operating systems), v8.0 > Set up the application serving environment > Administer nodes and resources > Administer nodes remotely using the job manager > Submit jobs > Submit jobs to manage files

Collecting files for the job manager

In a flexible management environment, you can submit the Collect file job to copy a single file or a directory of files from managed targets, which can be hosts or nodes, to the job manager. You might collect files before submitting jobs that use the files. For example, you might collect and then distribute an enterprise application before you install or update the application on managed application server targets. Similarly, you might collect and then distribute a properties file to managed application server targets before you apply the file to configure the application servers.

Start the job manager. Ensure that the targets from which to copy a file are registered with the job manager.

If you are collecting a file on a host, first register the host with the job manager.

If a target is dmgr, start the dmgr. If a target is a stand-alone application server, start the admin agent.

Your ID at the job manager must be authorized for the administrator role or the operator role to submit jobs. When you submit a job, you can specify a user name and password for authentication and authorization at the target or targets. When you submit a job to multiple targets, the user name and password or the credentials for the submitter must apply to all the job targets.

You can simplify administration of a large number of targets by submitting jobs against groups of targets. Before you can submit a job for a group of targets, create the group of targets.

We can use the administrative console of the job manager or the dmgr to submit a job that transfers a file or directory of files from targets to the job manager. From the console, choose the Collect file job, specify the file or directory to transfer, specify job options, schedule the job, review the summary, and submit the job. When the job runs, the job manager copies the file from the application server or dmgr profile directory to the job manager profile config/temp/JobManager/jobToken/targetName directory.

When collecting a directory from a node, the job recursively zips the directory contents and copies the resulting compressed format file. When collecting multiple files from a host, you can specify wildcards in the filename.

This topic describes how to run the Collect file job using the job manager console or the dmgr console. Instead of using a console, you can run the collectFile job script in the AdministrativeJobs command group. See the Administrative job types topic.

Procedure

1. For nodes, determine the location of the file or directory to collect relative to the PROFILE_ROOT directory of the target.

   For example, suppose that you want to collect the DynaCacheEsi.ear file from the PROFILE_ROOT/AppSrv01/config/cells/node1Cell/applications/DynaCacheEsi.ear directory. AppSrv01 is the target node profile name. AppSrv01 is a stand-alone application server. node1Cell is the AppSrv01 cell name. The location of the DynaCacheEsi.ear file relative to the profile root, AppSrv01, is config/cells/node1Cell/applications/DynaCacheEsi.ear

   For hosts, you can collect one or more files from any location of the hosts if your user ID has the correct permissions.

2. Click Jobs > Submit from the navigation tree of the administrative console.

3. Choose the job.

   1. Select the Collect file job type from the list.

   2. Optionally describe the job.

   3. Click Next.

4. Choose the targets from which to collect the file or directory.

   1. Select a group of targets from the list, or select Target names.

      Only target groups that are valid for the job type that you selected are displayed in the list of target groups.

      The target can be a host. However, you can only collect a file from a host. We cannot collect a directory from a host.

   2. If you selected Target names, then specify a target name and click Add, or click Find and specify the chosen targets on the Find targets page.

      Select the target from which to collect a file or directory.

      To continue with the example in step 1, suppose the AppSrv01 profile is registered with the job manager as nodeA. Select nodeA.

   3. If user authentication is required, specify a user name, password, or any other authentication values as needed.

   4. Click Next.

5. Specify parameters for the collect file job.

   1. For Source, we have different options depending on if you are collecting files from a host or from a node:
      • Node: specify the path of the file or directory that you want to collect, relative to the PROFILE_ROOT directory of the target.

        For example, to collect the DynaCacheEsi.ear file from the PROFILE_ROOT/AppSrv01/config/cells/node1Cell/applications/DynaCacheEsi.ear directory, specify the following path:

        config/cells/node1Cell/applications/DynaCacheEsi.ear/DynaCacheEsi.ear
        

        To collect a directory such as the logs directory under the PROFILE_ROOT of the target, specify logs in the Source field.

      • Host: Specify a fully qualified path of the file. There are no restrictions on the source. We can specify files using wildcards. Supported wildcard characters are (*) and (?).
        • Asterisk (*) – for multiple unknown or variable characters in the term.
        • Question mark (?) – for a single unknown or variable character in the term.

      Optional. For Destination, specify a destination name for the file or directory that is being copied to the job manager.

      By default, the file or directory is placed in the job_manager_profile/config/temp/JobManager/jobToken/targetName directory. The file or directory retains its name unless you specify a different name in the Destination field. For the DynaCacheEsi.ear example, if you do not specify a value for Destination, the product copies the DynaCacheEsi.ear file to a directory such as PROFILE_ROOT/JobMgr01/config/temp/JobManager/124517860634322577/nodeA. In this example, JobMgr01 is the name of the job manager profile, 124517860634322577 is the job token identifier, and nodeA is the target from which the file was copied. The DynaCacheEsi.ear file is placed in the nodeA directory.

      • Node

        Suppose that you want the DynaCacheEsi.ear file to have a name such as dynacache_esi_sample in the nodeA directory. If you specify dynacache_esi_sample for Destination, the DynaCacheEsi.ear file is copied to the PROFILE_ROOT/JobMgr01/config/temp/JobManager/jobToken/nodeA directory, where it has the name dynacache_esi_sample.

      • Host

        If you chose to specify a destination for a host, specify a directory. When collecting a file from a host, the destination cannot be a file name.

      If you specify a Destination value, remember the value. If you later run a job that references the collected file or directory, you can use the destination value to identify the file or directory.

   2. For Distribution provider, if you use a distribution provider other than the default distribution provider, specify the name of the distribution provider. For the DynaCacheEsi.ear file or logs directory example, do not specify a value and use the default distribution provider.

   3. Click Next.

6. Schedule the job.

   The times and dates that you specify are relative to the job manager.

   1. Optionally specify one or more email addresses where notifications are sent when the job finishes.

      If you specify multiple email addresses, separate them with commas. The email addresses are saved in your console preferences. Each email address is validated for format errors.

   2. Select when the job is available for submission.

      We can submit the job to be available now, or specify a time and date that the job is retrieved from the job manager.

   3. Select the job expiration.

      The job expiration is the time at which the job will no longer be available for targets to run. We can use the default expiration, specify a time and date for the job expiration, or specify an amount of time in which the job expires. The default expiration is defined on the Job manager configuration panel.

   4. Optionally specify a recurring interval for the job, a start date and time for the interval, and an end date and time for the interval.

   5. Click Next.

7. Review the summary, and click Finish to submit the job.

Results

The job manager copies the file or directory into the job_manager_profile/config/temp/JobManager/jobToken/targetName directory. The name of the collection file or directory is the destination. If you did not specify a destination value, then the file or directory retains its original name.

For the DynaCacheEsi.ear example, the file is copied to the job_manager_profile/config/temp/JobManager/jobToken/nodeA directory.

What to do next

On the Job status page, click the ID of the collect file job and view the job status. Click the status refresh icon to refresh the displayed status.

If the job is not successful, view any error messages that result from running the job, correct the error condition, and submit the job again.

If the job manager successfully copies the file or directory from the targets to the job manager, you can submit jobs that distribute collected files.
Job manager
Set up a job manager environment
Start and stop the job manager
Start and stop the admin agent
Start and stop the dmgr
Start and stop a node
Administer nodes remotely using the job manager
Administer groups of nodes for the job manager
Check job status
Distribute files from the job manager to targets

Related

Administrative job types using wsadmin.sh
Find targets
Find target resources

+

Search Tips   |   Advanced Search