4.3 Integrating Service Desk with ZENworks

ZENworks Service Desk brings with it a host of new and exciting features. One of these is the ability to leverage the capabilities of ZENworks Configuration Management bundles from within ZENworks Service Desk’s Web console. For example, Sue from Finance contacts the service desk to request installation of Visio 2010. The service deck technician, Bob, uses the new Bundle Management feature to deliver Visio 2010 to Sue and resolves the call immediately. We can build out from this example to include approvals from Sue’s line manager and even automatic checking of available licenses with initiation of purchasing workflows if required.

This section enables you to achieve an initial integration between the two solutions so that you can start to explore the possibilities. You should try this on a test system, then note your settings and transfer them to your production system when everything is working as you expect.

First we need to ensure a few prerequisites are met before continuing:

4.3.1 Prerequisites

  • Time on the ZENworks Configuration Management primary and ZENworks Service Desk servers must be within 1 minute of each other. You should use NTP to ensure that time is accurate on the servers. Time drift is a common occurrence in virtual environments.

  • ZENworks primary and ZENworks Service Desk servers must be able to resolve each other’s host names to IP addresses.You should use static IP addresses and have entries in your DNS system for these servers.

  • ZENworks and ZENworks Service Desk must reference the same LDAP source. This guide presumes that you have already done this in both products.

  • Devices from ZENworks must be imported into ZENworks Service Desk’s CMDB to use bundle management capabilities. You will reference one of the standard mapping files (These can be customized, but this is outside of the scope of this document).

4.3.2 Switch on Integration within ZENworks Service Desk

  1. Log in to the ZENworks Service Desk as a supervisor or administrator.

  2. Click Setup > Privileges > System.

  3. In the General Settings panel, set the Enable ZENworks Integration option to On.

    This enables the ZENworks tab in the ZENworks Service Desk menu.

4.3.3 Telling ZENworks Service Desk about your ZENworks Configuration Management System

Automatic Configuration

Automatic configuration is applicable for ZENworks 11.2.3 and higher versions only.

NOTE:For earlier versions of ZENworks, use the Manual Configuration option.

  1. In the ZENworks Service Desk user interface, click Setup > ZENworks.

  2. In the General tab, specify the ZENworks Server address.

  3. Select Automatic Configuration to automatically exchange certificates.

NOTE:

  • The ZENworks Service Desk and ZENworks certificates need to be exchanged to complete the registration process.

  • Ensure that the system time is in sync of both ZENworks Service Desk and ZENworks server.

Manual Configuration

  1. In the ZENworks Service Desk user interface, click Setup > ZENworks.

  2. In the General tab, specify the ZENworks Server address.

  3. Select Manual Configuration. Click Download Certificate and store it on the local drive.

4.3.4 Telling ZENworks about your Service Desk System

For ZENworks versions 11.2.3 and above

  1. Log in to the ZENworks Control Center, click Configuration > Service Desk Management > Service Desk Registration.

  2. Select Import NSD Certificate by directly contacting the server after following the steps described in Automatic Configuration.

  3. Provide ZENworks Service Desk server address in the ZENworks Control Center for automatic exchange of certificates.

  4. Click Import Certificate. Once the certificate is imported, click Apply and OK.

    NOTE:You can also upload the NSD certificate from file to ZENworks (versions 11.2.3 & above) by selecting the Import Certificate from file option.

4.3.5 Importing Assets from ZENworks Configuration Management into ZENworks Service Desk

  1. Log into ZENworks Service Desk as a supervisor or administrator.

  2. Click Setup > ZENworks > ZENworks Import > New

  3. In the Server section of the AMIE page, complete the fields as follows:

    Type Select ZENworks Configuration Management v11.1 – Hardware from the drop down list.

    Identifier A common name by which this import definition will be known.

  4. In the Database section, complete the fields as follows:

    Host Specify the fully qualified DNS name or IP address of the database server.

    Port Specify the port number for the database.

    Name Specify the database name.

    Username Specify the user name.

    Password Specify the password.

    Use the password that you configured during the ZENworks Primary Server installation:

    • Schema: Specify the schema type. Depending on the database type, you must specify one of the following schema types:

      • For MS_SQL: dbo

      • For Oracle: ZENWORKS

    • Catalog: Depending on the database server, you must specify one of the following catalog names:-

      • For MS_SQL: zenworks_zonename

        Replace the zone name with the name of the management zone in which the Primary Server is installed.

      • For Oracle: ZENWORKS

  5. Optional: In the Notification section, select whether you want notify technicians for generated change requests. You can do this only if Control CMS via RFC is also enabled.

  6. Fill in the fields in the Ownership section:

    Unassigned (Import Items as Global) Select this option if the items are to be globally owned if they cannot be linked with a ZENworks Service Desk customer automatically during the import. This is performed by matching the login names between ZENworks Service Desk and reported by the items operating system.

    System User Select this option to assign imported items to the System User. Selected Customer: Select this option to assign imported items to a specific customer.

  7. Fill in the fields in the Synchronization section:

    Auto Create New Items This option is visible only when a single AMIE source is defined within AMIE. Click Yes to automatically create items upon synchronization, relative to the Control CMS via RFC setting in the Setup > Privileges > Requests tab. If the setting is disabled, a snapshot of imported asset information is listed within the Super > Configuration >AMIE Snapshots tab.

    Frequency Choose a synchronization interval. You can leave this set to Never if the database will be synchronized manually. The synchronization time can vary, depending on the connection speed with the external service and the database size.

  8. Click Test to initiate a connection and test the setup.

  9. Click Save.

  10. Click Import to immediately import the asset information from ZENworks Configuration Management into ZENworks Service Desk.

    Depending on number of managed / inventoried devices that you have, this might take some time to complete.

4.3.6 Create Role for ZENworks Service Desk Users in ZENworks Configuration Management

  1. Log in to ZENworks Control Center as a administrator or equivalent

  2. Click Configuration.

  3. Scroll down to Roles.

  4. Click New.

  5. In Add Role window:

    • Name: NSD bundle management

    • Description: All rights to allow ZENworks Service Desk users to use bundle management features

    For Rights, assign the following:

    • Bundle Rights: Modify Settings and Assign Bundles

    • Device Rights: Modify, Create / Delete and Assign Bundles

    • Quick Task Rights: Refresh ZENworks Adaptive Agent and Install / Launch Bundles

    • User Rights: Modify and Assign Bundles

  6. Click Ok.

4.3.7 Creating Administrators in ZENworks for ZENworks Service Desk Users

  1. Log in to ZENworks Control Center as a administrator or equivalent.

  2. Click Configuration.

  3. Scroll down to Administrators.

  4. Click New.

  5. Choose New Administrator Group.

  6. In Add new Administrator group.

    • Administrator Group Name: Link to NSD users

    • Description: ZCC Administrator accounts link to ZENworks Service Desk users

  7. Click Add.

  8. Explore the user source and choose the groups that ZENworks Service Desk is using for Supervisors and Technicians.

  9. Click Ok.

  10. Make that Import user members of each user group as administrators immediately is selected.

  11. Click Ok.

4.3.8 Assigning a Role to Administrator Groups in ZENworks for ZENworks Service Desk Users

  1. Log in to ZENworks Control Center as a administrator or equivalent.

  2. Click Configuration.

  3. Scroll down to Administrators.

    For each of the ZENworks Service Desk related groups imported from the user source complete the following

  4. Click the group.

  5. Click the Rights tab in the group summary page.

  6. In Assigned Roles, add the NSD bundle management.

  7. Click Ok.

  8. In the Add Role Assignment window set the necessary rights.

  9. Bundle Rights:

    1. In the Select Contexts window, click Add.

    2. Click the Bundles folder icon.

    3. Click Ok

    4. Back at the Select Contexts window, click Ok.

  10. Device Rights:

    1. In the Select Contexts window, click Add.

    2. Click the Devices folder icon.

    3. Click Ok.

    4. Back at the Select Contexts window, click Ok.

  11. Quick Task Rights:

    1. In the Select Contexts window, click Add.

    2. Click the Devices folder icon.

    3. Click Ok.

    4. Back at the Select Contexts window, click Ok.

  12. User Rights:

    1. In the Select Contexts window, click Add.

    2. Click the blue arrow to the left of Users folder.

    3. Click Ok.

    4. Back at the Select Contexts window, click Ok.

  13. Click Ok.

  14. On the group summary page, click Apply.

4.3.9 Verifying that the Integration Is Working

  1. Log in to the ZENworks Service Desk console as a technician.

  2. Create an incident.

  3. On the incident summary screen, look for a panel on the right side of the page titled ZENworks Tools, with a bundle icon.

  4. Click the Bundle icon.

    A popup window appears, titled Bundle Management. This takes a few moments to load because ZENworks Service Desk authenticates to ZENworks Configuration Management, and reads the list of bundles. The window will look similar to this:

  5. If you get an error message, verify that the time between ZENworks Configuration Management Primary Servers and the ZENworks Service Desk Server is within 1 minute of each other. Then verify that your technician has the correct roles and privileges in ZENworks Control Center.

  6. Change the filter to All Bundles.

  7. Click the bundle.

  8. To add the bundle to one or more users, click the Customers tab.

    To add the bundle to one or more devices, click the Devices tab.

  9. For either option, search for the users or devices that you want to assign the bundle to then, click Assign.

    You should see a message confirming the assignment. It will look similar to this:

  10. Click Done.

    The bundle is launched and installed the next time that the ZENworks Configuration Management adaptive agent is refreshed.

4.3.10 Verifying that the Remote Control is working

  1. Log in to the ZENworks Service Desk console as a technician.

  2. Open an incident. On the Incident Summary screen, you should now see a panel on the right hand side of the page titled ZENworks Tools, with a bundle icon and Remote Control icon.

  3. Click the Control icon. A Remote Control panel window appears.

  4. Select the required remote operation from Operations list.

  5. Click Download to ensure valid viewer plugins are downloaded and installed.

    NOTE:Incase there is an error in performing remote control operation:

    • Verify that the time between ZENworks Configuration Management Primary Servers and the ZENworks Service Desk Server is within 1 minute.

    • Verify that the technician has the correct roles and privileges in ZENworks Control Center.

    • Verify that the GUID field in the Advanced settings of LDAP configuration is appropriately configured for the LDAP source used.

  6. Click Start, you will see the screen of the remote machine.

4.3.11 User Directory or Domain Migration

If the user accounts are migrated to a different directory server, or to another domain in the same server, perform the follow these steps in the ZENworks Service Desk to sync the existing accounts with the new server:

IMPORTANT:Ensure that the email and username for accounts are the same in the new source, else the accounts will not be reconciled in the ZENworks Service Desk.

  1. In the ZENworks Service Desk, modify the existing LDAP configuration and update the details as required.

  2. Save the details and sync the changes.

  3. The existing user accounts in ZENworks Service Desk will be synced with the new LDAP source.

NOTE:It is recommended that you perform the steps in the test environment and then replicate the same in the production environment.