F.2. Configuring Admin Express
F.2.1. Admin Express File Locations
Table F.1. Admin Express File Directories
Directory | Description |
---|---|
/etc/dirsrv/admin-serv/ | Contains the local.conf , httpd.conf , and other configuration files which define the Administration Server and configure the web server. |
/usr/share/dirsrv/html/ | Contains the HTML files and graphics used for the Admin Express appearance. |
F.2.2. Admin Express Configuration Files
<style>
tags in the page head. For information on editing inline tags, see http://directory.fedoraproject.org/docs/389ds/administration/htmlediting.html.
F.2.2.1. Files for the Administration Server Welcome Page
/etc/dirsrv/admin-serv
directory. One file sets the formatting, copyright text, and some web application text, admserv.html
.

Figure F.4. Intro Page Elements
INCLUDEIFEXISTS
directive.
<tr valign="TOP"> <td> </td> <td bgcolor="#9999cc" colspan="4"> <font color="white" size="+1"><font face="Verdana, sans-serif">Services for Administrators</font></font></td> <td> </td> </tr> <tr valign="TOP"> <td> </td> <td colspan="4"> <table border="0" cellspacing="0" cellpadding="0"> <tr valign="TOP"> <td><img src="/icons/spacer.gif" width="6" height="6"></td> <td></td> </tr> <!-- INCLUDEIFEXISTS admserv_dsgw.html -->
F.2.2.2. Files for the Replication Status Appearance
- The body of the page,
/usr/share/dirsrv/html/monreplication.html
- The heading of the page,
/usr/share/dirsrv/html/htmladmin.html

Figure F.5. Monitoring Replication Setup Page Elements
- The body of the page, which is configured in the replication monitoring script,
/usr/bin/repl-monitor.pl
- Optionally, the configuration file for the replication monitoring, which can configure the time lag colors with the
[colors]
section - The heading of the page,
/usr/share/dirsrv/html/htmladmin.html

Figure F.6. Monitoring Replication View Page Elements
#Print the header of consumer print "\n<tr class=bgColor16>\n"; print "<th nowrap>Receiver</th>\n"; print "<th nowrap>Time Lag</th>\n"; print "<th nowrap>Max CSN</th>\n"; .... print "</tr>\n";
style.css
for the other web applications. These can be edited in the Perl script or by uncommenting the stylesheet reference and supplying a CSS file. For example:
# print the HTML header
print "Content-type: text/html\n\n";
print "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 3.2//EN\"><html>\n";
print "<head><title>Replication Status</title>\n";
# print "<link type=text/css rel=stylesheet href=\"master-style.css\">\n";
print "<style text/css>\n";
print "Body, p, table, td, ul, li {color: #000000; font-family: Arial, Helvetica, sans-serif; font-size: 12px;}\n";
print "A {color:blue; text-decoration: none;}\n";
print "BODY {font-family: Arial, Helvetica, sans-serif}\n";
print "P {font-family: Arial, Helvetica, sans-serif}\n";
print "TH {font-weight: bold; font-family: Arial, Helvetica, sans-serif}\n";
print "TD {font-family: Arial, Helvetica, sans-serif}\n";
print ".bgColor1 {background-color: #003366;}\n";
print ".bgColor4 {background-color: #cccccc;}\n";
print ".bgColor5 {background-color: #999999;}\n";
print ".bgColor9 {background-color: #336699;}\n";
print ".bgColor13 {background-color: #ffffff;}\n";
print ".bgColor16 {background-color: #6699cc;}\n";
print ".text8 {color: #0099cc; font-size: 11px; font-weight: bold;}\n";
print ".text28 {color: #ffcc33; font-size: 12px; font-weight: bold;}\n";
print ".areatitle {font-weight: bold; color: #ffffff; font-family: Arial, Helvetica, sans-serif}\n";
print ".page-title {font-weight: bold; font-size: larger; font-family: Arial, Helvetica, sans-serif}\n";
print ".page-subtitle {font-weight: bold; font-family: Arial, Helvetica, sans-serif}\n";
print "</style></head>\n<body class=bgColor4>\n";
F.2.2.3. Files for the Server Information Page
- The body of the page,
/usr/share/dirsrv/html/viewdata.html
- The heading of the page,
/usr/share/dirsrv/html/htmladmin.html

Figure F.7. Server Information Page Elements
viewdata.html
file is very simple, using only the two directives to insert the server data, plus other directives to insert other information. For the Administration Server, the SHOW_DATA
directive takes the information from the /etc/dirsrv/admin-serv/local.conf
file. For the Directory Server, it takes the data from the /etc/dirsrv/slapd-instance/dse.ldif
file. The ID_TITLE
is the name of the server instance.
<body text="#000000" bgcolor="#FFFFFF" link="#666699" vlink="#666699" alink="#333366"> <br> <table BORDER=0 CELLSPACING=2 CELLPADDING=2 WIDTH="100%"> <!-- ID_TITLE --> <p> <!-- SHOW_DATA --> <p> <font face="PrimaSans BT, Verdana, sans-serif"><font size=-1>Additional Information:</font></font> <p> <!-- CHECK_UPGRADE --> <p> <!-- SHOW_URL --> </table> <!-- HELPBUTTON --> </body>
F.2.2.4. Files for the Server Logs Page
- The body of the page,
/usr/share/dirsrv/html/viewlog.html
- The heading of the page,
/usr/share/dirsrv/html/htmladmin.html

Figure F.8. Log View Page Elements
ID_TITLE
directive. The log is displayed through the ACCESS_LOG
directives. The form at the top is formatted with directive pairs, one which sets the descriptive text and the other inserting the field type. For example, this sets the log type menu:
<form method=GET action=ViewLog> <font face="PrimaSans BT, Verdana, sans-serif"><font size=-1> <!-- BEGINELEM --> <!-- ELEM txt="Log to view: " --> <!-- LOG_TO_VIEW --> .... <!-- SUBMIT --> </font></font> </form>
F.2.3. Admin Express Directives
Table F.2. Admin Express Directives
Directive | Description | Example |
---|---|---|
ACCESS_LOG | Inserts the server log file. | <!-- ACCESS_LOG --> |
ADMURL | <!-- ADMURL --> | |
BEGINELEM | Marks the opening of form input elements. This is always paired with ENDELEM . | <!-- BEGINELEM --> |
CHECK_UPGRADE | <!-- CHECK_UPGRADE --> | |
ELEM | Inserts a text element. This has one argument, txt= , which defines the text to use. | <!-- ELEM txt="Field name here: " --> |
ELEMADD | Inserts a text element. This has one argument, txt= , which defines the text to use. | <!-- ELEMADD txt="Field name here: " --> |
ENDELEM | Marks the ending of form input elements. This is always paired with BEGINELEM . | <!-- ENDELEM --> |
HELP_BUTTON | Inserts a button to open context-specific help. | <!-- HELP_BUTTON --> |
HELPLINK | Inserts a link to the general Admin Express help file. | <!-- HELPLINK --> |
HIDDEN_ID | <!-- HIDDEN_ID --> | |
ID_TITLE | Inserts the name of the server instance, such as admin-serv or example (if the Directory Server instance name is slapd-example ) | <!-- ID_TITLE --> |
INCLUDEIFEXISTS | Inserts the contents of the HTML file. The inserted file should include both the text and any HTML markup. | <!-- INCLUDEIFEXISTS "file.html" --> |
LOG_TO_VIEW | Inserts a drop-down menu with the types of logs available to view. | <!-- LOG_TO_VIEW --> |
NUM_TO_VIEW | Inserts a form field to set the number of lines to return. | <!-- NUM_TO_VIEW --> |
REFRESHINTERVAL | Inserts a form field to set the refresh interval (in seconds) for replication monitoring. | <!-- REFRESHINTERVAL --> |
SERVHOST | <!-- SERVHOST --> | |
SERVPORT | <!-- SERVPORT --> | |
SHOW_DATA | Inserts the server data from the configuration file, including the port number, installation date, and build number. | <!-- SHOW_DATA --> |
SHOW_URL | <!-- SHOW_URL --> | |
SITEROOT | <!-- SITEROOT --> | |
STRING_TO_VIEW | Inserts a form field to use to set the search string for the logs. | <!-- STRING_TO_VIEW --> |
SUBMIT | Inserts a three-button set: to save or submit the form; to reset the form; and to open a help topic. | <!-- SUBMIT --> |