Skip Headers

Oracle Files Administration Guide
9.0.3

Part Number A97358-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
Feedback

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

C
Server Configuration Properties

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 4, "Basic Administrative Operations" for additional information.

Access Control List Index Agent

The Access Control List Index agent...

IFS.SERVER.Class that instantiates the agent is:

oracle.ifs.management.servers.AccessControlListIndexAgent

Table C-1 Access Control List Index Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.SESSION.User

Username 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) Server

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 an 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 (AppleTalk Filing Protocol) Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.SESSION.User

Username for server session. Must be a user with Oracle Files administrator privileges.

system

IFS.SERVER.PROTOCOL.AFP.AcceptGuest
Connections

Allows or prevents unauthenticated guest connections. Set to true to allow unauthenticated users (guests) to connect. Set to false to require authentication (thus disabling guest access). By default, guest access (unauthenticated user access) is enabled.

true

IFS.SERVER.PROTOCOL.AFP.Disable
FolderIcons

Disables or enables custom Macintosh folder icons. Set to true to disable folder icons. Set to false to enable custom folder icons. By default, custom folder icons are disabled to provide faster file browsing.

true

IFS.SERVER.PROTOCOL.AFP.Disable
PkgInfo

Whether or not to "vanish" the special Macintosh "contents/PkgInfo" file. Set to true to hide all PkgInfo files. Set to false to display PkgInfo files. By default, PkgInfo files are not displayed to provide faster file browsing.

true

IFS.SERVER.PROTOCOL.AFP.Encoding

The encoding to use (Java or IANA code name) to convert Macintosh strings.

MacRoman

IFS.SERVER.PROTOCOL.AFP.LocalBind Address

The IP address that the server will use (bind to) when listening for incoming connections.

This value is set to the server IP address by default. It should not be modified except in unusual cases, for example, a multi-homed server.

IP address or DNS name

IFS.SERVER.PROTOCOL.AFP.MaxOpen Files

Maximum number of open file forks for each connected session. Macintosh files consist of up to two forks. A connected session can open only up to this number of forks simultaneously

1024

IFS.SERVER.PROTOCOL.AFP.Port

The AFP port; fixed and set to 548.

If not specified, Oracle Files uses the local host address and port 548.

AfpGarbageCollection Agent

The AFP server creates additional objects and attaches them to every folder and document in the Oracle Files repository that is viewed, edited, or created by Macintosh clients. When folders or documents are deleted, these additional objects are not deleted; they are left dangling. The AfpGarbageCollection agent deletes these dangling objects; it does so at periodic intervals.

IFS.SERVER.Class that instantiates the agent is:

oracle.ifs.protocols.afp.agent.AfpGarbageCollectionAgent

The AfpGarbageCollection agent requires t information must be included in the server configuration to run the agent:

Table C-3 AFPGarbageCollection Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.SESSION.User

Username for server session. Must be a user with Oracle Files administrator privileges.

system

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.TIMER.InitialTimeOfDay

First event. Set time based on a 24 hour clock.

01:30:00

Content Agent

These properties control the management of document content. Document content is stored in the database as LOBs. Content is moved to BFILES if it has not been accessed after the retention period. For information on using this feature, see Appendix 5, "Maintenance and Tuning".

The IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.ContentAgent

The following information must be included in the server configuration file to run the Content agent:

Table C-4 Content Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENT.CONTENTAGENT.Max
FilesPerFolder

For every relative path created, the maximum number of files that can be moved to a folder.

500

IFS.SERVER.AGENT.CONTENTAGENT.Max
FoldersPerActivationPeriod

The maximum number of folders created when the Content agent runs.

20

IFS.SERVER.AGENT.CONTENTAGENT.
RetentionPeriod

How long a file may be kept in the database as a LOB if no one accesses it.

30d

IFS.SERVER.AGENT.CONTENTAGENT.ContentToBfileManager

The fully qualified classname of ContentToBfileManager interface.

oracle.ifs.management.servers.Content.Ifs
ContentToBfile
Manager

Content Garbage Collection Agent

File attributes and content are stored separately. The Content Garbage Collection agent identifies content that no longer is referenced and deletes it. 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.

IFS.SERVER.Class used to instantiate the agent:

oracle.ifs.management.servers.ContentGarbageCollectionAgent

The following information must be included in the server configuration file to run the Content Garbage Collection agent:

Table C-5 Content Garbage Collection Agent Required 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

Dangling Object AV Cleanup Agent

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.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.DanglingObjectAVCleanupAgent

The following information must be included in the server configuration file to run the Dangling Object AV Cleanup agent:

Table C-6 Dangling Object AV Cleanup Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENTS.DANGLING
OBJECTAVCLEANUPAGENT.Excluded AttributeList

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

Distributed Authoring and Versioning (DAV) Server Configuration

Through WebFolders (WebDAV) and WebFolders-enabled applications, 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).

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.dav.impl.server.IfsServletServer

The following parameters must be included in the server configuration file to run the DAV server.

Table C-7 DAV Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.PROTOCOL.DAV.GuestPool.
Size. Min

The minimum size of the anonymous session pool.

This is allocated immediately upon startup.

1

IFS.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.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.Gu estPool.Timeout.Targ et milliseconds before allocating.

10

IFS.SERVER.PROTOCOL.DAV.GuestPool.
Timeout.Target

The targeted time before the anonymous session pool times out. The DavServer will wait this amount of time before allocating a new session if the Target size has been reached.

500

IFS.SERVER.PROTOCOL.DAV.GuestPool.
Timeout.Max

The maximum time before the anonymous session pool times out. The DavServer will wait this amount of time before returning Server Busy if the Max size has been reached.

1500

IFS.SERVER.PROTOCOL.DAV.LoginBeanName

The name by which the IfsHttpLogin bean is bound to the HttpSession.

IfsHttpLogin

IFS.SERVER.PROTOCOL.DAV.DAV.Browse.
Enabled

Enables and disables directory browsing. By default, directory browsing is enabled.

true

IFS.SERVER.PROTOCOL.DAV.Welcome

The welcome files, in the order they will be searched.

index.html

IFS.SERVER.PROTOCOL.DAV.Rendering.
Enabled

Enables and disables rendering. Set to true to enable rendering.

false

IFS.SERVER.PROTOCOL.DAV.Parsing.
Enabled

Enables and disables parsing for WebFolders. Set to true to enable parsing.

true

IFS.SERVER.PROTOCOL.DAV.Webfolders.
DefaultCharset

The charset the server should use if the client connecting is MS Web Folders.

iFS service-wide default charset

IFS.SERVER.PROTOCOL.DAV.ContextServlet
Path

The context/servlet path to which the IfsDavServlet is bound. If left unset, this will be computed automatically.

<null>

IFS.SERVER.PROTOCOL.DAV.IfsServer.Auth.
TokenCredential.Timeout

When the DavServer generates a TokenCredential, how long should it be good for.

864000

IFS.SERVER.PROTOCOL.DAV.UserLoginPool.
Max

How many concurrent connections a given user can have.

3

IFS.SERVER.PROTOCOL.DAV.Jsp.Enabled

Is JSP execution enabled? Must always be false. Do not change.

false

IFS.SERVER.PROTOCOL.DAV.Jsp.AllowedDirs

The directories in which JSPs are allowed to be executed. (Includes the directory and all of its subdirectories).

/ifs/webui/j sps

/ifs/jsp-bin

IFS.SERVER.PROTOCOL.DAV.Jsp.Lookup.BundleName

The name of the property bundle in the iFS repository containing the JspLookup mappings.

JspLookup

IFS.SERVER.PROTOCOL.DAV.Jsp.Lookup.
Para meterName

The parameter name the IfsDavServlet will use for the original request URL when redirecting to a JSP via the JspLookup mechanism.

path

Event Exchanger Agent

This agent periodically purges expired events from the event queue.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.EventExchangerAgent

The following information must be included in the server configuration file to run the Event Exchanger agent:

Table C-8 Event Exchanger Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.EventLifespan

The time, in seconds, after which an event is assumed to have been delivered and become eligible for purging.

Unit of measure is seconds.

1800

Expiration Agent

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.

IFS.SERVER.Class used to instantiate this agent:

IFS.SERVER.Class: oracle.ifs.management.servers.ExpirationAgent

The following information must be included in the server configuration file to run the Expiration agent:

Table C-9 Expiration Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.SESSION.User

Username 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

FolderIndexAnalyzerAgent

Oracle Files uses a scheme called FolderIndexService 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 FolderIndex in a suboptimal state. FolderIndexAnalyzer agent runs periodically to detect and correct any such state, and return the FolderIndex to an optimal state

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.FolderIndexAnalyzerAgent

You should never modify this value.

Table C-10 FolderIndex Analyzer Agent Required 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.

ANDed with the MaxChildren
Threshold.

10

IFS.SERVER.AGENTS.
FOLDERINDEXANALYZER
AGENT.MaxChildrenThreshold

The threshold for max number of children, after which FIS is considered suboptimal.

This condition is ANDed with the MaxParentsThreshold.

10

File Transfer Protocol (FTP) Server

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.

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.ftp.server.FtpServer

The following parameters must be included in the server configuration file to run the FTP server.

Table C-11 FTP (File Transfer Protocol) Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.PROTOCOL.FTP.Localhost

Optionally, specify the host name if the host is multi-homed in the network.

Default_Hostname

IFS.SERVER.PROTOCOL.FTP. AnonymousAllowed

If set to true, allows anonymous connections.

false

IFS.SERVER.PROTOCOL.FTP. DateFormat

Specifies the default date format.

MMM dd HH:mm

IFS.SERVER.PROTOCOL.FTP.Timeout

Amount of time between activity before the connection times out; default is 900 seconds or 15 minutes.

Unit of measure is milliseconds.

900000

IFS.SERVER.PROTOCOL.FTP.Delimiter

Specifies the Folder Path Delimiter.

/

IFS.SERVER.PROTOCOL.FTP.Port

The port on which the server is running.

21 (Windows NT), 2100 (Unix)

IFS.SERVER.PROTOCOL.FTP.AcceptQueueSize

The number of server requests back-logged before denying requests.

Do not modify.

50

IFS.SERVER.PROTOCOL.FTP.AnonymousPool Size

Initial pool size for anonymous connections.

0

IFS.SERVER.PROTOCOL.FTP.BannerText

The string that will be displayed when the FTP client is started.

Oracle Internet File System FTP Server ready

Garbage Collection Agent

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. It uses the following four parameters for this purpose, which are specified in the server configuration file:

For example, a document is created and modified by "ssmith." The creator, owner, and last modifier attribute of document are set to ssmith's object id. If "ssmith" 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.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.GarbageCollectionAgent

The following information must be included in the server configuration file to run the Garbage Collection agent:

Table C-12 Garbage Collection Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENT.GARBAGECOLLECTION AGENT.ReplacementOwner

User to be replaced as owner.

Modify as needed.

system

IFS.SERVER.AGENT.GARBAGECOLLECTION AGENT.ReplacementDeletor

User to be replaced as deletor.

Modify as needed.

system

IFS.SERVER.AGENT.GARBAGECOLLECTION AGENT.ReplacementCreator

User to be replaced as creator.

Modify as needed.

system

IFS.SERVER.AGENT.GARBAGECOLLECTION AGENT.ReplacementModifier

User to be replaced as modifier.

Modify as needed.

system

HTTP Admin Server

The HTTP Admin server must be running to use the Oracle Files Manager tool. [Dragos had deleted this server, another developer supplied the Files values. What is this used for with Files?]

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.dav.impl.server.IfsServletServer

Table C-13 HTTP Admin Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.PROTOCOL.DAV.LoginBeanName

The Login bean name. If it is different from the name that the Dav Server uses, the user will be required to log in once per servlet.

IfsHttpLogin

IFS.SERVER.APPLICATION.UIX.Maximum
UniqueSessionsPerUser

The maximum number of distinct sessions a web user can get. After the maximum number has been reached, the sessions are shared in a round-robin fashion.

3

IFS.SERVER.APPLICATION.UIX.Application
Host

The host name of the site (where a user connects; e.g., files.oracle.com)

Configurable at installation.

IFS.SERVER.APPLICATION.UIX.Application
UseHttps

Whether the site uses SSL/HTTPS; e.g., https://file.oracle.com.

Configurable at installation.

IFS.SERVER.APPLICATION.UIX.Application
Port

The port number of the site (usually 80).

Configurable at installation.

IFS.SERVER.APPLICATION.UIX.Application
ServletMount

The mount point for the application servlet

/files/app

IFS.SERVER.APPLICATION.UIX.ContentServletMount

The mount point for the content/DAV servlet.

/files/content

IFS.SERVER.APPLICATION.UIX.StaticResourcesMount

The mount point for the static images used to render web pages.

/files/static

IFS.SERVER.APPLICATION.UIX.HttpAuth
ManagerClass

The HTTP Authentication Manager to use (do not edit).

oracle.ifs.files.servlet.
FilesHttpAuthManager

IFS.SERVER.APPLICATION.UIX.AdministratorEmail

The email address of the person who administers the system and receives alerts and error reports.

Configurable at installation.

Inbound Queue Listener Agent

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 InboundQueueListener agent can dequeue a message and delegate the work of proccessing to the message object itself.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.InboundQueueListenerAgent

Table C-14 Inbound Queue Listener Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENT.INBOUNDQUEUE
LISTENERAGENT.Queues +

Holds a list of queues that the agent will listen on.

IFS_IN

Lock Agent

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.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.LockAgent

NbServer [NetBIOS]

The NbServer is a DNS server for Windows NetBIOS names. It tells client machines that its name is registered to a particular IP address.

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.smb.server.NbServer

The following parameters must be included in the server configuration file to run the Nb server.

Table C-15 Nb or Agent Required 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.getInetAddress()

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, e.g. "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

Enable Host Announcement.

true

Network File System (NFS) Protocol Server

The Network File System (NFS) protocol is used to provide file sharing between a client machine and a server machine 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.

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.nfs.server.NfsServer

The following parameters must be included in the server configuration file to run the NFS server.

Table C-16 NFS Protocol Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.PROTOCOL.NFS. Localhost

Specifies the IP address the server will listen on if the server machine is capable of listening on multiple IP addresses.

This is the same as the Localhost parameter on other protocol servers.

Null

IFS.SERVER.PROTOCOL.NFS. PortmapUdpServers

Specifies the number of UDP server threads to be started for the Portmap server.

The number of UDP server threads determines how many simultaneous UDP requests the Portmap server can handle.

1

IFS.SERVER.PROTOCOL.NFS. PortmapTcpEnabled

specifies whether or not the Portmap server will accept TCP connections in addition to UDP connections.

true

IFS.SERVER.PROTOCOL.NFS. MountUdpServers

Specifies the number of UDP server threads to be started for the Mount server.

The number of UDP server threads determines how many simultaneous UDP requests the Mount server can handle.

1

IFS.SERVER.PROTOCOL.NFS. MountTcpEnabled

Specifies whether or not the Mount server will accept TCP connections in addition to UDP connections.

true

IFS.SERVER.PROTOCOL.NFS. MountPort

Specifies the port number which the Mount server will listen on. A value of zero will use any available port.

The Mount server will normally use any available port number and then register the port number being used with the Portmap server. A specific port number should be specified if the Mount server is a secondary server and does not register the port with the Portmap server.

4048 for Unix; 0 for NT

IFS.SERVER.PROTOCOL.NFS. UdpServers

Specifies the number of UDP server threads to be started for the NFS server.

The number of UDP server threads determines how many simultaneous UDP requests the NFS server can handle.

16

IFS.SERVER.PROTOCOL.NFS. TcpEnabled

Specifies whether or not the NFS server will accept TCP connections in addition to UDP connections.

true

IFS.SERVER.PROTOCOL.NFS. Port

Specifies the port number which the NFS server will listen on.

The standard port number for the NFS server is port 2049. On Unix systems, the standard Unix NFS server will be running on the standard port, therefore the iFS NFS server is configured to be a secondary NFS server running on a different port number.

4049 for Unix; 2049 for NT

IFS.SERVER.PROTOCOL.NFS. TrustedClientsEnabled

Enable Trusted Client List feature.

false

IFS.SERVER.PROTOCOL.NFS.TrustedClient
List+

List of trusted NFS clients.

<"">

IFS.SERVER.PROTOCOL.NFS.NISEnabled

Used to indicate if HIS is used for user management.

false

IFS.SERVER.PROTOCOL.NFS.NISService
Provider

Provider of NIS service. This is an NIS server.

<"">

IFS.SERVER.PROTOCOL.NFS. CharacterEncoding

Specifies the character encoding to be used to interpret string such as file names that the NFS server receives from the clients. The value is the name of a Java character encoding. For example: ASCII, ISO8859_1, or Cp437. A null value indicates that the default character encoding should be used.

Null

IFS.SERVER.PROTOCOL.NFS. UserCacheMax

Specifies the number of iFS user sessions the NFS server will keep open.

This value should be set to the expected number of simultaneous active users.

16

IFS.SERVER.PROTOCOL.NFS.Allow
AnonymousUser

Allows users to login as anonymous/guest.

true

IFS.SERVER.PROTOCOL.NFS.ResetUserCache

Used to control the resetting of the user cache. Used when privileges are changed.

0

IFS.SERVER.PROTOCOL.NFS.
IoBufferSize

Specifies the I/O buffer size. The I/O buffer size determines the largest amount of data that can be read or written in a single request to the NFS server.

32768

IFS.SERVER.PROTOCOL.NFS.
IoBufferCacheTargetSize

Specifies the number of I/O buffers that the NFS server will try to allocate.

This should be set to the expected number of simultaneous I/O operations.

8

IFS.SERVER.PROTOCOL.NFS. ContentCacheFlush

Specifies the write flush time-out value in milliseconds. The default value of 2000 means that writes to an iFS document will be committed to the database after 2 seconds.

Setting too low of a time-out value may cause additional database commits resulting is slower performance. Setting too high a time-out value will cause a delay before the data is committed and is available to other protocols.

2000

IFS.SERVER.PROTOCOL.NFS. ContentCacheKeep

Specifies the keep time-out value in milliseconds. The default value of 10000 means that once a document is opened, the NFS server will attempt to cache its contents for 10 seconds.

10000

IFS.SERVER.PROTOCOL.NFS. ContentCacheMax

Specifies the maximum number of documents the NFS server will keep in its content cache.

Increasing the content cache size improves performance but will use additional database connections.

8

IFS.SERVER.PROTOCOL.NFS. RpcRequestCacheBufferSize

Specifies the size of the request cache buffer. The request cache maintains a history of recent requests and is used to return a reply when a duplicate request is received from a client.

65535

IFS.SERVER.PROTOCOL.NFS. RpcRequestCacheMax

Specifies the maximum number of requests to be kept in the request cache. The request cache maintains a history of recent requests and is used to return a reply when a duplicate request is received from a client.

64

IFS.SERVER.PROTOCOL.NFS. RpcRequestCacheMaxReply
Len

Specifies the maximum length of a reply to be kept in the request cache. The request cache maintains a history of recent requests and is used to return a reply when a duplicate request is received from a client.

16384

IFS.SERVER.PROTOCOL.NFS. SafeWriteMode

Specifies whether or not SafeWriteMode is enabled. If true, data written to NFS will be logged tot he local disk in addition to being written to the database.

false

IFS.SERVER.PROTOCOL.NFS. SafeWriteLogs

Specifies the directory where the recovery log files will be written if SafeWriteMode in enabled.

The directory path specified in relative the iFS home directory where Oracle Files was installed.

nfs/Recovery Logs

IFS.SERVER.PROTOCOL.NFS. SafeWriteActivationPeriod

Specifies the activation period for the SafeWriteMode recovery thread in minutes. The default value of 20 indicates that the SafeWriteMode recovery thread will run every 20 minutes.

20

NT File System Protocol Server

Windows NT/2000 platforms only.

The NT File System (NTFS) allows the Oracle Files repository to appear as a local hard drive on the server machine. When using the NTFS, the Oracle Files repository will be mapped to a drive letter on the server machine and can be accessed using the file system as if it were a local hard drive.

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.ntfs.server.NtfsServer

The following parameters must be included in the server configuration file to run the NTFS server.

Table C-17 Ntfs Required 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 in relative to the Oracle Files home directory where Oracle Files was installed.

lib\ifsproxy.
dll

OiD Credential Manager Agent

The Oid Credential Manager agent is a time-based agent that polls for changes and notifies the system administrator whenever a new OiD subscriber is added. The agent used the OidCrendentialManager APIs to obtain a list of subscribers in OiD and the list of those that are supported by the credential manager.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.OidCredentialManagerAgent

Table C-18 Oid Credential Manager Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.SESSION.User

Username for server session. Must be a user with Oracle Files administrator privileges.

system

IFS.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

6m

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).

15m

Print Agent

The Print agent makes printing through Oracle Files indistinguishable from printing to a normal Windows NT server.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.print.PrintAgent

Quota Agent

The Quota agent is triggered by an event to check for any users who may have used up their quota. 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, then 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 users' last file will put them over quota before being denied.

Quotas will not be enforced if:

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.QuotaAgent

Service Warmup Agent

When a node is started, this agent automatically preloads the service's data cache. It expects the following entries in the Server Configuration file.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.ServiceWarmupAgent

Table C-19 Service Warmup Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENT.SERVICEWARMUP.
WarmupSetAdmin

If the warmup is done in administration mode.

true

IFS.SERVER.AGENT.SERVICEWARMUP.
WarmupUsers

If set to true, warms up user collection.

false

IFS.SERVER.AGENT.SERVICEWARMUP.
WarmupAcls

If set to true, warms up ACL collection.

false

IFS.SERVER.AGENT.SERVICEWARMUP.
WarmupFormats

If set to true, warms up format collection.

true

IFS.SERVER.AGENT.SERVICEWARMUP.
WarmupMedias

If set to true, warms up Media collection.

true

Service Watchdog Agent

ServiceWatchdogAgent cleans up after the Oracle Files services that do not shut down cleanly. This functionality is also used by SMB servers to keep track of WCP servers that are currently running, and the Web interface to keep track of FTP servers that are currently running.

IFS.SERVER.Class used to instantiate this agent:

oracle.ifs.management.servers.ServiceWatchdogAgent

Table C-20 Service Watchdog Agent Required Properties
Property Description and Usage Note Default

IFS.SERVER.AGENT.SERVICEWATCHDOG AGENT.ServiceTimeoutPeriod

The time before the Server Manager will kill an unresponsive protocol server.

Unit of measure is seconds.

120

Server Message Block (SMB) Protocol Server

The SMB server allows Windows users 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 FilesOracle Files repository. SMB is best suited for interactive browsing and modifying documents.

IFS.SERVER.Class used to instantiate this server:

oracle.ifs.protocols.smb.server.SmbServer

Table C-21 SMB Protocol Server Required Properties
Property Description and Usage Note Default

IFS.SERVER.PROTOCOL.SMB.ServerComment

Holds the SMB server description that shows up in the Windows Properties window.

"Oracle Internet File Server"

IFS.SERVER.PROTOCOL.SMB.PrimeServer

Primes the server with a simple login.

true

IFS.SERVER.PROTOCOL.SMB.EnableOplocks

If this parameter is true, it lets client cache their reads and writes and results in improved performance.

If set to true, this may cause problems with consistency across all the protocols; however, true yields better performance.

true

IFS.SERVER.PROTOCOL.SMB.MaxOplocks

Maximum number of op locks per mount point.

See Microsoft documentation for information about OpLocks.

8

IFS.SERVER.PROTOCOL.SMB.KeepStats

If true, keeps statistics on various server operations.

true

IFS.SERVER.PROTOCOL.SMB.PrintStats

If true, prints statistics on SMB commands into the log file after the user disconnects.

Defaults to true if the log level for the node is medium or greater.

IFS.SERVER.PROTOCOL.SMB.ShareMyHome

Specifies if the virtual MyHome mount point is shared as a mount point.

true = MyHome the list of mount points.

false = only administer defined mount points.

true

IFS.SERVERPROTOCOL..SMB.Workgroup

Windows workgroup.

This determines the workgroup where the SMB server will appear in the Network Neighborhood.

WORKGROUP

IFS.SERVER.PROTOCOL.SMB.Port

Port for the SMB server to listen on.

All Windows clients require the SMB server to listen on the default port, 139. Only processes with root privileges can listen on low-numbered ports, so the SMB server must be run as root.

139

IFS.SERVER.PROTOCOL.SMB.AllowGuest
IfNot User

Allows users who do not have valid accounts on this server to browse as a guest.

true = allows non-guest users as guest.

false = forces a valid username.

true

IFS.SERVER.PROTOCOL.SMB.MaxOpenFiles

The maximum number of files a user can have open on a single mountpoint.

30

IFS.SERVER.PROTOCOL.SMB.MaxAll
OpenFiles

The total number of open files the SMB server allows across all users.

The total is also limited by the number of connections configured for the SMB server and database.

100

IFS.SERVER.PROTOCOL.SMB.EnableParsing

Enables the parsing feature when saving Oracle Files files.

true = enables parsing.

false = disables parsing.

true

IFS.SERVER.PROTOCOL.SMB.Enable
Rendering

Enables the rendering feature when reading Oracle Files files.

true = enables rendering.

false = disables rendering.

true

IFS.SERVER.PROTOCOL.SMB.SessionTimeout

The server will disconnect idle sessions after this timeout.

Unit of measure is in milliseconds.

43200000 (12 hours)

IFS.SERVER.PROTOCOL.SMB.IpAddress

The IP address that is advertised as the location for the SMB server.

This value is defaulted from the server IP address and should not be modified except in unusual cases, for example, multi server.

server IP address

IFS.SERVER.PROTOCOL.SMB.HostName

Name of the SMB server.This value is defaulted from the socket information.

IFS.SERVER.PROTOCOL.SMB.ForceLowerCase

Forces lowercase filenames.

Oracle Files Server Configuration Parameters

Oracle Files uses four additional server configuration properties, specific to Oracle Files. These properties are inherited and locally defined:

Table C-22 Oracle Files Server Configuration Properties
Property Description and Usage Note

IFS.SERVER.APPLICATION.FILES.PortalUrl

URL for the Back to Portal global button.

IFS.SERVER.APPLICATION.FILES.PrivacyStatement

Location of primary statement relative to the system data folder.

IFS.SERVER.APPLICATION.FILES.PublicBrowsingAllowed

Whether users can browse public folders without logging in.

IFS.SERVER.APPLICATION.FILES.WorkflowUrl

URL for the workflow global button.

To access the Oracle Files Server Configuration Properties page:

  1. Click the Server Configuration under the Configuration section on the Oracle Files Administration page.
  2. From the Server Configuration page, click FilesHttpServerConfiguration.
  3. In the Properties section on the Properties page, begin working with Oracle Files Server Configuration Properties.

If you make changes to the inherited Server Configurations, click Update Inherited Properties to revise the inherited properties. Click Add, Edit, or Remove to manage locally defined properties.