2
Starting Oracle iFS

To use Oracle iFS, you must start the servers and agents used by Oracle iFS. This chapter shows you how to start Oracle iFS. Topics include:

• Starting Oracle iFS

• Starting Server Manager

• Stopping Oracle iFS

• Starting the JWS

• Configuring the System for Optimal Performance

• Logging In as the Administrator for the First Time

Starting Oracle iFS

Before you can use Oracle iFS, you must first start the servers and agents used by Oracle iFS. These processes used by Oracle iFS are managed using Server Manager. This tool provides managing and monitoring capabilities for the Oracle iFS servers and agents.

To start the servers and agents, you must first start Server Manager. To do this, use a command line on the same machine where Oracle iFS is installed.

Server Manager can be run in two different ways: interactively or running in the background. Running Server Manager in the background is recommended if it will have any agents running. This avoids the possibility of mistakenly exiting out of Server Manager and shutting down all the running agents and protocol servers it was managing. An interactive Server Manager can be used to monitor any agents, protocol servers and other server managers in the system.

When Server Manager is started, the agents, if specified in the definition file, are also started. Starting all the agents and protocol servers may take a few minutes depending upon the number of agents and available hardware resources.

See Also

For an introduction to Server Manager and to learn about the various commands to use with Server Manager, see Chapter 8, "Using Server Manager to Start and Stop Servers".

Starting Server Manager

To start Server Manager, use the ifsstart command. This starts Server Manager running in the background. The ifsstart command is found in the following directory:

Platform	Directory
UNIX	$ORACLE_HOME/ifs<version>/bin
Windows NT	%ORACLE_HOME%\ifs<version>\bin

You can use the ifsstart -h command to access help.

Using ifstart on UNIX

On UNIX, you can use the ifsstart command with parameters. Use the following syntax:

ifsstart [-w] [-a] [p]

When Server Manager is started, a dialog displays where you must enter the following:

• Oracle iFS username--If nothing is entered, the default is system.

• Oracle iFS password--The username's password.

• Oracle iFS service name--The default is ServerManager.

• Oracle iFS schema password--The schema password.

The following parameters may be passed to the ifsstart command:

Parameter	Description
no parameters	Two Server Managers are started in the background and load all agents in the definition files and start all agents that have a TRUE setting for the "Start" parameter. By default, all agents including any External Server Agents for the protocols selected in the Oracle iFS configuration process are set to true. If the Java Web Server (JWS) was selected in the Oracle iFS configuration process, then it is started. The Sendmail process is also started.
-w	For UNIX only. Server Manager loads all agents in the definition file and starts all agents, including External Server Agents that have a TRUE setting for the "Start" parameter. The Sendmail process is started. JWS is not started.
-a	For UNIX only. Server Manager starts all agents that have a TRUE setting for the "Start" parameter, excluding all External Server Agents even if they have a TRUE setting. This parameter also starts the Sendmail process and the JWS if selected in the Oracle iFS configuration process.
-p	For UNIX only. Server Manager starts all External Server agents with a TRUE setting for the "Start" parameter. This flag also starts the Sendmail process and JWS if selected in the Oracle iFS configuration process.

If you choose to run Server Manager in the background, after using the ifsstart command, there is no information displayed.

Using ifsstart on Windows NT

On Windows NT, you can simply use the ifsstart command from a command prompt to start Server Manager. You must be in the %ORACLE_HOME% directory.

Using the ifssvrmgr Command

The ifssvrmgr command is used to start the default Server Manager to monitor the system or to start with a custom definition file. This starts Server Manager interactively on either UNIX or Windows NT. You can use the ifssvrmgr command with or without a definition file specified. The ifssvrmgr file is found in the following directory:

Platform	Directory
UNIX	$ORACLE_HOME/ifs<version>/bin
Windows NT	%ORACLE_HOME%\ifs<version>\bin

Use the following syntax:

ifssvrmgr [<definition_filename>]

The following parameters are passed to the ifsvrmgr command:

Parameter	Description
no parameters	Server Manager runs interactively with no agents loaded. This Server Manager can be used to monitor and manage the agents and servers in the system.
definition_filename	Server Manager runs interactively, using the specified custom definition file to load and start the agents as indicated by the "Start" parameter. This Server Manager can be used to monitor and manage the agents and servers in the system.

Note: The specification must be an aboluste or relative path and the definition file.

Stopping Oracle iFS

Use Server Manager to shut down any running agents and protocol servers it was managing. The ifsstop command will automatcially shut these processes down, and will stop the JWS and the Sendmail process, if they are running.

There are three different ways to shut down Oracle iFS servers:

• Shut down all agents and servers in the Oracle iFS system.

• Shut down all agents and servers managed by a specific Server Manager.

• Shut down specific an agent or server managed by a specific Server Manager.

Shutting Down All Agents and Servers in Oracle iFS

To shut down all agents and servers in Oracle iFS, use the ifsstop command. The ifsstop command will shut down all agents, protocol servers and Server Manager started with the ifsstart command. ifsstop will also stop JWS and the Sendmail process, if running. The ifsstop command is found in the following directory:

Platform	Directory
UNIX	$ORACLE_HOME/ifs<version>/bin
Windows NT	%ORACLE_HOME%\ifs<version>\bin

Syntax:

ifsstop

Note: You must use the ifsstop command from the %ORACLE_HOME% directory. This command returns an error if used from a Server Manager prompt.

After running the ifsstop command, you will be prompted to enter the following information:

• Java Web Server (JWS) administrator password--The password for the JWS administrator user (default is admin).

• Oracle iFS username--If nothing is entered, the default is system.

• Oracle iFS password--The username's password.

• Oracle iFS service name--The default is ServerManager.

• Oracle iFS schema password--The schema password.

Shutting Down All Agents and Servers Managed by a Specific Server Manager

To shut down all agents and servers managed by a specific Server Manager, you must run the stop server <server_manager> command from a Server Manager interactive session. All running agents and protocols servers managed by the Server Manager specified will be shut down, including the specified Server Manager. JWS and Sendmail cannot be stopped with this command.

Syntax:

stop server <server_manager>

Parameters:

<server_manager>

The name or ID of a Server Manager

Shutting Down Specific Agents or Servers Managed by a Specific Server Manager

To shut down specific agents or servers managed by a specific Server Manager, you must run the stop server <server_name> -m <server_manager> or the stop agent <agent_name> -m <server_manager> command from a Server Manager interactive session. The specified agent or protocol server managed by the specified Server Manager will be shut down. JWS and Sendmail cannot be stopped with this command.

Syntax:

stop server <server_name> -m <server_manager>

stop agent <agent_name> -m <server_manager>

Parameters:

server_name	The name of the protocol server being managed by the specified Server Manager to be shut down. The associated External Service agent will also be shut down automatically.
agent_name	The name of the agent being managed by the specified Server manager to be shut down. If the agent is an external service agent, the associated protocol server will also be shut down automatically.
server_manager	The name or ID of a Server Manager.

Starting the JWS

Oracle iFS provides the standard implementation of the Sun Java Web Server 2.0 as part of its distribution. Before using the Web interface to administer Oracle iFS, you must start the Web server. To do this, use the ifsstart command, which starts all protocol servers. To administer the Java Web Server, log into port 1717 using HTTP.

To start the Web server independently, use the ifsjwsstart file located in the following directory:

Platform	Location
UNIX	$ORACLE_HOME/ifs<version>/bin
Windows NT	%ORACLE_HOME%\ifs<version>\bin

See AlsoFor more information on using the ifsstart command, see Chapter 8, "Using Server Manager to Start and Stop Servers".

Configuring the System for Optimal Performance

Before running Oracle iFS, it is important to understand how to configure the system for optimal performance. There are three types of files to be recognized. The following table lists the file, gives a brief description, and the location:

File	Description	Location
Properties files	Used to configure Oracle iFS services.	$ORACLE_HOME/ifs<version>/settings/oracle/ifs/server/properties/ <service-name>.properties
Definition files	Used to configure Server Manager and protocol servers.	$ORACLE_HOME/ifs<version>/settings/ <server-name>.def
Log files	Used by Server Manager and protocol servers for logging activity and error conditions.	$ORACLE_HOME/ifs<version>/log/ <server-name>.log

Property Descriptions

Use a text editor to edit the following properties in the Properties file. These properties are configured during installation.

Property	Specifies	Example
Database Properties
User	The name of the Oracle iFS schema (the Oracle user that owns the Oracle iFS schema). Required; no default value.	User=ifssys
Driver	The fully-qualified class of the Java JDBC driver to use when connecting to the Oracle8i database. Required.	driver=oracle.jdbc.driver.OracleDriver
DatabaseUrl	Which database to connect to, depending on the JDBC driver. Required; no default value.	DatabaseUrl=jdbc:oracle:oci8:@tnsname

Note: The driver property has a fixed value and should not be modified.

Secondary Properties

There are several secondary properties you may modify, including Server, User Session, and Tracing properties. Oracle Corporation recommends that you retain the default settings for these secondary properties. Refer to Appendix B, "Secondary Properties" for a list of these secondary properties.

Using Analyze

To maintain peak performance, it is important for the Oracle8i database to know the storage distribution of the files in Oracle iFS. It is recommended that you run analyze to update the database statistics, especially after adding large numbers of documents, such as after a bulk load.

You will need to run analyze more often when you first install Oracle iFS. Adding two-hundred documents to an existing five-hundred documents has a larger impact than adding two-hundred documents to ten-thousand documents.

See Also

• For more information on configuration, see the Oracle Internet File System Installation Guide.

Logging In as the Administrator for the First Time

Logging in to any Oracle iFS tool for the first time is a simple process. Oracle iFS Manager does not require you to start a server. Before using the Web interface, however, you must start the Java Web Server. To use the Command Line Utilities, you must start the Command Line Protocol server (CUP).

Starting and Logging in to Oracle iFS Manager

To start Oracle iFS Manager, run the ifsmgr script installed with Oracle iFS from a command line prompt. This script is located in the following directory:

Platform	Directory
UNIX	$ORACLE_HOME/ifs<version>/bin
Windows NT	%ORACLE_HOME%\ifs<version>\bin

This directory contains either ifsmgr.bat for Windows NT machines or ifsmgr.sh for UNIX machines.

When Oracle iFS Manager starts, the Login window displays.

1. Enter a username and password (the default administrator login is system/manager).

2. Notice that the following fields are grayed out. They display information for the underlying Oracle iFS Service:
   • Oracle iFS Service--The property settings for the Oracle iFS Service. This field is not editable, but you can change it by clicking Change Oracle iFS Service.

   • Database Service--The Oracle database Net8 Service Name. This field is not editable and is determined by the Oracle iFS Service field.

   • Oracle iFS Schema--The Oracle database schema name for the Oracle iFS repository. This field is not editable and is determined by the Oracle iFS Service field.

3. Enter the Oracle iFS Schema Password.

4. Click OK to complete the logon process.

   The main window for Oracle iFS Manager displays:

The following table lists the default users in a new Oracle iFS installation:

Username	Password	Description
system	manager	User with administrator permissions. It is recommended that the password be changed when you first login. This system user is an Oracle iFS user and is not necessarily the database user, system/manager.
scott	tiger	A sample user without administrator permissions.
guest	welcome	A guest user to allow anonymous access to Oracle iFS. The guest user has access to the /ifs/public Folder and any other folders and documents with the Public, Published, or Protected ACL.

Note: The guest user is required by Oracle iFS File Transfer Protocol (FTP) and the Command Line Utility Protocol (CUP) to function correctly. If the guest user is deleted, you will not be able to log into FTP or CUP.

Tips

To change the Oracle iFS Service, click the Change Oracle iFS Service button. Enter a new Oracle iFS Service in the field provided and click OK. This step is optional.

See Also

For more information on logging into the Web interface and using it to administer Oracle iFS, see the Internet File System User's Guide.