Installing, Setting Up, and Connecting To the ZENworks Database

The ZENworks database should be installed on a server where policies are enforced. This is required so that you can use the ZENworks Database policy to locate ZFSLOG.DB.

The database object is automatically created in the tree when you run the Installation Wizard and select a server for the database.

The installation program can install only one database at a time. To install additional databases to the tree, you will need to perform the steps in the following sections for each database to be installed.

Perform the steps in the following sections to install and set up the database:


Installing the Database

To install the ZENworks database:

  1. On the workstation, insert the ZENworks for Servers product CD.

    The startup screen is displayed. If the startup screen is not automatically displayed after inserting the CD, you can start it by running WINSETUP.EXE at the root of the CD.

    IMPORTANT:  Installation from a remote CD is not supported unless there is a drive mapped on the workstation to that CD. For example, if you place the CD in a Windows NT* server CD drive, then run the installation from a workstation, you must have a drive mapped to the CD drive of that NT server.

  2. Click the ZENworks for Servers option > click the Install Policy and Distributions Services option.

  3. Review the License Agreement > click Accept if you agree > click Next.

    or

    Click Decline > click Next to exit the Installation Wizard.

  4. Browse and select the tree to install to (only one tree can be selected) > click Next.

    The tree name is not case-sensitive.

  5. Click Next on the License page.

  6. Click Add > browse for the server or multiple servers (use Shift or Ctrl) where you want to install the database.

  7. Check the radio button under the Database column for each server where you want a database to be running.

    You can select only one server per run of the installation program.

    You might want a database for each Distributor to write its own information to. However, Distributors can share a database. Because the Distributor writes information to the database for all TED objects, the database should be installed on the same server as the Distributor to minimize network traffic.

    If you have not previously installed the ZfS 2 database, enable this option for at least one Distributor. If you enable this option, the installation program checks all mounted volumes on the server to see if ZFSLOG.DB exists. If not, both the file and the database object will be installed. If the file exists, the database object will still be installed.

    IMPORTANT:  Make sure you select a server for the database where you are installing policies. The Purge Database option works only if the ZFS.NCF and ZFSLOG.DB files are on the same server.

  8. To install the necessary software for the database objects, click the Copy Files and Create Objects for the Selected Components radio button.

    If this option is not selected, software will not be installed and the database objects will not be created in the tree.

  9. To have the installation program modify AUTOEXEC.NCF, check this box.

    The Modify AUTOEXEC.NCF option will ensure that the database will be started.

  10. To pause the installation and give you the opportunity to unload Java* before continuing the installation, check the Pause Installation If JAVA.NLM Is Loaded On Target Server box.

    If this box is not checked, the installation program skips any servers where Java is loaded and does not install the database. An error for each such server will be logged to:

       C:\TEMP\_RESNumber.TXT

    where Number is increased incrementally each time a new installation log is created.

  11. When you have finished configuring the component options, click Next.

    The Database page is displayed.

  12. Select a volume for the database > click Next.

    SYS: is not recommended because ZFSLOG.DB can become large. It is used for logging report information on server policies and TED usage.

    The Summary page is displayed.

  13. Review your selections > click Finish.

    The Installation Wizard now copies files and installs the database objects.

    WARNING:  If you click Cancel, none of the work you did in the Installation Wizard is saved.

    After the installation has finished, you can check the installation log file (see Step 10) to see if any components failed to install.

  14. Continue with setting up the database (see Configuring the ZENworks Database Policy ).


Configuring the ZENworks Database Policy

You must set up a database locator policy so that information can be logged to the database.

The Distributor Agent requires a database policy that is associated. The Policy/Package Agent requires a database policy that is distributed to each Subscriber server where the agent is installed.

The Distributor Agent writes distribution information, and the Policy/Package Agent writes policy information.

Perform the following applicable tasks:


For the Distributor Agent

To configure the required attributes for the ZENworks Database policy:

  1. In ConsoleOne®, browse eDirectory for the container you created specifically for Policy Package objects.

    If necessary, create the container object.

  2. Right-click the policies container > click New > click Policy Package to open the Policy Package Wizard.

  3. Under Policy Packages, select Service Location Package > click Next.

  4. Name the package > click Next > click Finish to create the package.

    Name the package so that it is identified with its ZENworks Database object.

  5. Right-click the Service Location Package > click Properties > click the Policies tab.

    If the box under the Enabled column is not checked for the ZENworks Database policy, click it before clicking Properties. A policy must be enabled to activate the Properties button.

  6. Click the check box under the Enabled column for the ZENworks Database policy to enable it > click Properties.

  7. Click to make sure you are viewing the Policy/Distribution Management tab.

  8. Browse for a Database object (or enter its DN) > click Apply > click Close > click OK.

    For example, the Database object might read:

    ZfS Database.Development.Novell

    The Database object was automatically created when you installed the Database. It is located in the same container as the Server object where the database was installed.

  9. Click the Associations tab > click Add.

  10. Browse to the container containing the Distributor objects > click Apply > click Close > click OK.

    If you have your Distributor objects in different containers, add the other containers to the list.

    The Service Location Package object must be associated so that ZFSLOG.DB can be found by the Distributor Agent for logging information.

  11. Click OK when finished associating the Service Location Package.


For the Policy/Package Agent

To configure the required attributes for the ZENworks Database policy:

  1. In ConsoleOne, browse eDirectory for the container you created specifically for Policy Package objects.

    If necessary, create the container object.

  2. Right-click the policies container > click New > click Policy Package to open the Policy Package Wizard.

  3. Under Policy Packages, select Distributed Server Package > click Next.

  4. Name the package > click Next > click Finish to create the package.

    Name the package so that it is identified with its ZENworks Database object.

  5. Right-click the Distributed Server Package > click Properties > click the Policies tab.

  6. Click the check box under the Enabled column for the ZENworks Database policy to enable it > click Properties.

  7. Click to make sure you are viewing the Policy/Distribution Management tab.

  8. Browse for a Database object (or enter its DN) > click Apply > click Close > click OK.

    For example, the Database object might read:

    ZfS Database.Development.Novell

    The Database object was automatically created when you installed the Database. It is located in the same container as the Server object where the database was installed.

  9. Click OK when finished.

  10. Distribute the Distributed Server Package object.

    For information on distributing policy packages, see Distributing Policies .

    The Distributed Server Package object must be distributed so that ZFSLOG.DB can be found by the Policy/Package Agent for logging information.


Connecting to the Database

To make sure that the database will be written to by the Policy/Package Agent and the Distributor Agent:

  1. On a server, load the Policy/Package Agent by doing the following:

    Server Platform Agent Startup Method

    Windows

    1. Open the Control Panel.
    2. Click Services (in Windows 2000, Services is under Admin Tools).
    3. Click Novell ZfS Policies > click Start.

    NetWare

    SYS:\ZENWORKS\PDS\SMANAGER\ZFS.NCF

    Solaris* or Linux*

    /usr/ZENworks/pds/smanager/ZFSSRV.sh

    Note whether a message is displayed indicating that the Policy/Package Agent has connected to the database.

  2. On a server, load the Distributor Agent by doing the following:

    Server Platform Agent Startup Method

    Windows

    1. Open the Control Panel.
    2. Click Services (in Windows 2000, Services is under Admin Tools).
    3. Click Novell ZfS Distribution > click Start.

    NetWare

    SYS:\ZENWORKS\PDS\SMANAGER\TED.NCF

    Solaris or Linux

    /usr/ZENworks/pds/smanager/TEDSRV.sh

    Note whether a message is displayed indicating that the Distributor Agent has connected to the database.

  3. Repeat Step 1 and Step 2 for each server where a Policy/Package Agent or Distributor Agent has been installed.

    IMPORTANT:  You must repeat Step 2 for each Distributor server because the Distributor Agent must be started or restarted to connect with the database.

  4. To determine whether the Policy/Package Agent or the Distributor Agent is writing to the database, do the following for each agent:

    1. At a NetWare server's console prompt, view the monitor while the agent is loading.

      A message should display that states whether the agent connected with the database.

    2. If the message indicates that the agent did not connect to the database, you should check the following:

      • Is the database is running on the server?
      • Is there a database object that has its Policy/Distribution Management tab set up with the server where the database file is installed?
      • Is there an effective ZENworks Database policy pointing to the database object?