| Red Hat Docs > Manuals > Red Hat Applications > |
|
| Red Hat Enterprise Web Application Framework Installation Guide | ||
|---|---|---|
| Prev | Chapter 3. Installing the Binary Distribution | Next |
WAF has a single configuration file that the system uses to connect to the database, configure the default administrator password, and so forth. Proper configuration of this file is critical to the proper functioning of your system, and you should be sure to double-check your values. Once complete and tested, this file should be checked into a source control system along with the installation file you used (RPM or ZIP); these files are all that are needed to recreate the WAF installation from scratch.
 | Note |
|---|---|
The parameters host-1 (and optionally host-2, host-3, and so on) and thishost (for controlling the publish to file system module) are also critically important. The host-n parameters should name each of application server, and thishost should match one of the host-n entries depending on which machine you are configuring. |
| Note |
|---|---|
Make sure the directories listed in log-dir and state-dir actually exist and that they are writable by the servlet user, or the WAF will not start. |
| Note |
|---|---|
If your system consists of a single instance of WAF with no cache peers, leave the caching "cachePeers" and publishToFile "server", "thisServer", and "publishSource" parameters blank. Any reference to a host which cannot be resolved may cause serious memory leaks. |
Here is a list of the prompts and values in a typical configuration file (your configuration file may have different values depending on the specific RPM/ZIP that you are using):
| Parameter | Description | Sample Value |
|---|---|---|
| servlet-container | Name of a servlet container. | tomcat4 |
| app-home | Home directory of your application. | /var/www/legal |
| runtime-home | Home directory of the runtime. | /usr/share/legal |
| oracle-home | $ORACLE_HOME | /opt/apps/oracle/product/9.0.1 |
| tomcat-conf-home | The home for your Tomcat configuration files. | /etc/tomcat3/conf |
| java-home | $JAVA_HOME for this server | /usr/local/j2sdk1.4.0 |
| jre-args | Arguments to be passed to the JRE e.g., stack size | -Xms128 |
| admin-answer | The answer to the question the administrator would be asked if they forgot their password. | Fifi |
| admin-email | Site administrator's email address. | admin@example.com |
| admin-forename | Administrator's first name | Jane |
| admin-password | Administrator password. | changeme |
| admin-question | Question administration will be asked if their password is forgotten. | What is the name of your beloved dog? |
| admin-screenname | Used if screen name/username authentication is used instead of email address. | JaneDoeAdmin |
| admin-surname | Administrator's last name | Doe |
| cache-expiry | How long to cache pages | 259200 |
| cache-peers | If running multiple front end servers, set this value to the external HTTP addresses of the other front ends. | "http://servlet1", "http://servlet2" |
| db-pass | Password to access the database schema. | dbpassword |
| db-pool | Number of connections to hold open. | 100 |
| db-user | Username to access the database schema. | dbuser |
| developer-support | Enable developer support for debugging? Make sure this is 'false' for production instances. | false |
| digest-sender | The return address used in emails in CMS for items that have expired. The name is misleading. | article-digest@foo.com |
| front-page | URL for registration page. Do not change this unless you have a custom registration page. | register/ |
| hostname | Hostname of the server. | ccm.redhat.com |
| jdbc-url | The JDBC URL to access the database. You can also use a tnsnames.ora entry immediately after the @ symbol. | jdbc:oracle:oci8:@(DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost )(PORT = 1521 )))(CONNECT_DATA = (SERVICE_NAME = oracle ) (SRVR = DEDICATED))) |
| log-dir | Logfiles directory. This must be created during installation or the server will not start. | /var/log/myserver |
| log-level | Choices are debug, info, warn, error, fatal; use fatal for production. | fatal |
| log-size | Log file size before it gets rolled over. | 1000000 |
| ora9-fix | Works around bugs in Oracle 9i Release 1 and 2 in the Oracle optimizer. Set to 'false' if using Oracle 8i. | true |
| publish-to-fs-servers | Hostnames for front-end servers to be used in publish-to-filesystem. | http://localhost/ |
| publish-to-fs-this-server | The hostname of the server using that config file. Must be one of the hostnames in publih-to-fs-servers | http://localhost/ |
| publish-to-fs-source | URL that is accessed to get the content to be publish. Usually just the URL for your site | http://localhost/ |
| sitename | Set to what you want to appear on the login page of the site. | Web Application Framework |
| smtp-host | Set to this server's SMTP host. | localhost |
| state-dir | This directory is used by the security initializer. It must be writable by the servlet container process | /var/www/ccm-core-cms/lib |
| xslt-engine | Which XSLT engine should we use? We recommend Saxon in production. | Saxon |
| xslt-timeout | This number should be high (around 60000) for a production instance, much lower for development. This regulates how often the file system is checked for changes in the XSL stylesheets. | 60000 |
Table 3-1. Configuration Values