Installing Policy and Distribution Services on a UNIX Server

Although the UNIX Policy and Distribution Services software comes on the same ZENworks for Servers 3 program CD as the NetWare and Windows versions, you cannot install it using the Windows-based Installation Wizard. Instead, you will use a UNIX installation script.

The most straightforward way to install Policy and Distribution Services on a UNIX server is to insert the ZENworks for Servers 3 program CD into the CD drive of the server where you want to install Policy and Distribution Services. Installation solutions that eliminate physically moving from server to server are left to the discretion of the UNIX administrator.

To install Policy and Distribution Services to a UNIX server, complete the following tasks:


Starting the Policy and Distribution Services Installation Script

At the UNIX server where you want to install Policy and Distribution Services:

  1. Log in as root.

  2. Place the ZENworks for Servers 3 program CD in the CD drive.

    If auto-mount does not occur, mount the CD drive manually.

  3. If you are running X Windows, open an Xterm window on the UNIX server console.

  4. Review the Readme file at the root of the CD for any last-minute information concerning installation.

  5. In an Xterm window, change to the directory where the Policy and Distribution Services installation script is located:

    cd /device_directory/ZfS/TedPol/platform

    where device_directory represents the mount point for the CD device and platform is either Linux or Solaris.

    The install scripts are named:

    Zfs_Linux_Install
    Zfs_Solaris_Install

    HINT:  The font used for the examples in this step is used throughout this section for case-sensitive text that must be typed exactly as provided in the example.

  6. To run the Policy and Distribution Services installation script, enter:

    ./Zfs_platform_Install

    where platform is either Linux or Solaris. As a shortcut, you can enter:

    ./*Install

  7. Press Enter to display the license agreement > press the Spacebar to scroll through the license agreement > type y > press Enter to accept the license agreement.

  8. Type one or more numbers, separated by a space or a comma, to specify what you want to install:

    1 Distributor
    2 Subscriber

    For example, type 1 2 > press Enter.

    The ZfSTed package installs the TED software as a Subscriber, as a Distributor, or both, depending on the options you specify. When you choose to install a Subscriber, the Policy/Package Agent is also installed in order to enforce policies and install software packages for the Subscriber.

  9. To confirm your selections, type y > press Enter.

    On Linux, the installation script uses the Red Hat Package Manager (RPM) to install the program files. Installation progress displays on the screen.

    On Solaris, the installation script uses the pkgadd command to install the program files. Progress does not display.

    The Policy and Distribution Services software is copied into subdirectories of the /usr/ZENworks directory on the UNIX server.

  10. Continue with Editing the TED Configuration File .


Editing the TED Configuration File

The installation script now helps you edit the TED configuration file.

  1. Press Enter to open your default text editor in order to edit the TED configuration file.

    Strings of asterisks (*****) represent parameter values in the configuration file. Replace the asterisks with the parameter values for your system. The configuration file includes examples to help you supply the information in the format expected by the installation script.

  2. Specify the value for each parameter listed in the file:

    dns_Name: Provide the fully qualified DNS host name or IP address of a server that holds a replica of the eDirectory tree where you want the installation script to create Distributor and Subscriber objects. For example:

    NWserver5.novell.com
    123.45.678.9

    tree_Name: Provide the name of the eDirectory tree where you want the Distributor and Subscriber objects created. For example:

    CORP_TREE

    user_Name: Specify the fully distinguished name of an eDirectory user that has Admin-equivalent rights to the tree. For example:

    admin.users

    distributor_Object_Name: If you are installing a Distributor, specify the fully distinguished name of the Distributor object that you want the installation script to create. For example:

    Distributer_UNIXserver47.TED.ZfS.NovellApps

    Be sure to include the object context where you want the new Distributor object to be created.

    subscriber_Object_Name: If you are installing a Subscriber, specify the fully distinguished name of the Subscriber object that you want the installation script to create. For example:

    Subscriber_UNIXserver47.TED.ZfS.NovellApps

    Be sure to include the object context where you want the new Subscriber object to be created.

    IMPORTANT:  Do not use double-byte or extended characters in object names.

  3. When you have filled in the values for all the parameters in the TED configuration file, save your changes > exit the text editor.

  4. Continue with Confirming Network Information .


Confirming Network Information

After you have edited the TED configuration file, the installation script displays the fully qualified DNS host name of the local UNIX server as obtained from one of the following locations, depending on your system search order:

The installation script requests confirmation of the displayed information.

  1. If the DNS entry is correct, type y > press Enter.

    or

    If the DNS entry is incorrect, type n > press Enter > type the correct fully qualified DNS host name > press Enter > type y to confirm the modified DNS host name > press Enter.

    IMPORTANT:  Without the correct DNS information, Policy and Distribution Services will not function properly on the server.

    After the DNS entry is correct, the installation script next prompts for the password corresponding to the user you supplied for the user_Name parameter.

  2. Type the password > press Enter.

    The installation script authenticates to the eDirectory tree and creates the Distributor and Subscriber objects in the context you specified. In addition, it modifies the trustees of the root object and the newly created Distributor and/or Subscriber object. Then you are returned to the system prompt.

    The installation script logs its actions in the following file:

    /var/log/ZFSinstall.log

    If the installation does not complete successfully, you can print this log file. To look up installation errors, see Installation Error Messages . Resolve the problem and perform a successful installation.

    At this point, you have installed the Policy and Distribution Services software on the UNIX server and created Distributor and Subscriber objects in eDirectory, but you have not yet started the Distributor and Subscriber Agents because additional configuration could be required.

  3. If you have already installed Policy and Distribution Services on NetWare or Windows servers, the Policy/Distribution database has already been created. Skip to Starting the Policy and Distribution Agents on UNIX .

    or

    Continue with Creating the Policy/Distribution Database .