9.2 Configuring

This section contains the following topics:

9.2.1 Editing Environment Registry Keys

After DAS is successfully installed, it initializes some registry keys. You must edit the registry keys to configure the system for your workstation.

To view and edit the registry keys:

  1. Click Start > Run, type RegEdit, then click OK. The Registry Editor is displayed.

  2. Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ARS.

  3. Modify the following keys to adapt the installation to your workstation environment:

    Key Name

    Value

    Description

    ConfigFile

    C:\Program Files\Novell\Securelogin\Desktop Automation Services\actions.xml

    The value is the default value.

    This is the pathname for the actions.xml file that defines the actions for the workstation.

    Use this key only when you are referring to an actions.xml file loaded locally to the workstation.

    If you are using a directory based actions.xml file, set the key value to null (blank).

    ConfigObject

    cn=ARSControl

    ou=ARS

    o=CHIP

    This is the value of the fully distinguished name (DN) of an ARSControl object.

    This key is the object in the directory that stores the actions.xml file. It can be managed through Novell iManager.

    ConfigTree

    IP address of the directory: xxx.xxx.xxx.xxx

    The default value is null.

    This value can be the tree name or the IP address of the eDirectory tree that contains the ARSControl object.

    Leave the key blank if the ConfigFile key is used with a locally installed actions.xml file on the workstation.

    NOTE:The tree name must be specified for DAS to access an ARSControl object.

    The server on which the object is residing must be SLP enabled.

    LogFilePath

    C:\Program Files\Novell\Securelogin\Desktop Automation Services\DASLog.txt

    The value is the default value.

    This is the path of DAS log file. If you do not want any log file to be generated on the workstation, set the LogFilePath to null (blank).

    The details of the log file are dependant on the log level that is set.

    LogLevel

    dword:00000001

    The value is the default value.

    See Section 9.2.2, Logging and Error Notification for the possible settings for this value.

9.2.2 Logging and Error Notification

You can configure the ARSControl.exe application for four levels of logging. The log level is set in the Registry Editor.

  1. Click Start > Run, then type RegEdit. The Registry Editor is displayed.

  2. Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Novell\ARS\LogLevel.

  3. Use the information in the following table to set the logging level:

    Name

    Value

    Description

    Normal

    0

    This produces the minimal logging.

    Use this level only if no errors are expected and you do not want to capture support information if an issue arises.

    If an error occurs, logging is not available.

    Error

    1

    This is the default log level.

    It causes ARSControl to log high-level errors.

    Use this only if no errors are expected and you want to capture support information if an issue arises.

    If an error occurs, a high-level log is recorded with a time stamp.

    Action

    2

    ARSControl adds basic information to the log.

    This information records the actions created from the configuration XML parse operation.

    Verbose

    4

    This setting produces the maximum output in the log file.

    Use this to only troubleshoot an existing ARSControl problem or during the development phases of a configuration file.

9.2.3 Managing the actions.xml File Through eDirectory and iManager

During the installation of DAS, the actions.xml file is set up to be managed locally on the workstation. You can decide to centrally manage the actions.xml file through eDirectory and Novell iManager.

To centrally manage the actions.xml file on eDirectory, do the following:

Extending the Schema for eDirectory

  1. Locate the ARSControl.sch in C:\Program Files\Novell\SecureLogin\Desktop Automation Services\Tools folder.

  2. Ask your eDirectory administrator to help you correctly extend the schema to add a new ARSConfig object to eDirectory.

    For a detailed procedure of the schema extension, see the Novell eDirectory 8.8 Administration Guide at the Novell Documentation Web site.