Environment properties specify the naming service that you use to save components and to retrieve stored components. Environment properties also specify other configuration information, such as credentials for security.
Environment properties are stored in a hash table.
If you use only the persistence service, then you construct the hash table and pass it to the constructor for the InitialPersistenceManager
.
If you use the persistence service through the MetadataManager, then you specify the environment properties in the Connection object that you create for connecting to the BI Beans Catalog.
The following list describes the environment properties that are significant when you use the persistence service:
In oracle.dss.persistence.PSRConstants.Login
:
HOSTNAME
-- The name of the host machine of the Oracle
database
PORT
-- The port name of the Oracle database
SID
-- The ID of the Oracle Service Instance on a machine
SERVICE
-- The name of the Oracle Database service
Note: SERVICE
substitutes for the combination of HOSTNAME
, PORT
, and SID
.
PASSWORD
-- The application password for the Oracle database
USER_NAME
-- The application user name; calling BISession.setBIUser
sets this property
In oracle.dss.persistence.PSRConstants
:
BISESSION
-- The BISession
object that contains user information
STORAGEMANAGER_DRIVER
-- (optional) The storage manager that the persistence service should use; the default is the BI Beans Catalog
ERROR_HANDLER
-- (optional) The error handler that handles messages from the persistence service; there is a default error handler
In oracle.dss.persistence.common.PersistenceManager
:
CLIENT_XML
-- Alternate state handler for the client to use
SERVER_XML
-- Alternate storage driver and possibly state handler
Note: You do not have to set CLIENT_XML
or SERVER_XML
if you use the default storage manager.
Connecting to Data Stores
Creating an Initial Context in the Persistence Service