Submitting jobs to manage profiles on a remote host

We can submit the Manage profiles job to create, delete, augment, back up, list, and restore profiles on remote hosts. Profiles are sets of files that define the runtime environment. On local host computers, we can use the manageprofiles command or the Profile Management Tool to manage profiles. After a remote host computer is registered with a job manager, we can use the Manage profiles job to run the manageprofiles command on the remote host. The remote host must have a WAS installation.

Restriction: The Manage profiles job is only available on distributed and IBM i operating systems. It is not available on z/OS operating systems.

Before we can run the Manage profiles job, complete each of the following steps:

We can use the administrative console of the job manager or the deployment manager to submit a job that manages profiles of a remote WebSphere Application Server installation. From the console, choose the Manage profiles job, specify the remote host computer, specify job options, review the summary, and submit the job. When the job runs, the job manager performs the profile management tasks described in the response file and changes the profile configuration in the product installation on the remote host.

Instead of using a console, we can run the manageprofiles job script in the AdministrativeJobs command group. See the topic on administrative job types.

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

  2. Choose a job to manage the profiles of a remote host target.

    1. Select the Manage profiles job type from the list.

      The Manage profiles job is only available in the list if the job manager has a host as a target. Stand-alone application servers or deployment managers registered with the job manager are targets, but not hosts.

    2. Optionally specify a description of the job.

    3. Click Next.

  3. Choose the job targets.

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

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

      On the Find targets page, the job type is automatically set to manageprofiles to filter search results. Click Find on this page to view the list of hosts in the Excluded targets list. Select the target, click > to move the host name to the Chosen targets list, and then click OK.

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

    4. Click Next.

  4. Specify job parameters.

    1. For WebSphere Application Server home, specify the location of the product installation on the host.

      Specify the app_server_root directory.

      For example, suppose the remote host computer has a Windows operating system and a WAS Version 8.0 installation with an app_server_root directory of C:\WAS_v850\IBM\WebSphere\AppServer. Specify the following path:


      When the job runs, the product appends \bin to the path specified to run the manageprofiles command on the remote host. If we use double-backslashes (\\) or a forward slash (/) for directory separators, the job fails with an error. For Windows operating systems, use a single backslash (\) as a directory separator.gotcha

    2. For Response file location, specify the fully qualified path of the response file.

      The response file contains instructions for the manageprofiles command of the product installation on the host.

      For example, specify the location of the test_response_file.txt response file described in the "Before beginning" section of this topic to create the profile test1 in the installation on the host. In this example, the response file is in the temp directory of the same computer on which the job manager resides:




    3. Click Next.

  5. Schedule the job.

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


The job manager runs the job. The manageprofiles command on the host changes the profile configuration in the product installation as instructed in the response file.

For the test_response_file.txt example, a profile named test1 is created on the host.

What to do next

On the Job status page, click the ID of the manageprofiles job and view the job 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.

Related tasks

  • Start and stop the job manager
  • Start and stop the administrative agent
  • Start and stop the deployment manager

    manageprofiles command

  • Administrative job types
  • New target settings
  • Find targets
  • Find target resources