9.6 Managing Deployment Tasks

A deployment task indicates an installation package you want to install on a certain computer based on the criteria met in a deployment rule. When the agent computer meets the criteria for a deployment rule, the Deployment Service generates a deployment task.

Before you can deploy a module to an agent computer, the AppManager agent must be installed. For example, if you configure a rule to install the AppManager agent and module for Microsoft Internet Information Services (IIS), the Deployment Service does not generate the deployment task for IIS until after you deploy the AppManager agent on the agent computer.

HINT:If a package is already installed on the agent computer, the Deployment Service does not generate a deployment task. For example, if you configure a rule to install the AppManager agent and module for Microsoft SQL Server, if the same version of the agent is already installed on the agent computer, the Deployment Service only creates the deployment task to install AppManager for Microsoft SQL Server.

9.6.1 Viewing Deployment Tasks

To view a list of all deployment tasks, log in to the Control Center console with an account that has permissions to work with tasks and in the Navigation pane select the Deployment view. Then select Tasks. The Deployment\Tasks view displays a list of all deployment tasks. You can group by Computer to view all deployment tasks for an agent computer.

You can configure how to display this information. For more information, see Section 3.2.3, Deployment Options.

9.6.2 Approving Deployment Tasks

You must approve deployment tasks, including scheduled deployment tasks, before Control Center installs the installation package on the agent computer identified in a deployment task. For more information, see Section 9.5.8, Deployment Schedule.

To approve a deployment task:

  1. Log in to Control Center with an account that has permissions to work with tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want to approve and in the Tasks tab, click Approve Deployment Task.

    To select multiple tasks, press Ctrl or Shift while making your selections. The task will become Active or Scheduled. After the task is completed, its status will be updated to indicate whether it ran successfully. If you configured email notification, the task will notify the list of email recipients once it completes.

9.6.3 Rejecting Deployment Tasks

You cannot run a deployment task until you approve it. If you do not want to run a task that is Waiting for Approval, you can reject the task. When you reject a task, its status changes to Rejected.

After you reject a deployment task, you cannot approve or configure the task. To configure a task that is Rejected, delete the task and wait for the deployment rule to generate a new task.

If you update the deployment rule that generated the deployment task, the Deployment Service does not generate a new task until you delete the Rejected task. For more information about deleting a task, see Section 9.6.4, Deleting Deployment Tasks.

To reject a deployment task:

  1. Log in to Control Center with an account that has permissions to work with tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks tab click Reject Deployment Task.

9.6.4 Deleting Deployment Tasks

You can delete a task to remove it from the list. If you delete a task that is Scheduled or Waiting for Approval, and the rule that generated the task is enabled, the Deployment Service automatically generates a new deployment task. You cannot delete an Active task.

You can configure the Control Center console to automatically delete Completed deployment tasks and to hide tasks that are older than a specified period. For more information, see Section 3.2.3, Deployment Options.

When deleting a task, you are prompted to confirm that you want to delete the task. You can disable the confirmation to delete a task by configuring the Control Center options. For more information, see Section 3.2.3, Deployment Options.

To delete a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want to delete.

    To select multiple tasks, press Ctrl or Shift while making your selections. If the tasks in the list are grouped, for example, by Computer, first expand the group and then select the tasks. You cannot select the group to delete more than one task.

  5. In the Tasks tab, click Delete Deployment Task.

9.6.5 Viewing the Deployment Rules for Deployment Tasks

You might want to view the deployment rule that generated a deployment task you want to run, reject, or delete.

To view information about the rule that generated a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks tab click View Rule.

9.6.6 Changing the Schedule for Deployment Tasks

You might want to configure a different schedule for a deployment task after the Deployment Service generates the task.

To change the schedule for a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks tab click Schedule Deployment Task.

  5. In the Edit Task Schedule window, update the schedule. For more information, see the Help.

  6. Click OK.

9.6.7 Configuring the Installation Package for Deployment Tasks

If the installation package for the deployment task requires configuration, you can configure the installation package either before or after you approve the task. For example, if you approve a task and it encounters a problem, you can configure the installation package and then re-activate the task. For more information, see Section 9.6.9, Re-activating a Deployment Task.

You cannot configure tasks that are Running, Rejected, or Completed.

To configure a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks tab click Configure. Note that only tasks that require configuration are selectable for configuration. For more information, see the Help.

9.6.8 Changing the Credentials for a Task

If a deployment task fails because of the credentials, you can change the credentials and re-activate the task. For more information, see Section 9.6.9, Re-activating a Deployment Task.

To change the credentials for a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks pane click Change Credentials.

  5. In the Package Credentials window, update the credentials. For more information, see the Help.

  6. Click OK.

9.6.9 Re-activating a Deployment Task

If a deployment task encounters an error, you can update the task properties and then re-activate the task to enable it to run on its specified schedule. For example, if the credentials for the deployment task are invalid, update the credentials for the task and then re-activate the task.

To re-activate a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the deployment task you want and in the Tasks tab click Reactivate Deployment Task.

    If you configured email notification, AppManager notifies the list of email recipients after the deployment task is completed.

9.6.10 Viewing the Properties of a Deployment Task

You can view the properties of a deployment task to check when it is scheduled to run or review any other information about the task.

To view the properties of a deployment task:

  1. Log in to Control Center with an account that has permissions to work with deployment tasks.

  2. In the Navigation pane, click Deployment.

  3. Click Tasks to view a list of available deployment tasks.

  4. Click the task you want and in the Tasks tab click Deployment Task Properties.

    In the Deployment Task Properties window, information about the task is displayed. For more information, see the Help.

9.6.11 Refreshing the List of Deployment Tasks

When you create, enable, and approve a deployment rule, the Deployment Service generates a deployment task. If you want to view the deployment task that the Deployment Service generates, you need to refresh the Tasks view. To refresh the list of tasks, in the ribbon click Refresh Current View or press F5.