Skip Headers
Oracle® Content Services Administrator's Guide
10g Release 1 (10.1.1)

Part Number B14493-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

D Service Configuration Properties

An Oracle Content Services service comprises a Java runtime environment for the protocol servers and agents that it supports. A service also manages connections to the database through JDBC. There are three default service configuration objects you can use to create new services on nodes:

The differences among the three configuration templates are in the number of connections and sessions supported.

This appendix lists the service configuration properties and their default values.

Note:

Spaces can be included in service configuration properties. For this reason, do not use spaces to separate alternate values of a property. You must use a comma as a delimiter.

Table D-1 IFS.SERVICE.* Properties

Property Description and Usage Note Default Required?

IFS.SERVICE. DefaultCharacterSet

Default character set, in IANA format, for Oracle Content Services Subscribers. Can be overridden on a per-session basis. Default character set for each user is determined by the user's Primary User Profile.

Character set of the database instance

ISO-8859-1

No

IFS.SERVICE. DefaultLanguage

Default language, as an Oracle language name, for Oracle Content Services Subscribers. Can be overridden on a per-session basis. Default language for each user is determined by the user's Primary User Profile.

Based on configuration.

No

IFS.SERVICE. MaximumConcurrentSessions

Maximum number of sessions the service can support concurrently. Default of 0 means unlimited.

0

No

IFS.SERVICE. CheckForOrphanSessionsPeriod

Number of seconds between checks for orphan sessions. (Active sessions generate heartbeats. An orphan session is one that no longer generates session heartbeats. When the service detects an orphan session, it disconnects the session and releases the session's resources.) Default is 60 seconds between checks. Set to 0 to disable the checking.

60

No

IFS.SERVICE. SessionOperationTimeoutPeriod

Number of seconds after which certain Oracle Content Services API calls are terminated, even if incomplete. If an operation times out in this manner, it is terminated, its transaction is aborted, and an exception is thrown. The session performing the operation remains valid. Set to 0 to disable session operation timeout.

300

No

IFS.SERVICE. OrphanSessionTimeoutPeriod

Number of seconds after which a session that no longer generates a heartbeat becomes an orphan. Set to 0 to disable orphan session timeout.

600

No

IFS.SERVICE. ServiceKeepAliveEventPeriod

Seconds between service heartbeats. The Service Watchdog Agent detects services that cease to have a heartbeat, and cleans up information associated with the failed service in the Oracle Content Services repository.

Set to 0 to disable heartbeat.

60

No

IFS.SERVICE. PollForEventsFromOtherServices Period

Seconds between checks for incoming events from other services. Set to 0 to disable inter-service event polling.

2

No

IFS.SERVICE. TransportEventsToOtherServices Period

Maximum length of time (seconds) that outgoing events are buffered before sending. Set to 0 to disable outgoing event buffer.

2

No

IFS.SERVICE.ACLCACHE. Size

The absolute maximum size of the service's ACL cache, in ACLs. The service ACL cache holds resolved access levels of ACLs.

750 - Small

3000 - Medium

7500 - Large

No

IFS.SERVICE.ACLCACHE. NormalTrigger

The cache size, in ACLs, at which the service ACL cache schedules a low-priority purge of data that has not been recently used.

500 - Small

2000 - Medium

5000 - Large

No

IFS.SERVICE.ACLCACHE. UrgentTrigger

The cache size, in ACLs, at which the service ACL cache schedules a high-priority purge of data that has not been recently used. Must be greater than IFS.SERVICE. ACLCACHE.NormalTrigger.

550 - Small

2200 - Medium

5500 - Large

No

IFS.SERVICE.ACLCACHE. EmergencyTrigger

The cache size, in ACLs, at which the service ACL cache performs an immediate purge of data that has not been recently used. Must be greater than IFS.SERVICE.ACLCACHE. UrgentTrigger but less than IFS.SERVICE.ACLCACHE.Size.

600 - Small

2400 - Medium

6000 - Large

No

IFS.SERVICE.ACLCACHE. PurgeTarget

The target cache size, in ACLs, upon completion of a purge cycle. Must be less than IFS.SERVICE.ACLCACHE. NormalTrigger.

400 - Small

1600 - Medium

4000 - Large

No

IFS.SERVICE.CONNECTIONPOOL. READONLY.MinimumSize

The initial number of database connections in the read-only connection pool.

2 - Small

4 - Medium

6 - Large

No

IFS.SERVICE.CONNECTIONPOOL. READONLY.TargetSize

The target maximum number of database connections in the read-only connection pool. Must be greater than or equal to IFS.SERVICE. CONNECTIONPOOL.READONLY. MinimumSize.

10 - Small

20 - Medium

30 - Large

No

IFS.SERVICE.CONNECTIONPOOL. READONLY.MaximumSize

The absolute maximum number of database connections in the read-only connection pool. Must be greater than or equal to IFS.SERVICE. CONNECTIONPOOL.READONLY. TargetSize.

20 - Small

40 - Medium

60 - Large

No

IFS.SERVICE.CONNECTIONPOOL. READONLY.TargetSizeTimeout

The maximum period, in milliseconds, that the service will postpone a connection allocation request when there are no unallocated connections, if the current size of the read-only connection pool is greater than or equal to its target size but less than the maximum size. If a database connection does not become available within this period, a new connection will be created.

1000

No

IFS.SERVICE.CONNECTIONPOOL. READONLY.MaximumSizeTimeout

The maximum period, in milliseconds, that a service will postpone a connection allocation request when there are no unallocated connections, if the current size of the read-only connection pool is equal to its maximum size. If a database connection does not become available within this period, the allocation request will fail and an exception will be thrown.

10000

No

IFS.SERVICE.CONNECTIONPOOL. WRITEABLE.MinimumSize

The initial number of database connections in the writeable connection pool.

2 - Small

4 - Medium

6 - Large

No

IFS.SERVICE.CONNECTIONPOOL. WRITEABLE.TargetSize

The target maximum number of database connections in the writeable connection pool. Must be greater than or equal to IFS.SERVICE. CONNECTIONPOOL.WRITEABLE. MinimumSize.

10 - Small

20 - Medium

30 - Large

No

IFS.SERVICE.CONNECTIONPOOL. WRITEABLE.MaximumSize

The absolute maximum number of database connections in the writeable connection pool. Must be greater than or equal to IFS.SERVICE. CONNECTIONPOOL.WRITEABLE. TargetSize.

20 - Small

40 - Medium

60 - Large

No

IFS.SERVICE.CONNECTIONPOOL. WRITEABLE.TargetSizeTimeout

The maximum period, in milliseconds, that the service will postpone a connection allocation request when there are no unallocated connections, if the current size of the writeable connection pool is greater than or equal to its target size but less than the maximum size. If a database connection does not become available within this period, a new connection will be created.

1000

No

IFS.SERVICE.CONNECTIONPOOL. WRITEABLE.MaximumSizeTimeout

The maximum period, in milliseconds, that a service will postpone a connection allocation request when there are no unallocated connections, if the current size of the writeable connection pool is equal to its maximum size. If a database connection does not become available within this period, the allocation request will fail and an exception will be thrown.

10000

No

IFS.SERVICE. CaseSensitiveAuthentication

Whether, in performing Cleartext authentication, passwords are case sensitive.

false

No

IFS.SERVICE.CREDENTIALMANAGER. CredentialNameTokenizer

The fully qualified classname of the CredentialNameTokenizer.

oracle.ifs. common. IfsCredential NameTokenizer

No

IFS.SERVICE.CREDENTIALMANAGER.*

The configuration of credential managers for the service. Do not edit these properties directly, except for IFS.SERVICE. CREDENTIALMANAGER.Oid.OidSsl and IFS.SERVICE. CREDENTIALMANAGER.Oid.OidUrl.

N/A

N/A

IFS.SERVICE.CREDENTIALMANAGER. Oid.OidSsl

Whether Oracle Content Services connects to Oracle Internet Directory using SSL.

Set during configuration

No

IFS.SERVICE.CREDENTIALMANAGER. Oid.OidUrl

The URL for Oracle Internet Directory.

Set during configuration

No

IFS.SERVICE.DATACACHE. Size

The absolute maximum size of the service's data cache, in LIBRARYOBJECTs. The service data cache holds the attribute values of recently used LIBRARYOBJECTs.

7500 - Small

30000 - Medium

75000 - Large

No

IFS.SERVICE.DATACACHE. NormalTrigger

The cache size, in LIBRARYOBJECTs, at which the service data cache schedules a low-priority purge of data that has not been recently used.

5000 - Small

20000 - Medium

50000 - Large

No

IFS.SERVICE.DATACACHE. UrgentTrigger

The cache size, in LIBRARYOBJECTs, at which the service data cache schedules a high-priority purge of data that has not been recently used. Must be greater than IFS.SERVICE. DATACACHE.NormalTrigger.

5500 - Small

22000 - Medium

55000 - Large

No

IFS.SERVICE.DATACACHE. EmergencyTrigger

The cache size, in LIBRARYOBJECTs, at which the service data cache performs an immediate purge of data that has not been recently used. Must be greater than IFS.SERVICE.DATACACHE. UrgentTrigger but less than IFS. SERVICE.DATACACHE.Size.

6000 - Small

24000 - Medium

60000 - Large

No

IFS.SERVICE.DATACACHE. PurgeTarget

The target cache size, in LIBRARYOBJECTs, upon completion of a purge cycle. Must be less than IFS.SERVICE.DATACACHE.Normal Trigger.

4000 - Small

16000 - Medium

40000 - Large

No

IFS.SERVICE.HSM. PrimaryDevice

This property is not used.

none

No

IFS.SERVICE.JDBC. DefaultRowPrefetch

Number of result set rows prefetched. If set to null or 0, prefetches 10 rows. Do not change.

0

No

IFS.SERVICE.JDBC. DriverType

Specifies the JDBC driver type. Do not change.

oci8

No

IFS.SERVICE.JDBC. TracingEnabled

Prints JDBC debugging information to the standard output. Do not change.

false

No

IFS.SERVICE.SESSION. TransactionStackSize

The maximum number of nested transactions by the session.

100

No

IFS.SERVICE.SESSION.EventPoller

The event poller used by a session to generate the session's "heartbeat." Must be either oracle.ifs. beans.LibrarySessionEvent PollerThreadPerProcess (recommended) or oracle.ifs. beans.LibrarySessionEvent PollerThreadPerSession.

oracle.ifs. beans.Library SessionEvent PollerThreadPerProcess

No

IFS.SERVICE.SESSION. EventPollerPeriod

The period, in milliseconds, of the session's "heartbeat." In addition to indicating the session's health to the service, the heartbeat allows an idle session to process events generated by other sessions or services.

2500

No

IFS.SERVICE.SESSION. DefaultSearchTimeoutPeriod

The period, in seconds, after which a search API call is terminated, even if incomplete. If a search times out in this manner, it is terminated and an exception is thrown. The session performing the search remains valid. A value of 0 disables search time-outs.

60

No

IFS.SERVICE.SESSION. BEANSOBJECTCACHE.Size

The target maximum size of the "bean-side" session object cache, in LIBRARYOBJECTs. The bean-side session object cache holds instances of oracle.ifs.beans.Library Object. If IFS.SERVICE. SESSION.SERVEROBJECTCACHE. IsUnbounded is false, this value is ignored and implicitly equal to IFS. SERVICE.SESSION.SERVER OBJECTCACHE.Size.

750

No

IFS.SERVICE.SESSION. FOLDERPATHCACHE.Enabled

Whether the session caches the resolution of folder paths.

true

No

IFS.SERVICE.SESSION. FOLDERPATHCACHE.Size

The absolute maximum size of the session's folder path cache, in cached folder paths.

150

No

IFS.SERVICE.SESSION. FOLDERPATHCACHE.NormalTrigger

The cache size, in folder paths, at which the session's folder path cache schedules a low-priority purge of data that has not been recently used.

100

No

IFS.SERVICE.SESSION. FOLDERPATHCACHE.UrgentTrigger

The cache size, in folder paths, at which the session's folder path cache schedules a high-priority purge of data that has not been recently used. Must be greater than IFS.SERVICE. SESSION.FOLDERPATHCACHE. NormalTrigger and less than IFS.SERVICE.SESSION. FOLDERPATHCACHE.Size.

110

No

IFS.SERVICE.SESSION. FOLDERPATHCACHE.PurgeTarget

The target cache size, in folder paths, upon completion of a purge cycle. Must be less than IFS.SERVICE. SESSION.FOLDERPATHCACHE. NormalTrigger.

80

No

IFS.SERVICE.SESSION. SERVEROBJECTCACHE.Size

The absolute maximum size of the "server-side" session object cache, in LIBRARYOBJECTs. The server-side session object cache holds instances of oracle.ifs.server.S_Library Object and oracle.ifs.beans. LibraryObject.

750

No

IFS.SERVICE.SESSION. SERVEROBJECTCACHE.NormalTrigger

The cache size, in LIBRARYOBJECTs, at which the session data caches schedule a low-priority purge of data that has not been recently used.

500

No

IFS.SERVICE.SESSION. SERVEROBJECTCACHE.UrgentTrigger

The cache size, in LIBRARYOBJECTs, at which the session data caches schedule a high-priority purge of data that has not been recently used. Must be greater than IFS.SERVICE. SESSION.SERVEROBJECTCACHE. NormalTrigger.

550

No

IFS.SERVICE.SESSION. SERVEROBJECTCACHE.EmergencyTrigger

The cache size, in LIBRARYOBJECTs, at which the session data caches perform an immediate purge of data that has not been recently used. Must be greater than IFS.SERVICE. SESSION.SERVEROBJECTCACHE. UrgentTrigger but less than IFS. SERVICE.SESSION.SERVER OBJECTCACHE.Size.

600

No

IFS.SERVICE.SESSION. SERVEROBJECTCACHE.PurgeTarget

The target cache size, in LIBRARYOBJECTs, upon completion of a purge cycle. Must be less than IFS.SERVICE.SESSION.SERVER OBJECTCACHE.NormalTrigger.

400

No

IFS.SERVICE.TRACING. ChannelCount

The number of trace logger channels. Oracle reserves channels 0 to TraceLogger.LAST_RESERVED_CHANNEL. Refer to the Javadoc for class oracle.ifs.common.Trace Logger for a list of Oracle-defined channels.

50

No

IFS.SERVICE.TRACING. ServiceTraceType

The destination of trace data generated by a service. Must be TRACETYPE_NONE (disabled) or TRACETYPE_LOCAL (writes to a file on the local file system).

TRACETYPE_NONE

No

IFS.SERVICE.TRACING. ServerSessionTraceType

The destination of trace data generated by a server-side session. Must be TRACETYPE_NONE (disabled), TRACETYPE_LOCAL (writes to a file on the local file system), TRACETYPE_REMOTE (routes to the service's trace logger), or TRACETYPE_BOTH (writes to a file on the local file system and routes to the service's trace logger).

TRACETYPE_NONE

No

IFS.SERVICE.TRACING. BeansSessionTraceType

The destination of trace data generated by a bean-side session. Must be TRACETYPE_NONE (disabled), TRACETYPE_LOCAL (writes to a file on the local file system), TRACETYPE_REMOTE (routes to the server-side session's trace logger), or TRACETYPE_BOTH (writes to a file on the local file system and routes to the server-side session's trace logger).

TRACETYPE_NONE

No

IFS.SERVICE.TRACING. TraceLevelChanneln

Tracing verbosity for trace channel n. Refer to the Javadoc for class oracle.ifs.common.Trace Logger for a list of Oracle-defined trace levels.

none

No

IFS.SERVICE.TRACING. DefaultTraceLevel

Default tracing verbosity for all trace channels. See oracle.ifs.common. TraceLogger Javadoc for a list of trace levels.

none

No