Oracle® Files Administrator's Guide Release 2 (9.0.4) Part Number B10872-02 |
|
|
View PDF |
Each server has an IFS.SERVER.Class
property that identifies the Java class that the node uses to instantiate the server or agent. You cannot change the name of the class; if you do, the protocol server or agent will not run.
The properties listed in these tables are all required for an agent or protocol server to run properly. When you install and configure an Oracle Files instance, the properties are configured using the default values shown in the tables in this section. You can change these in the base class and then create new servers or agents based on the changes, or you can change the values in the running server or agent. See Chapter 6, "Changing Configuration Settings" for additional information.
This appendix includes the following topics:
The Access Control List Index Agent performs background maintenance operations on internal Oracle Files tables that are referred to collectively as the "ACL index." These tables make certain security functions (such as object discovery, ACL resolution, ACL proxies, and Workspace membership resolution) perform better.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.AccessControlListIndexAgent
Table C-1 Access Control List Index Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.SESSION.User |
User name for server session. Must be a user with Oracle Files administrator privileges. | system |
FS.SERVER.TIMER.InitialDelay |
The initial delay when the agent will first run; this allows the agents' first trigger to be staggered.
h = hours, m = minutes, s = seconds |
10s |
IFS.SERVER.TIMER.ActivationPeriod |
Time interval between agent activation. Default setting of 24h activates the agent every 24 hours. Set time in h (hours), m (minutes), or s (seconds). | 24h |
IFS.SERVER.AGENT.ACCESSCONTROLLIST INDEXAGENT.MaxDeferredEntryCount |
Maximum number of entries to process in a single batch. The default value should rarely be modified. | 10000 |
FS.SERVER.AGENT.ACCESSCONTROLLIST INDEXAGENT.PublishStatisticsPeriod |
Time interval at which agent statistics are published. Set time in h (hours), m (minutes), or s (seconds). | 1m |
AppleTalk Filing Protocol (AFP) is the remote filing system protocol that enables Macintosh users to store, access, and share files over a network. AppleShare is the AFP file server that is implemented on Macintosh computers. The Oracle Files AFP server enables Macintosh users to access Oracle Files as if it were an AppleShare server.
The IFS.SERVER.Class
that instantiates the AFP Server is:
oracle.ifs.protocols.afp.AfpServer
Table C-2 AFP Server Properties
File attributes and content are stored separately. For performance reasons, the content of a document is not deleted when the document is deleted. The Content Garbage Collection Agent deletes the unreferenced content. This agent runs at specific times of the day as specified in the server configuration file.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.ContentGarbageCollectionAgent
Table C-3 Content Garbage Collection Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENT.CONTENTGARBAGE COLLECTIONAGENT.FilteredContent RemovalPeriod |
Amount of time filtered content is kept in the system before it is deleted. HTML-generated rendition of content is an example of filtered content. Unit of measure is seconds. | 3600 |
Similar to the Garbage Collection Agent, the Dangling Object AV Cleanup Agent removes orphaned object type references and identifies all invalid object references, such as references to objects that no longer exist, and sets these references to null for array type attributes and zero for scalar attributes. For example, this agent cleans up the owner attribute of a document pointing to directory object which was deleted and is now invalid.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.DanglingObjectAVCleanupAgent
Table C-4 Dangling Object AV Cleanup Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENTS.DANGLING OBJECTAVCLEANUPAGENT. ExcludedAttributeList |
A list of attributes for which invalid references to Library Objects are not cleaned up.
Do not delete the default values, so the Garbage Collection Agent can handle deleted users correctly. Add additional attributes as needed. |
AUDITENTRY
PUBLICOBJECT:OWNER PUBLICOBJECT:DELETOR PUBLICOBJECT:CREATOR PUBLICOBJECT:LASTMODIFIER VERSIONSERIES:RESERVOR |
Through Web Folders (WebDAV) and Web Folders-enabled applications, you can edit Microsoft Office documents stored in Oracle Files in place with Windows Office 2000. A new document can be created in Oracle Files this way. Customers can then delete this document in a Web Folder. This servlet also serves documents over HTTP (browser).
The IFS.SERVER.Class
that instantiates this server is:
oracle.ifs.protocols.dav.impl.server.IfsServletServer
Table C-5 DAV Server Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.PROTOCOL.DAV. Browse.Enabled |
This value has no effect in Oracle Files. | N/A |
IFS.SERVER.PROTOCOL.DAV. ContextServletPath |
This value has no effect in Oracle Files. | N/A |
IFS.SERVER.PROTOCOL.DAV. GuestPool.Size.Max |
The maximum size of the anonymous session pool. This is allocated if the target size is not sufficient to service traffic volume, but will wait IFS.SERVER.PROTOCOL.DAV. GuestPool.Timeout.Target milliseconds before allocating. |
10 |
IFS.SERVER.PROTOCOL.DAV. GuestPool.Size.Min |
The minimum size of the anonymous session pool. This is allocated immediately upon startup. | 1 |
I FS.SERVER.PROTOCOL.DAV. GuestPool.Size.Target |
The target size of the anonymous session pool. This is allocated immediately if the target size is not sufficient to service traffic volume. | 5 |
IFS.SERVER.PROTOCOL.DAV. GuestPool.Timeout.Max |
The maximum time before the anonymous session pool times out. The DAV Server will wait this amount of time before returning "Server Busy" if the Max size has been reached. | 1500 |
IFS.SERVER.PROTOCOL.DAV. GuestPool.Timeout.Target |
The targeted time before the anonymous session pool times out. The DAV Server will wait this amount of time before allocating a new session if the Target size has been reached. | 500 |
IFS.SERVER.PROTOCOL.DAV. IfsServer.Auth.TokenCredential. Timeout |
When the DAV Server generates a token credential, how long should it be good for. Currently used by Oracle FileSync.
This property is measured in seconds. Set to zero to disable the token credential. |
864000 |
IFS.SERVER.PROTOCOL.DAV. Jsp.AllowedDirs |
This value has no effect in Oracle Files. | N/A |
IFS.SERVER.PROTOCOL.DAV. Jsp.Enabled |
Whether JSP execution is enabled. Must always be false. Do not change. | false |
IFS.SERVER.PROTOCOL.DAV. Jsp.Lookup.BundleName |
This value has no effect in Oracle Files. | N/A |
IFS.SERVER.PROTOCOL.DAV. Jsp.Lookup.ParameterName |
This value has no effect in Oracle Files. | N/A |
IFS.SERVER.PROTOCOL.DAV. LoginBeanName |
The name by which the IfsHttpLogin bean is bound to the HttpSession. Do not change. |
IfsHttpLogin |
IFS.SERVER.PROTOCOL.DAV. UserLoginPool.Max |
How many concurrent connections a given user can have. | 3 |
IFS.SERVER.PROTOCOL.DAV. Welcome |
The welcome files, in the order they will be searched. | index.html |
IFS.SERVER.PROTOCOL.DAV. Webfolders.DefaultCharset |
This value has no effect in Oracle Files. | N/A |
This agent periodically purges expired events from the event queue.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.EventExchangerAgent
All public objects have an attribute called ExpirationDate. Once this date passes, the Public Objects are automatically deleted. This is handled by the Expiration Agent, which periodically deletes expired objects. If the expiration date of a Public Object passes, the agent deletes the Public Object. This agent runs at specific times of the day as specified in the server configuration parameter, IFS.SERVER.TIMER. ACTIVATIONPERIOD
.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.ExpirationAgent
Table C-7 Expiration Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.SESSION.User |
User name for server session. Must be a user with Oracle Files administrator privileges. | system |
IFS.SERVER.TIMER.InitialTimeOfDay |
First event.
Set time based on a 24 hour clock. |
02:00:00 |
IFS.SERVER.TIMER.ActivationPeriod |
Defines the time interval between when the agent will be triggered.
h = hours, m = minutes, s = seconds. |
24h |
The FTP server allows users to easily transfer files between one file system and the Oracle Files repository. FTP is particularly useful when performing bulk transfers, in regards to both ease and performance. In addition to the common FTP commands, the Oracle Files server also has built-in parsing and versioning support.
The IFS.SERVER.Class
that instantiates the FTP server is:
oracle.ifs.protocols.ftp.server.FtpServer
Table C-8 FTP Server Properties
Oracle Files uses additional server configuration properties, specific to Oracle Files. These properties are inherited and locally defined.
Note: If you configured Oracle Files to reuse a previously created schema, you must edit the following Files Base Server Configuration properties so that they point to the appropriate computer:
Or, you can override these properties in the server-specific configurations. |
Table C-9 Files Base Server Properties
Oracle Files uses several server configurations that do not have properties of their own; they only inherit from other configurations. The properties of the Files-specific configurations may override properties from the inherited configurations.
Table C-10 Files-Specific Server Configurations
The Oracle Files HTTP Server
Do not change the name of the FilesHttpServer
. If you change the server name, you will not be able to access Oracle Files through the Web application interface.
If you must change the FilesHttpServer
name, you must also change the name in the web.xml
configuration file. To change the FilesHttpServer
name:
Rename the server using the Oracle Enterprise Manager Web site.
Edit web.xml
, located in the following directory:
$ORACLE_HOME/j2ee/OC4J_iFS_files/applications/files/files/WEB-INF/
Look for the following lines of code and replace the value for <param-value>
:
<init-param> <param-name>IFS.SERVER.PROTOCOL.DAV.IfsServer.Name</param-name> <param-value>FilesHttpServer</param-value> </init-param>
Save the file.
Restart the OC4J instance.
Oracle Files uses an internal mechanism called the Folder Index to speed up folder-restricted queries. This index is modified every time the folder hierarchy gets changed, to reflect the up-to-date folder hierarchy. However, certain forms of file links may leave the Folder Index in a suboptimal state. The Folder Index Analyzer Agent runs periodically to detect and correct any such state, and return the Folder Index to an optimal state.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.FolderIndexAnalyzerAgent
You should never modify these values.
Table C-11 Folder Index Analyzer Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENTS.FOLDERINDEX ANALYZERAGENT.MaxParentsThreshold |
The threshold for max number of parents after which FIS is considered suboptimal.
This condition is ANDed with the |
10 |
IFS.SERVER.AGENTS.FOLDERINDEX ANALYZERAGENT.MaxChildrenThreshold |
The threshold for max number of children after which FIS is considered suboptimal.
This condition is ANDed with the |
10 |
The Garbage Collection Agent runs at specific times of the day as specified in the server configuration file. Currently, this agent fixes invalid Public Object owners, creators, deletors, and modifiers.
For example, a document is created and modified by "jsmith." The creator, owner, and last modifier attribute of document are set to jsmith's object ID. If "jsmith" is deleted, the attribute value becomes invalid. The agent replaces these invalid attribute values with the ID of the replacement owner, creator, or deletor specified in the server configuration file.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.GarbageCollectionAgent
Table C-12 Garbage Collection Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT. ReplacementOwner |
User to be replaced as owner.
Modify as needed. |
system |
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT. ReplacementDeletor |
User to be replaced as deletor.
Modify as needed. |
system |
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT. ReplacementCreator |
User to be replaced as creator.
Modify as needed. |
system |
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT. ReplacementModifier |
User to be replaced as modifier.
Modify as needed. |
system |
The Inbound Queue Listener Agent is a time-based agent that polls all of the inbound queues periodically so that Oracle Files can act upon the messages placed on inbound queues. The Inbound Queue Listener Agent can dequeue a message and delegate the work of processing to the message object itself.
The IFS.SERVER.Class that instantiates this agent is:
oracle.ifs.management.servers.InboundQueueListenerAgent
The Lock Agent is a time-based agent that releases locks that are timed out. The agent needs to be running at all times for the lock auto-expiration function to work.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.LockAgent
The NbServer is a name server for Windows NetBIOS names. It tells client computers that its name is registered to a particular IP address.
The IFS.SERVER.Class
that instantiates this server is:
oracle.ifs.protocols.smb.server.NbServer
Table C-14 Nb Server Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.NB.Workgroup |
Name of the workgroup this server is in. | WORKGROUP |
IFS.SERVER.NB.ServerComment |
This holds the SMB server description that shows up in properties in Windows. | Oracle Internet File Server |
IFS.SERVER.NB.IpAddr |
If host is multi-homed, use this to choose the IP address if necessary | IP Address returned by Socket.getInet Address() |
IFS.SERVER.NB.Netmask |
NetMask for the name server. This is used to derive the broadcast address. No need to set this if the broadcast address is specified explicitly. | 255.255.252.0 |
IFS.SERVER.NB.Broadcast |
Broadcast address. Use this if you know the broadcast address or want to override the address derived from the netmask. This is specified as a standard IP string (for example, 144.25.103.255). | Derived from the IP address and netmask |
IFS.SERVER.NB.StatusInterval |
Number of packets between each status message to trace file. | 100 |
IFS.SERVER.NB.HostAnnouncer |
Enables Host Announcement. | true |
The Network File System (NFS) protocol is used to provide file sharing between a client computer and a server computer across a network. The NFS protocol is a standard protocol which is widely used for file sharing on UNIX platforms. Although used primarily on UNIX platforms, the NFS protocol is designed to be operating system-independent and implementations of the NFS protocol exist for other platforms, such as Windows.
See "Using Oracle Files with NFS" for information about configuring the NFS server, including mapping UNIX UIDs to Oracle Files user accounts, setting up a trusted client list, and enabling NIS authentication.
The IFS.SERVER.Class
that instantiates the NFS server is:
oracle.ifs.protocols.nfs.server.NfsServer
Table C-15 NFS Server Properties
For Windows platforms only.
The NT File System (NTFS) allows the Oracle Files repository to appear as a local hard drive on the server computer. When using NTFS, the Oracle Files repository will be mapped to a drive letter on the server computer and can be accessed using the file system as if it were a local hard drive.
The IFS.SERVER.Class
that instantiates the NTFS server is:
oracle.ifs.protocols.ntfs.server.NtfsServer
Table C-16 NTFS Server Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.PROTOCOL.NTFS. DriveLetter |
The drive letter used to map the Oracle Files drive.
An available and valid drive letter (A - Z). |
O |
IFS.SERVER.PROTOCOL.NTFS. LogLevel |
Specifies the type of information listed in the log file.
A number from 1 to 4. 1 is the minimum and 4 is the maximum information in the log file. |
1 |
IFS.SERVER.PROTOCOL.NTFS. LogStackTrace |
Specifies if the Java stack trace is listed in the log file.
true = list Java stack trace. false = do not list Java stack trace. |
false |
IFS.SERVER.PROTOCOL.NTFS. SessionCache |
Specifies the number of user sessions the NTFS server will keep open.
This value should be set to the expected number of simultaneously opened files. |
40 |
IFS.SERVER.PROTOCOL.NTFS. ifsproxy |
Specifies the location of the ifsproxy.dll library.
The path specified is relative to the Oracle Files home directory where Oracle Files was installed. |
lib/ifsproxy.dll |
The Print Agent makes printing through Oracle Files indistinguishable from printing to a normal Windows server.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.print.PrintAgent
The Quota Agent is triggered by an event to compute the consumed quota for users or Workspaces. This agent also periodically checks all users who are active, according to a specified timer period. The agent updates the user's consumed storage. When the consumed storage is over the allocated quota, the user will not be able to add any more documents to Oracle Files.
A user's quota is calculated upon the content already consumed. Therefore, a user will go over quota by adding the final file that pushes the consumed storage over the allocated storage. When setting users' allocated quota, remember that a user's last file will put him or her over quota before being denied.
Quotas will not be enforced if:
The Quota Agent has not been started or is not running.
The user's quota has not been enabled.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.QuotaAgent
When a node is started, this agent automatically preloads the service's data cache. It expects the following entries in the Server Configuration file.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.ServiceWarmupAgent
Table C-17 Service Warmup Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENT.SERVICEWARMUP. WarmupSetAdmin |
If the preloading is done in administration mode. | true |
IFS.SERVER.AGENT.SERVICEWARMUP. WarmupUsers |
If set to true, preloads user collection. | false |
IFS.SERVER.AGENT.SERVICEWARMUP. WarmupAcls |
If set to true, preloads ACL collection. | false |
IFS.SERVER.AGENT.SERVICEWARMUP. WarmupFormats |
If set to true, preloads format collection. | true |
IFS.SERVER.AGENT.SERVICEWARMUP. WarmupMedias |
If set to true, preloads Media collection. | true |
The Service Watchdog Agent cleans up after Oracle Files services that do not shut down cleanly.
The IFS.SERVER.Class
that instantiates this agent is:
oracle.ifs.management.servers.ServiceWatchdogAgent
Table C-18 Service Watchdog Agent Properties
Property | Description and Usage Note | Default |
---|---|---|
IFS.SERVER.AGENT.SERVICEWATCHDOGAGENT. ServiceTimeoutPeriod |
The number of seconds after which a service is considered inactive. When a service becomes inactive, it is eligible for cleanup by the Service Watchdog Agent. | 120 |
The SMB server allows Windows clients to easily copy files between their local drives and the Oracle Files repository. It also allows users to browse and edit files and even execute programs directly from the Oracle Files repository. SMB is best suited for interactive browsing and modifying documents.
You should configure the NbServer for use with SMB; see "NbServer [NetBIOS]" for more information.
The IFS.SERVER.Class
that instantiates this server is:
oracle.ifs.protocols.smb.server.SmbServer
Table C-19 SMB Server Properties