Software Delivery Solution 6.1 For Windows: Product Guide

ALTIRIS
SOFTWARE DELIVERY SOLUTION 6.1 FOR WINDOWS PRODUCT GUIDE
Notice
Copyright 2001-2005 Altiris Inc. All rights reserved. Product Version: 6.1 Document Date: February 3, 2005 Bootworks U.S. Patent No. 5,764,593. RapiDeploy U.S. Patent No. 6,144,992. Recovery Solution U.S. Patent No. 5,778,395, 5,907,672, 4701745, 5016009, 5146221, 5144425, 5463390, 5506580, 5532694, GB 2172127, B 904359, 3606869. Other patents pending. Due to the inherently complex nature of computer software, Altiris does not warrant that the Altiris software is error-free, will operate without interruption, is compatible with all equipment and software configurations, or will otherwise meet your needs. The content of this documentation is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Altiris. Altiris Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this documentation. For the latest documentation, visit our Web site at www.altiris.com. Altiris, the Altiris logo, BootWorks, Inventory Solution, LabExpert, PC Transplant, RapiDeploy, and RapidInstall are registered trademarks of Altiris, Inc. in the United States and in other countries. Carbon Copy is a registered trademark licensed to Altiris, Inc. in the United States and a trademark of Altiris, Inc. in other countries. Altiris eXpress, Altiris Protect, Application Management Solution, Application Metering Solution, Asset Control Solution, Asset Management Suite, Client Management Suite, Compliance Toolkit, Connector Solution, Conflict Analysis Solution, Contract Management Solution, Deployment Server, Deployment Solution, Energy Saver Toolkit, Education Management Suite, Helpdesk Solution Software, Lab Management Suite, Migration Toolkit, Mobile Client for SMS, Monitor Solution, Notification Server, Patch Management Solution, Problem Management Suite, Recovery Solution, Server Management Suite, Site Monitor Solution, Software Delivery Solution, TCO Management Solution, UNIX Client for SMS, Web Administrator for SMS, Web Reports, and other product names are trademarks of Altiris, Inc. in the United States and other countries. Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries. HP and Compaq are registered trademarks of the Hewlett-Packard Corporation. Dell is a registered trademark of Dell Inc. Macintosh is a registered trademark of the Apple Computer Corporation. Palm OS is a registered trademark of Palm Computing, Inc. BlackBerry is a service mark and a trademark of Research In Motion Limited Corporation. RIM is a service mark and trademark of Research In Motion (RIM) All other brand names are trademarks or registered trademarks of their respective companies.
Altiris Software Delivery Solution for Windows Product Guide
Contents
Software Altiris Product Guide Delivery Solution 6.1 for Windows
Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Chapter 1: Introducing Altiris Software Delivery Solution for Windows . . . . . . . . . . . . . . . . . . . . . . . 5 Software Delivery Overview ........................................................... 5 Chapter 2: Installing Altiris Software Delivery Solution for Windows . . . . . . . . . . . . . . . . . . . . . . . . . 7 Planning Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Notification Server and SQL Server ................................................. 7 Prerequisites Registration ...................................................................... 8 .................................................... 8 ....................................................................... 8 ..................................................... 9 ................................................. 9 Installing Software Delivery Solution
Chapter 3: Getting Started with Software Delivery Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Software Delivery Usage Overview Using Multicasting Software Delivery Solution Components
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 13 13 14 15 15 16 16 16 22 23 23 23 24 24 25 25 25 26 30
Chapter 4: Using Software Delivery Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Using Software Packages and Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Packages Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Package Download Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating a Package ............................................................ Defining a Program for a Package ................................................. Checking for Package Download Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing the Check for Updated Package Files Schedule .............................. Software Package Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Software Delivery Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Delivery Task Priority ................................................... Software Delivery Task Status Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disabled Software Delivery Tasks ................................................. Creating a Software Delivery Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specifying Software Delivery Task Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Verifying that a Policy Has Been Successfully Delivered to the Altiris Agent Computer ........ Policy Scheduling on Altiris Agents ................................................ Scheduling Software Delivery Tasks ............................................... Software Delivery Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sequential Software Delivery Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the Software Delivery Wizard and Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Software Delivery Wizard and Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Contents
Deliver an Existing Package of Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Create and Deliver a New Package of Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Using Software Migration Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Software Migration Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Using the Software Migration Wizard and Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Software Migration Wizard and Status Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Using the Software Migration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Using Notifications and Automated Actions Using the Software Portal Software Portal Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Chapter 5: Configuring Software Delivery Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Configuring Software Delivery Security Privileges Installing Software Delivery Solution Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Software Delivery Solution Agent Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Task Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Setting Up Distribution Point Connection Parameters Configuring the Software Portal Configuring Application Inventory Data Purging
Configuring Application Relationships
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 58 59 59 59 59 60 61 61
Chapter 6: Technical Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 SMS Software Delivery Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SMS and Notification Server Collections ............................................ Integrating SMS Software Delivery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Specifying an SMS Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring Software Delivery for SMS ............................................. Specifying When Notification Server Is Used for SMS Advertisements . . . . . . . . . . . . . . . . . . . . . Deleting SMS Software Delivery Objects from Notification Server . . . . . . . . . . . . . . . . . . . . . . . . . Removing SMS Software Delivery Integration from Notification Server . . . . . . . . . . . . . . . . . . . . .
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 FTP Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Chapter 1:
Introducing Altiris Software Delivery Solution for Windows

Altiris Software Delivery Solution provides secure, bandwidth-sensitive distribution of applications and updates throughout your organization. Software Delivery Solution supports LAN, WAN, and remote and mobile clients from a single infrastructure, and offers advanced application management features such as application self-healing, conflict analysis, and other ongoing software management capabilities. Altiris Software Delivery Solution for Windows lets you define software packages, distribute software packages, and run programs on Windows 9x/Me/NT/2000/XP/2003 operating system computers. Software Delivery includes the following features: Computers can be targeted for software delivery based on data that is gathered from a computer. You can easily designate groups of computers to receive a software delivery job based upon hardware, software, or end-user details. A Software Delivery task, which downloads and deploys software packages, can be designated as mandatory or optional. You can allow or prohibit users from running a Software Delivery task. You can also expire programs, so they can no longer be deployed after a specified date. Network bandwidth throttling helps minimize network impact. This is especially useful for remote users. Checkpoint recovery lets you resume a package download to an Altiris Agent computer if the download is interrupted. This is especially useful for remote/dial-up users. Non-intrusive operation on Altiris Agent client computers. Full support for locked down Windows NT/2000/XP/2003 environments, which means software can be installed on computers even if the logged on user at the time of the installation does not have administrator rights to the computer. Native support for SMS packages, collections, advertisements, and status reporting. Numerous reports to help you analyze and make proactive management decisions.
Note: If you want to define and deploy software packages for UNIX/Linux, Macintosh, or
handhelds, Altiris also has Software Delivery products for these platforms. Quick Link Software Delivery Overview (page 5)
Software Delivery Overview

The Software Delivery Solution works in conjunction with Notification Server and the Altiris Agent to define and deploy software packages and run programs. Programs can be run once or based on a schedule. To deploy a package, which consists of any collection of program files, you start by using the Altiris Console to define a package. Once the package has been defined, you create a Software Delivery task to deploy the package and to run programs within the package. The Software Delivery task also specifies when a program is to be run, the security context used when a program is run, and the collection of computers to which the Software Delivery task applies.
Chapter 1: Introducing Altiris Software Delivery Solution for Windows
Bandwidth Throttling Bandwidth throttling lets you control the amount of bandwidth used in the delivery of packages. This feature can help minimize the impact of software deployment at peak network usage times. When the Software Delivery Agent (which is installed along with the Altiris Agent) downloads a file, the agent downloads the file buffer by buffer with a delay between each buffer. The buffer size and the amount of delay between buffers are both configurable through the Altiris Agent. Different values can be used depending on the bandwidth usage. If bandwidth control is disabled by the user, the Software Delivery Agent will use no (0) delay between buffers when downloading files. Effectively, the agent uses all of the available bandwidth for package download. If bandwidth control is enabled, the agent will test the data transfer rate by using full bandwidth to download a package for 10 seconds, and then estimate the transfer rate during that period of time. If the estimated transfer rate is less than a threshold, the agent will then use a delay between buffer downloads to slow down the download process. The data transfer rate test is done every two minutes to re-evaluate the link speed during the package download. Therefore, bandwidth usage depends on the transfer rate of the package download. For more information on the throttling feature, see the Altiris Notification Server Reference. Blockout Blockout lets you block out times in which packages are delivered with a high priority, low priority, or not at all. This feature lets you ensure that package delivery does not take up significant network bandwidth during peak usage times. For more information on the blockout feature, see the Altiris Notification Server Reference. Multicasting Multicasting lets you transmit packages to a select group of recipients. This feature has been introduced to Notification Server to improve Package Server performance on large networks for large customers using significant amounts of network bandwidth. It will protect Package Servers from being overloaded and slow network responses when distributing large packages. Multicasting reduces the load on Package Servers by reducing the number of Altiris Agents that connect to the Package Server and decreases network utilization by multicasting package data to peers. For more information about multicasting, see Using Multicasting on page 11. Sequential Software Delivery Tasks You can create a Software Delivery task to deliver a single application or you can create a sequential Software Delivery task to deliver multiple tasks. When using sequential Software Delivery tasks you can configure the sequence of the tasks to be deployed as well as dependencies that must exist for each task to be run. For example, you can have three tasks, Task A, Task B, and Task C in one sequential task. After setting the execution order, you can configure a dependency for Task C to only execute if Task B executed successfully. Software Portal The Software Portal lets users install software on their computers by executing Software Delivery programs for which they have been given permission by the administrator. Software Portal options are provided in addition to existing Software Delivery Package and Program settings. Software Migration The Software Migration Wizard creates tasks that can identify applications that are installed on one or more source computers and then deliver the corresponding Software Delivery packages to one or You can use the Software Migration Wizard to identify which applications are installed on the original computer and then use Software Delivery to deploy software delivery packages for those applications to the new computer. After the software migration, you can use PC Transplant to migrate the settings from the original computer to the new computer and both the applications and settings will be available to the user.
Chapter 2:
Installing Altiris Software Delivery Solution for Windows

This section provides information you need to know to install Software Delivery Solution for Windows. Planning Information (page 7) Prerequisites (page 8) Installing Software Delivery Solution (page 8) Registration (page 8)
Planning Information
Before installing Software Delivery, we recommend that you review the following information: Security (page 7) Notification Server and SQL Server (page 7)
Security
On Windows NT/2000/XP, the Software Delivery Agent piece of the Altiris Agent runs as a service with local administrator rights on the computer. The Software Delivery Agent can run only under either the local system or the currently logged on user account. The default is the local system account. When running using the local system account, the Software Delivery Agent will not have the same HKEY_CURRENT_USER registry value as the local logged on user. The HKEY_CURRENT_USER is only the same value if you set up the Software Delivery task to run as the logged on user.
Notification Server and SQL Server

If Notification Server and the Microsoft SQL Server database are NOT running on the same computer, make sure that the two computers are in the same time zone and their clocks are reasonably synchronized. Differences in times or time zones between the two computers can cause package update problems.
Chapter 2: Installing Altiris Software Delivery Solution for Windows
Prerequisites
Software Delivery Solution for Windows requires the following: Notification Server Notification Server Version 6.0
Client Computer Windows 95, Windows 98, Windows Me, Windows NT 4.0, Windows 2000, Windows XP, or Windows 2003 Altiris Agent Version 6.0
Installing Software Delivery Solution

Before installing Software Delivery, review Prerequisites on page 8. To install Software Delivery Solution on Notification Server
1
Click Start > Programs > Altiris > Altiris Console. This starts the Altiris Console. Click the Configuration tab. In the treeview pane, navigate to Upgrade/Install Additional Solutions. Click the Available Solutions tab. Click the Software Delivery Solution for Windows link. Click Start. This starts the installation of the solution. When the installation is complete, the window will automatically close.
2 3 4 5 6
Registration
Each Altiris product comes with a 7-day trial license that is installed by default. You can register and obtain a 30-day evaluation license through our Web site at www.altiris.com or purchase a full product license. To view your current license, open the Altiris Console, click the Configuration tab, and select Licensing. For more information, see Licensing Altiris Software in the Altiris Getting Started Guide on the product CD or on our Web site at www.altiris.com/support/documentation.
Chapter 3:
Getting Started with Software Delivery Solution

This section provides information you need to know to get started using Software Delivery Solution for Windows. Quick Links Software Delivery Usage Overview (page 9) Software Delivery Solution Components (page 9) Using Multicasting (page 11)
Software Delivery Usage Overview

Software deployment involves defining packages, creating Software Delivery tasks, delivering packages, running programs, and monitoring feedback. The following outlines the software deployment procedure. To deploy software
1 2 3 4 5
Set up software delivery (see Configuring Software Delivery Solution on page 49). Define a package that contains the files you want to deploy (see Creating a Package on page 15). Define the program you want to run (see Defining a Program for a Package on page 15). Create a Software Delivery task for the package that specifies a schedule for the program and the collection to which it applies (see Creating a Software Delivery Task on page 24). Create reports to analyze results (see Altiris Notification Server Help).
If you have problems downloading a package, see Checking for Package Download Errors on page 16. Using the Software Delivery Wizard The Software Delivery Wizard takes you through the steps of creating and delivering new and existing packages. Because packages are delivered through Software Delivery tasks, this wizard guides you through creating packages and setting up Software Delivery tasks to deliver those packages. This is the easiest and most efficient way to create packages, assign programs to them, and set up Software Delivery tasks to deliver them. For more information, see Using the Software Delivery Wizard and Status Page on page 32.
Software Delivery Solution Components

When Software Delivery Solution for Windows is installed, folders and items are placed in various tab views of the Altiris Console. You can use these folders and items to create and manage packages, programs, and Software Delivery tasks. All folders and items for Software Delivery Solution for Windows are placed in the Software Management > Software Delivery > Windows folder in the treeview pane of the various tab views.
Chapter 3: Getting Started with Software Delivery Solution
Software Delivery Solution Components
Tasks Tab View The following table lists the shortcut menu items that are added after Software Delivery Solution is installed. These can be accessed when you right-click a folder or item in the treeview pane on the Tasks tab view. Folder Notification Policies Shortcut Menu Item Description Software Delivery Solution for Windows supplies Notification Policies that provide active reporting for the Altiris Agent. See Using Notifications and Automated Actions on page 44. You can create a Software Delivery task to deliver a single application or you can create a sequential Software Delivery task to deliver multiple tasks. When using sequential Software Delivery tasks, you can configure the sequence of the tasks to be deployed as well as dependencies that must exist for each task to be run. The Software Delivery Tasks folder is provided as a container for the Software Delivery tasks that you create. Software Delivery Wizard and Status Opens the Software Delivery Wizard. This wizard takes you through the steps of creating packages and setting up Software Delivery tasks to deliver those packages. See Using the Software Delivery Wizard and Status Page on page 32.
Sequential Software Delivery Task
Software Delivery Tasks
Hello World - Sample A pre-installed sample Software Delivery task called Hello World - Sample. New Software Delivery Task Software Migration Software Migration Task Wizard and Status Creates a new Software Delivery task. Software Migration tasks lets you migrate applications from one computer to another. See Using the Software Migration Wizard and Status Page on page 40.
Resources Tab View Software Delivery Package folder is provided as a container for the Software Delivery packages that you create. Reports Tab View From the Reports tab, you can view the Software Delivery dashboard and Software Delivery reports. The Software Delivery dashboard displays a list of executed Software Delivery tasks, their status, the computers they were delivered to, and the execution time. A chart showing the number of executed tasks is also provided. Reports let you analyze your data. Each Altiris solution includes predefined reports that you can use or modify, or you can create your own reports. Software Delivery Solution provides numerous predefined reports to help you analyze your asset information. These reports are found in the Altiris Console under the Reports tab by navigating to Reports > Software Management > Software Delivery > Windows in the treeview pane. The reports are organized Application Inventory Audit Information Client Package Download Client Program Execution
into the following categories:
10
Using Multicasting
Client Software Delivery Tasks Status Packages/Programs Software Delivery Tasks Definitions Software Portal
In addition to the above reports, you can create reports related to Software Delivery task usage. Software Delivery Solution also provides the ability to automatically delete old reports. For information on these features as well as using predefined reports and creating custom reports, see Altiris Notification Server Reference. Configuration Tab View Software Delivery Solution for Windows places several configuration items in the Configuration tab view. These items let you configure Software Delivery Solution for Windows to meet your needs. For more information, see Configuring Software Delivery Solution on page 49.
Using Multicasting
Sample Multicasting Scenario Imagine the scenario of a remote network segment consisting of five Altiris Agents that remotely communicate to the Notification Server. When the first Altiris Agent updates its configuration, it is notified that there is a package ready for download. If this Altiris Agent has multicasting enabled, it will begin a multicast session and ask if any other Altiris Agents in the segment already have this package. As other Altiris Agents in turn update their configuration and are also asked to download this package they will join the multicast session to register that they too need to download the package. The Altiris Agents first negotiate to see who is going to be the 'master' of the session. Once the minimum numbers of Agents per multicast session join, one of two things will then occur: If one of the Altiris Agents has the package, then it will become the multicast master. The master will wait for the minimum number of Agents to join the session. If no Altiris Agent in the session has the package, then they will negotiate with each other and pick a multicast master based on their respective OS, OS type, CPU speed, and memory. This has a minimum timeout of 240 seconds. Once the master is chosen, it will download the package in the usual manner and then wait for the minimum number of Agents to join the session.
The master Altiris Agent will then multicast the package over the physical subnet so that each of the Altiris Agents in the multicast session can then receive it. If an Altiris Agent requests a package after it has been available for some time, it will attempt to join an existing session or else it will begin a multicast session as normal. This process optimizes the package download procedure. Only one Altiris Agent per session will communicate with the Package Server or Notification Server to download the package. Previously, each Altiris Agent required bandwidth & CPU usage to communicate directly to the Package Server or the Notification Server. Multicasting reduces this overhead by reducing significant amounts of network bandwidth usage and thereby reducing load on the Package Server or the Notification Server. Altiris Agents will revert to unicast for downloading packages under the following circumstances: If the Maximum sessions per physical subnet value has been reached, the backoff period will initiate. If this occurs more times than the Maximum transmission attempts per package, the Altiris Agent will revert to unicast. If an Altiris Agent is connected to the session at less than 64 Kbytes/second it will be removed from the session. If the maximum bandwidth used for multicasting has been reached. If the Maximum sessions per physical subnet value has been reached. If the package is smaller than the Disable multicast for packages smaller than value.
11
Using Multicasting
Package Servers and Multicasting Previously, a Package Server exclusively received packages from an Altiris server and passed those packages on to other Altiris-enabled computers. This process has changed with the advent of multicasting but it is imperative to keep the following information in mind: Package Servers will always download a package using unicast. If there is a Package Server on the subnet that has already downloaded a package, it will participate in the multicast session as the master.
Configuring Multicasting Package multicasting is configured in the Package Multicast tab on the Altiris Agent Settings page. You can also select to use multitasking on the Advanced tab on the Software Delivery Task page on the Advanced tab Advanced Tab View - Software Delivery Task Page on page 29. By default, all Software Delivery tasks that meet the criteria will use multicasting.
12
Chapter 4:
Using Software Delivery Solution

This section provides information you need to know to use Software Delivery Solution for Windows. Quick Links Using Software Packages and Programs (page 13) Using Software Delivery Tasks (page 22) Using the Software Delivery Wizard and Status Page (page 32) Using Software Migration Tasks (page 38) Using the Software Migration Wizard and Status Page (page 40) Using Notifications and Automated Actions (page 44) Using the Software Portal (page 45)
Using Software Packages and Programs

Quick Links Software Packages Overview (page 13) Package Download Overview (page 14) Creating a Package (page 15) Defining a Program for a Package (page 15) Checking for Package Download Errors (page 16) Changing the Check for Updated Package Files Schedule (page 16) Software Package Page (page 16)
Software Packages Overview

Software packages are a group of program files. Software Delivery Solution lets you define and deploy software packages. To define a package, you must designate where the source files are located (a folder). This folder can be local to the Notification Server computer, on the network (UNC), or accessed through a URL. When a package is defined, all of the contents of the folder specified by the package, including the contents of subfolders, are part of the package. When you define a package, only include the files that are necessary to accomplish the purpose of that package. The more files included, the greater the bandwidth or time required to deploy the package, since all of the files in a package are downloaded to the Altiris Agent. As part of the package definition process, you specify the locations from which an Altiris Agent can download the package. By default, a package can be downloaded from the location specified in the package as the source for the package. You can also specify Package Servers where a package can
13
Chapter 4: Using Software Delivery Solution
be obtained. Package Servers let you reduce the load on the Notification Server and the network by distributing packages to multiple locations from which they can be downloaded. For more information on package servers, see the Altiris Notification Server documentation. The Altiris Agent stores package files on the same drive that the agent installed (in the install path \Altiris\Altiris Agent\Software Delivery\Package GUID folder). When installing the Altiris Agent, install the Altiris Agent on a drive with sufficient space for all the files that will be downloaded. If the Altiris Agent does not have sufficient disk space to download a package, a message is displayed by the Altiris Agent and a status message is sent to the Notification Server. If the end user manually deletes the package files, the Altiris Agent will re-download them from the Notification Server the next time the Altiris Agent tries to run the package. For information on defining software packages, see Creating a Package on page 15.
Note: If you have a Software Delivery task that uses cmd.exe with the /K switch, the command
window will be left open after execution. This is because the Software Delivery Agent runs the command and waits for the exit code. When the /K switch is used, the command line does not produce an exit code until you either type exit or close the window. If you type exit, the exit code is 0 (no error). If you close the window, the exit code is non-zero, which indicates an error, which is reported in the Altiris Agent. If you want to run commands using cmd.exe and return an exit code, use the exit N command, where N is the desired exit code. This will cause the cmd.exe application to terminate with exit code N.
Package Download Overview

When a new package is defined, the package will be automatically downloaded to the appropriate Altiris Agent Package Server the next time the Altiris Agent requests configuration information from Notification Server. If you modify a package definition within the Altiris Console, the changed files in the package will also be downloaded to the appropriate Altiris Agent computers when the Altiris Agents check for configuration information. To send a package to a group of computers, the package must be assigned to a Software Delivery task, the destination computers must be a part of a Collection assigned to the task, and the task must be enabled. For more information, see Using Software Delivery Tasks (page 22). If the actual files in a package change, Notification Server automatically recognizes the changes. Notification Server checks for changed package files on a regular basis (once a day by default). If Notification Server determines that files in a package have changed, Notification Server will inform the appropriate Altiris Agents that the package has changed. Only the changed files will be downloaded to the Altiris Agent again. The interval that Notification Server checks for changed files can be modified (for more information, see Changing the Check for Updated Package Files Schedule on page 16). The less frequently the check is made, the longer the time is required for a changed package to be available on an Altiris Agent computer. The more frequently the check is made, the more processing resources are required by Notification Server. If the Software Delivery Agent is unable to download a package due to a link failure or denied access so a connection cannot be established, the Altiris Agent will report a Download failed - Link failure status message. The Software Delivery Agent will back off for N minutes (where N increases exponentially from a default of 3 minutes to a default of 2 hours) before attempting to download the package again. If the Altiris Agent detects a network status change (a new network link), any package waiting for a retry at being downloaded will immediately restart. The back off interval will be reset to the initial value. If a connection is lost during the download of a package, the transfer rate is throttled. When the Altiris Agent attempts to download the package again, a buffer transfer delay applies and slows down the download. The Altiris Agent determines which files in the package still need to be downloaded and downloads those files. If a source or destination fails during a package download, the checkpoint recovery feature lets you continue the download of a package without starting over. For example, suppose you are deploying a package that is 20 MB in size and there is a network failure 15 MB into the deployment process. When your systems are back up, the package deployment resumes at the 15 MB point. The checkpoint recovery feature is always available; you do not need to enable it.
14
Creating a Package
For information on packages, see Software Packages Overview on page 13.
Notes:
To quickly create a new package, program, and Software Delivery task at the same time, use the Software Delivery Wizard. For more information, see Using the Software Delivery Wizard and Status Page on page 32. To define and deploy Unix software packages, use the Altiris Software Delivery Solution for Unix.
To create a package
1 2 3. 4
In the Altiris Console, click the Resources tab. In the treeview pane, click Resource Management > Resources > Software Management > Software Delivery Packages. Right-click the desired platform folder, and then select New > Software Delivery Package. In the content pane, specify the package properties. For information about package properties, see Software Package Page on page 16. Click the Apply button.
Defining a Program for a Package

For each package, you can define one or more programs that the package can run. To define a program for a package
1 2 3
In the Software Package, click the Programs tab view. To configure a new program, click the New button. Specify the program details of the first program. For information on the program properties, see Software Package Page on page 16 If you have more than one program, repeat this procedure for each of the programs.
Note: Defining multiple programs for a single package lets you use the same package for more
than one purpose.
For more information about program properties, see Software Package Page on page 16. To run MSI files MSI files are not executables. They are databases that include files and provide descriptions on how the data should be installed. To run an MSI in a package, you need to run msiexec.exe. The msiexec.exe program should be on the path. For information on all of the parameters for msiexec.exe, see the online help. You can use the following command line:
msiexec.exe /i msifilename.msi
Note that you can pass other command line parameters to msiexec.exe so that your installation is done in quiet mode. Examples For a basic UI
msiexec.exe /i msifilename.msi /qb
15
For no UI
msiexec.exe /i msifilename.msi /qn
To run script files For VBS and VBE files, you need to run either cscript.exe or wscript.exe. For information on the available commands, see the documentation for these programs. Usually, other script files can be run as programs. See the documentation for your desired script file executables.
Checking for Package Download Errors

After deploying packages, it is important to know that the packages were deployed successfully. If some packages were not successfully deployed, you need to know on which computers the deployment was not successful. To facilitate this process, Software Delivery provides the Package download errors report. The following procedure describes how to create and use the report. To determine package download errors
1 2 3
In the Altiris Console, click the Reports tab.

Windows > Client Package Download
In the treeview pane, navigate to the Reports > Software Management > Software Delivery > > Package Download - Errors item. In the content pane, click the Run this report link.
A report using the latest data will be created displaying package deployment error information. You can click on items in the report to drill down for more details.
Tip For other client status information, use the above procedure, but select one of the other reports.
Changing the Check for Updated Package Files Schedule

By default, Notification Server checks all packages every day for changes You can change this schedule as needed. For more information on how software packages are updated, see Package Download Overview on page 14. To change the check for updated package files schedule
1 2 3 4
In the Altiris Console, click the Configuration tab.

Shared Schedules.
In the treeview pane, navigate to Configuration > Server Settings > Notification Server Settings > In the content pane, click on the Package Refresh Schedule link. In the Schedule Editor dialog, specify the desired schedule, and then click the OK button.
Software Package Page

This page is used to configure packages and specify Package Servers for the package. It contains four tabs - Package, Programs, Advanced, and Software Portal. To access a software package page
1 2 3
In the Altiris Console, click the Resources tab view. In the treeview pane, navigate to Resource Management > Resources > Software Management > Software Delivery Packages > Windows. In the content pane, double-click on a software package resource.
16
In Resource Manager, click on the Package tab view.
Note: Software packages can be located in other folders depending on where they were placed when they were created.
Software Package Toolbar The Software Package toolbar contains icons that let you perform actions while using the Software Package page.
The clickable icons on the Software Package toolbar are as follows: Right click menu for item - Displays the right click menu for the folder. Export - Lets you export the software package to XML. View as XML - Lets you view the software package as XML. Properties - Lets you view the Properties page of the software package. The Properties page contains general information of the software package and also lets you set up security for the software package.
Package Tab View - Software Package Page This tab view is used to configure a package. Items in italics are settings options.
Page Items
Item Name Description Publisher Language Version Package source
Description Name of the package. Description of the package. Publisher of the package. Language for which the package is designed. Version of the package. Drop-down list with following options:
Package does not A command-line is sent to the Altiris-enabled computer, for example a call to contain source files a utility like Chkdsk.exe. The package contains no source files. Access package from a local directory on the NS computer Select this to access the package from a local directory on the Notification Server computer. If this is selected, you must enter a Package Location. Notification Server will map HTTP URLs to this location through which Altiris Agents will access the package. Package Location - The location of the package on a local directory on the Notification Server computer.
17
Page Items
Item
Description
Access package Select this to access the package from an existing Universal Naming from existing UNC Convention (UNC) path. In order for the Notification Server to access packages that exist at a UNC path, you must first enter the credentials that the Notification Server will use when connecting to the UNC path. To do this, go to the Package Server Configuration page and fill in the credentials in the Distribution Point Connection Parameters drop-down section. This option requires a package location. Notification Server will map HTTP URLs to this location through which the Altiris Agents will access the package. Package Location UNC - The location of the package at a UNC path. Access package from a URL Select this to access the package from a URL. This option requires a package location URL. Package HTTP URL - The Altiris Agent will access the package through this anonymous URL. The location of the package on the Notification Server computer. This can be a local directory, a UNC path, or URL location depending on the package source. The alternate UNC package location when the Package source is Access Package from a URL. This UNC package location is used to generate a snapshot of all of the files in the package. The URL is the location where the Altiris Agent will download the package from. The snapshot is used by Altiris Agents as a list of files that will be downloaded. This UNC package location should be the path to the directory used to create the virtual directory. Click to select one or more installers, if found. The contents of the selected folder will be analyzed and the installers found will be shown. Installers of type Wise and MSI are recognized. Selecting installers helps in identifying the applications that will be installed by the programs of this package.
Package location
Package directory
Installers found
Package files will Drop-down list to specify time frame for package files to be deleted from the be deleted from the client computer if they have been unused for any length of time. client computer if unused for Apply Cancel Click Apply to save changes. Click Cancel to discard changes.
Update Distribution Click this button to update this package information as soon as possible on all Point enabled Package Servers. Programs Tab View - Software Package Page This tab view is used to configure the programs associated with a package. Select a program from the drop-down list to view the details on that program. To add a new program to the package, click New. To delete a program from the package, select the program from the dropdown list, then click Delete.
Page Items
Item Program New Delete
Description Drop-down list that lets you select the program to be associated with the selected package. Creates a new program definition using the information currently listed in the Program Details section of the page. Deletes the program definition selected in the Program drop-down list.
18
Page Items
Item Name Description Applications
Description (Required) Name of the program. (Optional) Description of the program. The Applications link lets you tie this program to a specific application. For example, you can tie this program to Word 2003, Excel 2003, or Outlook 2003. This functionality is tied to the Application Inventory functionality. The Applications and Installer links let you tie your software delivery package and programs to specific products and applications. This lets Software Delivery Solution use the Application Inventory agent to detect what software is on a computer, and tie it to a software delivery package. This helps you manage the applications and installers on Altiris-enabled computers. In order for this link to appear, an Installer must be selected from the Installer link. Gives the information of the installer that can install or uninstall the application selected in the Applications field. This lets you tie a package to a specific installer program. For example, you may have a package called 'My Applications' and you know that this package installs Office 2003. Using the Installer link, you can tie the package to the applicable installer program. In order for this link to appear, you must define a valid package location that points to a folder that includes an MSI or an EXE file. (Required) Command line entry to run program, including switches and parameters if applicable. The command line entry must be in the same location as the package or along the same path as the package.
Installer
Command line
Working directory (Optional) Directory where files needed by the program are temporarily stored during deployment. Success codes (Optional) Enter the success code(s) for the program. Success codes are determined by the exit code that is returned when an application ends. Applications can define their own exit codes for success and failures, but typically a zero value is used for success, and a non-zero value for failure. Multiple values can also be specified with a comma delimiter. For example, 0,3000 could be entered as success values. (Optional) Enter the failure code(s) for the program. Failure codes are determined by the exit code that is returned when an application ends. Applications can define their own exit codes for success and failures, but typically a zero value is used for success, and a non-zero value for failure. Multiple values can also be specified with a comma delimiter. For example, 1,5000 could be entered as failure values. (Optional) Estimated disk space required by the installed program. This is only an information field.
Failure codes
Estimated disk space
Estimated run time (Optional) Estimated time in minutes required to complete the deployment. This is only an information field. Terminate after After running Starting window Run with rights (Optional) Terminates running of the program after the specified number of minutes. (Optional) Specifies the action to take after running the program. The options are No action required, Restart computer, and Log off user. Specifies the status of the program window when the program is run. The options are Normal, Hidden, Minimized, and Maximized. Specifies whether the program is run with the System Account, Logged in User, or Specified User account. If you select the Specified User, you must specify the users domain, name, and password in the field below.
19
Page Items
Item User domain
Description Domain information of the account to use if you use Specified User in the Run with Rights field. Enter the domain, user name, and password of the specified user.
when a user is logged on, Whether or not a user is logged on, user is logged on.
Program can run
Specifies the conditions in which the program can run. The options are Only and Only when no
If you select Only when a user is logged on, you can select User Input required if you want to allow user input. The User Input required option is only valid when a user is logged in. This option is available if the program run on a computer brings up a User Interface that may require user input to complete its process. Usually, it is safe to keep this option selected, which is why it is selected by default. The Run once for each logged on user option can be used to configure the program to run for each user that logs on to the computer. The Software Delivery agent keeps track of each user that has run the program. Specifies that this program requires a network connection. This program requires a network If this is selected, you can specify the Minimum connection speed that the connection network connection needs to be in order for the program to run.
20
Advanced Tab View - Software Package Page This tab view is used to specify Package Servers associated with a package. For information on Package Servers, see the Altiris Notification Server Help and Altiris Notification Server Reference.
Page Items
Item Agent display name
Description The name of the package that will be displayed on the Altiris Agent. This can be different than the package name you specified on the Package tab view. The purpose of this field is for you to be able to supply package names to the end user that makes sense to users while also being able to have package names that make sense to you on an administrative level. The description of the package that will be displayed on the Altiris Agent. This can be different than the package description you specified on the Package tab view. It is recommended that you enter a description here that will let the end user know what the package will do to the Altiris-enabled computer. This setting controls whether the Altiris Agent sends all package status events for this package to the Notification Server. Select the check box to enable sending all package status events to the Notification Server. Note: The Advanced Settings in the Configuration tab view take precedence to this setting. Events are only sent if their corresponding check box is enabled in the Capture Event Name section of the Advanced Settings. The following types of AeX SWD Status events are not sent if package verbose reporting events are disabled: Package Updated Package Added Package To Be Removed Package Removed Unable To Check Package Insufficient Disk To Download Package Download Start Download Complete Package Download Blocked
Agent display description
Enable verbose reporting of package status events
For information on capturing events in large environments, see Scalability in the Altiris Notification Server Reverence. Use Alternate Download Destination on Client Select this to use an alternate package download destination to the Altirisenabled computer besides the default. This option makes it possible to deliver package files to computers at alternate destinations. When the task executes, the package files will be copied from the internal cache location to the location specified. After they are copied, the copied package files will never be deleted by the Altiris Agent. They will be recopied every time the task is run; so if the task is on a recurring schedule, the files will be copied repeatedly. This can be useful to ensure the user does not delete a required file. Note: The default of the internal cache location is install path\altiris\altiris agent\software delivery\{package guid}\cache). Select this to send the package to all available Package Servers. Select this to show a table of available Package Servers. You can then choose the Package Servers that you want this package sent to.
All Package Servers Selected Package Servers
21
Using Software Delivery Tasks
Page Items
Item Enabled Package Servers
Description This table lists the Package Servers available for your Notification Server. The Package Servers section lets you specify which Package Servers you would like this package to be replicated to. The grid contains a list of all Package Servers that have been created for the Notification Server. Select the box in the enabled column next to each of the Package Servers that you wish this package to be replicated to. The default and recommended option is to have the package replicated to all Package Servers (by selecting All Package Servers). All selected computers will have the package copied to them. Enter the desired package destination location on the Package Servers if you do not want the default. Enter a UNC path. The default package delivery location on Package Servers is install path\altiris\altiris agent\package delivery\{package guid}\cache).
Package Destination Location on Package Servers
Software Portal Tab View - Software Package Page This tab view lets you view and modify Software Portal permissions for the programs found in this package. The Software Portal is used to manage the availability of software that can be added manually by a user from the Altiris-enabled computer. The table lists the programs that are currently defined for the package and the state of their Software Portal permissions. When you click a program in the table, you can see who has permission to install the software without administrator approval (Install Software permission) and who requires administrator approval before installing the software (Install On Approval permission). When you click the Modify button, the Security Descriptor dialog appears. This lets you modify the security settings for the program by group, user, or Altiris role, by defining the Software Portal permissions you desire. You can use Alert Manager and the Software Portal to retrieve user software requests, approve or deny them, and send out e-mails if required.

Quick Links Software Delivery Task Priority (page 23) Software Delivery Task Status Files (page 23) Disabled Software Delivery Tasks (page 23) Creating a Software Delivery Task (page 24) Specifying Software Delivery Task Availability (page 24) Verifying that a Policy Has Been Successfully Delivered to the Altiris Agent Computer (page 25) Policy Scheduling on Altiris Agents (page 25) Scheduling Software Delivery Tasks (page 25) Software Delivery Task Page (page 26) Sequential Software Delivery Task Page (page 30)
Software Delivery tasks are policies that specify delivery and deployment information about a software package. For a software package to be downloaded to and deployed on the Altiris-enabled computer, there must be at least one Software Delivery task associated with that package. Each package can have more than one Software Delivery task associated with it, but each Software Delivery task is only associated with one package.
22
Software Delivery tasks have several options on how they are run, depending upon how they are configured. A Software Delivery task can be run: By the user of the Altiris-enabled computer through the Altiris Agent program or Software Portal. As soon as possible after the Software Delivery task has been requested by the Altiris Agent and the run conditions are met. The run conditions are specified in the package definition policy on the Programs tab view. The condition options are Only when a user is logged on, Only when no user is logged on, and Whether or not a user is logged on. According to a schedule specified in the Software Delivery task.
Each Software Delivery task has availability dates associated with it. These dates specify when a Software Delivery task is first available and no longer available. The Software Delivery package associated with a task specifies the security context under which a program runs (local system administrator or logged on user rights). For information on creating a Software Delivery task, see Creating a Software Delivery Task on page 24.
Software Delivery Task Priority

Each Software Delivery task has an associated priority that is set in the definition of the Software Delivery task. The priority is used to set a priority when more than one Software Delivery task needs to download an associated package. The package associated with the Software Delivery task having the highest priority is downloaded first. The Software Delivery tasks will also be executed according to their priority order. Each task will be executed to completion before another task is started. The priority options are Low, Normal, High, and Very High.
Software Delivery Task Status Files

The Software Delivery Agent keeps track of package download status information for each package in a status file. The status is kept in the install path\Altiris\Altiris Agent\Software Delivery \Status\package guid\log.xml. This file keeps track of the last 30 download attempts. This value can be adjusted by editing the registry value Download history size located under the key HKLM\SOFTWARE\Altiris\Communications\Package Delivery on the client computer The Software Delivery Agent keeps track of package execution status for each Software Delivery task in the install path \Altiris\Altiris Agent\Software Delivery\AexSWDPolicy.xml file.
Disabled Software Delivery Tasks

If you disable a Software Delivery task, or it is disabled due to platform mismatch, expiration, filtering, or unavailability, the Software Delivery Agent will keep that Software Delivery tasks status information for 10080 minutes (one week) by default, including any downloaded packages. After one week, the associated status information is removed entirely from the Altiris Agent computer. If the associated packages are no longer referenced by any other active Software Delivery policies on the Altiris Agent, the packages are also removed. (If you re-enable the policy after one week, any associated software packages will be downloaded again.) The one-week default can be changed by modifying the Software Delivery package and changing the package deletion option. This cleanup process is performed once a day. For testing purposes, you can force a cleanup within the next 5 minutes by removing the AdsStatusLastCleanUp registry value under the following registry key: HKLM\Software\Altiris\Altiris Agent\Software Delivery
23
The following registry setting configures how long, in minutes, a Software Delivery task must be disabled before the status and packages are removed from the Altiris Agent computer. HKLM\Altiris\Altiris Agent\Software Delivery\RemovedSoftPkgsCleanUpPeriod
Creating a Software Delivery Task

For information on Software Delivery tasks, see Using Software Delivery Tasks on page 22. You can create a Software Delivery task to deliver a single application or you can create a sequential Software Delivery task to deliver multiple tasks. When using sequential Software Delivery tasks you can configure the sequence of the tasks to be deployed as well as dependencies that must exist for each task to be run. For example, you can have three tasks, Task A, Task B, and Task C in one sequential task. After setting the execution order, you can configure a dependency for Task C to only execute if Task B executed successfully.
Note: To quickly create a new package, program, and Software Delivery task at the same time, use
the Software Delivery Wizard. For more information, see Using the Software Delivery Wizard and Status Page on page 32. To create a Software Delivery task
1 2 3 4 5
In the Altiris Console, click the Tasks tab. In the treeview pane, navigate to Tasks > Software Delivery > Windows > Software Delivery Tasks. Right-click the Software Delivery Tasks folder, then select New Software Delivery Task. In the Software Delivery Tasks folder, click on the newly created Software Delivery task. Specify the Software Delivery task details in the content pane. For information about task properties, see Software Delivery Task Page on page 26.
If you want to verify that a Software Delivery task has been deployed properly, see Verifying that a Policy Has Been Successfully Delivered to the Altiris Agent Computer on page 25. To create a sequential Software Delivery task
1 2 3 4 5
In the Altiris Console, click the Tasks tab.

Delivery Tasks.
In the treeview pane, navigate to Tasks > Software Delivery > Windows > Sequential Software Right-click the Software Delivery Tasks folder, then select New Sequential Software Delivery Task. In the Sequential Software Delivery Tasks folder, click on the newly created sequential Software Delivery task. Specify sequential Software Delivery task details in the content pane. For more information about sequential task properties, see Sequential Software Delivery Task Page on page 30.
Specifying Software Delivery Task Availability

To specify Software Delivery task availability
1 2 3
In the Altiris Console, click the Tasks tab. In the treeview pane, navigate to the Software Delivery task on which you want to set availability options. In the content pane, specify the availability details in the Availability section. For a description of the properties, see Software Delivery Task Page on page 26.
24
Verifying that a Policy Has Been Successfully Delivered to the Altiris Agent Computer
To verify that a policy has been successfully delivered to an Altiris Agent computer using the Resource Manager
1
Open the Resource Manager to display information about the desired Altiris Agent computer. For information on using the Resource Manager, see the Altiris Notification Server Reference. In the treeview pane, click on the Policy Summary item. This displays a list of all the policies that are enabled for the selected computer. Verify that the policy you are checking for is in the list.
To verify on the Altiris Agent that a policy has been successfully delivered to it
1
In Windows Explorer or through My Computer, open the install path\Altiris\Altiris Agent\Client Policies folder (C:\Program Files\Altiris\Altiris Agent\Client Policies by default). This is where policies are stored on the Altiris Agent. Open the notification_server_name.xml file using a text editor or Internet Explorer. Review the contents of the policy file and confirm that the policy you are interested in is included in the file.
2 3
Policy Scheduling on Altiris Agents

The Altiris Agent uses the Microsoft Task Scheduler to schedule the execution of policies on each Altiris Agent computer. The Task Scheduler is accessed through the individual Altiris Console pages that use the scheduler. Without the Task Scheduler installed, the Altiris Agent can only automatically run mandatory jobs that are marked for As Soon As Possible execution. You can verify that the task scheduler is installed by going to My Computer > Scheduled Tasks or My Computer > Control Panel > Scheduled Tasks. If you do not have the Task Scheduler installed on an Altiris Agent computer, Notification Server will automatically install it for you when you install the Altiris Agent. If for some reason the Microsoft Task Scheduler is not installed on your Altiris Agent computer, you can install the scheduler manually if you have the Altiris Agent package installed on your Notification Server. Run TaskScheduler.exe from the Notification Server in the install path\Altiris \Notification Server\NSCap\Bin\Win32\X86\redist\TaskScheduler folder (C:\Program Files\Altiris\Notification Server\NSCap\Bin\Win32\X86\redist\TaskScheduler by default). If you have an older version of the Task Scheduler installed, running TaskScheduler.exe will upgrade your version of Task Scheduler.
Note: Software Delivery schedules are based on the local time of the computer. Software Delivery
task availability times can be based on the local time or GMT (Greenwich Mean Time).
Scheduling Software Delivery Tasks

The following procedure describes how to create or modify a schedule for a Software Delivery task. To schedule Software Delivery tasks
1 2 3 4 5
In the Altiris Console, click the Tasks tab. In the treeview pane, navigate to the task you want to schedule. In the content pane, select the On a schedule radio button, and then select the Run on a schedule check box if it is not already selected. Click the No schedule has been defined link next to the Run on a schedule check box. Create a schedule that fits your needs.
25
For a description of scheduling options, see Software Delivery Task Page on page 26.
6
Click the OK button.
Software Delivery Task Page

This page lets you configure software delivery tasks. To access a Software Delivery task page
1 2
In the Altiris Console, click the Tasks tab view.

Software Delivery Tasks.
In the treeview pane, navigate to Tasks > Software Management > Software Delivery > Windows >
Note: Software Delivery tasks can be located in other folders depending on where they were placed
when they were created.
Software Delivery Task Toolbar The Software Delivery Task toolbar contains icons which let you perform actions while using the Software Delivery Task page.
The clickable icons on the Software Delivery Task toolbar are as follows: Rename - Lets you quickly rename the Software Delivery task. Delete - Lets you quickly delete the Software Delivery task. Clone - Lets you clone the Software Delivery task. Export - Lets you export the Software Delivery task to XML. View as XML - Lets you view the Software Delivery task as XML. Properties - Lets you view the Properties page of the Software Delivery task. The Properties page contains general information of the task and also lets you set up security for the task.
General Tab View - Software Delivery Task Page
Page Items
Item Enable Name Description
Description Enables the Software Delivery task when selected. Disables the Software Delivery task when cleared. Name of the Software Delivery task. Description of the Software Delivery task.
26
Page Items (Continued)
Item Priority
Description Defines the order in which packages associated with Software Delivery tasks are downloaded. Can be Low, Normal, High or Very high. Packages associated with higher priority Software Delivery tasks get downloaded before those for lower priority Software Delivery tasks. Any package that is being downloaded will be suspended if a higher priority Software Delivery task arrives. Specifies the package to be used by the Software Delivery task. Clicking on the link will open the Package Selector. Opens the Package page for the package selected in the Package Name field. Name of the program to run. The list of available options in the drop-down list depends on the value selected in the Package field. Opens the Program page for the program selected in the Program name field. Specifies the collection to which the software task applies. Clicking on the link will open the Collection Selector. Note: You must select at least one collection before you can apply the Software Delivery task. Select manual to run the Software Delivery task manually and not according to a schedule. You can choose one or both of the following: Notify the user when this task is available - Select this to notify the user when this Software Delivery task becomes available to run. The user can then control when to run the Software Delivery task. Warn the user before running this task - Select this to warn the user before a Software Delivery task is run. The user can then choose to cancel the task, run the task immediately, or be reminded later.
Package name Go to Package Program Name Go to Program Applies to Collection
Run - Manual
27
Item
Description
Run - On a schedule Specifies that the Software Delivery task is to be run according to a schedule. You can schedule for the Software Delivery task to be run as soon as possible and/or set up a schedule for it to be run. You can choose one or more of the following: Run as soon as computer is notified (only runs once) - Select this to run the Software Delivery task as soon as the package has been downloaded to the Altiris-enabled computer and the run conditions have been met. This option creates a mandatory Software Delivery task that does not display a dialog on the Altiris-enabled computer before running. Run on a schedule - Select this to run the Software Delivery task on a schedule. Click No schedule has been defined to open the Schedule Editor. Select one of the following: Run as soon as possible after the scheduled time - This option tells the Altiris Agent to run the Software Delivery task as soon as possible after the time you have scheduled. The Altiris Agent will wait until the scheduled time, then run the Software Delivery task as soon as it can. This option can help spread out the network load as the Software Delivery tasks will most likely run at different times on each Altiris Agent. Only run at scheduled time - This option tells the Altiris Agent to run the Software Delivery task only at the scheduled time. This option will force all Altiris Agents to run the Software Delivery task at the same time.
Power up the computer (Wake on LAN) - Select this to send a power up signal to the Altiris-enabled computer at the designated scheduled time. Immediately notify each computer of task - Select this to immediately notify all computers of the Software Delivery task at the designated scheduled time. This can lead to increased network traffic and should be used carefully. User can run this task immediately - Select this to let the user run the Software Delivery task immediately when it becomes available. Notify the user when this task is available - Select this to notify the user when this Software Delivery task becomes available to run. The user can then control when to run the Software Delivery task. Warn the user before running this task - Select this to warn the user before a Software Delivery task is run. The user can then choose to cancel the task, run the task immediately, or defer the task.
Use Recovery to backup the computer
If this is selected, Software Delivery Solution performs a Recovery snapshot on the Altiris Agent prior to running the Software Delivery task. Note: This option only appears if you have Recovery Solution 6.0 or greater installed.
Removal - Remove Removes the Software Delivery task (and associated package) from the Altiris this task after Agent user interface on the Altiris-enabled computer. This does not delete the successful install package from the Altiris-enabled computer. However, this makes it so that the user of the Altiris-enabled computer cannot view this task or associated package from the Altiris Agent program. It is recommended that you use this for tasks that you only want to run once. Availability Specifies the date that this Software Delivery task becomes available and whether or not it expires. You can also select whether to use the Notification Servers time or the time of the Altiris-enabled computer. Click Apply to save changes. Click Cancel to discard changes.
Apply Cancel
28
Advanced Tab View - Software Delivery Task Page
Page Items
Item
Description
Agent display name Specifies the name of the Software Delivery task that is displayed on the Altiris Agent. Agent display description Enable verbose reporting of task status events Download and Execute Options Specifies the description of the Software Delivery task that is displayed on the Altiris Agent. Select this to track all status events for this task. The status events are added to the log files. These options control how Software Delivery packages are downloaded and executed. The default is to use the Altiris Agent settings found on the Altiris Agent Settings page. Note: If you choose Use the following settings when downloading and running, these options override the default Download and Execute Options (found on the Altiris Agent Settings page) for this Software Delivery task. The two checkboxes let you configure whether or not the package will be downloaded from Notification Server before it is run. If you choose to have the package downloaded and run locally, the two radio buttons let you configure when the package will be downloaded. Run from the server if bandwidth is above - Select this to run the program directly from the Notification Server if the bandwidth is above a certain speed. Download and run locally if bandwidth is above - Select this to download and run the program locally if the bandwidth is above a certain speed. If you select Use the following settings when downloading and running, you must select either Run from the server if bandwidth is above or Download and run locally if bandwidth is above or both. When Download and run locally if bandwidth is above is selected, you will be able to select one of the following radio buttons: Download the package files as soon as possible - Select this to download the package files right away.
Download the package files before running the program
- Select this to download the package files only when the program is required to run.
Multicast package - Select this to multicast this package to other client computers receiving the same package. Note: Multicasting must be enabled for a computer to participate in a multicast session. This is a configuration setting option available in each computer's Altiris Agent. This option can be found under Configuration > Altiris Agent > Altiris Agent Configuration > Collection Group > Altiris Agent Settings > Package Multicast. For information about multicasting, see Multicasting on page 6 and the Altiris Agent Settings page and the associated Notification Server help.
Status Tab View - Software Delivery Task Page The Status tab view displays details about the execution of the task on the Altiris-enabled computers.
Page Items
Item
Description
Display computers Specifies the criteria for displaying computers on which the Software Delivery on which this task task ran. ran When you select an item from the drop-down list, a table is displayed with status information.
29
Sequential Software Delivery Task Page

This page lets you edit sequential software delivery tasks. To access a Sequential Software Delivery task page
1 2
In the Altiris Console, click the Tasks tab view. In the treeview pane, navigate to Tasks > Software Management > Software Delivery > Windows > Sequential Software Delivery Tasks.
Note: Software Delivery tasks can be located in other folders depending on where they were placed
when they were created.
Software Delivery Task Toolbar The Software Delivery Task toolbar contains icons that let you perform actions while using the Software Delivery Task page.
The clickable icons on the Software Delivery Task toolbar are as follows: Rename - Lets you quickly rename the Software Delivery task. Delete - Lets you quickly delete the Software Delivery task. Clone - Lets you clone the Software Delivery task. Export - Lets you export the Software Delivery task to XML. View as XML - Lets you view the Software Delivery task as XML. Properties - Lets you view the Properties page of the Software Delivery task. The Properties page contains general information of the task and also lets you set up security for the task.
General Tab View - Sequential Software Delivery Task Page
Page Items
Description Enables the Software Delivery task when selected. Disables the Software Delivery task when cleared. Name of the Software Delivery task. Description of the Software Delivery task.
30
Item Execution Order
Description You can add multiple packages/programs, set the execution order, and set dependencies for the sequential Software Delivery task.
To add a task
Click the add Click OK.
icon.
Select the programs you want to include from the program tree.
To change the execution order of the programs
Click a program and click the up or down execution order will reset the dependency. Click the program dependency selector.
icons. Changing the
To configure a dependency for the package
Select the packages that are higher in the execution order that must be delivered successfully in order for this package to be delivered. Select the package you want to delete and click the delete Deleting a package will reset the dependency. icon.
To delete a package
Applies to Collection
Specifies the collection to which the software task applies. Clicking on the link will open the Collection Selector. Note: You must select at least one collection before you can apply the Software Delivery task.
Run - On a schedule Specifies that the Software Delivery task is to be run according to a schedule. You can schedule for the Software Delivery task to be run as soon as possible and/or set up a schedule for it to be run. You can choose one or more of the following: Run as soon as computer is notified (only runs once) - Select this to run the Software Delivery task as soon as the package has been downloaded to the Altiris-enabled computer and the run conditions have been met. This option creates a mandatory Software Delivery task that does not display a dialog on the Altiris-enabled computer before running. Run on a schedule - Select this to run the Software Delivery task on a schedule. Click No schedule has been defined to open the Schedule Editor. Select one of the following: Run as soon as possible after the scheduled time - This option tells the Altiris Agent to run the Software Delivery task as soon as possible after the time you have scheduled. The Altiris Agent will wait until the scheduled time, then run the Software Delivery task as soon as it can. This option can help spread out the network load as the Software Delivery tasks will most likely run at different times on each Altiris Agent. Only run at scheduled time - This option tells the Altiris Agent to run the Software Delivery task only at the scheduled time. This option will force all Altiris Agents to run the Software Delivery task at the same time.
Power up the computer (Wake on LAN) - Select this to send a power up signal to the Altiris-enabled computer at the designated scheduled time. Immediately notify each computer of task - Select this to immediately notify all computers of the Software Delivery task at the designated scheduled time. This can lead to increased network traffic and should be used carefully.
Availability
Specifies the date that this Software Delivery task becomes available and whether or not it expires. You can also select whether to use the Notification Servers time or the time of the Altiris-enabled computer.
31
Using the Software Delivery Wizard and Status Page
Item Apply Cancel
Description Click Apply to save changes. Click Cancel to discard changes.
Advanced Tab View - Sequential Software Delivery Task Page
Page Items
Item Download and Execute Options
Description These options control how Software Delivery packages are downloaded and executed. The default is to use the Altiris Agent settings found on the Altiris Agent Settings page. Note: If you choose Use the following settings when downloading and running, these options override the default Download and Execute Options (found on the Altiris Agent Settings page) for this Software Delivery task. The two checkboxes let you configure whether or not the package will be downloaded from Notification Server before it is run. If you choose to have the package downloaded and run locally, the two radio buttons let you configure when the package will be downloaded. Run from the server if bandwidth is above - Select this to run the program directly from the Notification Server if the bandwidth is above a certain speed. Download and run locally if bandwidth is above - Select this to download and run the program locally if the bandwidth is above a certain speed. If you select Use the following settings when downloading and running, you must select either Run from the server if bandwidth is above or Download and run locally if bandwidth is above or both. When Download and run locally if bandwidth is above is selected, you will be able to select one of the following radio buttons: Download the package files as soon as possible - Select this to download the package files right away.
Download the package files before running the program
- Select this to download the package files only when the program is required to run.
Multicast package - Select this to multicast this package to other client computers receiving the same package. For information about multicasting, see Multicasting on page 6 and the Altiris Agent Settings page and the associated Notification Server help.
Status Tab View - Sequential Software Delivery Task Page The Status tab view displays details about the execution of the task on the Altiris-enabled computers.
Page Items
Item
Description
Display computers Specifies the criteria for displaying computers on which the Software Delivery on which this task task ran. ran When you select an item from the drop-down list, a table is displayed with status information.

The Software Delivery Wizard takes you through the steps of creating and delivering new and existing packages. Because packages are delivered though Software Delivery tasks, this wizard guides you through creating packages and setting up Software Delivery tasks to deliver those packages.
32
This is the easiest and most efficient way to create packages, assign programs to them, and set up Software Delivery tasks to deliver them.
Management > Software Delivery > Windows > Software Delivery Tasks > Wizard and Status, selecting Launch Software Delivery Wizard.
The Software Delivery Wizard can be accessed by clicking the Tasks tab and navigating to Software then
Software Delivery Wizard and Status

The Wizard and Status page gives you access to the Software Delivery Wizard and also provides status information for your Software Delivery tasks.
Page Items
Item Run Software Delivery Wizard Use the Advanced Wizard
Description Select this to access the Software Delivery Wizard. See Using the Software Delivery Wizard and Status Page on page 32. Select to run the Advanced Wizard. When running the Advanced Wizard, you also have the option to configure package server options, event logging options, the package display name in the Altiris Console, and task download and execute options. For a description of these options see Advanced Tab View - Software Package Page on page 21 and Advanced Tab View Software Delivery Task Page on page 29. Specifies the criteria for displaying available Software Delivery tasks. When you select an item from the drop-down list, a table is displayed with task information.
Task list criteria check boxes:
Created for Select this to display tasks that have been approved by the administrator. approved software Created for software requiring approval Scheduled by administrator Select this to display tasks that require approval by the administrator.
Select this to display tasks that have been scheduled by the administrator.
Software Delivery Status Toolbar The Software Delivery Status toolbar contains icons which let you perform actions while using the Wizard and Status page.
33
The clickable icons on the Software Delivery Status toolbar are as follows: Right click menu - Provides a shortcut for the right click menu for the item. Display for - Lets you select which tasks are displayed by age, number of rows, or status. Edit - Lets you edit the task. Clone Failed Task - Creates a copy of this task for the computers where it failed. Enter the name for the new copy and then click OK to create the copy. Run Task Again - Runs the task again. View task status details - Lets you view the success, failure, and not run details of the task. Refresh - Refreshes the grid. Changes made to the grid will not appear until you perform a refresh. Copy - Creates a copy of selected task row to paste elsewhere. Find - Lets you search for a task in the table. Enter the search text in the Find field and then click the Find button. Find Again - Finds the next task based on the last search criteria you entered in Find. Grid right click menu - Provides a shortcut for the right click menu for the selected row.
Deliver an Existing Package of Software

In this scenario you will deliver an existing Software Delivery package. For instruction on using the wizard to create and delivery a new package, see Create and Deliver a New Package of Software on page 36.
Step 1 - Select Package Option

In this step, you select that you want to deliver an existing package and select the package you want to deliver.
1 2 Select wizard mode
Select Deliver an existing package of software.

Select an existing software package
Navigate through the tree until you locate the package you want to deliver. If you have not yet created the package you want to deliver, see Create and Deliver a New Package of Software on page 36.
3 Verify package details
Verify that this is the package you want by observing the name, description, and location of the package.
4 Select a program to run from within the package
Select a program that has been attached to the package. If the program you want to run is not attached to the package, you must cancel this wizard and edit the package.
5
Click Next to go to Step 2 in the Wizard.
Step 2 - Select Collection and Schedule

In this step, you select the collection of computers to which you want the package of software to be delivered. Next, you select when you want it delivered.
Note: This step lets you set up a Software Delivery task to deliver the package.
1 Select the collection to which the package will be delivered
You can only select one collection per Software Delivery task. If you want to send the package to more than one collection, you can either create a collection which includes all collections to which you want to send the package or you can run the Software Delivery Wizard again.
Note: This is a required field.
34
Select when to run this task a
User must manually activate the task on the target computer. If this is selected, the Software Delivery task will not run on the target computer unless the user activates it manually. Also, the radio buttons and check-boxes in steps d through h below are unnecessary.
Automatically run the task on the target computer
If this is selected, the Software Delivery task will run automatically on the target computer based on the selections in steps d and e.
c Notify the user when task is available
If this is selected, the user will be notified when the task is available to run. The user can then manually activate the task or wait until it is automatically run, based on the selections in step a, b, and f.
d e Run this task as soon as possible
If this is selected, the Software Delivery task will run as soon as possible.
Run the task at a specified date and time
Select this to run the Software Delivery task at a specified date and time. Select the date and time from the drop-down menus.
f Allow the user to run the task before the scheduled date and time
Selecting this lets the user control when the Software Delivery task runs. If the task has been selected to run automatically and this check-box is selected, the user can still run the task manually before the scheduled time.
g This task is available from
Select the date and time from which the Software Delivery task will be available. Leave this at the default for the task to be available from todays date. Select and never expires for the task to never expire. Select and expires and the expiration date to state when the task will expire.
h Dates and times are in Coordinated Universal Time (UTC)
Select this if you want dates and times used in steps d and g to be in UTC.
3
Click Finnish to go to Step 3 in the Wizard.
Step 3 - Summary
In this step, you enter a name for your Software Delivery task, review your settings, and then click the Finish button.
1 2 Enter the name for the software delivery task
This can be any name you choose. This is a required field.

Verify the information below and then click OK
Make sure the information in this table is correct.

3
Enable or disable the Software Delivery task.

a
This Software Delivery task will be Enabled If this is displayed above 1. Enter the name for the software delivery task, the Software Delivery task will be enabled when it is created. Software Delivery tasks must be enabled before they can be run.
This Software Delivery task will be Disabled If this is displayed above 1. Enter the name for the software delivery task, the Software Delivery task will be disabled when it is created. Software Delivery tasks must be enabled before they can be run.
Click OK. This creates the Software Delivery task with the selected package attached to it.
35
Create and Deliver a New Package of Software

Step 1 - Select Package Option
In this step, you select that you want to create and deliver a new package, select the package source and location, and select the program you want to run.
1 2 Select wizard mode
Select Create and deliver a new package of software.

Select the package source and location a Package source
Select one of the following from the drop-down menu:

Package does not contain source files - This option is used to run a command-line on the Altiris Agent computer, for example a call to a utility like Chkdsk.exe. In this case, the package contains no source files. Access package from a local directory on the NS computer - This option requires a folder name.
Notification Server will map HTTP URLs to this location through which Altiris Agent computers and Package Servers will access the package.
Access package from an existing UNC - This option requires a folder name. Notification Server will map HTTP URLs to this location through which the Altiris Agent computers and Package Servers will access the package. Access package from a URL - This option requires a URL (entered in the Folder name field) through which Altiris Agent computers and Package Servers will access the package. b Folder name
If this field appears, you must enter the required information based on what you selected in the Package source field. Click on the folder icon to navigate to and select the desired folder.
3 Select the program that will run
In this field, enter the name of the program you want to run. Click on the folder icon to navigate to and select the desired program.
4
Click Next. The required fields are tested and if the information you entered is correct, the Wizard goes to Step 2 or 4.
Step 2 - Program Options

In this step, you select how the program will run, which rights to use, and what should happen when the program has finished running.
1 Select the user rights for the program to run a Run with rights
Select from the following:

System Account Logged in User
- The program will run with the system account rights.
- The program will run with the rights of the logged in user.
Specified User - The program will run with the rights of the user that you specify in the fields that appear. Enter the appropriate information in the User domain, User, Password, and Confirm Password fields. b Program can run
Note: This option is not available if Logged in User is selected above.
Select from the following:

Whether or not a user is logged on - This lets the program run whether or not the user is logged
on.
Only when a user is logged on
- This lets the program run only when the user is logged on. - This lets the program run only when no user is logged on.
Only when no user is logged on
36
c d
User input required
Select this if you want a prompt to appear for user input before the program is ran.
Run once for each logged in user
Select this if you want the program to run for each user that logs onto the computer. The Software Delivery agent keeps track of each user that has run the program.
2 Select the window style in which the program will run
Select one of the following from the Window style drop-down list:
Normal Hidden
- The window is normal when it opens. - The window is hidden when it opens. - The window is minimized when it opens. - The window is maximized when it opens.
Minimized Maximized 3
Select the action to take after the program has finished running
Select one of the following from the After running drop down list: running.
No action required - Select this if you do not want any action taken after the program has finished
Restart computer - Select this if you want the target computer to restart after the program has finished running. Enter the number of minutes that the user can defer the restart. Select Force running applications to quit upon restart if you want to force the restart. Log off user - Select this if you want the user to be logged off after the program has finished running. Enter the number of minutes that the user can defer the log off. Select Force running applications to quit upon log off if you want to force the log off. 4
Step 3 - Select Collection and Schedule

In this step, you select the collection of computers to which you want the package of software to be delivered. Next, you select when you want it delivered.
Note: This step lets you set up a Software Delivery task to deliver the package.
1 Select the collection to which the package will be delivered
You can only select one collection per Software Delivery task. If you want to send the package to more than one collection, you can either create a collection which includes all collections to which you want to send the package or you can run the Software Delivery Wizard again.
Note: This is a required field.
2 Select when to run this task a
User must manually activate the task on the target computer. If this is selected, the Software Delivery task will not run on the target computer unless the user activates it manually. Also, the radio buttons and check-boxes in steps d through h below are unnecessary.
Automatically run the task on the target computer
If this is selected, the Software Delivery task will run automatically on the target computer based on the selections in steps d and e.
c Notify the user when task is available
If this is selected, the user will be notified when the task is available to run. The user can then manually activate the task or wait until it is automatically run, based on the selections in step a, b, and f.
d e Run this task as soon as possible
If this is selected, the Software Delivery task will run as soon as possible.
Run the task at a specified date and time
Select this to run the Software Delivery task at a specified date and time. Select the date and time from the drop-down menus.
f Allow the user to run the task before the scheduled date and time
37
Using Software Migration Tasks
Selecting this lets the user control when the Software Delivery task runs. If the task has been selected to run automatically and this check-box is selected, the user can still run the task manually before the scheduled time.
g This task is available from
Select the date and time from which the Software Delivery task will be available. Leave this at the default for the task to be available from todays date. Select and never expires for the task to never expire. Select and expires and the expiration date to state when the task will expire.
h Dates and times are in Coordinated Universal Time (UTC)
Select this if you want dates and times used in steps d and g to be in UTC.
3
Step 4 - Summary
In this step, you enter your Software Delivery task, package, and program names. Next, you review your settings, and click the Finish button.
1 2 Enter the name for the software delivery task
Enter information in the following fields:

Software delivery task name - Enter the name for your Software Delivery task. This can be any name you choose. This is a required field. Package name
required field.
- Enter the name of the package. This can be any name you choose. This is a - Enter the name of the program. This can be any name you choose. This is a
required field.
3
Program name
Verify the information below and then click Finish
Make sure the information in the table is correct.

4
Enable or disable the Software Delivery task.

a
This Software Delivery task will be Enabled If this is displayed above 1. Enter the name for the software delivery task, the Software Delivery task will be enabled when it is created. Software Delivery tasks must be enabled before they can be run.
This Software Delivery task will be Disabled If this is displayed above 1. Enter the name for the software delivery task, the Software Delivery task will be disabled when it is created. Software Delivery tasks must be enabled before they can be run.
Click OK. This creates the package and the Software Delivery task and attaches the package to the task.

Software Migration tasks are policies that can identify applications that are installed on one or more source computers and then deliver the corresponding Software Delivery packages to one or more destination computers. You can use Software Migration tasks to identify which applications are installed on the original computer and then use Software Delivery to deploy software delivery packages for those applications to the new computer. After the software migration, you can use PC Transplant to migrate the settings from the original computer to the new computer. This makes both the applications and settings be available to the user. The easiest way to create Software Migration tasks is by using the Software Migration Wizard.
38
Quick Links Software Migration Task Page (page 39) Using the Software Migration Wizard and Status Page (page 40)
Software Migration Task Page

This page lets you configure Software Migration tasks. To access a Software Migration task page
1 2 3
In the Altiris Console, click the Tasks tab view.

Software Migration Task. Migration Task
In the treeview pane, navigate to Tasks > Software Management > Software Delivery > Windows > To create a new Software Migration task, click Wizard and Status or right-click the Software folder and click New > Software Migration Task. For information about the wizard, see Software Migration Wizard and Status Page on page 41.
Software Migration Task Toolbar The Software Migration Task toolbar contains icons which let you perform actions while using the Software Migration Task page.
The clickable icons on the Software Migration Task toolbar are as follows: Rename - Lets you quickly rename the Software Migration task. Delete - Lets you quickly delete the Software Migration task. Clone - Lets you clone the Software Migration task. Export - Lets you export the Software Migration task to XML. View as XML - Lets you view the Software Migration task as XML. Properties - Lets you view the Properties page of the Software Migration task. The Properties page contains general information of the task and also lets you set up security for the task.
General Tab View - Software Migration Task Page
Page Items
Item Enable Name Description Migrate from
Description Enables the Software Migration task when selected. Disables the Software Migration task when cleared. Name of the Software Migration task. Description of the Software Migration task. Select a collection of computers to migrate from.
39
Using the Software Migration Wizard and Status Page
Item Migrate to
Description Select a collection of computers to migrate to. Note: These can be the same or different collections. However, if you select the same collection, there must be multiple computers in that collection. You cannot migrate to the same computer. After you select both the source and destination collections, a list of all the computers in the destination collection will be displayed on the left in the Destination computers column. On the right side, there is a Source computers column that has drop-down lists where you can select the source computers. For each destination computer, select the source computer from the dropdown list. Specifies the date that this Software Migration task becomes available and whether or not it expires. You can also select whether to use the Notification Servers time or the time of the Altiris-enabled computer. Click Apply to save changes. Click Cancel to discard changes.
Map source computer to destination computer
Run - On a schedule For information on the options, see Run - On a schedule on page 28. Availability
Apply Cancel
Advanced Tab View - Software Migration Task Page
Page Items
Item Download and Execute Options
Description These options control how Software Delivery packages are downloaded and executed. The default is to use the Altiris Agent settings found on the Altiris Agent Settings page. You can use the default Altiris Agent settings or set different options. For information on the options, see Advanced Tab View - Software Delivery Task Page on page 29. These options control the applications that are migrated. For information on these options see Step 2 - Select Applications and Migration Settings on page 43.
Migrate Software
Status Tab View - Software Migration Task Page The Status tab view displays details about the execution of the task on the Altiris-enabled computers.
Page Items
Item
Description
Display computers Specifies the criteria for displaying computers on which the Software on which this task Migration task ran. ran When you select an item from the drop-down list, a table is displayed with status information.

The Software Migration Wizard creates tasks that can identify applications that are installed on one or more source computers and then deliver the corresponding Software Delivery packages to one or more destination computers.
40
Software Migration Tasks and Wizard Overview In order to create Software Migration tasks, do the following:
1
Gather application inventory on the computers you want to migrate from. Application inventory creates a list of applications in the Notification Server database. For more information, see Configuring Application Inventory on page 52.
Associate discovered applications to existing Software Delivery packages. The Software Migration Wizard does not create software packages but will only use existing software packages. For more information, see Configuring Application Relationships on page 53. If you need to create new Software Delivery packages, do so before running the Wizard. Run the Software Migration Wizard to create a Software Migration task (see Using the Software Migration Wizard on page 42).
Management > Software Delivery > Windows > Software Migration Tasks > Wizard and Status, selecting Run Software Migration Wizard.
The Software Migration Wizard can be accessed by clicking the Tasks tab and navigating to Software then Quick Links Using Software Migration Tasks (page 38) Software Migration Wizard and Status Page (page 41) Using the Software Migration Wizard (page 42)
Software Migration Wizard and Status Page

The Software Migration Wizard and Status page gives you access to the Software Migration Wizard and also provides status information for your Software Migration tasks. Quick Links Using Software Migration Tasks (page 38) Using the Software Migration Wizard and Status Page (page 40) Using the Software Migration Wizard (page 42)
Page Items
Item Run Software Migration Wizard
Description Select this to access the Software Delivery Wizard.
Status of Migration Provides a list of Software Migration tasks and displays their status. tasks
41
Software Migration Status Toolbar The Software Migration Status toolbar contains icons that let you perform actions while using the Wizard and Status page. Some items are only available after tasks are created.
The clickable icons on the Software Migration Status toolbar are: Right click menu - Provides a shortcut for the right click menu for the item. Display for - Lets you select which tasks are displayed by age, number of rows, or status. Edit - Lets you edit the task. Clone Failed Task - Creates a copy of this task for the computers where it failed. Enter the name for the new copy, then click OK to create the copy. Run Task Again - Runs the task again. View task status details - Lets you view the success, failure, and not run details of the task. Refresh - Refreshes the grid. Changes made to the grid will not appear until you perform a refresh. Copy - Creates a copy of selected task row to paste elsewhere.
Find
Find - Lets you search for a task in the table. Enter the search text in the Find field, then click the button.
Find Again - Finds the next task based on the last search criteria you entered in Find. Grid right click menu - Provides a shortcut for the right click menu for the selected row.
Using the Software Migration Wizard

This sections describes how to use the Software Migration Wizard to identify software applications installed on one or more computers and deliver corresponding existing Software Delivery packages to one or more computers.
Step 1 - Select Source and Destination Computers

In this step, you select the source and destination computers of the software migration.
Management > Software Delivery > Windows > Software Migration Tasks > Wizard and Status, selecting Run Software Migration Wizard. 1 2
The Software Migration Wizard can be accessed by clicking the Tasks tab and navigating to Software then Select a collection of computers to migrate from. Select a collection of computers to migrate to.
42
Note: These can be the same or different collections. However, if you select the same collection,
there must be multiple computers in that collection. You cannot migrate to the same computer.
After you select both the source and destination collections, a list of all the computers in the destination collection will be displayed on the left in the Destination computers column. On the right side there is a Source computers column that has drop-down lists where you can select the source computers.
3 4 5
Select the destination computer you want to migrate to, then select from the drop-down list the source computer. If there is a computer in the Destination computers list that you do not want to migrate to, then leave the source computer as Do not migrate. After you have selected the destination and source computers, click Next.
Step 2 - Select Applications and Migration Settings

1
Configure Download and Execute options. You can use the default Altiris Agent settings or set different options. For information on the options, see Advanced Tab View - Software Delivery Task Page on page 29.
Select the version option. You can select to migrate the same version number or a higher version number. For example, the source computer may have Adobe Acrobat Reader 6 installed. You may also have Software Delivery packages for both Acrobat Reader 6 and Acrobat Reader 7. By selecting Same version number, the Acrobat Reader 6 package will be installed on the destination computer. By selecting Higher version number, the Acrobat Reader 7 package will be installed on the destination computer.
Select the software applications to migrate. A list is shown where you choose the applications to be installed on the destination computer(s). You can display the list in two ways: by application name and by computer name. For information about applications that are displayed, see Software Migration Tasks and Wizard Overview on page 41. If you use the By Computer Name list, you will see a list of the destination computers you selected in the previous step. Using the check boxes, you can select which computers will get applications migrated to it. After you have selected a computer, you can then expand the list and choose the application Software Delivery packages that are available. If you use the By Software Name list, you will see a list of applications that are installed on the source computer and available through Software Delivery packages. Using the check boxes, you can select which applications to install. After you have selected an application, you can then expand the list and choose the destination computers to install to.
(Optional) Add additional software packages to be installed on the destination computers. There may be additional applications that you want to install on the destination computer. To add additional applications, click the Add and select the packages you want to install. If multiple computers are in the By Computer Name list, and if you want to add the application to only one computer, select and highlight the computer name, then select the Add Software to Selected Machine only check box before clicking Add. This will add the new application only to the selected computer.
(Optional) Remove Software Delivery packages from the list. If you want to remove a Software Delivery package from the list:
a b c
Select the By Software Name list. Click and highlight a Software Delivery package name. Click Remove.
When you have completed your selections, click Next.
43
Using Notifications and Automated Actions
Step 3 - Select the Schedule and Credential Settings

1
Set the schedule and availability options. For more information, see Run - On a schedule on page 28. Click Finish.
Step 4 - Name the Software Migration Task Policy

1 2 3 4
Enter a name and description for this Software Migration task. Verify the task settings. To change any settings, click the Back button. To finish the wizard, click OK.
The software task will be created in the Software Migration Task folder and will be enabled by default. The task will be run according to the schedule you configured. If you selected multiple applications to be installed on a destination computer, they will be installed sequentially.
Using Notifications and Automated Actions

Software Delivery Solution for Windows supplies Notification Policies that provide active reporting for the Altiris Agent. Notification Policies let you automatically be notified when certain conditions exist. Notification Policies can be set on something as simple as a single software delivery failure or specific set of conditions across multiple computers. Automated responses include sending of e-mail, running corrective commands and scripts, generating SNMP traps, and automatically generating a report and e-mailing you the URL of the report. The automatic actions that can be taken by a notification policy are defined by Automated Actions. Several Automated Actions can be associated with a single notification policy. For more information on Automated Actions, see the Altiris Notification Server documentation.
44
Using the Software Portal
The following table lists and describes the predefined notification polices.
Software Delivery Solution Notification Policies
Policy Package Download May Be Too Late
Description Sends an e-mail containing a web report, which summarizes the computers where the package download might not be in time. You can adjust the percent download and the number of days warning (Day Filter). For example, report computers with less than 60 percent download and 4 days before mandatory first execution. This policy applies only to Software Delivery tasks with mandatory schedules other than ASAP. Note: If you change the notification policy schedule, you must change the Days Filter parameter to match the interval. Sends an e-mail containing a web report summarizing failed program execution. Note: If you change the notification policy schedule, you must change the Days Filter parameter to match the interval.
Program Execution Failed
Software Delivery Task Sends an e-mail notification when a Software Delivery task has run Completed successfully (at least once) on all of the targeted computers. Both mandatory and optional Software Delivery tasks are reported. Note: If you change the notification policy schedule, you must change the Days Filter parameter to match the interval. Note: Software Delivery tasks with a repeating schedule will be continually reported. Software Delivery Task Sends an e-mail notification when a Software Delivery task has expired Expired and not all of the targeted computers have successfully run the program. Both mandatory and optional Software Delivery tasks are reported. Note: If you change the notification policy schedule, you must change the Days Filter parameter to match the interval. Software Delivery Task Sends an e-mail notification when a Software Delivery task is about to Expires In Less Than 7 expire and not all of the targeted computers have successfully run the Days program. Both mandatory and optional Software Delivery tasks are reported. Note: If you change the notification policy schedule, you must change the Days Filter parameter to match the interval. You can also create your own notification policies using the Notification Policy template. For more information on creating notification policies, see the Altiris Notification Server Reference. monitoring the same event, use caution so that the actions taken by the policies do not conflict with each other. For example, if two policies monitor the same event and the action taken by each policy is to add a log entry in the Notification database, you will have duplicate entries in your database.
Note: It is possible for multiple policies to monitor the same event. If you have more than one policy

The Software Portal lets users install software on their computers by executing Software Delivery programs for which they have been given permission by the administrator. Software Portal options are provided in addition to existing Software Delivery Package and Program settings. For information on the Software Portal page, see Software Portal Page on page 47. The Software Portal can be used when: One or more users need to install the software right away One or more users want control over the software they install
IMPORTANT: You must install the Software Delivery Solution Agent and the Task Synchronization Agent to all Altiris Agents with which you want to use the Software Portal. (See Installing Software Delivery Solution Agent on page 50 and Task Synchronization on page 50.)
45
You use permissions to set up the Software Portal. Each Software Delivery program can have its own permissions. To implement the Software Portal, you need to do two things: set permissions, and select how the user can see the Software Portal. To configure Software Portal Settings For information on configuring Software Portal settings, see Configuring the Software Portal on page 52. To set permissions
1 2 3 4 5 6 7 8 9
Open the Altiris Console. From the Resources tab view, navigate to Resource Management > Resources > Software Management > Software Delivery Packages > Windows. From the Resource folder, double-click on a package. Click the Package tab. Click the Software Portal tab. Click the Modify button. Select the Permissions tab. Click the Add button. Select a role, or user, or group from the Advanced dialog. The members of the chosen role, user or group will be able to install the software associated with this program.
10 11 12
Click Select. From the Permission Selection window, select the permissions you want for this program. A special Software Delivery Solution Permissions section appears at the bottom of this window. You have two choices: Install Software and Install on Approval. Select only one of these.
Install Software - The user will be able to select this task from the Software Portal and run the
program without approval.
Install on Approval - The user will be able to select this task from the Software Portal, but will
need to wait approval from an administrator or help desk worker before the program is run.
13 14
Click Select. Click Apply.
Select how the user can run the Software Portal

1 2 3 4
In the Altiris Console, click the Configuration tab view. Navigate to Configuration > Solution Settings > Software Management > Software Delivery > Software Portal Configuration. Select the Software Portal Settings policy that applies to the collection(s) to which you want these changes sent. Select one or more of the following:
Show link for Software Portal in Start Menu - This lets the user portal by clicking Start > Programs > Altiris > Software Portal.
access the Software Request - This lets the user install
Show link for Software Portal in Add Remove Programs dialog box
the Software Portal and access it as a program.
Show link for Software Portal in Altiris Agents context menu - This lets the user access the Software Request portal by right-clicking on the Altiris Agent toolbar icon.
46
Software Portal Page

The Software Portal appears on the Altiris-managed computer when the system administrator gives the user permission to run software manually. The Software Portal can be accessed by one of the following ways, based on the Altiris Agent settings that the system administrator provides: Click Start > Programs > Altiris > Software Portal. Install it from Add/Remove Programs and run it as a program. Right-click on the Altiris Agent toolbar icon and select Software Portal.
Note: The Software Portal can also be accessed in the Altiris Console by selecting the Tasks tab view, clicking Quick Starts in the treeview pane, and then clicking Software Portal in the content pane. It can also be run manually from Internet Explorer using the URL provided in the URL of Software Portal for Win32 Users field under Configuration > Solution Settings > Software Management > Software Delivery > Windows > Software Portal Configuration.
There are two folders available to the user from this portal: Approved Software and Software Requiring Approval. Only the software that is available for the user to manually install is listed in these folders.
Approved Software
Users can run software listed here manually without getting approval. To run approved software
Note: The software disappears from the Approved Software folder until it has run successfully.
1 2
In the Software Portal, in the Approved Software folder, select the check-box next to the software you want to install. Click Apply.
Software Requiring Approval

Users can ask for approval to run software listed here. Once approved by the administrator from the Incidents task queue, the program will be scheduled for execution. To request approval and run software
Note: The software disappears from the Software Requiring Approval folder after the approval request
has been made until the program has run successfully.
1 2
In the Software Portal, in the Software Requiring Approval folder, select the check-box next to the software you want to get approval for and run. Click Apply. After the administrator or help desk user approves the software install request, the software will be installed on the user computer.
Software Portal Tab View This tab view lets you view and modify Software Portal permissions for the programs found in this package. The Software Portal is used to manage the availability of software that can be added manually by a user from the Altiris-enabled computer. The table lists the programs that are currently defined for the package and the state of their Software Portal permissions.
47
When you click a program in the table, you can see who has permission to install the software without administrator approval and who requires administrator approval before installing the software. When you click the Modify button, the Security Descriptor dialog appears. This lets you modify the security settings for the program. You can use Alert Manager to retrieve user software requests, approve or deny them, and send out e-mails if required. To approve software, click on the Incidents tab from within the Altiris Console. By default, all software that requires approval will be added to the Asset Management queue. Whoever is assigned to this queue will be responsible for approving or denying each software request. An administrator is provided with two tasks for each software request incident - Create a new Software Delivery Task, and Deny Software Request. If the administrator chooses to create a new software delivery task, he will be presented with the Software Delivery Task page with everything defined to run the program on that user's computer. By selecting the Enable check box, and the Apply button, the task will be delivered and run the next time the user's computer requests its configuration. Note: The administrator has the option of changing any schedule or any other option prior to applying the task to fit his requirements.
48
Chapter 5:
Configuring Software Delivery Solution

The following procedures configure your system for Software Delivery. Configuring Software Delivery Security Privileges (page 49) Installing Software Delivery Solution Agent (page 50) Task Synchronization (page 50) Setting Up Distribution Point Connection Parameters (page 51) Configuring the Software Portal (page 52) Configuring Application Inventory (page 52) Configuring Application Relationships (page 53) Data Purging (page 56)
Configuring Software Delivery Security Privileges

You can assign security privileges for Software Delivery administrative functions. Using role-based security you can control who has rights to do the following: Create Software Delivery Packages Create Software Delivery Tasks Create Software Portal Definitions
Security Privileges Example Suppose you want to roll out Microsoft Office to all corporate computers. You have offices in New York and Sydney and only want to give permission for employees to roll out Microsoft Office at their location. You would first give privileges to all the employees doing the roll out. Next, you could create two Software Delivery policies: one for the New York roll out and one for the Sydney roll out. Then, you would give the New York roll out employees permissions for the New York Software Delivery policy and the Sydney roll out employees permissions for the Sydney Software Delivery policy. To configure Software Delivery Security Privileges
1 2 3 4
From the Altiris Console, click on the Configuration tab view. In the treeview pane, navigate to Configuration > Server Settings > Notification Server Settings > Item Tasks > Security Role Management. Grant Software Delivery Solution privileges to the desired roles. Click Apply.
For more information about configuring security, see Security Role Management in the Notification Server help.
49
Chapter 5: Configuring Software Delivery Solution
Installing Software Delivery Solution Agent
Installing Software Delivery Solution Agent

The Software Delivery Solution Agent does the following: It controls the exposure of the Software Portal on Altiris-enabled computers. (See Using the Software Portal on page 45.) It manages the inventory of programs installed on Altiris-enabled computers.
The Software Delivery Solution Agent inventories programs that are installed on the Altiris-enabled computer and sends this data to the Notification Server. It then uses this information to track programs that are installed on the Altiris-enabled computer and matches them with packages that are defined by the Notification Server. You can use this information in deciding which programs to send to which Altiris-enabled computers. You need to install the Software Delivery Solution Agent only if you are doing one of the following: Using the Software Portal. Tracking inventory of installed applications on Altiris-enabled computers (using an Application Inventory task).
To install the Software Delivery Solution Agent

1 2 3 4 5
From the Altiris Console, click on the Configuration tab view. In the treeview pane, navigate to Configuration > Solution Settings > Software Management > Software Delivery > Windows > Software Delivery Solution Agent Rollout. Select Software Delivery Solution Agent Install. In the content pane, select Enable. Click the Apply button.
After the Software Delivery Solution Agent has been installed on the Altiris-enabled computers, you can then set up and enable an Application Inventory task to perform inventory of installed applications.
Note: If you deploy the Software Delivery Solution Agent, you should also deploy the Task
Synchronization Agent (Task Synchronization on page 50).
Software Delivery Solution Agent Uninstall

The Software Delivery Solution Agent Uninstall folder contains a policy you can use to uninstall the Software Delivery Solution Agent. This policy uninstalls the Software Delivery Solution Agent from all computers listed in the Computers With Software Delivery Solution Agent Installed collection. If you want to uninstall the Software Delivery Solution Agent from your Altiris-enabled computers, enable the Software Delivery Solution Uninstall policy.
Task Synchronization
Task Synchronization is used by Software Delivery Solution and other Altiris solutions that synchronize the execution of tasks on an Altiris Agent. The Task Synchronization Agent should be rolled out to any Altiris Agents that have the Software Delivery Solution Agent installed on them. The Task Synchronization Agent Install policy installs the Task Synchronization Agent to the All Windows Computers with NS 6 Agents collection. To install the Task Synchronization Agent to these computers, enable the Task Synchronization Agent Install policy. When a Task Synchronization Agent upgrade is available, you can enable the Task Synchronization Agent Upgrade policy. This policy upgrades the Task Synchronization Agent to all computers listed in the Computers Requiring Task Synchronization Agent Upgrade collection.
50
Setting Up Distribution Point Connection Parameters
Setting Up Distribution Point Connection Parameters

You need to perform this procedure only if you are doing one of the following: Using Microsoft SMS and the SMS distribution server is not on the same computer as Notification Server. Creating virtual directories to UNC paths that have credentials different from the credentials specified on the Application Identity page.
To set up Software Delivery

1 2 3 4
In the Altiris Console, click the Configuration tab, and then, in the treeview pane, navigate to Configuration > Server Settings > Notification Server Infrastructure > Package Servers. In the content pane, click the Package Service Access tab. In the Distribution Point Connection Parameters section, select whether or not you want to use application credentials. If you chose to use other credentials, enter the user name and password. The following are the fields in this section: User name - Domain and user name (separated by a \) with administrator rights you want to use on the Notification Server computer. Password and Confirm Password - Password for the account in the User name field.
Click the Apply button.
51
Configuring the Software Portal
Configuring the Software Portal

The Software Portal Settings page lets you control the visibility of links to the Software Portal on Altiris-enabled computers.
Software Portal Page Items
Item Enable
Description Select to enable these settings.
Show link for Software Places a link for the Software Portal in the Start menu on the AltirisPortal in Start Menu enabled computer. Show link for Software Shows a link for the Software Portal in the Add Remove Programs Portal in Add Remove dialog box on the Altiris-enabled computer. Programs dialog box This is available only on Windows 2000 clients and above. Show link for Software Places a link for the Software Portal in the Altiris Agent's context menu Portal in Altiris Agents on the Altiris-enabled computer context menu Applies to collections This lists the collection(s) that the settings apply to. Click on the pencil icon to edit the collection(s) that the settings apply to. These settings can apply to one or more collections.
URL of Software Portal You can e-mail this URL to your Altiris-enabled computer users. Users for Win32 users can access the Software Portal using this URL. Show me this page Click to view the URL page that you will send to the Altiris-enabled computer users. Note: To access the Software Portal using this URL, the Altiris Agent and the Software Delivery Solution Agent must be installed on the client computers. Click Apply to save changes. Click Cancel to discard changes.
Apply Cancel
Configuring Application Inventory

Application Inventory tasks gather information on applications that are installed on Altiris-enabled computers. This information is then placed in the Notification Database. You can then run reports that give you information and status on these installed applications. You can also use this information for migrating software. For more information, see Using the Software Migration Wizard and Status Page on page 40. After you use an Application Inventory task to gather information on applications from Altirisenabled computers, you can set up application relationships (see Configuring Application Relationships on page 53) and create packages which use applications and installer relationships. If the Application Inventory task finds that some applications have been uninstalled when compared to the previous inventory, the information is reported to the Notification Database. The information about uninstalled applications is kept for 7 days (configurable using the Data Purging section) after which it is deleted. To create an Application Inventory task
1 2 3
In the Altiris Console, click the Configuration tab view.

Software Delivery > Windows.
In the treeview pane, navigate to Configuration > Solution Settings > Software Management > Right-click on the Application Inventory folder, then select New > Application Inventory Task.
52
Application Inventory Task Toolbar The Application Inventory task toolbar contains icons which let you perform actions while using the Application Inventory task page.
The clickable icons on the Application Inventory task toolbar are: Rename - Lets you quickly rename the Application Inventory task. Delete - Lets you quickly delete the Application Inventory task. Clone - Lets you clone the Application Inventory task. Export - Lets you export the Application Inventory task to XML. View as XML - Lets you view the Application Inventory task as XML. Properties - Lets you view the Properties page of the Application Inventory task. The Properties page contains general information of the Application Inventory task and also lets you set up security for the Application Inventory task.
General Tab View
Page Items
Description Select to enable this task. (Required) The name of the task. (Optional) The description of the task.
Applies to collection(s) This lists the collection(s) that the task applies to. Click on the pencil icon to edit the collection(s) that the task applies to. This task can apply to one or more collections. Run the inventory task once Run the inventory task on a schedule Schedule Apply Cancel Select to run this task only one time. Select to run this task on a schedule. Click on the link to open the scheduler and create a schedule for this task. Click Apply to save changes. Click Cancel to discard changes.

The Application Relationships feature helps you manage Applications and Installers which are found on your Altiris-enabled computers. Applications are any executables that may be found on your computers. Installers are the installation executables that install Applications.
53
The Application Relationships page comes with pre-populated Applications and Installers. You may also define your own Applications and Installers to suit your needs. Applications can be associated with Installers. Each Application can be associated with one or more Installers. Each Installer can be associated with one or more Applications. The relationships between Applications and Installers have been created already for the prepopulated Applications and Installers. If you define your own Applications and Installers, you will need to associate them as applicable. Application Relationships are used in linking application inventory to specific software packages, which can then be installed where needed. Using Application Inventory, you can scan Altirisenabled computers for application information. This information is placed in the Notification Database and can then be used when deploying software packages. Software Delivery tasks are associated with packages and programs. Software Delivery programs can then be associated with specific Applications and Installers. This gives you the advantage of tying a software delivery package and program to an Application Relationship. You can also use these relationships for migrating software. For more information, see Using the Software Migration Wizard and Status Page on page 40. You can associate Applications and Installers with software programs in one of two ways On the Application or Installer page, associate programs with the Application or Installer. On the Programs page, associate Applications and Installers with the program.
Application Page
Item Application Exe name Language File version Family
Description (Required field) Application name. (Required field) Name of the executable file. Click Browse to browse and select the desired executable. (Required field) The Application language. (Required field) The file version of the executable listed above. Select the Application family that you want this Application to belong to. You can create families by clicking View Families, then clicking on Add. The size of the Application (in bytes). The publisher of the Application. The version of the Application. Application.
Click here to select
Size Publisher Product version Installed by programs
lets you select the programs that install this
Uninstalled by programs Click here to select lets you select the programs that uninstall this Application. Contained by installers Installed on computers Apply Cancel contained by.
lets you select the Installers that this Application is
Displays the Altiris-enabled computers that this Application has been installed on. Click Apply to save changes. Click Cancel to cancel changes.
54
Installer Page
Item Installer Publisher Filename Type Used by packages Contains applications Apply Cancel
Description (Required field) Installer name. Click Browse to browse and select the desired Installer. The publisher of the Installer. The filename of the Installer. The Installer type. Select a type from the menu.
lets you select the packages that use this Installer. lets you select the Applications that this Installer is
contained by
Click Apply to save changes. Click Cancel to cancel changes.
To create a new Application relationship

1 2 3
Navigate to Applications & Installers > Applications. Right-click on Applications, then select New Application. Enter the fields as explained in Application Page on page 54.
To create a new Installer relationship

1 2 3
Navigate to Applications & Installers > Applications. Right-click on Installers, then select New Installer. Enter the fields as explained in Installer Page on page 55.
To use Application Relationships to automatically send packages to Altiris-enabled computers

1 2 3 4
Perform an inventory on your computers (do this by setting up specific Application Inventory tasks and running them). Make sure the necessary Application Relationships are set up. When you create programs, associate them with Applications and Installers. Create Software Delivery tasks and associate them with the desired packages and programs.
Notification Server then automatically determines which Applications and Installers to push down to which computers. This is very useful when upgrading. Notification Server can detect if a new version needs to be pushed down based on which versions are installed. Example 1 Suppose you use Application Inventory to gather inventory on an Altiris-enabled computer. The Application Inventory task finds an aol.exe file and gathers the version number and its language. This information is sent to the Notification Server that places it in the Notification Database. Notification Server can now determine that the aol.exe file on this Altiris-enabled computer is associated with the American Online 4.0 application. The American Online 4.0 application can be associated with one or more installers. In this case, the American Online 4.0 application is only associated with the American Online 4.0 setup installer. This information can now be used for performing upgrades or for sending aol.exe to another computer that needs it. Example 2 You can set up PC Transplant Pro and Software Delivery to inventory computers and migrate settings from one computer to another computer automatically through application relationships.
55
Data Purging
Suppose you want to migrate applications from one computer to another computer. You can set up Software Delivery Solution to perform an application inventory on the first computer. Through this inventory, it is determined that the first computer has AOL 4.0 and Microsoft Word 2000. It is also determined, through an application inventory, that the second computer does not have AOL 4.0 and Microsoft Word 2000 on it. A Software Delivery package can be created which is associated with the AOL 4.0 and Microsoft Word 2000 applications and installers. Then, you can create a Software Delivery task to push these applications automatically to the second computer. This process can happen automatically, making your migration fast and easy.
Data Purging
This page lets you set the period for which saved reports and captured events remain in the Notification database before they are deleted. All saved reports belonging to this solution that are older than the period you specify are automatically purged from the database on a daily basis. Likewise, events belonging to policies in this solution that are older than the period you specify are also purged.
Note: If you are having trouble running your reports (if they are slow), try purging your events or
set the purge of events to happen more often.
WARNING: Purging will also cause the history of assets to be deleted. This information is very
important when tracking details such as the cost details of assets. Enabling Purging will cause Asset data to be lost with potential loss to financial information.
Item Purge events older than
Description This lets you purge all events belonging to this solution that are older than the period you specify.
Purge saved reports older This lets you purge all reports belonging to policies in this solution that than are older than the period you specify. Purge tasks and collections older than Purge uninstalled applications older than Apply Cancel Purge Now This lets you purge all tasks and collections created for the Software Portal that are older than the period you specify. This lets you purge information about uninstalled applications that are older than the period you specify. This applies only if you are using Application Inventory. Click to save all changes. The old data is then purged from the Notification database on a daily basis. Click to cancel changes. Click to immediately purge old data from the Notification database.
Purge internal collections This lets you purge all collections that were dynamically created by Software Delivery that are no longer in use. To enable or change the purging of saved reports or events for this solution
1 2 3 4
Altiris Console, select the Configuration tab.

Software Delivery.
In the treeview pane, navigate to Configuration > Solutions Settings > Software Management > In the treeview pane, select Data Purging. In the content pane:
a b
To purge events, select the check box next to Purge events older than. Type in the number for your time period, and then select the time period (Day(s), Week(s), or Month(s)). To purge saved reports, select the check box next to Purge saved reports older than. Type in the number for your time period, and then select the time period (Day(s), Week(s), or Month(s)).
56
Data Purging
Click Apply. The following events get purged: User login/logout Event History table Transport status Push status
To disable the purging of saved reports or events for this solution

1 2 3 4 5
Altiris Console, select the Configuration tab.

Software Delivery.
In the treeview pane, navigate to Configuration > Solutions Settings > Software Management > In the treeview pane, select Data Purging. In the content pane, clear the check box next to Purge events older than and Purge saved reports older than. Click Apply.
Note: You can also use the Purge Now button to immediately purge old data from the database based on the specified settings.
57
Chapter 6:
Technical Reference
Quick Links SMS Software Delivery Integration (page 58) Troubleshooting (page 62)
SMS Software Delivery Integration

Software Delivery lets you use Notification Server to integrate with SMS and deliver and deploy SMS software packages. This is an especially useful feature if you have Altiris Agents on low speed connections (such as dial-up connections). Software Delivery lets you use SMS program, package, Software Delivery task, and collection definitions in Notification Server. Events received from the Altiris Agent related to SMS software delivery can be forwarded to SMS. To integrate SMS software delivery with Notification Server, you need to have the following: Microsoft SMS installed SMS Site Server installed SMS Distribution Point SMS client installed on the Notification Server computer if you want to forward SMS software delivery events received by Notification Server to SMS Notification Server Altiris Agent Software Delivery
When SMS objects, such as collections, advertisements, and packages are imported into Notification Server, they have the same name as in SMS, except they have (SMS) appended to their names. SMS imported advertisements (Software Delivery tasks in Notification Server) can be enabled and disabled, but are otherwise not modifiable from Notification Server.
Note: The initial importing of SMS objects into the Notification database can take several minutes.
Subsequent updates to the object information takes much less time.
You can specify the action to take when the same SMS advertisement can be run by the SMS client and the Altiris Agent. This is especially useful for an Altiris-enabled computer that can be both remote and local. When the Altiris Agent is local, SMS can handle software delivery. When the Altiris Agent is remote, Notification Server can handle software delivery. For details on specifying this, see Specifying When Notification Server Is Used for SMS Advertisements on page 60. To perform the integration of SMS and Notification Server, see Integrating SMS Software Delivery on page 59.
58
Chapter 6: Technical Reference
SMS and Notification Server Collections

If you are using Notification Server for SMS software delivery, you will import SMS collections into Notification Server. When Software Delivery imports collections from SMS, a set of collections with the same names as the SMS collections with (SMS) appended is created in Notification Server. The computers in these newly created collections are a union between the SMS collection list of computers and the computers discovered by Notification Server. For example, an SMS collection named PC has servers named A,B, C, and D. Notification Server has discovered computers named A, B, E, and F. The PC (SMS) collection on the Notification Server contains A and B. To ensure that all Notification Server discovered computers are part of the SMS collections, you need to make sure that the Data Discovery Record check box is selected on the Microsoft SMS Configuration page of the Altiris Console. Selecting this will forward the identity of all Notification Server discovered computers to SMS, so all Notification Server discovered computers are a part of an SMS collection.
Integrating SMS Software Delivery

For information on integrating Software Delivery with SMS, see SMS Software Delivery Integration on page 58. To integrate Software Delivery with SMS
1 2
Specify an SMS database (see Specifying an SMS Database on page 59). Configure Software Delivery for SMS integration (Configuring Software Delivery for SMS on page 59).
Specifying an SMS Database

If you want to integrate Software Delivery to distribute and deploy SMS packages, see Integrating SMS Software Delivery on page 59. To configure Notification Server for SMS integration
1 2 3 4
In the Altiris Console, click the Configuration tab. In the treeview pane, click on Microsoft SMS. In the right pane, click the SMS database section link to expand it. Enter the SMS database connection information. The following are the fields in the pane: SQL Server - Name of the server running SQL Server. SQL Login ID - Login ID for the SMS SQL Server database. SQL Login Password - Password for the SMS SQL Server database. SMS SQL Database - SMS database name. If the SQL Server is specified properly, this dropdown list will include the name of your SMS database.
Configure software delivery (see Configuring Software Delivery for SMS on page 59).
Configuring Software Delivery for SMS

The following procedure describes how to integrate the Notification database with an SMS database. If you want to integrate Software Delivery to distribute and deploy SMS packages, see Integrating SMS Software Delivery on page 59.
59
To configure software delivery

1 2 3 4 5
In the Altiris Console, click the Configuration tab. Click on Software Delivery in the treeview pane. In the right pane, select the Integrate with my SMS Software Delivery Environment check box. Click the SMS Site Connection Information section link to expand it. Enter the SMS site connection information. The following are the fields in this section: SMS Site Server - Name of the server running SMS Site Server. SMS Login ID - SMS Site Server login ID. SMS Login Password - Password for ID listed in the SMS Login ID field. SMS Site Code - SMS Site Status code.
Note: If you do not specify a login ID and password, the connection will be made using the
account under which the MTS package is running.
Note: If Notification Sever is installed on the same computer as SMS Site Server it is not
necessary to enter a SMS connection login ID and password.
6 7 8 9
Click the SMS Distribution Point section link to expand it. Select a distribution point location. Click the SMS Software Delivery Synchronization section link to expand it. Select the desired SMS software delivery synchronization options. The following are the fields in this section: SMS Software Objects - Select this check box to keep SMS software objects synchronized between SMS and Notification Server. Software Delivery Events - Select this check box to forward SMS software delivery event to SMS. Synchronize now - Click this link to synchronize SMS and Notification Server software delivery objects immediately. Forward now - Click this link to forward Notification Server software delivery events to the SMS server immediately. Forward as soon as possible - Select this option to forward SMS software delivery events as soon as possible after they are received by Notification Server. Forward on schedule - Select this option to forward SMS software delivery events according to a schedule after they are received by Notification Server. SMS forwarding and synchronization schedule - Click the Edit link to specify the SMS forwarding and synchronization schedule.
IMPORTANT: By default you must define a schedule for how often the Notification Server will replicate SMS advertisement data from the SMS database to the Notification database. Ensure that you select a schedule if you want updated information to appear in your Notification database. Note that you can also remove existing SMS advertisement data from your database.
10 11
If you need to authenticate to the SMS distribution point, see Setting Up Distribution Point Connection Parameters on page 51. Click the Apply button.
Specifying When Notification Server Is Used for SMS Advertisements

If you have integrated SMS with Notification Server for software delivery and both the SMS client and the Altiris Agent are installed on a managed computer, you need to specify the action to take when the same advertisement is on both clients.
60
To specify the action to take with advertisements on both clients

1 2 3 4 5
In the Altiris Console, click the Configuration tab. In the treeview pane, navigate to Client Settings. In the right pane, click the Configure the Win32 Client button. Click the SMS Integration section link to expand it. Select the desired integration option. The following are the options: Only run SMS advertisements when remote - SMS advertisements are used only by the Altiris Agent if the connection speed between the client and the network is slower than the Connection Speed Threshold defined under the Client Communication section of the same page. This is the recommended option. Run all SMS advertisements - All SMS advertisements are run by the Altiris Agent, regardless of whether they are run on the SMS client or not. Ignore all SMS advertisements - No SMS advertisements are run by the Altiris Agent.
Click Apply.
Deleting SMS Software Delivery Objects from Notification Server

This procedure describes how to delete SMS software delivery objects from Notification Server. However, unless you remove SMS software delivery integration from Notification Server, the software delivery objects will be re-imported from SMS during the next scheduled synchronization time. To remove SMS software delivery integration from Notification Server, see Removing SMS Software Delivery Integration from Notification Server on page 61. To delete SMS software delivery objects from Notification Server
1 2 3 4
In the Altiris Console, click the Configuration tab. Navigate to Software Delivery. Click the SMS Software Delivery Synchronization section link. Click the Delete all mapped SMS Software Delivery objects link.
Removing SMS Software Delivery Integration from Notification Server

To remove SMS software delivery integration from Notification Server
1 2 3 4
In the Altiris Console, click the Configuration tab. Navigate to Software Delivery. Click the SMS Software Delivery Synchronization section link to expand it. Clear the SMS Software Delivery Objects and Software Delivery Events check boxes. This will prevent the synchronization of objects and events with SMS. Delete the SMS software delivery objects from Notification Server. For details, see Deleting SMS Software Delivery Objects from Notification Server on page 61. This will remove the current SMS software delivery objects from Notification Server.
6 7
At the top of the right pane, clear the Integrate with my SMS Software Delivery Environment check box. Click the Apply button.
61
Troubleshooting
Troubleshooting
Log Files (page 62) FTP Service (page 62)
Log Files
Components that encounter errors while running place messages in a log file in the install folder \Altiris\eXpress\logs folder on the Notification Server computer. The log is an XML text file that you can open in a text editor or within Internet Explorer 5.
FTP Service
If the FTP service is not installed, you will get the following error messages: An error occurred whilst creating virtual directories to package's distribution point. Method MapPackageDistPoints() threw an error or returned empty. MapPackageDistPoints(): Error thrown by function CheckCreateDistPoints() when attempting to get/create FTP virtual directory named {0BA533E9-0C99-4E6D-8AA3-984435BFDA06}, Distribution point UNC = C:\Downloads\Acrobat Reader. ERROR: Number=80040000, Description=CheckCreateDistPoints(): Failed to get AeXNS FTP site CheckCreateDistPoints(): Failed to get AeXNS FTP site. ERROR: Number=1A8, Description=Object required GetNfySvrDir(): Failed getting IIS admin object: IIS://POULNIELSEN/MSFTPSVC. ERROR: Number=80070003, Description= To fix this problem, start the FTP service.
62
Index
A
agent software delivery solution 50 application inventory task 50 automated actions 44
sample multicasting scenario 11
N
notice 2 Notification Policies 10 notification policies 44 Notification Server collections 59 deleting SMS objects 61 removing SMS integration 61
B
bandwidth throttling 6 blockout 6
C
checking for updated package files 16 checkpoint recovery 5, 14 cleanup process 23 connection loss 14 copyright 2 creation date of document 2
P
package checking for updated files 16 deleting a program 15 deletion 15 download 14 download errors 16 location 14 overview 13 package server 13 package servers and multicasting 12 patent 2 PC Transplant 6, 38 planning information 7 policy deployment 25 prerequisites 8 priority of Software Delivery task 23 product version 2 program deletion 15
D
database 59 deploying a policy 25 document print date 2 download errors for packages 16 downloading packages 14
Software Delivery configuring for SMS 59 usage overview 9 software delivery 59 software delivery solution agent 50 Software Delivery task disabled 23 overview 22 priority 23 sample 10 scheduling 25 sequential 10 status files 23 Software Delivery tasks 10 software delivery wizard 9, 10, 15, 24, 32 Software Migration task overview 38 Software Migration Wizard 6, 40 software package 13 Software packages 13 software portal 22, 47, 50 software requester portal 45 SQL Server 7 status files 23
F
FTP service 62
T
task scheduler 25 throttling 6 trademark 2
H
HTTP 36
I
installation 8 installers 53 integrating SMS 58
R
registry key 23 requirements 8
U
UNC path 51 unicast 11 uninstall 50
S
scheduling 25 script files 16 security 7 sequential Software Delivery task 10 SMS collections 59 database 59 deleting objects from Notification Server 61 integration 51, 58 removing integration 61 software delivery 59 when Notification Server is used 60 SMS configuration 59 version 2
L
legal notice 2 license 8 log files 62 lost connection 14
V W
wizard software delivery 9, 10, 15, 24, 32
M
Microsoft SQL Server 7 MSI files 15 Multicasting 6 multicasting 11 configuring 12 package servers and multicasting 12
63

Software Delivery Solution 6.1 For Windows: Product Guide

Uploaded by

Copyright:

Available Formats

Software Delivery Solution 6.1 For Windows: Product Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Software Delivery Solution 6.1 For Windows: Product Guide

Uploaded by

Copyright:

Available Formats

ALTIRIS

SOFTWARE DELIVERY SOLUTION 6.1 FOR WINDOWS PRODUCT GUIDE

Altiris Software Delivery Solution for Windows Product Guide

Altiris Software Delivery Solution for Windows Product Guide

Configuring Application Relationships

Altiris Software Delivery Solution for Windows Product Guide

Introducing Altiris Software Delivery Solution for Windows

Software Delivery Overview

Altiris Software Delivery Solution for Windows Product Guide

Chapter 1: Introducing Altiris Software Delivery Solution for Windows

Altiris Software Delivery Solution for Windows Product Guide

Installing Altiris Software Delivery Solution for Windows

Notification Server and SQL Server

Altiris Software Delivery Solution for Windows Product Guide

Chapter 2: Installing Altiris Software Delivery Solution for Windows

Installing Software Delivery Solution

Altiris Software Delivery Solution for Windows Product Guide

Getting Started with Software Delivery Solution

Software Delivery Usage Overview

Software Delivery Solution Components

Altiris Software Delivery Solution for Windows Product Guide

Chapter 3: Getting Started with Software Delivery Solution

Software Delivery Solution Components

Sequential Software Delivery Task

Software Delivery Tasks

into the following categories:

Altiris Software Delivery Solution for Windows Product Guide

Chapter 3: Getting Started with Software Delivery Solution

Altiris Software Delivery Solution for Windows Product Guide

Chapter 3: Getting Started with Software Delivery Solution

Altiris Software Delivery Solution for Windows Product Guide

Using Software Delivery Solution

Using Software Packages and Programs

Software Packages Overview

Altiris Software Delivery Solution for Windows Product Guide

Chapter 4: Using Software Delivery Solution

Using Software Packages and Programs

Package Download Overview

Altiris Software Delivery Solution for Windows Product Guide

Chapter 4: Using Software Delivery Solution

Using Software Packages and Programs

Defining a Program for a Package

than one purpose.

Altiris Software Delivery Solution for Windows Product Guide

Chapter 4: Using Software Delivery Solution

Using Software Packages and Programs

Checking for Package Download Errors

In the Altiris Console, click the Reports tab.

Changing the Check for Updated Package Files Schedule

In the Altiris Console, click the Configuration tab.

Software Package Page

Altiris Software Delivery Solution for Windows Product Guide

Chapter 4: Using Software Delivery Solution

Using Software Packages and Programs

In Resource Manager, click on the Package tab view.

Item Name Description Publisher Language Version Package source

Altiris Software Delivery Solution for Windows Product Guide

Chapter 4: Using Software Delivery Solution

Using Software Packages and Programs