3
Configuring mod_plsql

Global Settings  

Default Database Access Descriptor (DAD)  

Specify a path that points to the default DAD. If the end user enters a URL without specifying the DAD name, the home page for the default DAD will be displayed.

Default = none You can change the DAD name by typing a new one in this field.

Administrators 

Specifies who can view the admin pages. By default, this is set to ALL which means anyone can view the admin pages. This should be changed to a comma separated list of users to enforce security on the admin pages, for example scott, mike where scott and mike are local database user names. Or, scott, mike@orcl where orcl is a connect string for a remote database.

Note This setting is accessible through the configuration file only, not through mod_plsql Web page.

Admin Path 

Specifies the URL path element that identifies an admin page. This should normally be left unchanged as /admin_/.

Note This setting is accessible through the configuration file only, not through mod_plsql Web page.

Database Access Descriptor Settings  

Database Access Descriptor Name  

Displays the name for this DAD. The name is set at installation time or during creation of new web sites. You can change the name by typing a new one in this field.

Oracle User Name  

Displays the Oracle database account user name. The user name is typically set at installation or during creation of new web sites. You can change it by typing a new name in this entry field.

Oracle Password  

Displays the Oracle database account password. The password is typically set at installation, but you change it by typing a new password in this entry field.

Notes The Oracle User Name and Password are the default user name and password for logging in to a Web site or page. If you leave the Oracle User Name and Oracle Password entry fields blank, the user will be prompted to enter a user name and password when first logging in.

Oracle Connect String  

Enter a SQL*Net alias if you are using a remote database. Leave this field blank if the database is local.

Authentication Mode 

This parameter can be set to one of the following values:

• Basic - authentication is performed using basic HTTP authentication. Most applications will use Basic authentication.

• Global Owa - authorization id performed in the OWA package schema.

• Custom Owa - authorization is performed using packages and procedures in the user's schema, or if not found, in the OWA package schema

• PerPackage - authentication is performed by packages and procedures in the user's schema

• Single Sign-On - authentication is performed using the Oracle Single Sign-On feature of the Login Server. You can use this mode only if your application is is set up to work with the Login Server.

Session Cookie Name 

Enter a session cookie name only for Oracle Portal 3.X installations that participate in a distributed environment. 

Create a Stateful Session? 

Choose Yes to preserve the database package/session state for each database request. Choose No to reset it after each request. For mod_plsql, this parameter must be set to No. 

Keep Database Connection Open Between Requests?  

Choose whether, after processing one URL request, the database connection should be kept open to process future requests. In most configurations, choose Yes for maximum performance.

The mod_plsql cleanup thread cleans up database sessions that have not been used for 15 minutes.  

Default (Home) Page  

Enter the PL/SQL procedure that will be invoked when none is specified as part of the URL itself. For example, if you specify a default home page of myapp.home and an end user enters this URL in a browser:

http://myapp.myserver.com:2000/pls/myapp/

will automatically update the URL to:

http://myapp.myserver.com:2000/pls/
myapp/myapp.home

Document Table  

Enter the name of the database table into which files uploaded to a web site created with will be stored. The default value in this entry field is based on the name of the schema in which you created the site.

Document Access Path  

Enter a path in the URL installation that is used to indicate a document is being referenced. In the following URL, for example:

http://myapp.myserver.com:2000/pls/my_site/
docs/folder1/presentation.htm

docs is the document access path.

Document Access Procedure  

Enter the procedure that will be used to upload and download documents.

Extensions to be Uploaded as LONGRAW

Specify extensions for files to be uploaded as LONGRAW.  

Path Alias 

To be used by PL/SQL applications for path aliasing.

WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.

Path Alias Procedure 

To be used by PL/SQL applications for path aliasing.

WebDB 2.X Note You must leave this field blank if the DAD is for an existing WebDB 2.x Web site.