Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.2) for Microsoft Windows Part Number B25463-03 |
|
|
View PDF |
The End-User Documentation Portal is a set of customizable HyperText Markup Language (HTML) pages that provides an overview of Oracle Collaboration Suite clients and the information for downloading, installing, and configuring each Oracle Collaboration Suite client. The End-User Documentation Portal also includes links to the Frequently Asked Questions (FAQ) and Troubleshooting site on the Oracle Technology Network (OTN) and Oracle Collaboration Suite end-user tutorials.
Oracle recommends that you install and use the End-User Documentation Portal to provide the end-users with all the information they need to run the Oracle Collaboration Suite clients.
This chapter contains the following sections:
Section 12.1, "Installing the End-User Documentation Portal"
Section 12.2, "Deploying the End-User Documentation Portal Package"
Section 12.3, "Restricting Access to the End-User Documentation Portal Administration Panel"
This section explains the installation process for End-User Documentation Portal. Installing the End-User Documentation Portal involves the following steps:
PHP is an HTML embedded scripting language. The End-User Documentation Portal requires PHP version 4.3.x or later but will not work with PHP 5.0 or later version. It is installed with Oracle Collaboration Suite and is already compiled. The steps for testing PHP are as follows:
Navigate to http://localhost
and locate the name of the directory on your machine that the URL points to. By default, the directory is htdocs
. In this directory, create a new file called info.php
, that consists of the following test script:
<?php phpinfo(); ?>
Check if the test script works by navigating to http://localhost/info.php
. A PHP page comes up if the etst
script is successful. A part of this page is shown in Figure 12-1:
There are many other tables that follow the table shown in Figure 12-1. These tables describe the extensions that were installed in the PHP installation.
You will need to install the DOM XML extension. This is a compiled library. (Note that this is different from the DOM extension, which is a PHP 5.0 extension.)
The steps to install the DOM XML extension are as follows:
Edit the php.ini
file as follows to indicate where PHP can find the compiled DOM XML library:
extension_dir=Specify the location of php_domxml.dll
Add the following entry in the php.ini
file.
extension-php-domxml.dll
To check if this extension was installed, navigate to the http://localhost/info.php
page. If you see a table titled domxml
, then the extension was successfully installed.
The steps for unzipping and deploying the End-User Documentation Portal package are as follows:
Unzip the contents of eudp.zip
from the DVD/Doc/EUDP
directory in to the htdocs
directory, or the directory to which http://localhost/
points.
In a browser window, navigate to http://localhost/eudp/admin/view.php
to test whether the End-User Documentation Portal administration tool works.
For instructions on how to use the End-User Documentation Portal administration tool and how to customize the content, refer to Chapter 5 of Oracle Collaboration Suite Administrator's Guide.
To prevent users other than the administrator from accessing the End-User Documentation Portal administration panel, use htpasswd
utility of Apache server to protect the eudp\admin
directory. After you have protected this directory, users will see a dialog requesting a user name and password when they try to access view.php
. See the documentation of Apache server for more information about restricting access to directories.
The following steps show you how to secure the admin
directory in eudp
with Apache basic authentication.
When a user tries to access the admin
directory (in particular, the view.php
file), then the user will be prompted for a user name and password.
Performing the following steps on a local installation of the End-User Documentation Portal:
Note: You cannot perform the following steps remotely. |
Create a file called htaccess
in the eudp\admin
directory that contains the following directives:
AuthType Basic
AuthName "End-User Documentation Portal Administration Panel"
AuthUserFile "C:\Apache_directory\htdocs\eudp\htpassword"
AuthGroupFile /dev/null
require user administrator
C:\
Apache_directory
is the location where you have installed Apache server and administrator
is the user name of the administrator of the End-User Documentation Portal.
Create AuthUserFile
called htpassword
. You must create this file in the same directory as specified in htaccess
. Run the htpasswd
utility as follows:
C:\Apache_directory\bin\htpasswd -c ^ C:\Apache_directory\htdocs\eudp\htpassword administrator
The htpasswd
command will prompt you for a password.
Enable the directives found in htaccess
files. Locate the <Directory>
tag in the Apache httpd.conf
file and change the AllowOverride
directive to the AuthConfig
option instead of None
:
<Directory "C:/Apache_directory/htdocs"> #........Other directives................ AllowOverride AuthConfig </Directory>
In the httpd.conf
file, change the AccessFileName
directive to specify htaccess
instead of .htaccess
. This is the name of the file Apache looks for in each directory for additional directives, such as the ones you specified in Step 1.
AccessFileName htaccess
Save the changes you made to the httpd.conf
file.
Restart the Apache server.