Installation guide
Table Of Contents
- Gateway Customization Guide
- Contents
- Preface
- Introduction
- Setting Up the Gateway
- Gateway Installation Planning
- HTTP Server Configuration
- Creating a New Gateway Instance
- Gateway .conf File Configuration
- Configuring Gateway Clients
- Gateway Localization
- File Controlling Gateway Functionality
- Editing Entry Types
- Search Attributes, Filters, and Results
- Customizing Graphics and Color
- Parameters Defined in the .conf File
- Gateway Directives
- Introduction
- Context-Related Directives
- Entry-Related Directives
- DS_ENTRYBEGIN
- DS_ENTRYEND
- DS_ATTRIBUTE
- DS_OBJECTCLASS
- DS_VIEW_SWITCHER
- DS_SORTENTRIES
- DS_SEARCHDESC
- DS_POSTEDVALUE
- DS_EDITBUTTON
- DS_DELETEBUTTON
- DS_SAVEBUTTON
- DS_EDITASBUTTON
- DS_NEWPASSWORD
- DS_CONFIRM_NEWPASSWORD
- DS_OLDPASSWORD
- DS_HELPBUTTON
- DS_CLOSEBUTTON
- DS_BEGIN_ENTRYFORM
- DS_END_ENTRYFORM
- DS_EMIT_BASE_HREF
- DS_DNEDITBUTTON
- DS_BEGIN_DNSEARCHFORM
- DS_ATTRVAL_SET
- IF/ ELSE/ ELIF/ ENDIF
- Miscellaneous Directives
- CGI Usage
- Index
- List of Tables
Creating a New Gateway Instance
36 Red Hat Directory Server Gateway Customization Guide • April 2005
http://webserverHost:webserverPort/clients/dsgw/bin/search
where webserverHost is the HTTP server’s hostname and webserverPort is the port
number used by the server. When the HTTP server is using the standard HTTP
port number (80), the port number does not need to be included in the URL.
Creating a New Gateway Instance
These instructions assume that the new gateway instance will run under the Red Hat
Administration Server or a similarly capable HTTP server.
1. Rename the dsgw.conf or pb.conf file to a new gateway context.
For example,
clients/dsgw/context/dsgw.conf might become
clients/dsgw/context/example.conf.
2. Set the gwnametrans parameter in the new gateway’s .conf file to point to the
HTML directory.
For example, the
gwnametrans parameter setting for example.conf should point to
/clients/dsgw/examplehtml.
3. To support non-anonymous searching (one individual user DN and password per
directory instance) using the new gateway, set the
binddnfile parameter in
example.conf to point to the location of the file containing the bind DN and bind
password that will be used to access information in the user directory.
The
binddnfile contains sensitive information; for security purposes, do not store
the
binddnfile within the /clients/dsgw directory or within any directory
served up over HTTP.
4. Create an HTML directory for the new gateway.
For example, to provide an HTML directory for
example.conf, copy and rename an
existing HTML directory (
clients/dsgw/html or clients/dsgw/pbhtml) to
/clients/dsgw/examplehtml.
5. Create a template directory containing object class templates and other configuration
files.
For example, to provide a template directory for
example.conf, copy and rename an
existing template directory (
/clients/dsgw/config or
/clients/dsgw/pbconfig) to /clients/dsgw/exampleconfig.
6. Edit the htmldir and configdir parameters in example.conf to point to the new
HTML and template directories.