"Administrator’s Guide Netscape Application Server: Process Automation Edition": Configuration Files

Netscape Application Server: Process Automation Edition (PAE) uses several configuration files to define installation values, server configurations, clusters, and application versions.

Much of what they do is behind the scenes, but you may need to know about them from time to time. This chapter describes what you need to understand about each and how you might need to modify them.

This chapter discusses these topics:

Overview

PAE Files and Folders

Error Messages and Logs

Overview

Configuration files are included in the components that you install as part of PAE. The configuration files that are important for PAE administrators touch on several areas:

The Enterprise Server Files

The Process Builder Preferences File

The Enterprise Server Files
The Enterprise Server has several configuration files, but the three that are relevant to PAE are the Enterprise Server object configuration file (obj.conf), the dbswitch.conf file, and the generated.https-yourServerName.acl file.

obj.conf: Object configuration values for the Enterprise Server, including access control information. These lines are added to your obj.conf as part of the PAE installation:

NameTrans fn="assign-name" name="Admin Data Auth" from="/*Data.apm"
NameTrans fn="assign-name" name="Admin IT Auth" from="/*IT.apm"
NameTrans fn="assign-name" name="Basic Auth" from="/*.npm"

If you specified a particular PAE administrator during installation, that user is assigned to the Admin Data Auth and Admin IT Auth groups with the same access privileges.

dbswitch.conf: Contains an LDAP URL about the corporate directory that PAE uses to authenticate users.

The following is a sample LDAP URL:

ldap://xyz.mcom.com:389/ou=People, o=mcom.com

This URL is obtained from the user during installation.

generated.https-yourServerName.acl: Contains access control list (ACL) information about PAE.

The following lines are added as part of your PAE installation:

acl "Admin Data Auth";

authenticate (user,group) {

prompt = "Netscape Process Manager Administration Data Manager";

database = "CorporateDirectoryYOURDIR";

};

deny (all) (user = "anyone");

allow absolute (all)(user = "admin");

Note that the default administrative user is admin, but users can specify any administrative user at installation.

The Process Builder Preferences File
The Process Builder has a preferences.ini file that identifies which cluster and corporate directory to use when designing applications.

You can add multiple cluster and directory entries to offer a choice to designers as they build applications in Process Builder. Each application can only belong to one cluster at a time and have access to a single user directory at a time, but a designer may work with several clusters at a time.

The preferences.ini file provides the unique cluster DN and identifies which corporate user directory is included in the cluster. If you cut and paste the two lines that result from a successful cluster creation, you are providing the preferences.ini file with one cluster and one corporate user directory. See "Creating a Cluster and Getting Started" in the Installation Guide for information about this hand-off to Process Builder. See Directory Server Terms and Attributes for details about how to structure LDAP information.

Note. If the process designer and the administrator are not the same individual, the administrator must give the following URLs to the process designer for inclusion in the preferences.ini file.

To add a cluster entry, use this LDAP URL format:

cluster=ldap://Bind DN:Password@yourConfigDirServer:port/clusterDN

To add an entry for a corporate user Directory, use this LDAP URL format:

corp_dir=ldap://corporateDirectoryServer:port/corpDirectoryBaseDN

PAE Files and Folders

The PAE installer adds many files and folders to your local system as it installs the PAE components.

The PAE files are added to serverRoot/bpm.

Process Builder files and folders are added to the serverRoot/builder folder.

Error Messages and Logs

There are several logs in PAE: some are for Process Administrator errors or information, others are specific to an application. You can directly open an application's logs or the PAE logs in your web browser window.

Process Builder logs are located at: serverRoot/builder/support/log/error.html and warning.html.

Process Administrator logs are located in the serverRoot/bpm/admin/logs folder. They are info.html, error.html, and security.html.

PAE applications use several log files, with each Netscape Application Server in a cluster having its own set of log files. PAE administrators can view these application logs that are maintained for each application on a per-server basis:

information log (info.html): shows information about the application's operations.

error log (error.html): shows the errors that have occurred with the application.

security log (security.html): shows the security violations that have occurred with the application.

The application log files are located at serverRoot/bpm/applications/applicationName/logs.

There are other log files for each of the Netscape servers:

Enterprise Server: serverRoot/https-yourEnterpriseServer/logs

Administration Server: serverRoot/admin-serv/logs

Directory Server: serverRoot/slapd-yourDirServer/logs