Computer Details Window

The computer details window displays everything that is known about a particular computer. You can open the computer details window for a computer by double clicking the computer in the Computers Window. By customizing columns in the Computers window (right click in its window header area), you can display most of the information from the Detail window's Information and Audit panes in tabular form in the Computers window itself.

See also our Short Burst Training Video on this topic.

     Computer Details Window

Categorization Pane

The Categorization pane shows the most basic information about how KeyServer identifies and treats this computer.

  • The Login type affects whether the client can login to the server, and how a seat is allocated for it. If a date is shown next to the Login type, this shows the date and time at which the server seat for this client will be revoked if there is no further activity on the client computer. To read more about Login types, refer to the Computer Window Document.
  • Map Availability - Here you can set if the computer is available for physical or remote login or both. If a computer is set to Physical only, it will show on maps but not show a remote link regardless of your other remote settings for the Floorplan. You can also set the Auto-logout flag, which says if a remote connection is dropped, log off the user automatically after a few minutes.
  • Next the Computer ID is shown. The Computer ID is assigned by KeyServer, according to the settings in Computer ID Types in the Config Menu. Next to this is the checkbox for Dual-boot which will indicate that audits from different operating systems should be merged not replaced. This will allow the machine to show software for both Mac and Windows for example, instead of only one at a time.
  • The Client Version of KeyAccess is shown, as well as if Auto-updates are enabled (default on). Note that the auto update feature is also dependent on the setting in the Division the computer is a member of. The latter does not propagate to the member computers, but both need to be enabled for the feature to apply.
  • If the computer is assigned to a Division this will be listed, otherwise Uncategorized will be shown. There is also a checkbox to set if the computer is Anchored to the shown division, which indicates no rules or client mapping will move it automatically.
  • Finally, a Tags field allows adding and removing of tags for this Computer.
  • Information Pane

         Computer Details Information Pane

    This pane shows hardware information about the computer, such as the Computer Name and the Last Address the computer used when connecting to KeyServer. If you hold the cursor over some of these properties, you may see additional information. For example, holding the cursor over the MAC address will reveal information about what type of interface it is (e.g. Gigabit Ethernet), and will show any additional MAC addresses which have been identified on the client. Hovering over the Memory information will show each RAM slot in the system. The Service URL will be populated automatically if the record was created by Import script like JAMF and link out to the record in the source system. An actual link will be displayed in the Web UI on that field.

    Audit Pane

         Computer Details Audit Pane

    This pane shows information about software audits from the computer. You can configure the default Audit Schedule in the General Settings.

    Policies Pane

         Computer Details Policies Pane

    This pane contains a list of Manage Policies which this computer currently has a license for, or in some cases simply has used. Node and Lease Policies are listed in bold, and these policies currently have a license allocated to the computer. Policies which are not in bold are Site, Concurrent or Observe policies, and these have been used on the computer, but are not necessarily currently in use (and therefore not necessarily allocated). Policies which have not been used on the computer for over 60 days are listed in italics.

    Since an administrator can add and delete computers from node lists for policies, this list may show policies which the computer has never actually used (in which case the Last Usage column will show the time at which the administrator manually added the computer to the node list).

    Also note that policies can be dragged directly from the Policies window into this list in order to add the computer to the node list for the policy. Likewise, policies can be deleted from this list, deleting the computer from the node list for the policy. In the case of a Node or Lease Policy, deleting the policy from the list will also revoke it, allowing a different computer to then use that license if necessary.

    Groups Pane

         Computer Details Groups Pane

    This pane contains a list of Groups which the computer belongs to as a member of the node list for the group. That is, the computer may be able to match a group based on location or filter definitions associated with the group, but that group won't be listed in the Groups pane of the computer details, because the computer isn't explicitly defined in the node list of the group.

    Asset Pane

         Computer Details Asset Pane

    This pane contains optional manual fields for inventory and lifecycle management. Some of these can be automatically populated from the client, if KeyAccess finds values on the local computer in the relevant registry keys or plist entries. They can also be set in bulk using Scripts or through CSV Import.

    The Lifecycle Stage pull down is your first choice. The default value is Deployed, which is the only status that will be displayed in Availability Maps in an available state. Maintenance will show as Out of Service in maps. All other statuses will hide the computer from map lists. You can customize these using Custom Values.

    Clicking the History button in the upper corner will open another window with the historic changes to this asset. This includes things like Department and Owner change so you can view the life of the asset moving through the organization. Like other windows you can sort by any of the columns to more easily see all events of a certain type.

         Computer History

    The Asset ID field is intended for any internal identifier your organization might use. It has a few special behaviors to be aware of. If there is a registry value that will be used automatically (see below for more details). Windows KeyAccess will also check WMI for Win32_SystemEnclosure -> SMBIOSAssetTag and use that if there is a value. Many manufacturers will populate the serial number in the BIOS, so be aware this will be used and overwrite manual values if it exists. You may consider part of your deployment workflow being setting your internal Asset ID in the BIOS for this reason to automate the data collection.

    There are no specific guidelines for how these various asset fields should be used. It is up to the individual customer to decide if and how each one is useful in their setting. Geolocation in particular is a special request that does not actually have an impact on Maps in the Web UI.

    The Loan fields can be leveraged using a Dashboard Widget to show due and overdue items. They are also automatically set (along with the Lifecycle) when using the Loaner Checkout Extra in the Web UI.

    The Confirmed and Confirmed By fields will not be populated automatically. A privileged user can click the Confirm button to populate these fields to show when and by who the computer details were verified. Note that once populated, they will not be cleared if KeyAccess subsequently sends up new data from the client registry values.

    You can manually enter values in KeyConfigure in the Asset ID, Location, and Owner fields, as long as no clients have registry/plist values for these fields which will overwrite the manual entries. If clients have such entries, the values will get overwritten with the values from the client when it next logs in. So if you are trying to force a manual change, you should check the Locked checkbox. This will prevent any automatic changes originating from the client in all fields in the Asset (and Custom Columns) panes. This is also handy to ensure no accidental changes are made to these fields as you must unlock before edit.

    Client side Population

    Windows KeyAccess looks in the registry key HKLM\SYSTEM\CurrentControlSet\Services\KeyAccess\Settings\options for string values assetID, assetLocation, assetOwner, assetBuilding, assetRoom, assetManagedBy, assetRegion, and site (Department).

    Mac KeyAccess looks for the same property names in /Library/Preferences/com.sassafras.KeyAccess.plist

    No other asset fields have registry/plist values, only the four mentioned. However note that Custom Columns do have registry/plist values to allow for automations of custom data (see below for more details).

    Any of these registry/plist values could be written to programmatically by some client side scripting. There are also variables that can be used in the registry to refer to other values.

    %foo%	GetEnvironmentVariable - i.e. any system environment variable can be populated by name like %windir% (not that you'd use that)
    <path>	GetRegistryValue - i.e. point to the registry key who's value you want to use

    Note that the Department (site) can also be set during the install of KeyAccess using the PROP_SITE Deployment option.

    One way to set these values on a Mac is using the command line:

    sudo defaults write /Library/Preferences/com.sassafras.KeyAccess assetID my_id 

    You can do this prior to client install in a scripted action so the values are read when the client starts. You can also set them with the client config utility


    Purchase Pane

         Computer Details Purchases Pane

    This pane shows data about the purchase of this computer. You can either enter relevant dates (and Salvage Value) directly in this computer record, or you can link this computer to a purchase record. To make this link, simply drag the hardware purchase from the Purchases Window into the Purchase field of this pane. There are some Dashboard Widgets that report on Residual Value and Salvage value that use this data.

    Install Codes

         Computer Details Install Codes Pane

    This pane displays any install codes that have been associated with the computer in the Install Codes Pane of the Purchase Details window. Codes can not be added here, but they can be deleted to free the code in the Purchase for reallocation.

    Custom Columns Pane

         Computer Details Custom Columns Pane

    This pane shows any custom columns which have been defined. Once you define custom fields you can populate the values in computer records. These can also be populated from the client based on special registry values. For more information on defining and using custom columns, see the Custom Columns documentation. Note the Locked option in the Asset Pane will prevent automatic or accidental change to these fields.

    Devices Pane

         Computer Details Devices Pane

    This pane lists all automatically discovered or manually linked Devices. This is useful for tracking equipment allocated with the computer in the environment.

    Notes Pane

         Computer Details Notes Pane

    This pane is a free-form text field. You can use it for any information you want and could be useful for noting system history.