C
Server Configuration Objects

The server configuration objects are stored in the Oracle 9iFS repository and administered through Oracle 9iFS Manager. Server Configurations, located under Administrator's Tasks, provides access to these server configuration files:

Overview of Server Configuration

A server configuration is a template for creating a particular type of server on a generic node. Server configurations specify their server types as Java classnames. In addition to the server type, each server configuration specifies values for parameters relevant to that type. For example, a server configuration for the Oracle 9iFS FTP server specifies the FTP port number, whether anonymous FTP connections are allowed, and the connection time-out period.

Most of the ServerConfiguration information is used by the server itself. Only the server Java class entry is used by the node to instantiate a new server. What follows is a description of ServerConfiguration for each of the servers that ship with Oracle 9iFS.

Content Garbage Collection Agent

Content is stored separately from file attributes. The Content Garbage Collection agent identifies unreferenced content 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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs.management. servers.ContentGarbage CollectionAgent`	The agent class.	Do not modify.
`IFS.SERVER.TIMER.InitialTimeOfDay`	`2:30:00m`	The initial delay when the agent will first run; this allows the agents' first trigger to be staggered.	h = hours, m = minutes, s = seconds.
`IFS.SERVER.TIMER.ActivationPeriod`	`1``h`	The time interval between the agent's subsequent runs.	h = hours, m = minutes, s = seconds.

Dangling Object AV Cleanup Agent

This agent is similar to the Garbage Collection agent. This agent cleans up dangling 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 following information must be included in the server configuration file to run the Dangling Object AV Cleanup agent:

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs.management. servers.DanglingObjectAV Cleanup Agent`	The agent class.	Do not modify.
`IFS.SERVER.TIMER.InitialTimeOfDay`	`00:45:00`	The first timer event.	Set time based on a 24 hour clock.
`IFS.SERVER.TIMER.ActivationPeriod`	`24`h	Time interval to when the agent runs again.	h=hours, m=minutes, s=seconds
`IFS.SERVER.AGENTS.DANGLING OBJECTAVCLEANUPAGENT.ExcludedAttributeList`	`AUDITENTRY` `PUBLICOBJECT:OWNER` `PUBLICOBJECT:DELETOR` `PUBLICOBJECT:LASTMODIFIER` `VERSIONSERIES:RESERVOR`	A list of attributes for which invalid references to Library Objects are not cleaned up.	Modify as needed.

Event Exchanger Agent

This agent periodically purges expired events from the event queue. The following information must be included in the server configuration file to run the Event Exchanger agent:

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs.management. servers.EventExchanger Agent`	The agent class.	Do not modify.
`IFS.SERVER.TIMER.InitialDelay`	`30m`	The initial delay when the agent will first run; this allows the agents' first trigger to be staggered.	h = hours, m = minutes, s = seconds
`IFS.SERVER.TIMER.ActivationPeriod`	`20s`	The time interval between the agent's subsequent runs.	h = hours, m = minutes, s = seconds
`IFS.SERVER.EventLifespan`	`1800`	The time, in seconds, after which an event is assumed to have been delivered and become eligible for purging.	Unit of measure is seconds.

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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs.management. servers.ExpirationAgent`	The agent class.	Do not modify.
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.TIMER.InitialTimeOfDay`	`02:00:00`	First event.	Set time based on a 24 hour clock.
`IFS.SERVER.TIMER.ActivationPeriod`	`24`h	Defines the time interval between when the agent will be triggered.	h = hours, m = minutes, s = seconds.

FolderIndexAnalyzerAgent

Oracle 9iFS 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.

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. management.server.FolderIndex AnalyzerAgent`	The agent class.
`IFS.SERVER.TIMER.InitialDelay`	`30m`	The initial delay when the agent is first run.
`IFS.SERVER.TIMER.Activation Period`	`1h`	Frequency of agent activation.
`IFS.SERVER.SESSION.User`	`system`	Username for agent sessions.
`IFS.SERVER.AGENTS. FOLDERINDEXANALYZER AGENT.MaxParentsThreshold`	`10`	The threshold for max number of parents after which FIS is considered suboptimal.	ANDed with the MaxChildren Threshold.
`IFS.SERVER.AGENTS. FOLDERINDEXANALYZER AGENT.MaxChildrenThreshold`	`10`	The threshold for max number of children, after which FIS is considered suboptimal.	This condition is ANDed with the MaxParentsThreshold.

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:

IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementOwner
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementCreator
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementModifier
IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementDeletor

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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs.management.servers.Garbage CollectionAgent`	The agent class.	Do not modify.
`IFS.SERVER.TIMER.TimeOfDay`	`02:30:00`	First timer event occurs here.	Set time based on 24-hour clock.
`IFS.SERVER.TIMER.ActivationPeriod`	`1h`	The time interval between the agent's subsequent runs.	h = hours, m = minutes, s = seconds
`IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementOwner`	`system`	User to be replaced as owner.	Modify as needed.
`IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementDeletor`	`system`	User to be replaced as deletor.	Modify as needed.
`IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementCreator`	`system`	User to be replaced as creator.	Modify as needed.
`IFS.SERVER.AGENT.GARBAGECOLLECTIONAGENT.ReplacementModifier`	`system`	User to be replaced as modifier.	Modify as needed.

interMedia Annotator Agent

interMediaAnnotatorAgent extracts metadata from multimedia content and creates categories to store that metadata. It can also add a text column, which is indexed by Oracle Text, to a document's Media if that Media is an instance of MediaTextBlob.

Parameter	Default Entry	Description
`IFS.SERVER.Class`	`oracle.ifs.management.servers. InterMediaAnnotatorAgent`	The agent class.
`IFS.SERVER.SESSION.User`	`system`	The username for agent sessions.
`IFS.SERVER.AGENT.INTERMEDIAANNOTATORAGENT.ANNOTATOR.TraceLevel`	`1` Following is a list of valid values for trace level: 0 = status, 1 = terse, 2 = verbose, 3 = trace.	Trace level of the annotator.
`IFS.SERVER.AGENT.INTERMEDIAANNOTATORAGENT.IndexAttributes`	`MEDIA_TITLE, MEDIA_DESCRIPTION, MEDIA_INFORMATION, MEDIA_USER_DATA, AUDIO_ARTIST, AUDIO_CD_ARTIST, AUDIO_CD_TRACK_ALBUM, MOVIE_DIRECTOR, MOVIE_CAST`	Attributes listed here will have their values indexed by Oracle Text.
`IFS.SERVER.AGENT.INTERMEDIAANNOTATORAGENT.ClassMap`	default=`INTERMEDIASOURCE,` MovieAnn=`INTERMEDIAMOVIE,` VideoAnn=`INTERMEDIAVIDEO,` AudioAnn=`INTERMEDIAAUDIO`	Maps an annotation type with an Oracle 9iFS category class. Format is <annotation_type>=<iFS_category_classname>. Make sure there are no spaces surrounding the "=."

Outbox Agent

The Outbox Agent provides a mechanism to deliver Oracle 9iFS e-mail created programmatically. Oracle 9iFS applications creating e-mails will place the messages in the system outbox (/ifs/outbox). The Outbox agent is notified every time an event is received indicating the insertion of an e-mail into the outbox folder. The agent sends the e-mail to the mail transfer agent (Sendmail) via SMTP.

Note:

This agent is only required for custom e-mail applications.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`admin`	The user that is used to authenticate to the repository.	Do not change.
`IFS.SERVER.Class`	`oracle.ifs.protocols. email.outbox.Outbox Agent`	The agent class path.	Do not modify.
`IFS.SERVER.SESSION.ApplicationName`	`Outbox Agent`	The name that is displayed to the user in some of the management GUIs.	Do not change.
`IFS.SERVER.TRACING.DefaultTraceLevel`	`1`	This parameter controls the trace level of some internal Oracle 9iFS tracing.	Change as needed.
`IFS.SERVER.TIMER.ActivationPeriod`	`1m`	Frequency to trigger a time event.	Timer events are no longer used.
`IFS.SERVER.TIMER.InitialDelay`	`1`m	Delay from startup to the initial timer event.	Timer events are no longer used.
`OutboxPath`	`/ifs/outbox`	Full path to the outbox.	Do not change.
`ExpireDelay`	`40`	Seconds until outgoing e-mail is bounced.	Change as needed.
`LogLevel`	`10`	Controls the verbosity of the log.

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 9iFS.

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:

The Quota agent has not been started or running.
The user's quota has not been enabled.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs.management.servers.QuotaAgent`	The agent class.	Do not modify.
`IFS.SERVER.TIMER.Activation Period`	`15`m	The time interval to when the agent will run again.	h=hours, m=minutes, s=seconds

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.

Parameter	Default Entry	Description
`IFS.SERVER.Class`	`oracle.ifs. management. servers.Service WarmupAgent`	The Agent class.
`IFS.SERVER.SESSION.User`	`system`	The username for agent sessions.
`IFS.SERVER.AGENT.SERVICEWARMUP.WarmupSetAdmin`	`true`	If the warmup is done in administration mode.
`IFS.SERVER.AGENT.SERVICEWARMUP.WarmupUsers`	`true`	If set to true, warms up user collection.
`IFS.SERVER.AGENT.SERVICEWARMUP.WarmupAcls`	`true`	If set to true, warms up ACL collection.
`IFS.SERVER.AGENT.SERVICEWARMUP.WarmupFormats`	`true`	If set to true, warms up format collection.
`IFS.SERVER.AGENT.SERVICEWARMUP.WarmupMedias`	`true`	If set to true, warms up Media collection.

Service Watchdog Agent

ServiceWatchdogAgent cleans up after the Oracle 9iFS 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.

Parameter	Default Entry	Description	Comments
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.
`IFS.SERVER.Class`	`oracle.ifs. management.servers. ServiceWatchdog Agent`	The agent class.	Do not modify.
`Start`	`true`	Specifies if the agent automatically starts up when the Server Manager starts up.	true= automatic start, false=manual
`IFS.SERVER.TIMER.ActivationPeriod`	`2m`	The time interval to when the agent will run again.	h = hours, m = minutes, s = seconds
`IFS.SERVER.AGENT.SERVICEWATCHDOGAGENT.ServiceTimeoutPeriod`	`120`	The time before the Server Manager will kill an unresponsive protocol server.	Unit of measure is seconds.

AppleTalk Filing Protocol (AFP) Server

The AFP server enables Macintosh users to browse, edit, and store files in Oracle 9iFS.

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.afp.AfpServer`	The server class.	Do not modify.
`IFS.SERVER.SESSION.User`	`system`	Username for server session.	Must be an admin user.
`IFS.SERVER.PROTOCOL.AFP.Local BindAddress`	`server IP address` (or DNS name)	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.
`IFS.SERVER.PROTOCOL.AFP.Accept GuestConnections`	`true`	Whether or not to allow guest connections without authentication.	true = allows guests to connect without authentication false = requires authentication as a valid user
`IFS.SERVER.PROTOCOL.AFP.Max OpenFiles`	`1024`	The 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.
`IFS.SERVER.PROTOCOL.AFP. DisableFolderIcons`	`true`	Whether or not to disable custom Macintosh folder icons.	true = custom folder icons are disabled false = custom folder icons are enabled Custom folder icons are disabled by default because it improves file browsing performance.
`IFS.SERVER.PROTOCOL.AFP. DisablePkgInfo`	`true`	Whether or not to "vanish" the special Macintosh "contents/ PkgInfo" file.	true = vanish all PkgInfo files false = do not vanish PkgInfo files The PkgInfo files are vanished by default because it greatly improves file browsing performance
`IFS.SERVER.PROTOCOL.AFP. Encoding`	`"MacRoman"`	The character encoding used to represent file and directory names for Macintosh clients. The default works for most European languages. Other languages may require a different character set.	If Macintosh clients are configured to use the Chinsee language, they may be configured to use the "Big5" character set. For file and directory names to be stored correctly in Oracle 9iFS, this AFP server parameter should be set to "Big5."

AfpGarbageCollection Agent

The AFP server creates additional objects and attaches them to every folder and document in the Oracle 9iFS 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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.afp. agent.AfpGarbage CollectionAgent`	The agent class.	Do not modify.
`IFS.SERVER.SESSION.User`	`system`	Username for agent session.	Must be an admin user.
`IFS.SERVER.TIMER.InitialTimeOfDay`	`01:30:00`	First event.	Set time based on a 24 hour clock.
`IFS.SERVER.TIMER.Activation Period`	`24`h	Defines the time interval between when the agent will be triggered.	h = hours, m = minutes s = seconds

Command Line Utilities Protocol (CUP) Server

The CUP server responds to the requests from the Oracle 9iFS command line utilities, a set of low-level development tools. Since the command line utilities allow direct access to the objects and their attributes, the user must be familiar with the Oracle 9iFS class hierarchy to manipulate the objects. The utilities target users with deeper knowledge and understanding of the Oracle 9iFS objects and their relationships with one another. It is not meant to be an end-user tool.

Note:

Logging into Oracle 9iFS through the Command Line Utilities allows any other users on the same machine to access Oracle 9iFS through that login without logging on themselves. To avoid this problem, use the ifsshell command on machines shared by multiple users.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.cup. server. Commandline UtilityServer`	Java class for the server.
`IFS.SERVER.SESSION.User`	`system`	Name of the admin user.
`IFS.SERVER.SESSION.LOCALE.Language`	`en`	Default language for CUP sessions.
`IFS.SERVER.SESSION.LOCALE.Country`	`US`	Default country to be used in session localizer.
`IFS.SERVER.SESSION.LOCALE.Variant`		Vendor-specific variant parameter used in java.util.Locale.
`IFS.PROTOCOLSERVER.Anonymous Username`	`guest`	Name of the iFS user used for anonymous sessions.
`IFS.PROTOCOLSERVER.Localhost`		Optionally, specify the host name if the host is multi-homed in the network.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.AnonymousAllowed`	`true`	If set to true, allows anonymous connections.
`IFS.PROTOCOLSERVER.SessionState TimeoutPeriod`	`900000`	Session state is valid only for time in milliseconds as specified.	Commandline commands will lose state if run after this amount of time.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.DateFormat`	`MMM dd HH:mm`	Specifies the default date format.
`IFS.PROTOCOLSERVER.AnonymousPool Size`	`2`	Initial pool size for anonymous connections.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.Timeout`	`900000`	Amount of time between activity before socket times out; default is 900 seconds or 15 minutes.	Unit of measure is milliseconds.
`IFS.PROTOCOLSERVER.SessionState TimeoutPeriod`	`900000`	Amount of time between activity before the session times out; default is 900 seconds or 15 minutes.	Unit of measure is milliseconds.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.Delimiter`	`/`	Specifies the Folder Path Delimiter.
`IFS.PROTOCOLSERVER.Port`	`4180`	The port on which the server is running.
`IFS.PROTOCOLSERVER.AcceptQueueSize`	`50`	The number of server requests back-logged before denying requests.	Do not modify.

File Transfer Protocol (FTP) Server

The FTP server allows users to easily transfer files between one file system and the Oracle 9iFS 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 9iFS server also has built-in parsing and versioning support.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.ftp. server. FtpServer`	Java class for the server.
`IFS.SERVER.SESSION.User`	`system`	Name of the admin user.
`IFS.SERVER.SESSION.LOCALE.Language`	`en`	Default language for FTP sessions.
`IFS.SERVER.SESSION.LOCALE.Country`	`US`	Default country to be used in session localizer.
`IFS.SERVER.SESSION.LOCALE.Variant`		Vendor-specific variant parameter used in java.util.Locale.
`IFS.PROTCOLSERVER.Anonymous Username`	`guest`	Name of the iFS user used for anonymous sessions.
`IFS.PROTOCOLSERVER.Localhost`		Optionally, specify the host name if the host is multi-homed in the network.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.AnonymousAllowed`	`true`	If set to true, allows anonymous connections.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.DateFormat`	`MMM dd HH:mm`	Specifies the default date format.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.Timeout`	`900000`	Amount of time between activity before the connection times out; default is 900 seconds or 15 minutes.	Unit of measure is milliseconds.
`IFS.PROTOCOLSERVER.SESSION.DEFAULT.Delimiter`	`/`	Specifies the Folder Path Delimiter.
`IFS.PROTOCOLSERVER.Port`	`21` (Windows NT), `2100` (Unix)	The port on which the server is running.
`IFS.PROTOCOLSERVER.AcceptQueueSize`	`50`	The number of server requests back-logged before denying requests.	Do not modify.
`IFS.PROTOCOLSERVER.AnonymousPool Size`	`2`	Initial pool size for anonymous connections.

Internet Mail Access Protocol (IMAP) Server

This is an implementation of Internet Mail Access Protocol. This provides a mechanism for mail clients to access mail from Oracle 9iFS accounts.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.PROTOCOL.IMAP.SSLEnabled = true \| False`	`false`	Set it to true to enable SSL, and false to disable it.
`SSLPortNum`	`993`	Sets SSL port umber.
`IFS.SERVER.PROTOCOL.IMAP.SSL AuthenticationMode`	Default is `ServerOnly`	Set it to `ServerOnly` to authenticate IMAP server the clients. Set it to `ServerClient` to have server and clients authenticate to each other. Set it to `Anonymous` to disable authentication between server and client, thus using the SLL encryption feature by itself.	This is the mode used by the popular clients Netscape, Microsoft Outlook, and Outlook Express.
`IFS.SERVER.PROTOCOL.IMAP.SSLVersion`	`Any`	Set SSL Version. Set to `Any` to support both SSL Version 2.0 and Version 3.0. Set to `3.0` if you want to support only SSL Version 3.0.
`IFS.SERVER.PROTOCOL.IMAP.SSL CipherSuite`	Default is all Ciphers that are supported by Oracle Java SSL.	List of Ciphers, separated by a whitespace. Possible values are: SSL_RSA_WITH_3DES_EDE_CBC_SHA SSL_RSA_WITH_RC4_128_SHA SSL_RSA_WITH_RC4_128_MD5 SSL_DH_anon_WITH_3DES_EDE_CBC_SHA SSL_DH_anon_WITH_RC4_128_MD5 SSL_DH_anon_WITH_DES_CBC_SHA SSL_RSA_WITH_DES_CBC_SHA SSL_RSA_EXPORT_WITH_RC4_40_MD5 SSL_RSA_EXPORT_WITH_DES40_CBC_SHA SSL_DH_anon_EXPORT_WITH_RC4_40_MD5 SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA SSL_RSA_WITH_NULL_SHA SSL_RSA_WITH_ NULL_MD5
`IFS.SERVER.PROTOCOL.IMAP.SSLWallet Path`	No default.	Path to Wallet file.
`IFS.SERVER.PROTOCOL.IMAP.SSLWallet Pwd`	No default.	Password for the Oracle Wallet file.

NbServer

The NbServer is a DNS server for Windows NetBIOS names. It tells client machines that its name is registered to a particular IP address. The following parameters must be included in the server configuration file to run the Nb server.

Parameter	Default Entry	Description
`IFS.SERVER.Class`	`oracle.ifs.protocols.smb.server.NbServer`	Java class for the server.
`IFS.SERVER.SESSION.User`	`system`	Name of the admin user.
`IFS.SERVER.NB.Workgroup`	`"WORKGROUP"`	Name of the workgroup this server is in.
`IFS.SERVER.NB.ServerComment`	`"Oracle Internet File Server"`	This holds the SMB server description that shows up in properties in windows.
`IFS.SERVER.NB.IpAddr`	`<IP Address returned by Socket.getInetAddress()`	If host is multi-homed, use this to choose the IP address if necessary.
`IFS.SERVER.NB.Netmask`	`255.255.252.0`	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.
`IFS.SERVER.NB.Broadcast`	`<Derived from the IP address and netmask>`	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".
`IFS.SERVER.NB.Status Interval`	`100`	Number of packets between each status message to trace file.
`IFS.SERVER.NB.Host Announcer`	`true`	Enable Host Announcement.

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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.PROTOCOL. NFS.Localhost`	`Null`	`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.`
`IFS.SERVER.PROTOCOL. NFS.PortmapUdpServers`	`1`	`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.`
`IFS.SERVER.PROTOCOL. NFS.PortmapTcpEnabled`	`true`	`specifies whether or not the Portmap server will accept TCP connections in addition to UDP connections.`
`IFS.SERVER.PROTOCOL. NFS.MountUdpServers`	`1`	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.
`IFS.SERVER.PROTOCOL. NFS.MountTcpEnabled`	`true`	Specifies whether or not the Mount server will accept TCP connections in addition to UDP connections.
`IFS.SERVER.PROTOCOL. NFS.MountPort`	`4048` for Unix; `0` for NT	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.
`IFS.SERVER.PROTOCOL. NFS.UdpServers`	`16`	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.
`IFS.SERVER.PROTOCOL. NFS.TcpEnabled`	`true`	Specifies whether or not the NFS server will accept TCP connections in addition to UDP connections.
`IFS.SERVER.PROTOCOL. NFS.Port`	`4049` for Unix; `2049` for NT	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.
`IFS.SERVER.PROTOCOL. NFS.CharacterEncoding`	Null	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.
`IFS.SERVER.PROTOCOL. NFS.UserCacheMax`	`16`	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.
`IFS.SERVER.PROTOCOL. NFS.IoBufferSize`	`32768`	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.
`IFS.SERVER.PROTOCOL. NFS.IoBufferCache TargetSize`	`8`	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.
`IFS.SERVER.PROTOCOL. NFS.ContentCacheFlush`	`2000`	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.
`IFS.SERVER.PROTOCOL. NFS.ContentCacheKeep`	`10000`	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.
`IFS.SERVER.PROTOCOL. NFS.ContentCacheMax`	`8`	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.
`IFS.SERVER.PROTOCOL. NFS.RpcRequestCache BufferSize`	`65535`	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.
`IFS.SERVER.PROTOCOL. NFS.RpcRequestCacheMax`	`64`	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.
`IFS.SERVER.PROTOCOL. NFS.RpcRequestCacheMaxReplyLen`	`16384`	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.
`IFS.SERVER.PROTOCOL. NFS.SafeWriteMode`	`false`	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.
`IFS.SERVER.PROTOCOL. NFS.SafeWriteLogs`	`nfs/RecoveryLogs`	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 9iFS was installed.
`IFS.SERVER.PROTOCOL. NFS.SafeWrite ActivationPeriod`	`20`	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.

Simple Mail Transfer Protocol (SMTP) Server

This is a base implementation of the Simple Mail Transfer Protocol. Oracle 9iFS uses Sendmail Pro 8.9.3 as the mail transfer agent. The SMTP server is used as the mail delivery agent for Oracle 9iFS. Sendmail connects to the SMTP server via the SMTP protocol and uses it to check if inboxes for e-mail recipients exist in Oracle 9iFS and to deliver mail to those inboxes.

The Oracle 9iFS SMTP server is not designed to be used as a Mail Transport Agent. Therefore, Oracle 9iFS depend upon sendmail to act as the Mail Transport Agent. Sendmail listens on port 25 and then sends mail intended for Oracle 9iFS to the Oracle 9iFS SMTP server.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.email.smtp.SmtpServer`	The name of the server properties file.	Do not change.
`IFS.SERVER.SESSION.User`	`admin`	The user that is used to authenticate to the repository.	Do not change.
`IFS.SERVER.TRACING.Default TraceLevel`	`1`	Controls the trace level of some internal tracing.	Change as needed.
`port`	`2500`	The port on which the server is running.	This port number is also used in sendmail.cf which does not pick it up from this file. Change only if you really need to and know what you're doing.
`SessionCount`	`5`	The number of SMTP sessions available for connections.	Tunable parameter.
`LogLevel`	`10`	Controls the verbosity of the log.	10 is the maximum value.

Server Message Block (SMB) Protocol Server

The SMB server allows Windows users to easily copy files between their local drives and the Oracle 9iFS repository. It also allows users to browse and edit files and even execute programs directly from the Oracle 9iFS repository. SMB is best suited for interactive browsing and modifying documents.

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.smb. server.SmbServer`	Java class for the server.
`IFS.SERVER.SESSION.User`	`system`	Name of the admin user.
`IFS.SERVER.SMB.Server Comment`	`"Oracle Internet File Server"`	Holds the SMB server description that shows up in the Windows Properties window.
`IFS.SERVER.SMB.PrimeServer`	`true`	Primes the server with a simple login.
`IFS.SERVER.SMB.EnableOp locks`	`true`	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.
`IFS.SERVER.SMB.MaxOplocks`	`8`	Maximum number of op locks per mount point.	See Microsoft documentation for information about OpLocks.
`IFS.SERVER.SMB.KeepStats`	`true`	If true, keeps statistics on various server operations.
`IFS.SERVER.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.SMB.Share MyHome`	`true`	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.
`IFS.SERVER.SMB.Workgroup`	`WORKGROUP`	Windows workgroup.	This determines the workgroup where the SMB server will appear in the Network Neighborhood.
`IFS.SERVER.SMB.Port`	`139`	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.
`IFS.SERVER.SMB.AllowGuest IfNot User`	`true`	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.
`IFS.SERVER.SMB.MaxOpen Files`	`30`	The maximum number of files a user can have open on a single mountpoint.
`IFS.SERVER.SMB.MaxAll OpenFiles`	`100`	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.
`IFS.SERVER.SMB.Enable Parsing`	`true`	Enables the parsing feature when saving Oracle 9iFS files.	true = enables parsing. false = disables parsing.
`IFS.SERVER.SMB.Enable Rendering`	`true`	Enables the rendering feature when reading Oracle Internet File System files.	true = enables rendering. false = disables rendering.
`IFS.SERVER.SMB.Session Timeout`	`43200000` (12 hours)	The server will disconnect idle sessions after this timeout.	Unit of measure is in milliseconds.
`IFS.SERVER.SMB.IpAddress`	server IP address	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.

Windows Client Protocol (WCP) Server

The Windows Client Protocol (WCP) is the main protocol used by the Oracle 9iFS Windows Utilities on Windows 95, Windows 98, Windows NT 4.0, and Windows 2000. You can start more than one WCP server against the same Oracle 9iFS repository. By starting multiple instances of the WCP server, the load balancing feature improves performance and scalability. Also, the automatic failover feature insures high availability of the WCP server.

The WCP port assignment is different from other protocols used by Oracle 9iFS because it does not run on any designated port. Each time it is started, the WCP finds an open port on the machine on which it is running. Exactly one WCP server should run in a system.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.Class`	`oracle.ifs. protocols.wcp. server.WcpServer`	The fully qualified classname of the server.	Required.
`IFS.SERVER.SESSION.User`	`system`	The user for the default session.	Required if the default session is used.
`IFS.SERVER.SESSION.ApplicationName`	`WcpServer`	The ConnectOptions application name for the default session.	Optional. If not specified, defaults to the server name.
`IFS.SERVER.SESSION.LOCALE.Language`	`en`	The ConnectOptions locale for the default session.	Optional. If not specified, no locale is set in the ConnectOptions.
`IFS.SERVER.SESSION.LOCALE.Country`	`US`	The ConnectOptions locale for the default session.	Optional. If not specified, no locale is set in the ConnectOptions.
`IFS.SERVER.SESSION.LOCALE.Variant`		The ConnectOptions locale for the default session.	Optional. If not specified, no locale is set in the ConnectOptions.
`IFS.SERVER.TIMER.ActivationPeriod`	`1`m	The frequency of timer events.	Required if the timer is used. Examples: 2500 (every 2.5 seconds), 5s (every 5 seconds), 10m (every 10 minutes), 2h (every 2 hours).
`IFS.SERVER.TIMER.InitialDelay`	`5`s	The delay before the first timer event.	Optional. If no values are specified for both this and IFS>TIMER. InitialTimeOfDay, defaults to the value of IFS.SERVER. TIMER. ActivationPeriod
`IFS.SERVER.TIMER.InitialTimeOfDay`	`22:30:00`	The time of day of the first timer event.	Optional. Overrides any value specified for IFS.SERVER. TIMER.Initial Delay.
`IFS.SERVER.TIMER.HourSuffix`	`H`	Time unit suffix.	Optional. If not specified, defaults to the values shown.
`IFS.SERVER.TIMER.MinuteSuffix`	`M`	Time unit suffix.	Optional. If not specified, defaults to the values shown.
`IFS.SERVER.TIMER.SecondSuffix`	`S`	Time unit suffix.	Optional. If not specified, defaults to the values shown.
`IFS.SERVER.TIMER.TimeFormat`	`HH:mm:ss`	Time format.	Optional. If not specified, defaults to the values shown.
`IFS.SERVER.PROTOCOL.WCP.ServerName`	`WcpServer`	Server name for identification in a multiple-WCP server environment.	Name must be unique repository-wide.
`IFS.SERVER.PROTOCOL.WCP.WinUI FullPath`	`/ifs/winui/ install/setup.exe`	Location of the Windows Utilities installation package on this server for automatic update.	Dynamic. Changes on the fly to reflect that you have a new version available in the repository.
`IFS.SERVER.PROTOCOL.WCP.Available ClientVersion`	`1.2.0.0.0`	Version of Windows Utilities available for automatic update.	Dynamic. Changes on the fly to reflect that you have a new version available in the repository. Defaults to the same as WCP server version.
`IFS.SERVER.PROTOCOL.WCP.LogMemory. Usage`	`true`	Flag to log memory usage.	Used in session pool creation and deletion. Dynamic. Can change while server is running.
`IFS.SERVER.PROTOCOL.WCP.Session PoolSize`	`2`	Number of sessions sharing a single socket.
`IFS.SERVER.PROTOCOL.WCP.Accept QueueSize`	`50`	Maximum queue length for incoming request to set up connection with WCP server socket.
`IFS.SERVER.PROTOCOL.WCP.IpAddress`		WCP server IP address.	By default, will used IP address assigned to your machine. If your machine has more than one IP address, use this to specify the IP address on which the WCP server should run.
`IFS.SERVER.PROTOCOL.WCP.WcpServer SocketTimeout`	`0`	WCP server socket time-out value	Time, in seconds. 0 = no time-out.

Windows NT File System Protocol Server (for Windows NT Only)

The NT File System Protocol Server (NTFS) allows the Oracle 9iFS repository to appear as a local hard drive on the server machine. When using the NTFS, the Oracle 9iFS 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.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.PROTOCOL.NTFS.Drive Letter`	`o`	The drive letter used to map the Oracle 9iFS drive.	An available and valid drive letter (a-z).
`IFS.SERVER.PROTOCOL.NTFS.LogLevel`	`1`	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.
`IFS.SERVER.PROTOCOL.NTFS.LogStack Trace`	`false`	Specifies if the Java stack trace is listed in the log file.	true = list Java stack trace. false = do not list Java stack trace.
`IFS.SERVER.PROTOCOL.NTFS.Session Cache`	`40`	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.
`IFS.SERVER.PROTOCOL.NTFS.ifsproxy`	`lib\ ifsproxy. dll`	Specifies the location of the ifsproxy.dll library.	The path specified in relative to the iFS home directory where Oracle 9iFS was installed.

DavServerConfigurations

Through WebFolders (WebDAV) and WebFolders-enable applications, customers can edit Microsoft Office documents stored in Oracle 9iFS in place with Windows Office 2000. A new document can be created in Oracle 9iFS this way. Customers can then delete this document in a web folder.

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

Parameter	Default Entry	Description	Comments
`IFS.SERVER.PROTOCOL.DAV.GuestPool. Size.Min`	`1`	The minimum size of the anonymous session pool.	This is allocated immediately upon startup.
`IFS.SERVER.PROTOCOL.DAV.GuestPool. Size.Target`	`5`	The target size of the anonymous session pool.	This is allocated immediately if the target size is not sufficient to service traffic volume.
`IFS.SERVER.PROTOCOL.DAV.GuestPool. Size.Max`	`10`	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.
`IFS.SERVER.PROTOCOL.DAV.GuestPool. Timeout.Target`	`500`	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.
`IFS.SERVER.PROTOCOL.DAV.GuestPool. Timeout.Max`	`1500`	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.
`IFS.SERVER.PROTOCOL.DAV.LoginBean Name`	`IfsHttpLogin`	The name by which the IfsHttpLogin bean is bound to the HttpSession.
`IFS.SERVER.PROTOCOL.DAV.DAV.Browse. Enabled`	`True`	Is directory browsing enabled?
`IFS.SERVER.PROTOCOL.DAV.Welcome +`	`index.html`	The welcome files, in the order they will be searched.
`IFS.SERVER.PROTOCOL.DAV.Rendering. Enabled`	`False`	Is rendering enabled?	Set to True to enable rendering.
`IFS.SERVER.PROTOCOL.DAV.Parsing. Enabled`	`True`	Is parsing enabled for WebFolders?	Set to True to enable parsing.
`IFS.SERVER.PROTOCOL.DAV.Webfolders. DefaultCharset`	iFS service-wide default charset	The charset the server should use if the client connecting is MS Web Folders.
`IFS.SERVER.PROTOCOL.DAV.Context ServletPath`	`<null>`	The context/servlet path to which the IfsDavServlet is bound. If left unset, this will be computed automatically.
`IFS.SERVER.PROTOCOL.DAV.IfsServer. Auth.Cleartext.Accept`	`True`	Should HTTP Basic authentication credentials be accepted?	Set to True to accept basic authentication credentials.
`IFS.SERVER.PROTOCOL.DAV.IfsServer. Auth.Cleartext.PreventNetscape`	`False`	Should Netscape clients be prompted to authenticate?	Netscape always uses cleartext credentials, which is a security risk.
`IFS.SERVER.PROTOCOL.DAV.IfsServer. Auth.TokenCredential.Timeout`	`864000`	When the DavServer generates a TokenCredential, how long should it be good for.
`IFS.SERVER.PROTOCOL.DAV.Jsp.Enabled`	`True`	Is JSP execution enabled?
`IFS.SERVER.PROTOCOL.DAV.Jsp.Allowed Dirs +`	`/ifs/webui/jsps` `/ifs/jsp- bin`	The directories in which JSPs are allowed to be executed. (Includes the directory and all of its subdirectories).
`IFS.SERVER.PROTOCOL.DAV.Jsp.Lookup. BundleName`	`JspLookup`	The name of the property bundle in the iFS repository containing the JspLookup mappings.
`IFS.SERVER.PROTOCOL.DAV.Jsp.Lookup. ParameterName`	`path`	The parameter name the IfsDavServlet will use for the original request URL when redirecting to a JSP via the JspLookup mechanism.
`IFS.SERVER.PROTOCOL.DAV.WEBUI.PortalUrl`	`<"">`	Represents the Portal URL. Its value is to be set by the administrator who installs Oracle 9iFS and knows the Portal URL. The value can be set by accessing the property through the Oracle Enterprise Manager Console or HTML-based EMD framework.	Note: This URL is used in the Web interface to provide a link to go back from the HTML pages to the Portal page.

C Server Configuration Objects