KACE Systems Management Appliance 9.1 Common Documents - Administrator Guide

About the KACE Systems Management Appliance (SMA) Getting started
Configuring the appliance
Requirements and specifications Power-on the appliance and log in to the Administrator Console Access the Command Line Console Tracking configuration changes Configuring System-level and Admin-level General Settings Configure appliance date and time settings Enable Two-Factor Authentication for all users Verifying port settings, NTP service, and website access Configuring network and security settings Configuring Agent settings Configuring session timeout and auto-refresh settings Configuring locale settings Configuring the default theme Configure data sharing preferences About DIACAP compliance requirements Configuring Mobile Device Access Enable fast switching for organizations and linked appliances Linking Quest KACE appliances Configuring history settings
Setting up and using labels to manage groups of items Configuring user accounts, LDAP authentication, and SSO Using Replication Shares Managing credentials Configuring assets
About the Asset Management component Using the Asset Management Dashboard About managing assets Adding and customizing Asset Types and maintaining asset information Managing Software assets Managing physical and logical assets Maintaining and using manual asset information Managing locations Managing contracts Managing licenses Managing purchase records
Setting up License Compliance Managing License Compliance Setting up Service Desk Configure the Cache Lifetime for Service Desk widgets Creating and managing organizations Importing and exporting appliance resources
Managing inventory
Using the Inventory Dashboard Using Device Discovery Managing device inventory
About managing devices Features available for each device management method About inventory information Tracking changes to inventory settings Managing inventory information Finding and managing devices Provisioning the KACE SMA Agent Manually deploying the KACE SMA Agent Using Agentless management Adding devices manually in the Administrator Console or by using the API Forcing inventory updates Managing MIA devices Obtaining Dell warranty information
Managing applications on the Software page Managing Software Catalog inventory
About the Software Catalog Viewing Software Catalog information Adding applications to the Software Catalog Managing License assets for Software Catalog applications Associate Managed Installations with Cataloged Software Using software metering Using Application Control Update or reinstall the Software Catalog
Managing process, startup program, and service inventory Writing custom inventory rules
Deploying packages to managed devices
Distributing software and using Wake-on-LAN Broadcasting alerts to managed devices Running scripts on managed devices Managing Mac profiles Using Task Chains
Patching devices and maintaining security
About patch management Subscribing to and downloading patches Creating and managing patch schedules Managing patch inventory Managing Dell devices and updates Maintaining device and appliance security
Using reports and scheduling notifications Monitoring servers
Getting started with server monitoring Working with monitoring profiles Managing monitoring for devices Working with alerts
Using the Service Desk
Configuring Service Desk Using the Service Desk Dashboard Managing Service Desk tickets, processes, and reports
Overview of Service Desk ticket lifecycle Creating tickets from the Administrator Console and User Console Creating and managing tickets by email Viewing tickets and managing comments, work, and attachments Merging tickets Using the ticket escalation process Using Service Desk processes Using Ticket Rules Run Service Desk reports Archiving, restoring, and deleting tickets Managing ticket deletion
Managing Service Desk ticket queues About User Downloads and Knowledge Base articles Customizing Service Desk ticket settings Configuring SMTP email servers
Maintenance and troubleshooting
Maintaining the appliance Troubleshooting the KACE SMA
Appendixes Glossary About us Legal notices

How asset information is handled during import

How asset information is handled during import

When asset information is imported, the appliance compares the new information to existing information to determine how the new information should be handled.

Depending on whether the information is new, existing, or duplicated, the appliance performs the following actions:

•
Creates the asset: If the Primary Key value does not match an existing value, the asset is created.
•
Updates the asset: If the Primary Key value matches an existing value, the asset information is updated.
•
Flags the asset as a duplicate: If multiple records for the Asset Type match the value of the CSV field chosen as the Primary Key, OR if multiple records match the associated asset, the asset is flagged as a duplicate. Duplicate records are not imported.

Importing asset data using CSV files

Importing asset data using CSV files

Prepare asset data before importing
Example: Import license data from prepared spreadsheets

You can import asset data, such as software license data, using CSV (comma separated value) files.

Prepare asset data before importing

Verify that asset data is appropriate and formatted properly before importing it.

1.
Define the basic fields for your assets. If you use product names, make sure they are useful and help to identify the asset. See Adding Software assets.
2.
Add header rows to your data. In the Asset Management component, columns without headers are referred to by their column number, so using column header rows can make it easier to identify data.
3.
Verify that all columns map to equivalent Asset Fields in the Asset Type.
Asset Types include default fields, such as Asset Name, Purchase Order Number, and Vendor, but you can add custom asset fields if necessary. See About adding and deleting asset fields.
* 
TIP: To view default fields go to the Asset Detail page. See Customizing Asset Types.
4.
Decide what field or fields to use for the primary key (PK) for the imported assets.
Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
5.
Save the spreadsheet as a CSV file, in a location you can access from the Administrator Console.
Example: Import license data from prepared spreadsheets

You can import license data from prepared CSV files.

This example describes how to import License assets for Software Catalog inventory. The example shows only the fields that are required for License asset import. You can add additional files, such as unit cost, publisher, product keys, and so on to meet your information management needs.

If you want to assign the imported assets to an Asset Subtype, add the subtype before you import the assets. See Add Asset Subtypes and select Device Detail page preferences.

1.
Create a file in a spreadsheet program such as Excel.
2.
Add the following columns and rows. The first row is a header column:

Asset Name

License Count

License Mode

Includes Maintenance

Applies to Software Catalog

Software Title 1

100

Enterprise

Yes

Software Title 1

Software Title 2

150

Enterprise

Yes

Software Title 2

Software Title 3

200

Enterprise

Yes

Software Title 3

Software Title 4

500

Enterprise

Yes

Software Title 4

3.
Save the file in CSV format.
The values in each column are separated by commas. For example: Software Title 1,100,Enterprise,Yes,Software Title 1
4.
Go to the Upload File page in the Import Assets section:
a.
Log in to the KACE SMA Administrator Console, http://KACE_SMA_hostname/admin. Or, if the Show organization menu in admin header option is enabled in the appliance General Settings, select an organization in the drop-down list in the top-right corner of the page next to the login information.
b.
On the left navigation bar, click Asset Management, then click Import Assets.
5.
Click Browse or Choose File, then select the CSV file.
6.
If the CSV file contains a header row, as it does in this example, select the File Header Row check box, then click Next.
The Asset Type Selection page appears.
7.
Select the Asset Type and Asset Subtype:
a.
In the Asset Type drop-down list, select License.
b.
In the Asset Subtype drop-down list, select Productivity.
* 
NOTE: In this example, the Asset Subtype, Productivity, has been added to the License Asset Type. The Subtype drop-down list is empty if you have not added subtypes for the License Asset Type. During import, all assets are assigned to the selected subtype.
c.
Click Next.
The Mapping page appears.
8.
In the CSV Fields drop-down list, select the fields that correspond to the appliance Required Standard Fields and Required Asset Fields. The mapping of these fields depends on the contents of your CSV file and the Asset Type. For the example in this section, use the following values:
◦
Asset Name=Asset Name
◦
License Count=License Count
◦
Applies to Cataloged Software=Software Catalog
◦
License Mode=Mode
9.
Select the PK check box next to the Asset Name field.
* 
NOTE: Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
10.
If the assets you are importing use barcodes, in the Barcode Fields area, indicate how you want to import the barcodes.

Option

Description

Update asset barcodes with selected

Check if the barcodes supplied in this area already exist, and if they do, update them. If they do not exist, they are created for the specified assets.

Replace all asset barcodes with selected

Replace the existing barcodes with the specified barcodes.

Barcode Data

The field in the CSV file that contains the barcode. There can be only one barcode of the same type per asset.

Barcode Name

The field in the CSV file that contains the barcode tag. Barcode numbers are always unique, they cannot be shared between multiple assets. However, it is possible for an active asset to share a barcode with an archived asset.

Barcode Format

The field in the CSV file that contains the barcode format. For example, UPC-A, Code 11, or UPC-E.

11.
Click Preview to verify the data on the Confirmation page.
12.
Click Import to complete the import process.
The Result for Asset Import page appears.
13.
Click Done to return to the Assets page.
When the import is complete, the assets appear in the Assets list. If the titles of the software matched titles in the Software Catalog inventory, the assets are associated with the inventory items and you can view them on the Software Catalog Detail page for the items.

Prepare asset data before importing

Importing asset data using CSV files

Prepare asset data before importing
Example: Import license data from prepared spreadsheets

You can import asset data, such as software license data, using CSV (comma separated value) files.

Prepare asset data before importing

Verify that asset data is appropriate and formatted properly before importing it.

1.
Define the basic fields for your assets. If you use product names, make sure they are useful and help to identify the asset. See Adding Software assets.
2.
Add header rows to your data. In the Asset Management component, columns without headers are referred to by their column number, so using column header rows can make it easier to identify data.
3.
Verify that all columns map to equivalent Asset Fields in the Asset Type.
Asset Types include default fields, such as Asset Name, Purchase Order Number, and Vendor, but you can add custom asset fields if necessary. See About adding and deleting asset fields.
* 
TIP: To view default fields go to the Asset Detail page. See Customizing Asset Types.
4.
Decide what field or fields to use for the primary key (PK) for the imported assets.
Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
5.
Save the spreadsheet as a CSV file, in a location you can access from the Administrator Console.
Example: Import license data from prepared spreadsheets

You can import license data from prepared CSV files.

This example describes how to import License assets for Software Catalog inventory. The example shows only the fields that are required for License asset import. You can add additional files, such as unit cost, publisher, product keys, and so on to meet your information management needs.

If you want to assign the imported assets to an Asset Subtype, add the subtype before you import the assets. See Add Asset Subtypes and select Device Detail page preferences.

1.
Create a file in a spreadsheet program such as Excel.
2.
Add the following columns and rows. The first row is a header column:

Asset Name

License Count

License Mode

Includes Maintenance

Applies to Software Catalog

Software Title 1

100

Enterprise

Yes

Software Title 1

Software Title 2

150

Enterprise

Yes

Software Title 2

Software Title 3

200

Enterprise

Yes

Software Title 3

Software Title 4

500

Enterprise

Yes

Software Title 4

3.
Save the file in CSV format.
The values in each column are separated by commas. For example: Software Title 1,100,Enterprise,Yes,Software Title 1
4.
Go to the Upload File page in the Import Assets section:
a.
Log in to the KACE SMA Administrator Console, http://KACE_SMA_hostname/admin. Or, if the Show organization menu in admin header option is enabled in the appliance General Settings, select an organization in the drop-down list in the top-right corner of the page next to the login information.
b.
On the left navigation bar, click Asset Management, then click Import Assets.
5.
Click Browse or Choose File, then select the CSV file.
6.
If the CSV file contains a header row, as it does in this example, select the File Header Row check box, then click Next.
The Asset Type Selection page appears.
7.
Select the Asset Type and Asset Subtype:
a.
In the Asset Type drop-down list, select License.
b.
In the Asset Subtype drop-down list, select Productivity.
* 
NOTE: In this example, the Asset Subtype, Productivity, has been added to the License Asset Type. The Subtype drop-down list is empty if you have not added subtypes for the License Asset Type. During import, all assets are assigned to the selected subtype.
c.
Click Next.
The Mapping page appears.
8.
In the CSV Fields drop-down list, select the fields that correspond to the appliance Required Standard Fields and Required Asset Fields. The mapping of these fields depends on the contents of your CSV file and the Asset Type. For the example in this section, use the following values:
◦
Asset Name=Asset Name
◦
License Count=License Count
◦
Applies to Cataloged Software=Software Catalog
◦
License Mode=Mode
9.
Select the PK check box next to the Asset Name field.
* 
NOTE: Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
10.
If the assets you are importing use barcodes, in the Barcode Fields area, indicate how you want to import the barcodes.

Option

Description

Update asset barcodes with selected

Check if the barcodes supplied in this area already exist, and if they do, update them. If they do not exist, they are created for the specified assets.

Replace all asset barcodes with selected

Replace the existing barcodes with the specified barcodes.

Barcode Data

The field in the CSV file that contains the barcode. There can be only one barcode of the same type per asset.

Barcode Name

The field in the CSV file that contains the barcode tag. Barcode numbers are always unique, they cannot be shared between multiple assets. However, it is possible for an active asset to share a barcode with an archived asset.

Barcode Format

The field in the CSV file that contains the barcode format. For example, UPC-A, Code 11, or UPC-E.

11.
Click Preview to verify the data on the Confirmation page.
12.
Click Import to complete the import process.
The Result for Asset Import page appears.
13.
Click Done to return to the Assets page.
When the import is complete, the assets appear in the Assets list. If the titles of the software matched titles in the Software Catalog inventory, the assets are associated with the inventory items and you can view them on the Software Catalog Detail page for the items.

Example: Import license data from prepared spreadsheets

Importing asset data using CSV files

Prepare asset data before importing
Example: Import license data from prepared spreadsheets

You can import asset data, such as software license data, using CSV (comma separated value) files.

Prepare asset data before importing

Verify that asset data is appropriate and formatted properly before importing it.

1.
Define the basic fields for your assets. If you use product names, make sure they are useful and help to identify the asset. See Adding Software assets.
2.
Add header rows to your data. In the Asset Management component, columns without headers are referred to by their column number, so using column header rows can make it easier to identify data.
3.
Verify that all columns map to equivalent Asset Fields in the Asset Type.
Asset Types include default fields, such as Asset Name, Purchase Order Number, and Vendor, but you can add custom asset fields if necessary. See About adding and deleting asset fields.
* 
TIP: To view default fields go to the Asset Detail page. See Customizing Asset Types.
4.
Decide what field or fields to use for the primary key (PK) for the imported assets.
Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
5.
Save the spreadsheet as a CSV file, in a location you can access from the Administrator Console.
Example: Import license data from prepared spreadsheets

You can import license data from prepared CSV files.

This example describes how to import License assets for Software Catalog inventory. The example shows only the fields that are required for License asset import. You can add additional files, such as unit cost, publisher, product keys, and so on to meet your information management needs.

If you want to assign the imported assets to an Asset Subtype, add the subtype before you import the assets. See Add Asset Subtypes and select Device Detail page preferences.

1.
Create a file in a spreadsheet program such as Excel.
2.
Add the following columns and rows. The first row is a header column:

Asset Name

License Count

License Mode

Includes Maintenance

Applies to Software Catalog

Software Title 1

100

Enterprise

Yes

Software Title 1

Software Title 2

150

Enterprise

Yes

Software Title 2

Software Title 3

200

Enterprise

Yes

Software Title 3

Software Title 4

500

Enterprise

Yes

Software Title 4

3.
Save the file in CSV format.
The values in each column are separated by commas. For example: Software Title 1,100,Enterprise,Yes,Software Title 1
4.
Go to the Upload File page in the Import Assets section:
a.
Log in to the KACE SMA Administrator Console, http://KACE_SMA_hostname/admin. Or, if the Show organization menu in admin header option is enabled in the appliance General Settings, select an organization in the drop-down list in the top-right corner of the page next to the login information.
b.
On the left navigation bar, click Asset Management, then click Import Assets.
5.
Click Browse or Choose File, then select the CSV file.
6.
If the CSV file contains a header row, as it does in this example, select the File Header Row check box, then click Next.
The Asset Type Selection page appears.
7.
Select the Asset Type and Asset Subtype:
a.
In the Asset Type drop-down list, select License.
b.
In the Asset Subtype drop-down list, select Productivity.
* 
NOTE: In this example, the Asset Subtype, Productivity, has been added to the License Asset Type. The Subtype drop-down list is empty if you have not added subtypes for the License Asset Type. During import, all assets are assigned to the selected subtype.
c.
Click Next.
The Mapping page appears.
8.
In the CSV Fields drop-down list, select the fields that correspond to the appliance Required Standard Fields and Required Asset Fields. The mapping of these fields depends on the contents of your CSV file and the Asset Type. For the example in this section, use the following values:
◦
Asset Name=Asset Name
◦
License Count=License Count
◦
Applies to Cataloged Software=Software Catalog
◦
License Mode=Mode
9.
Select the PK check box next to the Asset Name field.
* 
NOTE: Primary Keys are the fields, or combinations of fields, used as unique identifiers for assets being imported. When assets are imported, the appliance uses Primary Keys to determine whether to update an existing record or create a record. You can select one field, or a combination of fields, as the PK.
10.
If the assets you are importing use barcodes, in the Barcode Fields area, indicate how you want to import the barcodes.

Option

Description

Update asset barcodes with selected

Check if the barcodes supplied in this area already exist, and if they do, update them. If they do not exist, they are created for the specified assets.

Replace all asset barcodes with selected

Replace the existing barcodes with the specified barcodes.

Barcode Data

The field in the CSV file that contains the barcode. There can be only one barcode of the same type per asset.

Barcode Name

The field in the CSV file that contains the barcode tag. Barcode numbers are always unique, they cannot be shared between multiple assets. However, it is possible for an active asset to share a barcode with an archived asset.

Barcode Format

The field in the CSV file that contains the barcode format. For example, UPC-A, Code 11, or UPC-E.

11.
Click Preview to verify the data on the Confirmation page.
12.
Click Import to complete the import process.
The Result for Asset Import page appears.
13.
Click Done to return to the Assets page.
When the import is complete, the assets appear in the Assets list. If the titles of the software matched titles in the Software Catalog inventory, the assets are associated with the inventory items and you can view them on the Software Catalog Detail page for the items.
Documents connexes