7.2 Installing the ZENworks Agent and Registering the Device

The following instructions explain how to install the ZENworks Agent and register it to the Management Zone. You should follow the instructions on at least one device to become familiar with the installation and registration process. However, before installing the ZENworks Agent on a large number of devices, you should review the following sections:

Dell PowerEdge Servers: If you plan to update Dell PowerEdge servers by using Dell Update Packages, we recommend that you mirror the packages from the Dell FTP site before installing the ZENworks Agent on the managed PowerEdge servers. You can also mirror the packages after installing the ZENworks Agent on the managed PowerEdge servers but before registering them in the ZENworks Management Zone. Mirroring the Dell Update Packages prior to installing the ZENworks Agent or registering the servers in the Management Zone ensures that all Dell model numbers are loaded into the database, the standard reports are run as the servers register, and the Dell Update Packages exist in the ZENworks package repository. For more information, see Using Dell Update Package Bundles in the Novell ZENworks 7.3 Linux Management Administration GuideNovell ZENworks 7.3 Linux Management Administration Guide.

You can install the ZENworks Agent in any of the following ways:

7.2.1 Manually Installing the ZENworks Agent

To manually install the ZENworks Agent and register it in the Management Zone:

  1. Make sure the device meets the necessary requirements. See Section 2.3, Managed Device Requirements.

  2. At the Linux device, mount the media you are using for the install:

    • Novell ZENworks 7.3 Linux Management Agent CD

    • Novell ZENworks 7.3 Linux Management with Interim Release 1 Agent CD

    • Novell ZENworks 7.3 Linux Management with Interim Release 2 Agent CD

    • Novell ZENworks 7.3 Linux Management with Interim Release 3 Agent CD

    • Novell ZENworks 7.3 Linux Management with Interim Release 4 Agent CD

    Or

    To mount a media, use the following command:

    mount device mountpoint

    For example:

    mount /dev/cdrom /zlm73

    If you are using an ISO image rather than a physical media, copy the ISO to a temporary folder on the Linux device, then mount the image using the following command:

    mount -o loop /tempfolderpath/isoimagename.iso mountpoint

    Replace tempfolderpath with the path to the temporary folder and replace mountpoint with the path to the file system location you want to mount the image. The path specified by mountpoint must already exist.

    For example:

    mount -o loop /zlm73/ZENworks_Agent.iso /zlm/install

  3. Log in as root, then start the installation program:

    • For Workstations and Servers that are Not Dell PowerEdge Servers: If you are installing the ZENworks Agent on a workstation or a server that you do not want to manage using the ZENworks Linux Management features specific to PowerEdge servers (on a server that is not a Dell PowerEdge server, for example), start the installation from the mount point using the following command:

      ./zlm-install -a

      The -a option installs only agent portions of ZENworks Linux Management. The -a option is optional because the agent iso, however, installs only the agent component.

    • For Dell PowerEdge Servers: If you are installing the ZENworks Agent on a Dell PowerEdge server that you want to manage using the ZENworks Linux Management features specific to PowerEdge servers, start the installation program from the mount point using the following command:

      ./zlm-install -o

      The -o option installs the OEM module for Dell hardware required to use the features specific to Dell PowerEdge servers in ZENworks Linux Management.

      If you install the ZENworks Agent using the -o option, you cannot use the ZENworks Linux Management Dell functionality until you have completed the configuration steps in Section 7.4, Enabling Dell PowerEdge Support.

    NOTE:The steps in this procedure perform a standard installation of ZENworks Linux Management. Depending on your situation, additional options can be used with the zlm-install command. For more information, see Section A.1, Installation Options.

    If you do not have the X Window System installed (for example, you installed a Minimal installation of SUSE Linux Enterprise Server 9), see -x.

  4. When prompted to install ZENworks, enter Y to continue.

  5. Review the Software License Agreement, pressing Page Down to scroll down the page, then enter Y to accept the agreement.

    Installation of the ZENworks Agent software begins.

  6. The installation checks whether the device is already registered to a ZENworks service, and prompts you to retain the existing registered ZENworks service.

    • If you enter y, the installation is completed. Skip to Step 8.

    • If you enter n, continue with Step 7.

  7. Provide the appropriate responses to the following prompts to register the device:

    • Registration Server Address: Enter the IP address or DNS name of the ZENworks Server that you want to manage this device. This can be the Primary Server or a Secondary Server, and should be the server that has best network access to the device.

      If you leave this field blank, no service is added. You can register the device at a later time by using the rug command line interface.

      For SUSE Linux Enterprise Server 10 (SLES 10) and SUSE Linux Enterprise Desktop 10 (SLED 10) devices:

      /usr/bin/rug sa https://ZEN_Server_address

      For SUSE Linux Enterprise 11 (SLES 11) and SUSE Linux Enterprise Desktop 11 (SLED 11) devices:

      /usr/bin/rug sa https://ZEN_Server_address

      For other managed devices:

      /opt/novell/zenworks/bin/rug sa https://ZEN_Server_address

    • (Optional) Registration Server Key: You can leave this field blank. ZENworks has two default registration rules, one for servers and one for workstations. If you leave this field blank, ZENworks uses one of the two default registration rules to register the device. The rules cause the device to be added to either the /Servers folder or the /Workstations folder with the device's hostname used for its device name.

      Before installing the ZENworks Agent on a large number of devices and registering them, you should create registration keys and rules that enable you to place devices in specific folders and groups. Using folders and groups reduces the effort required to manage a large number of devices. Registration keys and rules, as well as folders and groups, are discussed in Understanding ZENworks Linux Management in the Novell ZENworks 7.3 Linux Management Administration Guide.

      NOTE:Do not register the ZENworks Agent to a ZENworks Linux Management server that has bundles assigned to this agent. If you do so, the ZENworks Agent ceases to work after the bundles are installed. You can, however, choose to register the ZENworks Agent to the server after the ZENworks Agent installation is complete.

  8. After the installation is complete, confirm that the ZENworks Agent is running by using the following command:

    /etc/init.d/novell-zmd status

  9. Confirm that the device has been added to the ZENworks Object Store by accessing the ZENworks Control Center:

    https://ZENworks_Primary_Server_Address

    Replace ZENworks_Primary_Server_Address with the IP address or DNS name of the Primary Server.

    After you are in the Control Center, you can click the Devices tab, then click the Servers folder or Workstation folder to view the device.

    The ZENworks Agent installation removes all the existing services that are registered through zmd on the managed device so that the managed devices with ZENworks 7.3 Linux Management installed contacts the ZENworks Server for all its management needs.

    If you’ve installed the ZENworks Agent on the Open Enterprise Server 1, continue with Section 7.3, Setting Up the Open Enterprise Server 1 after Installing ZENworks Linux Management. To deploy and manage Dell PowerEdge servers, skip to Section 7.4, Enabling Dell PowerEdge Support.

7.2.2 Installing the ZENworks Agent by Using the YaST Add-on

You can create an ISO image that contains Novell ZENworks 7.3 Linux Management with IR4 packages, and use it to include ZENworks 7.3 Linux Management with IR4 as an add-on product.

Review the following sections:

Creating the ZENworks Linux Management Agent Add-On

  1. At the Novell Downloads, search for the novell-zenworks-yast-add-on.rpm keyword. This displays the list of available RPMs.

  2. Download the required RPM to the device where you want to create the ZENworks Linux Management agent.

  3. At the command prompt, install the RPM by using the following command:

    rpm -ivh filename

  4. Create the ZENworks Linux Management agent add-on ISO by using the following command:

    zlm-create-yast-add-on options

    The following table describes the options that can be used with the command:

    Option

    Description

    -i ISO_name

    The name of the ISO image to be created. If you do not provide an ISO name; the default ISO name zlm-add-on is selected.

    -m mount_point

    The path where the ZENworks Linux Management agent is mounted.

    -o output_directory

    The directory to which the ISO image is written. If you do not specify an output directory, the ISO image is copied to the /tmp directory.

    -c value

    The values can be 9, 10, or 11.

    The number 10 is the default value to create the ZENworks Linux Management agent add-on for SLES 10, SLED 10, and OES 2 platforms. The number 9 is the value to create the ZENworks Linux Management agent add-on for SLES 9 platforms. The number 11 is the value to create the ZENworks Linux Management agent add-on for SLES 11 / SLED 11 platforms.

    -h

    Prints the help information.

For example, to create a zlm-agent-add-on.iso image for SLES 10, SLED 10 or OES 2, and store it in the /mnt directory, run the following command:

zlm-create-yast-add-on -i zlm-agent-add-on -m /mnt/zlm-agent -o /mnt/ -c 10

Adding the ZENworks Linux Management Agent Add-On to YaST and Installing the ZENworks Linux Management Agent

  1. Create the ZENworks Linux Management agent add-on ISO.

    For more information on how to create the ZENworks Linux Management agent add-on ISO, see Creating the ZENworks Linux Management Agent Add-On.

  2. Run the yast2 add-on command.

    The Add-on Product Media Graphical User Interface is displayed.

    NOTE:On SLES 9 devices, you must add the add-on ISO as an installation source via YaST.

  3. Select the media where the agent add-on ISO is stored.

    For example, if you have stored the agent add-on ISO on an NFS server, select the NFS option.

  4. Click Next.

  5. Provide the necessary details for the selected media.

  6. Click OK.

  7. Accept the license agreement.

    The ZENworks Linux Management agent add-on is added to YaST.

  8. Click Next to install the ZENworks Linux Management Agent.

  9. (Conditional) Filter based on Patterns and select the required patterns for SLES 10 / SLED 10, SLES 11 / SLED 11, or OES 2 platforms.

    The following table describes the patterns that are available with the agent add-on:

    Patterns

    Description

    ZLM Agent no X

    Agent installation without X-related packages. This pattern is for the agent on default clients.

    ZLM Agent X

    Agent installation with X.

    ZLM Agent Imaging

    Agent imaging agent component.

    ZLM Agent OEM

    Agent OEM package for Dell machines.

    ZLM Agent All

    Full installation of the agent.

  10. (Conditional) Filter based on Selections and choose the required selections for SLES 9 platform.

  11. Select Packages > All in this List > Update unconditionally to update the packages.

  12. Click Accept to install the ZENworks Linux Management agent.

Installing the ZENworks Linux Management Agent while Installing the Operating System

  1. Create the ZENworks Linux Management agent add-on ISO.

    For more information on how to create the ZENworks Linux Management agent add-on ISO, see Creating the ZENworks Linux Management Agent Add-On.

  2. In the Installation Mode window that is displayed while installing the operating system, select the Include Add-on Products from Separate Media check box, then click Next.

  3. Select the ISO Image check box to include the ZENworks Linux Management agent add-on ISO to Yast as an add-on product, then click Next.

  4. Accept the license agreement, then click Next.

  5. In the Installation Settings window, click Software.

  6. Filter the packages based on Patterns, then select the required patterns.

  7. Click Accept and continue with the installation.

The ZENworks Linux Management agent is installed along with the operating system.

7.2.3 Installing the ZENworks Linux Management Agent by Using AutoYaST

To install the ZENworks Linux Management agent by using AutoYaST, an autoyast configuration file autoinst.xml with the ZENworks Linux Management agent add-on is required. You can create the autoinst.xml file with the ZENworks Linux Management agent add-on either while installing the operating system or by updating an existing autoinst.xml file.

NOTE:You cannot create an AutoYaST configuration file for the ZENworks Linux Management agent on SLES 9 devices.

You can create the AutoYaST configuration file with the ZENworks Linux Management agent add-on in any of the following ways:

Creating the AutoYaST Configuration File With the ZENworks Linux Management Agent Add-on While Installing the Operating System

  1. Create the ZENworks Linux Management agent add-on ISO. For more information on how to create the ZENworks Linux Management agent add-on ISO, see Creating the ZENworks Linux Management Agent Add-On.

  2. In the Installation Mode window that is displayed while installing the operating system, select the Include Add-on Products from Separate Media check box, and click Next.

  3. Select the ISO Image check box to include the ZENworks Linux Management agent add-on ISO to Yast as an add-on product, and click Next.

  4. Accept the license agreement, and click Next.

  5. In the Installation Settings window, click Software.

  6. Filter the packages based on Patterns, and select the required patterns.

  7. Click Accept.

  8. Click Install.

  9. After the installation is complete, select the Clone This System for Autoyast check box.

  10. Click Finish.

    The autoinst.xml configuration file is created in the /root directory.

Adding ZENworks Linux Management Agent Add-on to an Existing AutoYaST Configuration File

  1. Create the ZENworks Linux Management agent add-on ISO. For more information on how to create the ZENworks Linux Management agent add-on ISO, see Creating the ZENworks Linux Management Agent Add-On.

  2. Run the yast2 autoyast command.

    The YaST 2 window is displayed.

  3. Click File > Open and select the existing AutoYaST configuration file.

  4. Click Software > Add-on Product.

  5. Click Configure.

    The Add-on product Installation window is displayed.

  6. Select the media where the agent add-on ISO is stored.

    For example, if the agent add-on ISO is stored on an NFS server, select the NFS option.

  7. Click Next.

  8. Provide the necessary details for the selected media.

  9. Click OK.

  10. Accept the license agreement and click Next.

  11. Click Software > Package Selection.

  12. Click Configure.

  13. Filter the packages based on patterns and select the required patterns.

  14. Click Accept.

  15. Select File > Save as and save the updated AutoYast configuration file.

7.2.4 Using the Default ZENworks Linux Management Agent to Install the ZENworks Agent

A default instance of the ZENworks Linux Management agent is available on SLES 10 and SLED 10 managed devices. You can use it to install the ZENworks agent.

  1. Create an upgrade bundle. For more information on how to create an upgrade bundle, see Creating an Upgrade Bundle.

  2. Create a script for the upgrade bundle. For more information on how to create a script for the upgrade bundle, see Creating a Script for Upgrade Bundles.

  3. Create a catalog for the upgrade bundle. For more information on how to create a catalog for an upgrade bundle, see Creating Catalogs for Upgrade Bundles.

  4. Upgrade the SLES 10 or the SLED 10 managed device by using the upgrade bundle. For more information, see Upgrading SLES 10 or SLED 10 Managed Devices by Using an Upgrade Bundle.