Chat now with support
Chat with Support

KACE Systems Deployment Appliance 9.2 Common Documents - Administrator Guide

About the KACE Systems Deployment Appliance Getting started Using the Dashboard Configuring the appliance Setting up user accounts and user authentication Configuring security settings Preparing for deployment Managing device inventory Using labels Creating a Windows or Linux Boot Environment Managing drivers Capturing images Capturing user states Creating scripted installations Creating a task sequence Automating deployments Performing manual deployments Managing custom deployments Managing offline deployments About the Remote Site Appliance Importing and exporting appliance components Managing disk space Troubleshooting appliance issues Updating appliance software Glossary About us Legal notices

Adding Managed Installation tasks

Adding Managed Installation tasks

Link appliances
View and import Managed Installations
Edit Managed Installation task

On the KACE Systems Management Appliance, Managed Installations (MI) are the primary mechanism for deploying applications to managed devices. Each Managed Installation is associated with a specific application title, version, and its command line. For complete information about Managed Installations, see the KACE Systems Management Appliance Administrator Guide.

The KACE Systems Deployment Appliance has a mechanism to install applications as part of the deployment process. Importing a Managed Installation from the KACE Systems Management Appliance allows you to quickly add it to a system deployment task sequence, when needed.

Link appliances

Link appliances

To enable importing of Managed Installations, you must link the KACE Systems Deployment Appliance with the KACE Systems Management Appliance that contains Managed Installations that you want to import.

1.
Complete the following configuration steps on the KACE Systems Management Appliance:

Step

For complete details, see this topic in the KACE Systems Management Appliance Administrator Guide:

•
Link the KACE Systems Management Appliance with the KACE Systems Deployment Appliance and enable access to the Federation API settings.
1.
In the KACE Systems Management Appliance System Administration Console, click Settings.
2.
On the Control Panel, click Link Settings.
3.
On the Linked Appliance Enablement page, select the following check boxes:
▪
Enable Appliance Linking
▪
Enable Federation API access settings

Enable appliance linking

•
Enable Federation API access to the linked KACE Systems Deployment Appliance.
1.
In the KACE Systems Management Appliance Administrator Console, select an Organization associated with a linked KACE Systems Deployment Appliance, and click Settings.
2.
On the Control Panel, click Federation API Settings.
3.
On the Federation API Settings page, select Enable access.
4.
Grant the Administrator role to the linked KACE Systems Deployment Appliance.
5.
Repeat these steps for each Organization associated with the KACE Systems Management Appliance.

Enable access to Federation API settings

View and import Managed Installations

View and import Managed Installations

Use the Import Managed Installations page to review the applications that you want to import.

Ensure your KACE Systems Deployment Appliance is linked to the KACE Systems Management Appliance from which you want to import one or more Managed Installations. For more information, see Link appliances.
* 
NOTE: Each KACE Systems Management Appliance comes with a default organization (named Default). If your appliance is linked with the Default organization on a KACE Systems Management Appliance, and the organization name changes, you must provide the new organization name:
1.
On the left navigation pane, click Settings > Control Panel > Linked Appliances.
2.
On the Linked Appliances page that appears, click the name or IP address of the linked KACE Systems Management Appliance.
3.
On the Edit Linked Appliance Detail page that appears, in the Default ORG Name field, type the organization name, and click Save.
1.
On the left navigation pane, click Library to expand the section, then click Post-installation Tasks to display the Post-installation Tasks page.
2.
On the Post-Installation Tasks page, select Choose Action > Import a Managed Installation.
3.
On the Import Managed Installations page that appears, just above the list of Managed Installations, click KACE Systems Management Appliance, and ensure this field points to the correct KACE Systems Management Appliance.
Tip:
 
TIP: Your appliance may be linked to multiple KACE Systems Management Appliances.
4.
Click View By, and choose the managed organization and the type of Managed Installation: Software or Software Catalog.
Your selection depends on the type of application that you want to import. All applications installed on the devices managed by the KACE Systems Management Appliance are listed when you select Software. Some of those applications are also in the Software Catalog. The Software Catalog is a database that contains standardized information about more than 60,000 Windows and Mac applications and software suites. For more information about Software applications, and the Software Catalog, see the KACE Systems Management Appliance Administrator Guide.
5.
To look for a specific application, type the application name in the Search List field.
6.
Review the list of Managed Installations.
The following information is available for each Managed Installation:
◦
Name: The application name.
◦
Version: The application version.
◦
Publisher: The application publisher.
◦
Imported: An indicator of whether a Managed Installation is already imported to the KACE Systems Deployment Appliance.
7.
To import a Managed Installation to the appliance, select the row containing the Managed Installation entry, and select Choose Action > Import.
The Import Managed Installations page refreshes, and a message appears at the top of the page, indicating that the import is in progress. You can review the progress of the import operation on the Package Management Queue page. For more information about this page, see Importing and exporting appliance components. When the import finishes, the imported Managed Installation appears on the Post-Installation Tasks list.

Next, edit the post-installation task containing the imported Managed Installation. For more information, see Edit Managed Installation task.

Edit Managed Installation task

Edit Managed Installation task

When you add a Managed Installation from the linked KACE Systems Management Appliance to run as a mid-level task, you can edit it, as required.

Ensure the Managed Installation associated with the task you want to view or edit is imported into the KACE Systems Deployment Appliance. For more information, see View and import Managed Installations.
1.
On the left navigation pane, click Library to expand the section, then click Mid-level Tasks to display the Mid-level Tasks page.
2.
On the Mid-level Tasks page, click the name of the task containing a Managed Installation to display the Mid-level Task Detail page.
3.
Review and update the following fields, as applicable:

Option

Description

Created (read-only)

The date and time when the task was created.

Modified (read-only)

The date and time when the task was last modified.

Version (read-only)

The version number of the task object on the KACE Systems Deployment Appliance. Every time a task changes, this number increases. Use it as a reference, to verify if the task was changed after your last update.

* 
NOTE: For example, changing the command-line parameters associated with the application executable results in version change. If you want to overwrite your changes and re-import the original Managed Installation, under Managed Installation Import Details, click Import Again.

Name

The name of the task.

Application (read-only)

The name of the application associated with the task.

Runtime Environment

The OS on which the application can be installed. See About runtime environments.

* 
NOTE: A KACE Boot Environment (KBE) built with the 5.0 Media Manager or the KBE Manipulator functionality is required, in order to include PowerShell in the KBE, to enable a Windows KBE runtime environment PowerShell task to work as expected.

Full Command Line

The command line for the task, including any command-line parameters, as defined in the Managed Installation.

Expected Return Code

A code that the task should return, if applicable. In general, most tasks exit with a zero '0' code, indicating success, but you can set it to any positive value, as applicable. Some installers exit with a different code, even when the install is successful. For example, anti-virus installers are typically successfully installed but exit with a different return code because they require a device reboot.

Notes

Additional information about the task.

Managed Installation Import Details

Information about the Managed Installation on the KACE Systems Management Appliance (read-only):

•
KACE SMA Server: The name or IP address on which the server is running.
•
KACE SMA Organization: The name of the organization in which the Managed Installation is defined.
•
Imported version: The version number of the Managed Installation object on the KACE Systems Management Appliance. You can use this number to verify if the original object was changed, and to import the latest version.

If you made any changes to the task after importing the Managed Installation (such as modifying command-line parameters), and you want to revert to its original state, click Import Again.

Deployment Details

Information about the deployments referencing this task (read-only):

•
Scripted Installations: A list of any scripted installations referencing this task.
•
System Images: The system images containing this application.
4.
Click Save.
The task is now available to assign to scripted installations, sysprepped system images, and non-sysprepped system image deployments.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating