Product Documentation

Using the Installation Manager Console

Jul 21, 2010
The Installation Manager console contains standard MMC panes and the following custom panes:
  • The Task pane lists tasks created using Installation Manager. This information is stored in the file share as IMTask.xml.
  • The Target pane displays the results on each target server of the task selected in the Task pane. This information is stored in subdirectories of the shared folder as ImTaskResult.xml. The display refreshes automatically every ten minutes. To manually refresh the display, click Refresh in the Actions pane.
  • The lower pane displays the PowerShell cmdlet equivalent of an action selected in the Actions pane. For example, if you select a task named InstallApp in the Task pane and a target server named srv2 in the Target pane, then click Refresh in the Actions pane, the lower pane displays:

    Get-IMTask –Name “InstallApp” –Targets srv2 –Log “\\im\InstallApp\IMTaskResult.xml”

To schedule installation of an MSI or MSP package

To schedule installation of MSI or MSP packages using Installation Manager, the Utilities package must be installed on the target servers.

From the Installation Manager console, click Schedule MSI package distribution in the Actions pane. In the Schedule MSI Package Distribution dialog box:
  • Enter the name of the task. The task name must start with an alphabetic character. The name must be unique, unless you click Advanced and select Overwrite existing task definition in the Advanced Options dialog box. When you select this option, the task is updated with the new definition.
  • In the Target list, specify the target servers where you want to install this package. Click Servers to select from Active Directory or XenApp server folders, or enter a comma-delimited list of servers by DNS name.
  • In MSI/MSP file path, enter the location of the MSI or MSP package to be scheduled for installation. To include a transform file, specify its location in MST list.

    To make the MSI, MSP, and MST files available from a single shared folder accessible by all target servers, click Advanced and specify a Shared folder in the Advanced Options dialog box. Any selected MSI, MSP, and MST files will be copied to this folder, if not already present. Installation Manager assigns read permission from the target servers to the file share.

  • Enter the date and time to start the installation in Schedule date and time, or select Now to launch the task immediately.
  • Use Session Options to specify what happens to user sessions on the target servers during and after the installation process.
    Option What happens when selected
    Disable session logon during installation process Prevents users from logging on during the installation.
    Logoff existing sessions Forces users to log off the server before launching the installation. You can specify how long to wait before users are logged off; you can also send a message to logged-on users that instructs them to save their work and log off.
    Reboot target after successful installation Restarts the server after installation. You can specify how long to wait after the installation completes to restart the server.
  • If Installation Manager fails to schedule a task on a server (for example, when a server is offline), it tries to reschedule the task. To specify how long Installation Manager will retry, and the interval between retries, click Advanced and specify Retry Interval values. (If you specify a retry time or retry interval, you must specify both values; otherwise, an error occurs.)

To schedule installation of MSI or MSP packages using a PowerShell cmdlet, see Create-IMMSITask.

To schedule installation of a Task Scheduler file

You should be familiar with using Task Scheduler; see the Microsoft documentation for information. Use the Task Scheduler MMC to create the Task Scheduler file. Installation Manager passes the Task Scheduler file directly to Windows Task Scheduler; it is not transferred using the file share.

From the Installation Manager console, click Distribute Windows Task Scheduler file in the Actions pane. In the distribute Windows Task Scheduler File dialog box:
  • Enter the name of the task. The task name must start with an alphabetic character. The name must be unique, unless you click Advanced and select Overwrite existing task definition in the Advanced Options dialog box. When you select this option, the task is updated with the new definition.
  • Enter the location of the Task Scheduler file in Task XML file.
  • In the Target list, specify the target servers where you want to install this task. Click Servers to select from Active Directory or XenApp server folders, or enter a comma-delimited list of servers by DNS name.
  • If Installation Manager fails to schedule a task on a server (for example, when a server is offline), it tries to reschedule the task. To specify how long Installation Manager will retry, and the interval between retries, click Advanced and specify Retry Interval values. (If you specify a retry time or retry interval, you must specify both values; otherwise, an error occurs.)

To schedule installation of Task Scheduler Files using a PowerShell cmdlet, see Create-IMTask.

To schedule installation of a command-line task

From the Installation Manager console, click Schedule command-line task in the Actions pane. In the Schedule command-line task dialog box:
  • Enter the name of the task. The task name must start with an alphabetic character. The name must be unique, unless you click Advanced and select Overwrite existing task definition in the Advanced Options dialog box. When you select this option, the task is updated with the new definition.
  • In the Target list, specify the target servers where you want to install this task. Click Servers to select from Active Directory or XenApp server folders, or enter a comma-delimited list of servers by DNS name.
  • Enter the command, or the location of the command, you want to execute on the target servers. If you enter a path, the command must be available to execute on the target servers at the specified path, or it must be available in the profile “PATH.” To make a command available from a single shared folder accessible by all target servers, click Advanced and specify a Shared Folder in the Advanced Options dialog box.
  • Enter the date and time to start the installation in Schedule date and time, or select Now to launch the task immediately.
  • If Installation Manager fails to schedule a task on a server (for example, when a server is offline), it tries to reschedule the task. To specify how long Installation Manager will retry, and the interval between retries, click Advanced and specify Retry Interval values. (If you specify a retry time or retry interval, you must specify both values; otherwise, an error occurs.)

To schedule installation of a command-line task using a PowerShell cmdlet, see Create-IMCMDTask.

To associate published applications with servers

After you use Installation Manager to install an application on a XenApp server, use this procedure to add the XenApp server to a preexisting published application object. This results in XenApp including that server when it load balances session requests to that application.
  1. From the Installation Manager console, select a task in the Task pane and then click Publish Application in the Actions pane.
  2. Click Browse and then enter the name of the XenApp server where Installation Manager will retrieve the list of published applications.
  3. Click Go and select the published application from the list.

To reschedule a task

Rescheduling creates a copy of the task, so you can change its parameters. You can reschedule command-line tasks and MSI/MSP package deployments.
  1. From the Installation Manager console, select a task in the Task pane and then click Reschedule in the Actions pane.
  2. In the Reschedule CMD Task or Reschedule MSI Task dialog box, change field values as needed.

To remove a scheduled task

Removing a Task Scheduler entry does not remove the task from the list in the MMC. If you remove a task that has already executed, this action removes only its Task Scheduler entry; it does not undo the installation or deployment of files.

From the Installation Manager console, select a task in the Task pane and then click Remove in the Actions pane.

To remove scheduled tasks using a PowerShell cmdlet, see Remove-IMTask.