5.2 Installing the ZENworks Server Software

To install the Primary Server:

  1. Make sure the server meets the requirements. See Section 2.1, ZENworks Server Requirements.

    If you are installing to a device that is configured with DHCP, you might encounter the following eDirectory error in zlm-config:

    eDir failed to start properly. Please ensure that this machine is configured with a static IP or permanently-leased DHCP Address.

    For detailed information on how to resolve the error, see Section A.6, Installing a ZENworks Server on a Device Configured with DHCP.

    IMPORTANT:If other services run on port 80, the installation will fail; the server cannot run other services on port 80. If Apache or another service is binding to port 80, remove the service or change the service’s port.

    For example, change the Apache2 web server's Listen Port (on SLES 9 SP3 as found in /etc/apache2/ listen.conf) from 80 to 81. Make sure the Apache service is shut down and then run zlm-config.

  2. If the /etc/hosts file contains the entry 127.0.0.2 hostname.localdomain hostname, then change it as follows:

    Your_IP_address hostname.localdomain hostname

  3. (Conditional) If you plan to use an existing database for the ZENworks Data Store, make sure you've prepared the database. See Section 3.0, Preparing the Database for the ZENworks Data Store.

  4. At the Linux server, mount the product media of the ZENworks Linux Management version you want to install by using the mount device mountpoint command.

    • Use the Novell ZENworks 7.3 Linux Management Server installation media to install ZENworks 7.3 Linux Management.

    • Use the Novell ZENworks 7.3 Linux Management with Interim Release 1 Server media to install ZENworks 7.3 Linux Management with IR1.

    • Use the Novell ZENworks 7.3 Linux Management with Interim Release 2 Server media to install ZENworks 7.3 Linux Management with IR2.

    • Use the Novell ZENworks 7.3 Linux Management with Interim Release 3 Server media to install ZENworks 7.3 Linux Management with IR3.

    • Use the Novell ZENworks 7.3 Linux Management with Interim Release 4 Server media to install ZENworks 7.3 Linux Management with IR4.

    For example, to install ZENworks 7.3 Linux Management, mount the product media by using 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 server, 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/ZEN73_LinuxMgmt.iso /zlm73/install

  5. Log in as root, then start the installation program from the mount point by running the following command:

    ./zlm-install

    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 VI, Appendixes.

    If you do not have the X Window System installed (for example, you installed a Minimal installation of SUSE Linux Enterprise Server 9), you need to install the glib2, XFree86-libs-32 bit, and compat-32bit packages to the server before installing ZENworks Linux Management. When you install ZENworks Linux Management on the server, you must use the -x switch to avoid dependency problems. Running ./zlm-install –x skips any packages that require the X Window System. In Step 8 below, you must agree when it says that the installation lacks the zmd-gconfpolicyenforcer, novell-zenworks-zmd-rmagent, and vnc components.

    For more information about installing ZENworks Linux Management on a SUSE Linux Enterprise Server with a Minimal installation, see Operating Systems.

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

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

    Installation of the software begins. There are ten software components to install. Installation progress is displayed for each component.

    If you are installing on a SUSE Linux Enterprise Server 10 (SLES 10) device, a message might be displayed informing you that some packages are already installed (for example, rug, zmd-inventory, or zen-updater). Some packages that ship with ZENworks Linux Management also ship with SLES 10. Depending on the versions of these packages, you might be prompted to re-install these packages, which might overwrite configuration changes you have made. Press Y to continue.

    If you are installing on a SUSE Linux Enterprise Server 11 (SLES 11) 64-bit device, a message might be displayed informing you that the nici packages are already installed. You might be prompted to reinstall these packages, which might overwrite configuration changes you have made. Press Y to continue.

  8. When installation of the software is complete, enter Y to run zlm-config and configure the ZENworks Primary Server and Management Zone.

  9. If you have multiple interfaces configured, you are prompted to enter the IP address to which you want to configure your server. Enter the IP address of the device. By default, the IP address of the first interface is selected as the device.

  10. Provide the appropriate responses to the following prompts:

    • Is this the first server in your system?: Enter Y for Yes.

    • Enter a unique Management Zone name: Enter the name you want to use for your ZENworks Management Zone. For example, Novell_Boston. The name cannot be the same as any other ZENworks Management Zone in your network environment. If you use Novell eDirectory, it cannot be the same name as your eDirectory tree name.

    • Enter an Administrator password: Enter the password you want assigned to the default ZENworks Administrator account.

    • Repeat the Administrator password: Re-enter the password.

    • Do you want ZENworks to install and set up a local PostgreSQL database for you?: If you want to use a new PostgreSQL database for the ZENworks Data Store and have it located on the Primary Server, enter Y for Yes. If you want to use an existing PostgreSQL or Oracle database, either on the Primary Server or on a remote server, enter N for No.

  11. Choose to continue with a Self-Signed Certificate or to import your own PKCS12 certificate. If you choose to import your own PKCS12 certificate, you must enter the location of the certificate and the password.

    For more information on the Self-Signed Certificates, see Section A.7, Adding a Third-Party Certificate.

  12. If you chose to use an existing database, continue with Step 13.

    or

    If you chose to install and set up a local PostgreSQL database, skip to Step 14.

  13. Provide the appropriate responses to the following prompts to configure access to an existing database:

    • IP address or hostname of the database server: Enter the IP address or DNS hostname of the server hosting the database.

    • Port database is listening on: Enter the listening port being used by the database server. The default PostgreSQL listening port is 5432. The default Oracle listening port is 1521.

    • Database name/SID: For a PostgreSQL database, enter the name of the database. For an Oracle database, enter the SID (System Identifier).

    • Database user name: Enter the user name for an administrative account that provides full access to the database.

    • Database user password: Enter the account password.

  14. When configuration of the ZENworks Server components is complete, you should verify the installation. To do so:

    1. Confirm that the ZENworks services are running by using the following command:

      /opt/novell/zenworks/bin/zlm-config --status

      The screen output should show that all services are running.

      Novell ZENworks Imaging Service is running
      
      Novell eDirectory is running
      
      Novell ZENworks Server Management is running
      
      Novell ZENworks Imaging Agent is running
      
      Novell ZENworks Server is running
      
      Novell ZENworks Preboot Policy Daemon is running
      
      Novell ZENworks Management Daemon is running
      
      Novell ZENworks Loader is running
      

      If a service is not running, use the following command to start it:

      /etc/init.d/servicename start

      Replace servicename with the name of the service that needs to be started.

      Service

      Service Name

      Novell eDirectory

      ndsd

      Novell ZENworks Server

      novell-zenserver

      Novell ZENworks Loader

      novell-zenloader

      Novell ZENworks Imaging Service

      novell-pbserv

      Novell ZENworks Preboot Policy Daemon

      novell-zmgprebootpolicy

      Novell ZENworks Server Management

      novell-zented

      Novell ZENworks Management Daemon

      novell-zmd

      Novell Imaging Agent

      novell-zislnx

      For example, if the Novell ZENworks Management Daemon is not running, use the following command to start it:

      /etc/init.d/novell-zmd start
      

      For additional information about the ZENworks services, see ZENworks Services in the Novell ZENworks 7.3 Linux Management Administration Guide.

    2. (Conditional) If you are using the PostgreSQL database, confirm that it is running by using the following command at the database server:

      /etc/init.d/postgresql status

    3. Access the ZENworks Control Center using a Web browser that meets the requirements listed in Section 2.4, Administration Workstation Requirements. Use the following URL to access the Control Center:

      https://ZENworks_Primary_Server_Address

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

      The ZENworks Control Center requires an https:// connection; requests to http:// are redirected to https://.

      When prompted for login credentials, use the Administrator user with the password you provided during the installation.

      After you are in the Control Center, you can click the Devices tab, then click the Servers folder to view your ZENworks Primary Server.

  15. After successfully installing the ZENworks Server components, take a reliable backup of the following files:

    • /etc/opt/novell/zenworks/hibernate.cfg.xml

    • /etc/opt/novell/zenworks/tomcat/base/server.xml

    • /etc/opt/novell/zenworks/serversecret

  16. (Conditional) Ensure that the ZENworks Linux Management server and the server on which the Oracle or the PostgreSQL database is running are in time sync.

  17. Continue with the next section, Supplying Your Product License Code.