|Oracle Internet File System Installation Guide
Release 9.0.1 for Sun SPARC Solaris
Part Number A80901-06
To install, configure, and administer Oracle Internet File System (Oracle 9iFS), administrators must understand key administration concepts, including:
The basic administrative unit of Oracle Internet File System (Oracle 9iFS) is the domain. A domain is a single Oracle 9iFS instance. Oracle 9iFS domains consist of several elements, such as nodes, running either on a single computer or spread across a set of interconnected computers.
The principal elements of an Oracle 9iFS domain are:
The repository, nodes, and domain controller comprise the logical elements of an Oracle 9iFS domain. However, a domain's physical configuration may be quite different than its logical configuration. There is no requirement that any element of the domain be on the same host as any other, or that any of element be on a different host than another. For small installations, the repository, nodes, and domain controller may all reside on a single host (Figure 1-1, "A Simple Oracle 9iFS Domain"). Larger installations may use separate hosts for each element (Figure 1-2, "A More Complex Oracle 9iFS Domain"). (In Figures 1-1 and 1-2, dotted lines represent host boundaries.)
Determining the logical and physical configurations of the Oracle 9iFS domain based on proposed use and expected load is a pre-installation step. You can change the domain's logical and physical configurations over time in response to changing requirements.
Each Oracle 9iFS node can have one or more services and one or more servers (Figure 1-3, "Services and Servers").
Domain controllers and nodes are identified by locators. A locator is a Uniform Resource Locator (URL) that specifies the host on which the domain controller or node is running and its port number.
For example, the locator of the domain controller in Figure 1-2, "A More Complex Oracle 9iFS Domain" might be:
Each node has a node guardian that monitors the node, detects error conditions, and attempts to recover from them. For unguarded nodes, the guardian runs in the node's process, whereas for guarded nodes, the node guardian runs in a separate process. Guarded nodes offer better fault recovery because the guardian can terminate and restart the node's process if necessary.
Nodes are guarded by default.
Oracle 9iFS provides HTTP and WebDAV support using a Java servlet running in the Oracle HTTP Server. By default, this servlet is loaded when Oracle HTTP Server is started. Once loaded, the servlet creates a node (the "HTTP node") in the Java VM of the servlet. The HTTP node has an Oracle 9iFS service which manages user sessions and provides access to the domain's repository, and an Oracle 9iFS server which provides HTTP and WebDAV protocol support.
Because its process is owned by the Oracle HTTP Server, an HTTP node is always unguarded.
The configurations of a domain's nodes are stored as objects in the Oracle 9iFS repository. Three types of objects are used to manage this information.
A service configuration is a template for creating a service on a generic node. Each service configuration specifies values for properties such as the database instance and schema name of the repository, the sizes of the cache and database connection pools, the maximum number of sessions, and the service's default language and character set. (See Appendix B of the Oracle 9iFS Setup and Administration Guide for a complete list of service configuration parameters.) Service configurations are uniquely named across the domain.
When Oracle 9iFS is installed, three service configurations are automatically created, corresponding to "small," "medium," and "large" services. You can edit these three configurations or create additional service configurations (see Figure 1-4, "Parameters for a Medium 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.
When Oracle 9iFS is installed, server configurations are automatically created for each protocol server and agent. Server configurations are uniquely named across the domain. Figure 1-5, "Configuration Parameters of Command Line Utilities Server" shows the default configuration parameters for the Command Line Utilities.
On the General property sheet (see Figure 1-6, "Configuration of an Oracle 9iFS Node"), the following information appears:
The Content property sheet (see Figure 1-7, "A Node's Services and Servers") displays information about the node's services and servers, including:
A full range of administration tools are provided with Oracle 9iFS to manage the repository, start and stop Oracle 9iFS domains and nodes, configure nodes in the Oracle 9iFS domain, manage users and document security, work from the command line, and import/export data and users from one Oracle 9iFS schema to another.
Oracle 9iFS is tightly integrated with Oracle9i Enterprise Manager to facilitate enterprise system management.
Oracle 9iFS Manager is the administrative interface for Oracle 9iFS. Oracle 9iFS Manager is integrated with Oracle Enterprise Manager and can be launched in an Oracle Management Server (OMS)-connected mode or in a standalone mode.
Oracle 9iFS Manager provides a powerful and easy-to-use graphical interface, and is divided between administrative tasks and developmental tasks (see Figure 1-9, "Oracle 9iFS Manager").
The Oracle 9iFS Configuration Assistant is a wizard that is started automatically by the Oracle Universal Installer during installation to specify Oracle 9iFS configuration parameters. For installation information, see "Run the Configuration Assistant" in Chapter 3, "Installing the Oracle 9iFS Software". For information on changing parameters, see Chapter 4, "Service and Server Configuration" in the Oracle Internet File System Setup and Administration Guide.
Though limited in its administrative functionality, the Web interface (see Figure 1-11, "The Web Interface") is the easiest tool to use and best suited for creating users and groups one-by-one. You must have administrative privileges to use these functions in the Web interface. For more information, click the Help icon on the Web interface.
The Command Line Utilities are an interface for administrators familiar with using the command line. These commands are best used for browsing the Oracle 9iFS objects in the repository and for performing scripted tasks. For example:
Stores the specified local file in Oracle Internet File System. If
iFSfile is not specified, the file is stored in the current Oracle Internet File System directory. If
iFSfile exists, the file is updated according to the versioning semantics.
ifsput <localfile> [<iFSfile>]
Stores the local file in the current Oracle Internet File System directory as
sample2.html with the local file,
sample.html, following versioning semantics.
For more information on using the Command Line Utilities, see Appendix A, "Command Line Utilities Reference" in the Oracle Internet File System Setup and Administration Guide.
XML configuration files can be used to streamline the creation of large numbers of repository objects. For example, the following file creates an Oracle 9iFS user:
<SimpleUser> <UserName>gking</UserName> <Password>ifs</Password> <DistinguishedNameSuffix>.yourcompany.com</DistinguishedNameSuffix> <DirectoryUserDescription>Gary King</DirectoryUserDescription> <AdminEnabled>true</AdminEnabled> <HomeFolderRoot>/home</HomeFolderRoot> <EmailAddressSuffix>@yourcompany.com</EmailAddressSuffix> </SimpleUser>
Using an XML configuration file, you can configure multiple objects with a single file. If one section of the file has a problem, however, everything after it in the file does not execute. For more information on using XML files with Oracle 9iFS, see the Oracle Internet File System Developer Reference.
Also available to manage Oracle 9iFS is a set of scripts that are run at the command line. These accomplish many of the tasks included in the Oracle9i Enterprise Manager Console and the Oracle 9iFS Manager. A number of these scripts are described in Chapter 5, "Post-installation". The scripts are also listed in the Index to this guide, under "scripts," as well as in the Index of the Oracle Internet File System Setup and Administration Guide.