24.2 Configuring or Reconfiguring Installed ZENworks Processes Running on Linux

When you install ZENworks Desktop Management Services on Linux, you answer certain questions with information that is used to configure these services. It is possible to change the configuration of an individual process after the installation is complete using the ZENworks 7 Linux Configuration utility (novell-zdm-configure) found in the /opt/novell/zenworks/bin directory.

NOTE:This utility can be used to modify the configuration of installed components, no matter how you installed them originally.

For a list of the available parameters you can use with the configuration utility, enter the following command:

./novell-zdm-configure -h[elp]

The help for this utility lists the following:

ZENworks Desktop Management 7 Linux Configuration Utility

USAGE:
novell-zdm-configure [<option> [<arg>]]...
  where <options> are:   
-p  =  <arg> specifies path to a properties file.          
(default /etc/opt/novell/zenworks/zdm/novell-zdm-configure.properties)     -l  =  <arg> is the pathname of the logfile to create.
    (default /var/log/novell/zenworks/zdm/novell-zdm-configure.log)
-c  =  <arg> is a list of ConfigureAction class names (e.g. "name1,name2").
    (default "")
-f  =  <arg> is a file (one per line list of ConfigureAction class names).
    (default /etc/opt/novell/zenworks/zdm/novell-zdm-configure-actions.conf)   
-a  =  allow internal list of ConfigureActions if not otherwise specified.          
    (default false)
-e  =  attempt subsequent ConfigureActions if an error occurs.
    (default false)   
-z  =  force the ConfigureActions to ignore previous configurations.
    (default false)   
-n  =  use color display.          
    (default false)
-h  =  display this message.

The default location of the novell-zdm-configure-actions.conf file is shown as /etc/opt/novell/zenworks/zdm/novell-zdm-configure.properties. The .conf file is a comprehensive list of all of the ConfigureActions you want to run.

By default, the novell-zdm-configure utility automatically detects the ZENworks services you have installed on your Linux server and runs only the associated ConfigureActions.

A sample of the novell-zdm-configure.conf file is shown below:

##############################################################
#               novell-zdm-configure.conf                    #
#                                                            #
#      ZENworks configuration ConfigureAction list           #
#                                                            #
#  Supply the class name of the ConfigureActions that you    #
#  want novell-zdm-configure to run, one class name per line.#
#  Classes will be called in the order specified in this     #
#  file.                                                     #
#                                                            #
#  Note: You must supply a complete class name unless the    #
#  class exists in the following package:                    #
#                                                            #
#  com.novell.application.zenworks.install.configure         #
#                                                            #
##############################################################
ExtendSchemaConfigureAction
ImagingConfigureAction
LicensingConfigureAction
XTierConfigureAction
NetBiosNameConfigureAction
SSLConfigureAction
InventoryServerConfigureAction
SybaseConfigureAction
StandaloneConfigureAction
RMServerConfigureAction
XMLProxyConfigureAction

The configuration file does not run any installation (file copy) process, it merely configures or reconfigures the features that have already been installed.

You can edit this file to change the components that are reconfigured, but it might be a better idea to make a copy of the file and use the -f parameter to point to it. If you want to reconfigure only one component, you can use the -c parameter to list a single class name (such as XTierConfigureAction) and change its original setting.

After configuring or reconfiguring the installed ZENworks processes, run the following command to restart all the installed ZENworks services:

/opt/novell/zenworks/bin/ZDMstart restart

For more information, see Section 24.2.1, Reconfiguration Example for Extending the eDirectory Schema.

However, you need not restart any of the installed ZENworks services if you use the LicensingConfigureAction to configure the product license. For more information, see Section 24.2.2, Reconfiguration Example for Updating the Product License.

The configuration files for the Workstation Inventory components cannot be executed individually using the -c option. The following constraints apply:

NOTE:You can execute other configuration files along with the combinations mentioned above.

24.2.1 Reconfiguration Example for Extending the eDirectory Schema

It is likely that you can use the configuration file if you want to extend the eDirectory schema. Use the following steps to extend the eDirectory schema:

  1. Navigate to the /opt/novell/zenworks/bin directory.

  2. Enter the following command at the bash prompt:

    ./novell-zdm-configure -c ExtendSchemaConfigureAction

  3. Run the following command to restart all the installed ZENworks services:

    /opt/novell/zenworks/bin/ZDMstart restart

NOTE:You can use the -c option to specify any ConfigureAction that you want on the command line. A list of the ConfigureActions is included in the novell-zdm-configure.conf file and in the silent.properties file. For more information about silent.properties, see Section 23.1, Preparing for Silent Installation.

24.2.2 Reconfiguration Example for Updating the Product License

It is likely that you can use the configuration file if you originally installed a 90-day evaluation version of the product, then you decide to purchase the product: you need to update the license code. Use the steps in the following example to reconfigure the license:

  1. Navigate to the /opt/novell/zenworks/bin directory.

  2. Enter the following command at the bash prompt:

    ./novell-zdm-configure -c LicensingConfigureAction

    The installation program runs, first prompting you for authentication credentials. When the credentials have been verified, the program prompts for the licensing code.

  3. Enter the licensing code you received when you purchased the product.

NOTE:You can use the -c option to specify any ConfigureAction that you want on the command line. A list of the ConfigureActions is included in the novell-zdm-configure.conf file and in the silent.properties file. For more information about silent.properties, see Section 23.1, Preparing for Silent Installation.