KACE Systems Management Appliance 9.1 Common Documents

Access the Command Line Console

The Command Line Console is a terminal window interface to the KACE SMA. You can use this interface to configure appliance settings, just as you would in the appliance Administrator Console. This is useful if a DHCP server is not available and you cannot log in to the Administrator Console.

The Command Line Console is not used with K1 as a Service.

If you have a physical version of the appliance:

Connect a monitor and keyboard directly to the appliance.

Connect a network cable to the port indicated:

The port is the second from the left in the upper middle section of the back plate.

Power on the appliance.

The Command Line Console login screen appears on the monitor connected to the appliance.

If you have a virtual version of the appliance, power on the virtual machine to boot the appliance.

The Command Line Console login screen appears.

At the prompts, enter:

Password: konfig

Choose the language to use for the Command Line Console. Use the up- and down-arrow keys to move between fields.

Configure network settings. See Change appliance network settings.

TIP: Use the right- and left-arrow keys to select options in a field; use the up- and down-arrow keys to move between fields.

Use the down-arrow key to move the cursor to Save, then press Enter or Return.

The appliance restarts.

Tracking configuration changes

If History subscriptions are configured to retain information, you can view the details of the changes made to settings, assets, and objects.

This information includes the date the change was made and the user who made the change, which can be useful during troubleshooting.

Configuring System-level and Admin-level General Settings

Configure appliance General Settings with the Organization component enabled

Configure Admin-level or organization-specific General Settings

Configure appliance General Settings without the Organization component

If the Organization component is enabled on your appliance, General Settings are available at the System level and at the Admin level. If the Organization component is not enabled on your appliance, all General Settings are available at the Admin level.

If the Organization component is enabled on your appliance, see:

•

Configure appliance General Settings with the Organization component enabled.

•

Configure Admin-level or organization-specific General Settings.

If the Organization component is not enabled, see:

•

Configure appliance General Settings without the Organization component.

Configure appliance General Settings with the Organization component enabled

If the Organization component is enabled on your appliance, configure appliance General Settings at the System level.

If the Organization component is not enabled on your appliance, see Configure appliance General Settings without the Organization component.

Go to the System-level General Settings page:

Log in to the KACE SMA System Administration Console, http://KACE_SMA_hostname/system, or select System from the drop-down list in the top-right corner of the page.

On the left navigation bar, click Settings.

On the Control Panel, click General Settings.

In the top section, provide the following information:

Option	Description
Company Name	Enter the name of your company.
Default Locale	Select the language to use in the Command Line Console, which uses the konfig user account.
Company Email Suffix	Enter the domain from which your users send email. For example: quest.com.
Appliance Administrator Email	Enter the email address of the appliance administrator. System-related messages, including critical alerts, are sent to this address.
Session Timeout	Set the number of inactive hours to allow before closing user sessions and requiring users to log in again. The default is 1. The User Console and Administrator Console have Timeout Session counters to alert users of this time limit. Only periods of inactivity are counted. The counter restarts when the user performs any action that causes the console to interact with the appliance server, such as refreshing a window, saving changes, and changing windows. When the counter reaches the limit, the user is logged out, unsaved changes are lost, and the login screen appears. The Timeout Session counter appears in the upper right of each console.
Enable mobile device access	Enable or disable Mobile Device Access to the appliance. Mobile device access enables you to interact with the KACE SMA using the KACE GO app on iOS and Android smart phones and tablets. Administrators can use the app to access Service Desk, inventory, and application deployment features. See Configuring Mobile Device Access.
Require organization selection at login	Display the Organization drop-down list on the Administrator Console login page, http://KACE_SMA_hostname/admin, where KACE_SMA_hostname is the hostname of your appliance. This enables you to choose an organization when you log in. If this option is disabled, the Organization drop-down list is not displayed on the login page, and you can only log in to the Default organization from http://KACE_SMA_hostname/admin. If organization fast switching is enabled, however, you can switch between organizations after you log in to the Default organization.
Show organization menu in admin header	Display the fast-switching drop-down list in the top-right corner of the Administrator Console next to the login information. This drop-down list makes it possible to bypass the login page when you switch from one organization to another. To appear in the drop-down list, organizations must have the same admin account password; only those organizations whose admin account passwords match appear in the list. Changes to the drop-down list are displayed only after you log out and then log in again.
Enable linked reporting	Select to allow the generation of reports from Federated (linked) KACE SMAs.

In the Agent section, view or configure KACE SMA Agent task throughput:

Option

Description

Last Task Throughput Update

This value indicates the date and time when the appliance task throughput was last updated.

Current Load Average

The value in this field depicts the load on an appliance at any given point of time. For the appliance to run normally, the value in this field must be between 0.0 and 10.0.

Task Throughput

The value that controls how scheduled tasks, such as inventory collection, scripting, and patching updates, are balanced by the appliance.

NOTE: This value can be increased only if the value in the Current Load Average is not more than 10.0, and the Last Task Throughput Update time is more than 15 minutes.

In the User Console section, modify the text as needed:

Option	Description
Title	The heading that appears on the User Console login page.
Welcome Message	A welcome note or description of the User Console. This text appears below the title on the User Console login page.

In the Acceptable Use Policy section, select policy settings:

Option	Description
Enabled	Enable the appliance to display your policy, and require users to accept the terms of your policy, when they access the Administrator Console, User Console, or Command Line Console, or log in using SSH or FTP.
Title	The heading of the policy to be displayed on the login page of the User Console.
Message	Details of the policy, which are displayed below the Title on the login page. Users must agree to the terms of the policy before they can log in to the User Console.

In the Reporting section, specify the password for the reporting system:

Option	Description
Username	(Read-only) The username used to generate reports. The report username provides access to the database (for additional reporting tools), but does not give write access to anyone.
User Password	The report user password. This password is used only by the reporting system and MySQL™.

In the Log Retention section, select the number of days to retain log information. Log entries that are older than the selected number of days are automatically deleted from the log. See View appliance logs.

In the Share with Us section, select data sharing options:

To validate the KACE SMA product license, Quest collects minimal license-related information, such as the MAC Address of the KACE SMA, the version of the KACE SMA software, the license key, and the number of managed devices, regardless of the data sharing options selected in this section.

Option	Description
Share summary usage data...	(Recommended) Share summary information with Quest. This information includes appliance status, uptime, and load averages, as well as the number of devices, Managed Installations, and applications being managed by the appliance. This option is recommended because it provides additional information to Quest Support if you need assistance. In addition, data shared with Quest is used when planning product enhancements.
Share detailed usage data...	(Recommended) Share detailed information with Quest and share anonymous information with ITNinja.com. This information includes Agent and appliance crash reports, user interface usage statistics, and inventory information, such as application titles. Quest uses this information to help improve the Software Catalog, and ITNinja uses anonymous data to identify relevant content on http://www.itninja.com for dynamic feeds to the KACE SMA Administrator Console. ITNinja.com is a community website where IT professionals can share information and research on a wide variety of systems management and deployment topics. The ITNinja feed is a feature that dynamically displays software deployment tips and other contextual information on relevant pages in the KACE SMA Administrator Console. To enable the ITNinja feed, you need to select Share detailed Usage data.... This setting shares information anonymously with ITNinja. The ITNinja feed is available only if Share Summary Usage Data... is selected, and it is available only on pages related to software or deployment, such as the software, Managed Installation, and File Synchronization detail pages. The feed is not available on the Software Catalog detail page. Clear this option to prevent the appliance from sharing inventory data with the ITNinja community. However, clearing this option does not remove any information that has already been shared. For more information, contact Quest Support.
Share extended patch diagnostics	(Recommended) Share detailed patch diagnostics with Quest.

To use a custom logo in the User Console, select images in the Logo Overrides section. Click Browse or Choose File to select the logo file.

NOTE: You can change the logo in the User Console only; you cannot change the logo in the Administrator Console.

Option

Description

User Console

The logo or other graphic displayed at the top of the User Console. The User Console is the web-based interface that makes applications available to users on a self-service basis. It also enables users to file Service Desk support tickets to request help or report issues. To access the User Console, go to http://<KACE_SMA_hostname>/user where <KACE_SMA_hostname> is the hostname of your appliance. Follow these guidelines for User Console graphics:

•

224 pixels wide by 50 pixels high is the default size.

•

104 pixels wide by 50 pixels high stays inside the blue highlight around the Log Out link.

•

300 pixels wide by 75 pixels high is the maximum size that does not impact the layout.

Report

This setting controls the logo used when generating System-level reports.

Upload a logo or other graphic to be displayed at the top of reports. The graphic must be 201 pixels wide by 63 pixels high as specified in the auto-generated XML layout. To use a different size, adjust the output of the XML report.

To see the default report logo and a customized version, refer to the following illustrations.

Figure 1. Default User Console logo

Figure 2. Custom User Console logo

Figure 3. Default report logo

Figure 4. Custom report logo

Figure 5. Default Alert logo

Figure 6. Custom Alert logo

10.

If you manage Hewlett-Packard (HP) or Lenovo devices, you can retrieve their warranty information. To do that, in the Manufacturer Warranty API Keys section, provide the HP and/or Lenovo API keys to obtain the warranty data. Lenovo requires only a key whereas HP requires both a key and a secret. These values are stored encrypted in the database.

IMPORTANT: To obtain warranty information, you must configure the manufacturer's warranty API keys. For complete instructions, visit https://go.kace.com/to/k1000-help-warranty.

When configured, the device warranty information appears on the Device Details page in the Inventory Information group when you select an HP or Lenovo device. For more information, see Groups and sections of items in device details.

Option	Description
Hewlett-Packard	Select this option if you want to obtain warranty information for your managed HP devices. If this option is selected and you clear it, the HP API key and secret are removed from the database.
Key	The API key for obtaining warranty information for managed HP devices.
Secret	The secret for obtaining warranty information for managed HP devices.
Lenovo	Select this option if you want to obtain warranty information for your managed Lenovo devices. If this option is selected and you clear it, the Lenovo key is removed from the database.
Key	The API key for obtaining warranty information for managed Lenovo devices.

11.

Click Save and Restart Services.

KACE Systems Management Appliance 9.1 Common Documents - Administrator Guide

Access the Command Line Console

Access the Command Line Console

Tracking configuration changes

Tracking configuration changes

Configuring System-level and Admin-level General Settings

Configuring System-level and Admin-level General Settings

Configure appliance General Settings with the Organization component enabled

Configure appliance General Settings with the Organization component enabled