B.11 Installing ZENworks 7 Desktop Management with SP1 in an OES Linux Cluster Environment

Novell ZENworks 7 Desktop Management with SP1 includes the capability of installing the following key elements on SUSE® Linux Enterprise Server (SLES) 9 Support Pack 2 or Novell Open Enterprise Server (OES Linux) 1.0 SP2, or Novell Open Enterprise Server (OES Linux) 2.0:

The installation program for ZENworks 7 with SP1 Desktop Management Services on Linux lets you choose between these two elements as organized in various combinations called “install sets.” For more information about these sets, see Section IV, Installing ZENworks Desktop Management Services on Linux.

NOTE:Of the four pre-built software “sets” available for the SLES 9 installation (that is, Minimum System, Minimum Graphical System, Full, and Default System installations) only the Default System installation mode for SLES 9 supports ZENworks 7 Desktop Management. All other modes used for SLES 9 installation cause a subsequent ZENworks 7 Desktop Management installation failure.

You can use the information in this section as a general guide for installing ZENworks 7 with SP1 Desktop Management Services on Linux, it also includes the following information about installing some of these services on an OES Linux SP2 cluster:

B.11.1 ZENworks Services in OES Linux Cluster Environment

Most of the ZENworks 7 Desktop Management components are considered “cluster-safe,” which means that you can install the ZENworks 7 Desktop Management services in an environment where Novell Cluster Services for Linux is installed, but if the cluster volume goes down, there is an interruption in services while the cluster fails over.

When failover occurs, most of the Desktop Management services are restored, but Application Management and some group policies that rely on a single resource (that is, a server where the policy files are copied) might time-out waiting for the resource to become available. The policies are not applied until the next login or scheduled event occurs and the file resource becomes available again.

The ZENworks Middle Tier Server is not cluster-enabled, but it can be installed on a single cluster node on Linux. For information, see Section 21.0, Installing Only the ZENworks Middle Tier Server on a Linux Server.

B.11.2 Prerequisites for Clustering ZENworks 7 Desktop Management Services with SP1 in an OES Linux Cluster

Before you can run the installation for ZENworks 7 with Support Pack 1 Desktop Management Services on Linux, you need to make sure that the environment where you will install the product has met all of the necessary prerequisites:

  • Meet the general requirements for installing ZENworks 7 Desktop Management Services with SP1. For details, see Section II, Preparation.

  • Make sure that Novell Cluster Services 1.8 is installed and running on the OES Linux 1.0 SP2 server where you will install ZENworks 7 with Support Pack 1 Desktop Management Services on Linux. For more information about installing Novell Cluster Services, see the OES Novell Cluster Services 1.8.2 Administration Guide for Linux.

B.11.3 Installing on an OES Linux Cluster

Use the following steps to installing ZENworks 7 Desktop Management Services with Support Pack 1 Services on Linux in an OES Linux SP2 cluster environment:

  1. From the terminal console, enter su to switch to the root user.

  2. Run mount /CD_mount_point to mount the ZENworks 7 with Support Pack 1 Desktop Management Services on Linux CD.

  3. Change to the CD mount directory, and run ./setup to display the first screen of the installation program.

    ==================================================================
    Introduction
    ------------
    
    InstallAnywhere will guide you through the installation of ZENworks Desktop Management.
    
    It is strongly recommended that you quit all programs before continuing with this installation.
    
    Respond to each prompt to proceed to the next step in the installation.  If you want to change something on a previous step, type ’back’.
    
    You may cancel this installation at any time by typing ’quit’.
    
    PRESS <ENTER> TO CONTINUE:
    
    
  4. Read the terms of the license, pressing Enter several times to screen down and read the contents, then at the end of license agreement, enter Y to accept the terms.

    HINT:You can enter back on any screen of the installation program to go back to the previous screen. You can enter quit on any screen to cancel the installation program.

  5. (Conditional, if the installation detects cluster services on the server) When you accept the terms of the license agreement, if Novell Cluster Services is installed on the server where you are installing ZENworks 7 with SP1 Desktop Mangement Services on Linux, the installation detects it and displays this screen:

    ==================================================================
    Novell Cluster Services Detected
    --------------------------------
    It appears that you have Novell Cluster Services installed on this server.  Do you wish to install ZENworks services into the cluster?
    Install (Y/N): (DEFAULT: Y):
    
    

    Even though the installation program detects that Novell Cluster Services was previously installed, it might not necessarily be configured or you might want to install on the cluster at a later time. If you do not want to install ZENworks services on the cluster, enter N.

    Enter Y or press Enter (Y is the default) to install configureable services for running ZENworks 7 Desktop Management with SP1 in your Novell Cluster Services for Linux environment.

    Whether you enter Y or N for this question or if you don’t see the cluster installation screen at all after the license agreement, the next screen of the installation is displayed:

    
    ==================================================================
    Choose Install Set
    ------------------
    Please choose the Install Set to be installed by this installer.
      ->1- All Features
        2- ZENworks Desktop Management Server
        3- ZENworks Middle Tier Server
    
        4- Customize...ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
       :
    
    
  6. Enter 4 to choose the Customize option.

    The Choose Product Features screen is displayed.

    ==================================================================
    Choose Product Features
    -----------------------
    
    ENTER A COMMA_SEPARATED LIST OF NUMBERS REPRESENTING THE FEATURES YOU WOULD
    LIKE TO SELECT, OR DESELECT. TO VIEW A FEATURE’S DESCRIPTION, ENTER
    ’?<NUMBER>’.  PRESS <RETURN> WHEN YOU ARE DONE:
    
        1- [X] Application Management
        2- [X] Remote Management
        3- [X] Middle Tier
        4- [X] Inventory Server
        5- [X] Inventory Proxy
        6- [X] Inventory Database
        7- [X] NAL Database
        8- [X] Imaging
        9- [X] PXE
       10- [X] Autoworkstation Import/Removal
       11- [X] ZENworks Desktop Agent Installer
    
    Please choose the Features to be installed by this installer.
       :
    
    
  7. Enter the listed number of the feature or features you want to select or deselect for installation on the Linux server. An [X] next to the feature name means that the feature will be installed. All of the features are selected by default.

    If you want to select or deselect more than one feature, use a comma to separate the numbers.

    If you need a description of a feature, type a question mark (?) followed by the feature number, then press Enter.

  8. Press Enter when your feature list is ready for installation.

    After being selected for installation, many of the ZENworks features require no further configuration. You are not prompted for further information about these features.

    No matter which of the features you select, however, you are always prompted for configuration information about the ZENworks Desktop Management Server. The first screen to be displayed is the Tree Information screen that is required for configuring the Desktop Management Server.

    
    ==================================================================
    Tree information
    ----------------
    Please enter authentication information for the tree where you want to configure ZENworks.
    
    Tree (zentree):
    
    
  9. On the Tree Information screen, enter the name of the local host (that is, this server's) tree where you want to configure ZENworks. This field is not case sensitive.

  10. Enter the eDirectory distinguished name (DN) for the Administrative User. This field is not case sensitive.

  11. Enter the password for the Administrative User. This field is not case sensitive.

    After your credentials are validated, the Cluster Support Information screen is displayed (if the installation program previously detected the presence of clustering services on the server, see Step 5):

    ==================================================================
    ZENworks Cluster Support Information
    ------------------------------------
    
    Specify the DN of the cluster resource object that should host the ZENworks
    services (MYCLUSTER_Resource.MYCLUSTER.Servers.mycompany):
    
    
  12. (Conditional, if the installation has detected cluster services on the server) Enter the fully distinguished name of the Cluster Resource object that should host the ZENworks services you are installing.

    Example: bs9_server.bs9cluster.novell

  13. (Conditional, if the installation has detected cluster services on the server) Enter the mount point for the cluster shared volume.

    Example: /media/nss/BS9VOL

    After your credentials are validated, or after you enter the mount point for the cluster shared volume, the ZENworks License Key screen is displayed.

    
    ==================================================================
    ZENworks License Key Information
    --------------------------------
    Please enter a valid ZENworks license code. (90 Day Trial):
    
    
  14. Enter the license code that you received in an e-mail from Novell after you purchased Novell ZENworks. You are periodically reminded to license the product until you provide this license code. If you don’t enter an appropriate code, ZENworks Desktop Management functions for only 90 days.

  15. (Conditional) If you chose to install the Middle Tier, the Middle Tier Server Configuration Information screen is displayed.

    
    ==================================================================
    Middle Tier Server Configuration Information
    --------------------------------------------
    The Middle Tier Server you configure with this program will access an eDirectory server in order to authenticate users and workstations and to obtain ZENworks configuration and policy information.
    
    Please provide the name or IP address and administrative credentials for an eDirectory server.
    
    Server Name/IP Address (zenmidt):
    
    
  16. (Conditional, if you selected the Middle Tier option) Enter the DNS name or IP address of the server where eDirectory is installed.

    
    Enter Administrative Credentials:
    Proxy User (admin.myCompany):
    
    
  17. (Conditional, if you selected the Middle Tier option) Enter the fully-qualified distinguished username of the Middle Tier proxy user account (for example, midtier-proxy.org-unit.org).

    To ensure that these credentials remain secure, you can set up an arbitrary user with specific administrative rights. For more information, see Section 10.3, Required Rights for the Middle Tier Proxy User Account and the NSAdmin Utility.

    Password():
    
  18. (Conditional, if you selected the Middle Tier option) Enter the eDirectory password for the Middle Tier proxy user.

    
    The ZENworks Middle Tier software searches for ZENworks user objects in a specified eDirectory context and below.
    
    Please Specify the ZENworks user context.
    NOTE: This context must already exist.
    
    Users Context (users.novell):
    
    
  19. (Conditional, if you selected the Middle Tier option) Enter the eDirectory context where the Middle Tier Server can look for user objects that will be using Desktop Management.

    The installation program verifies the existence of the context (that is, the directory container) before continuing.

    (Conditional) If you chose to install the Inventory Server and the Inventory Database on the same server, the Inventory Standalone Configuration screen is displayed.

    
    ==================================================================
    Inventory Standalone Configuration
    ----------------------------------
    Note: ZENworks Inventory Standalone settings must be configured only on one cluster node.
    Do you want to configure as a Standalone? (Y/N) (Y):
    
     
    
  20. (Conditional, if you selected the Inventory Server option) Enter the context for the standalone inventory server.

    Inventory Server Context (myCompany):

    If you chose to install the Inventory Proxy feature, the Inventory Proxy Configuration screen is displayed.

    
    ==================================================================
    Inventory Proxy Configuration
    -----------------------------
    
    XML Proxy port (65000):
    
    
  21. (Conditional, if you selected the Inventory Proxy option) Enter the port number you want to designate as one to allow XMLRPC requests pass through to the Inventory Proxy service.

    If you want to change the Port 65000 default, specify a value between 0 and 65535. Ensure that the port number is not used by other services on the server.

    The SSL Configuration screen is displayed.

    
    ==================================================================
    SSL Configuration
    -----------------
    Do you want to configure SSL? (Y):
    
    
  22. (Optional) If you want the ZENworks 7 Inventory Server to establish a secure connection with eDirectory using LDAP, enter Y, then enter the complete path and the filename of the SSL certificate.

    IMPORTANT:Enter the path for the SSL certificate at each cluster node.

    The NetBIOS Configuration screen is displayed

    
    ==================================================================
    NetBIOS Configuration
    ---------------------
    NetBIOS Name (NetBIOS_name):
    
    
  23. (Conditional) The NetBIOS Configuration screen is displayed only if the NetBIOS name is not present in /etc/samba/smb.conf, and the Linux server name on which you run the ZENworks installation is more than 13 characters.

    If the NetBIOS name is not present in /etc/samba/smb.conf and the Linux server name is more than 13 characters, then the installation program generates a NetBIOS name using the first 13 characters of the Linux server name on which you run the installation. This name is displayed as the default value during the ZENworks Linux installation.

    
    ==================================================================
    NetBIOS Configuration
    ---------------------
    NetBIOS Name (NetBIOS_name_generated_by_the_ZENworks_installation_program):
    
    

    You can either accept the default value or enter a new value, but make sure that the NetBIOS name is unique.

  24. The Pre-Installation Summary screen is displayed.

    
    Pre-Installation Summary
    ------------------------
    We are ready to install ZENworks to your server.  Press <Enter> to continue,
    type "back" to change your choices or "quit" to exit this install.
    
    Product Name:  
      ZENworks Desktop Management
    
    Product Components:
        Inventory Server,
        Remote Management,
        Application Management,
        Inventory Proxy,
        Inventory Database,
        NAL Database,
        Autoworkstation Import/Removal,
        PXE,
        Imaging,
        Middle Tier,
        ZENworks Desktop Agent Installer
    
    ZENworks License Key:
        90 Day Trial
    
    Schema Extensions: 
       Schema extensions will be applied.
    ZENworks Cluster Support
        Cluster support will be installed
    PRESS <ENTER> TO CONTINUE:
    
    
  25. Press Enter to begin the installation.

    When the installation process is complete, InstallAnywhere creates an installation log file. Press Ctrl+C to abort the creation of the log file.

    If the installation is successful, the View Readme screen is displayed.

    ============
    View Readme
    -----------
    
    Do you want to view the readme file?
    
      ->1- YES
        2- NO
    
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       :
    
  26. (Optional) Enter 1 to open the Readme file. Read the file, pressing Enter to screen down as you read. At the end of the Readme, press Enter to display the Installation Complete screen.

  27. (Optional) Enter 2 to display the Installation Complete screen.

    
    ================================================================
    Installation Complete
    ---------------------
    
    Congratulations. ZENworks Desktop Management has been successfully installed
    to:
    
    /opt/novell/zenworks/
    
    All installed ZENworks services have been started.
    
    Please see the log file (/var/log/ZENworks_Desktop_Management_InstallLog.log)
    for more details.
    
    PRESS <ENTER> TO EXIT THE INSTALLER:
    
    

    Although the Installation Complete message states that all installed ZENworks services have been started, the proxydhcp service is not started after the installation is completed, nor is it started after a reboot. To start the service, unload the Cluster Resource object in ConsoleOne or iManager to run the start script (opt/novell/zenworks/bin/ZDMstart). If you try to run the proxydhcp service from the run level, an error is generated on the server that is not hosting the clustered resource.

  28. Press Enter to exit the installation program.

  29. Offline and then online the cluster resource where ZENworks Desktop Management is installed.

B.11.4 Preparing for Silent Installation on a Cluster

Use the following steps to prepare for a silent installation:

  1. Locate the silent.properties file at the root of the ZENworks 7 with Support Pack 1 Desktop Management Services on Linux CD, then copy the file to /root on your Linux server.

  2. Edit /root/silent.properties as needed.

A copy of silent.properties for ZENworks 7 with Support Pack 1 Desktop Management Services on Linux is shown below.

INSTALLER_UI=silent
#---------------------------------------------------------------------# Install Sets
#---------------------------------------------------------------------
##CHOSEN_INSTALL_SET=(All|Server|Midtier) [default: All]
#CHOSEN_INSTALL_SET=Midtier
#CHOSEN_INSTALL_SET=Server
#---------------------------------------------------------------------# Installable Features
#---------------------------------------------------------------------
INSTALL_REMOTE_MANAGEMENT=true
INSTALL_MIDDLE_TIER=true
INSTALL_INVENTORY_SERVER=true
INSTALL_INVENTORY_PROXY=true
INSTALL_INVENTORY_DATABASE=true
INSTALL_APPLICATION_MANAGEMENT=true
INSTALL_APPLICATION_MANAGEMENT_DATABASE=true
INSTALL_IMAGING_SERVER=true
INSTALL_PXE_SERVER=true
INSTALL_WORKSTATION_IMPORT_SERVER=true
INSTALL_ZDM_AGENT=true
#---------------------------------------------------------------------# Pre-file-copy verification
#---------------------------------------------------------------------
#-------------------------------------
# Authentication
#-------------------------------------
#TREE_USER_NAME=admin.myCompany
#TREE_PASSWORD=myPassword
#TREE_NAME=MY-TREE
#-------------------------------------
# ExtendSchemaConfigureAction
#-------------------------------------
##SHOULD_EXTEND_SCHEMA=(true|false) [default: false]
#SHOULD_EXTEND_SCHEMA=true
#-------------------------------------
# LicensingConfigureAction
#-------------------------------------
##USER_SUPPLIED_SERIAL_NUMBER= [default: 90 Day Trial]
#USER_SUPPLIED_SERIAL_NUMBER=mySerialNumber
#---------------------------------------------------------------------# Post-file-copy verification
#---------------------------------------------------------------------
#-------------------------------------
# Force Re-Configuration
#-------------------------------------
##ConfigureAction.ZDM_FORCE_CONFIGURE=(true|false) [default: false]
#ConfigureAction.ZDM_FORCE_CONFIGURE=true
#-------------------------------------
# Imaging
#-------------------------------------
##NDS_CONF_PATH= [default: /etc/nds.conf]
#NDS_CONF_PATH=/etc/nds.conf
#-------------------------------------
# Middle Tier
#-------------------------------------
#XTierConfigureAction.AUTH_DOMAIN=myServer
#XTierConfigureAction.AUTH_CONTEXT=myZENWorksUserSearchContext
#XTierConfigureAction.PROXY_USER=myProxyUser
#XTierConfigureAction.PROXY_PASSWORD=myProxyPassword
#-------------------------------------
# Inventory Server Standalone Mode
#-------------------------------------
##StandaloneConfigureAction.INV_STANDALONE=(Y|N) [default: N]
#StandaloneConfigureAction.INV_STANDALONE=Y
#StandaloneConfigureAction.INV_SERVER_CONTEXT=myContext.myCompany
#-------------------------------------
# XML Proxy
#
# value placed in /etc/opt/novell/zenworks/zws.properties as port2
#-------------------------------------
##XMLProxyConfigureAction.XML_PROXY_PORT= [default: 8080]
#XMLProxyConfigureAction.XML_PROXY_PORT=myPortNumber
#-------------------------------------
# SSL for Inventory
#-------------------------------------
##SSLConfigureAction.SSL_CONFIGURE=(Y|N) [default: N]
#SSLConfigureAction.SSL_CONFIGURE=Y
#SSLConfigureAction.INV_CERT_PATH=/my.dir/my.cer
#-------------------------------------
# NETBIOS Name
#
# value placed in /etc/samba/smb.conf as netbios name
# iff there is no existing value
#-------------------------------------
##NETBIOS_NAME= [default: <hostname>-w]
#NETBIOS_NAME=myNetBiosName
#-------------------------------------
# Novell Cluster Support
#-------------------------------------
##INSTALL_ZENWORKS_CLUSTERING=(Y|N) [default: N]
#INSTALL_ZENWORKS_CLUSTERING=N
# Specify the Cluster resource object that will host the ZENworks services.
ConfigureAction.CLUSTER_RESOURCE_DN=myResource.mycluster.mycompany
# Specify the mount point for the shared resource for the above named cluster
# resource object
ConfigureAction.SHARED_VOLUME_PATH=/mnt/

# In general the following information can be derived from the Cluster resource
# object but in the off chance that we can't determine this information, you
# can set these variables.
# Specify the DN of the Virtual server object associated with the
# cluster resource object, and the IP address assigned to the resource object
ConfigureAction.CLUSTER_NCP_SERVER=
ConfigureAction.CLUSTER_NCP_SERVER_IP=

By default, all Desktop Management components are selected for installation in silent.properties. As you edit this file, you can deselect components for installation by commenting that component name in the Installable Features section of the file. This creates a customized install set that you can apply when you run the installation program.

Instead of creating this customized install set, you can also choose to uncomment a consolidated install set in the Install Sets section of the file.

The silent.properties file also contains specific parameters that you need to configure for the components that you install. Make sure that you uncomment these parameters and provide the required values.

If you plan to run the silent installation in an insecure environment, you might want to take measures to hide passwords. For more information, see Section 23.3, Making the Silent Installation More Secure.

B.11.5 Running the Silent Installation on an OES Linux Cluster

When you have edited the silent.properties file to include the installation of all of the components (including the services you want to install on the cluster) and the accompanying configuration values for those components, you are ready to run the installation program.

Use the following steps to complete the installation:

  1. Copy the edited silent.properties file to the /root directory of the server where you intend to run the silent installation.

  2. Insert the ZENworks 7 with Support Pack 1 Desktop Management Services on Linux CD in the CD drive of the Linux server where you want to install ZENworks.

  3. From the terminal console, use the su command to switch to the root user.

  4. Run mount /CD_mount_point to mount the ZENworks 7 with Support Pack 1 Desktop Management Services on Linux CD.

  5. Change to the CD mount point, then enter the following command:

    ./setup -f /root/silent.properties
    

    NOTE:The path to the silent.properties file must be a complete path, beginning with a forward slash ( / ).

    The installation program runs, copying the appropriate files and configuring the ZENworks components according to the information you have provided in silent.properties. The Pre-file-copy Verification section of silent.properties checks each of the values you provided for validity. The installation stops if any value is invalid.

    The program checks the Post-file-copy verification section of silent.properties for validity after the files are copied. In case of an incorrect value in this section, an error is logged to the InstallAnywhere log file located at /var/log/ZENworks_Desktop_Management_InstallLog.log, but the installation continues.

    You can use the novell-zdm-configure utility to correct any errors than are encountered. For more information, see Section 24.2, Configuring or Reconfiguring Installed ZENworks Processes Running on Linux.

  6. Offline and then online the cluster resource where ZENworks Desktop Management is installed.

B.11.6 Configuring Workstation Inventory on an OES Linux Cluster

After you have completed the ZENworks 7 SP1 Desktop Management Services installation, you need to configure Workstation Inventory to work in the clustering environment. The following steps provide the configuration information you need:

  1. Configure the Inventory database object. If you have selected Sybase during Desktop Management installation, the installation program creates the Database object (Inventory database_server_name) and configures the properties of this object. Skip Step 1.a and Step 1.b. If you are using Oracle or MS SQL, continue with Step 1.a.

    1. If you are maintaining the Inventory database in Oracle or MS SQL, ensure that you have created the Database object and configured the properties. For more information, see Section 27.0, Post-Installation Tasks

    2. To configure the Database object for a cluster environment: In ConsoleOne, right-click the Database object, click Properties, click ZENworks Database, Browse for the DN (NCP server object) of the virtual server or specify the IP address of the virtual server, and then click OK.

  2. If you did not select standalone configuration during installation, when you create the database location policy, you must set the inventory database to Inventory database_virtual_server_name.

  3. While creating the Workstation Inventory policy, set the inventory service object DN to Inventory Service_virtual_server_name.

  4. To configure all roll-up policies, select the Inventory service object of the cluster service (Inventory Service_virtual_server_name).