6
Oracle Files Configuration

This chapter guides you through the process of configuring Oracle Files.

This chapter contains these topics:

• Preconfiguration Tasks for Oracle Files

• Configuring Oracle Files

• Non-Interactive Initial Configuration of Oracle Files

• Setting Up Oracle Files Runtime

Preconfiguration Tasks for Oracle Files

Oracle Files Configuration Assistant starts automatically at the end of the Oracle Universal Installer process and guides you through the process of identifying the Oracle database to use for the Oracle Files schema and various other configuration tasks.

Before you configure Oracle Files, you should:

• Ensure the Oracle9i database and listener process are running on the database server computer. If necessary, you can start these processes from the shell prompt as follows:

  prompt> lsnrctl START
  prompt> sqlplus /NOLOG
  SQL> CONNECT sys/password AS SYSDBA
  Connected.
  SQL> startup
  
  ORACLE instance started.
  Total System Global Area  185369592 bytes
  Fixed Size                   279544 bytes
  Variable Size             117440512 bytes
  Database Buffers           67108864 bytes
  Redo Buffers                 540672 bytes
  Database mounted.
  Database opened.
  SQL> exit
  
  

• Create users in Oracle Internet Directory.

  In order for users to access Oracle Files, they must first be created as users in Oracle Internet Directory. It is recommended that you perform this task prior to configuring Oracle Files. To create users in Oracle Internet Directory:

  1. Connect to your infrastructure host, typically:

     http://hostname:7777/oiddas
     
     

  2. Log in as the Oracle Internet Directory Administrator (typically orcladmin).

  3. Click the Directory tab.

  4. Click Create.

     The Create User page displays.

  5. Fill in the fields.

  6. Click Submit.

     Once users are created in Oracle Internet Directory, they are automatically provisioned in Oracle Files every 24 hours, a default setting that can be changed to provision users more frequently.

     See Also: "Provisioning Users in Oracle Files" for additional information

• Configure Oracle Workflow to integrate properly with Oracle Internet Directory and Oracle9iAS Single Sign-On.

  Oracle Workflow will not integrate successfully with Oracle Files if Oracle Workflow is not properly configured prior to configuring Oracle Files. For step-by-step information, please see Chapter 3 of the Oracle Collaboration Suite Release Notes.

  Table 6-1 Critical Information for Configuring and Running Oracle Files

  Topic	Location
  Configuring Oracle Workflow prior to configuring Oracle Files	Chapter 3 of Oracle Collaboration Suite Release Notes
  Creating Oracle Files users in Oracle Internet Directory	"Provisioning Users in Oracle Files"
  Provisioning users in Oracle Files	"Provisioning Users in Oracle Files"
  Oracle Files configuration tasks involving Oracle Enterprise Manager	Oracle Files Administration Guide
  Oracle Files Site Administrator and Subscriber Administrator information	"Creating the Oracle Files Subscriber" and Oracle Files online help
  Configuring the NFS Server	Oracle Files Release Notes
  Installing the Oracle FileSync client	"Installing Oracle FileSync for Windows"
  Other client access paths and software	Chapter 2 of Oracle Files Administration Guide
  Troubleshooting Oracle Files installation and configuration	"Troubleshooting Oracle Files Installation"

Configuring Oracle Files

Oracle Files Configuration Assistant is started automatically by Oracle Universal Installer, and guides you through the range of possible deployment scenarios listed in Table 6-2. Oracle Files Configuration Assistant always begins with the Oracle Files CA - Welcome screen.

Using Oracle Files Configuration Assistant, make your choices on each screen and click Next to continue. You can click Cancel to stop the assistant and configure Oracle Files at a later time by executing ifsca from the command line, located in the following directory:

$ORACLE_HOME/ifs/files/bin

Table 6-2 describes the type of configurations you can perform:

Table 6-2 Configuration Assistant Options

Configuration Type	Description	See Also...
Creating a New Oracle Files Domain	Creates a new Oracle Files schema in the database. Optionally configures the software required to include the computer as a node in the domain.	"Creating a New Oracle Files Domain"
Setting Up a Computer to Use an Existing Domain	Configures Oracle Files software on the system for integration with an existing domain.	"Setting Up a Computer to Use an Existing Domain"

To monitor the Oracle Files Configuration Assistant as it progresses, you can view the log as it is being written to the following file:

$ORACLE_HOME/ifs/files/log/FilesConfig.log

Creating a New Oracle Files Domain

These instructions guide you through the process of configuring the Oracle Files domain controller computer, which is typically the first computer in the domain that you are configuring.

The instructions begin from the Oracle Files Configuration Assistant Welcome screen.

1. Click Next.

   The Domain Operation screen appears.

   

   Text description of the illustration ifsca_01.gif

2. Select the Create a new Oracle Files domain option.

3. Click Next.

   The Database Selection screen appears.

   See Also: "Setting Up a Computer to Use an Existing Domain"

   

   Text description of the illustration ifsca_02.gif

4. Enter the name of the host on which the database is running, the listener port number, the database service name, and the password for the database SYS user account.

5. Click Next.

   The Database Login Verifications message box appears while the CLASSPATH, database connection to the Oracle9i database, initialization parameters, Oracle JServer installation, and other important requirements are verified.

   If an error occurs, you must correct the problem before configuration can continue. For example, if JServer is not installed in the database, you see an error message related to the DBMS_JAVA package.

   See Also: "Deploying Oracle Files" for information about preliminary setup requirements

   If an "Invalid password for Oracle user SYS" error message is displayed, this is likely due to a missing password file on the database server. Oracle Files Configuration Assistant attempts to make a connection as SYS AS SYSDBA using a database string, and therefore needs the database to be configured with a password file.

   See Also: "Password File Administration" in Chapter 1 of Oracle9i Database Administrator's Guide for more information. This manual is available on Oracle Technology Network at http://otn.oracle.com

   If additional errors occur, more information on why verification failed can be found in the FilesConfig.log file.

   When the verification process completes, the Schema Name screen appears.

   

   Text description of the illustration ifsca_03.gif

   6. Enter a name to use for the Oracle Files schema. You must also provide a password for the schema. Enter the password in both fields to confirm.

   7. Click Next.

      Oracle Files Configuration Assistant checks to see if the schema name exists in the database. If it does exist, or if related schema names based on this schema name exist, a message box appears notifying you of this problem.

   8. In this message box:
      • Click No to return to the Schema Name screen and enter a new name for the schema.

      • Click Yes if you are certain that you want to delete this schema and all related objects from the database, such as tables and views, and create a new schema.

      If the schema name does not exist, the Tablespaces screen appears.

      

      Text description of the illustration ifsca_04.gif

      9. Select one of the following options:
         • If you have not created custom tablespaces for Oracle Files content, select Use the USERS tablespace for all Oracle 9iFS data.

         • If you have created tablespaces specifically for Oracle Files content, select Specify a tablespace for each data type and choose the tablespaces you want to use for each type of content from the drop-down lists. The tablespaces must exist in order to select them for each data type; Oracle Files Configuration Assistant does not create them.

           See Also: Oracle Files Administration Guide for additional information on custom tablespaces. This manual is available on Oracle Technology Network at http://otn.oracle.com

   10. Click Next.

       A warning screen appears if you do not have an Oracle Workflow instance installed and configured in the database, and therefore Oracle Files cannot automatically integrated with Oracle Workflow. No warning box appears if an Oracle Workflow instance is installed and configured.

       See Also: "Oracle Files Dependencies on Oracle Workflow 2.6.2" for more information

       11. Make a selection based on your configuration needs:
           • If you want to automatically integrate with Oracle Workflow, click No to terminate Oracle Files configuration, and create an Oracle Workflow schema in the database. You can then configure Oracle Files by starting Oracle Files Configuration Assistant from the command line.

           • If you do not want to integrate with Oracle Workflow, or wish to integrate with Oracle Workflow as a postconfiguration step (not recommended), click Yes and continue with the Oracle Files configuration process.

             Note: It is strongly recommended that you have an instance of Oracle Workflow already installed and configured prior to creating the Oracle Files schema. This enables Oracle Files Configuration Assistant to automatically integrate with Oracle Workflow. For step-by-step information on configuring Oracle Workflow, see Chapter 3 of Oracle Collaboration Suite Release Notes. You can also integrate Oracle Files with Oracle Workflow manually as a postconfiguration step, although this is not recommended. Contact Oracle Support Services for detailed information about integrating Oracle Workflow with Oracle Files as a postconfiguration step.

           If you continue with the configuration, the Character Set and Language screen appears. Otherwise, the Oracle Files configuration process ends.

           

           Text description of the illustration ifsca_05.gif

           12. Select the default character set and indexing language to use when storing documents in Oracle Files. The document character set defaults are used by client applications that do not specify a language or character set for documents being transferred to Oracle Files. The default character set is also used by non-Unicode enabled protocols, such as FTP and WebDAV, to determine the character set for these protocol servers to use.

               Oracle Corporation recommends setting the character set to Unicode (UTF8) to enable full multi-language functionality. Specifying non-UTF8 character sets may limit Oracle Files ability to access and display content in multiple languages.

               If you need to support single-byte language functionality only, you can use UTF8 or any of the single-byte character sets supported by the database.

               See Also: "Multi_Lexer" in Oracle Text Reference Guide for more information

           13. Click Next.

               The Default Port Numbers screen appears.

               

               Text description of the illustration ifsca_06.gif

               The default port number settings are stored as an object for use by all middle tier computers that use the Oracle Files schema. To change the configuration on any single middle tier computer, you must use the Enterprise Manager Web Site.

           14. Change any of the port numbers as needed.
               • To run both the native UNIX and the Oracle Files versions of specific protocol servers on this computer, you must change the port numbers to avoid conflicts. If you change port numbers, the new port numbers will be used for all nodes in the domain.

               • If you change the main port for the NFS protocol server, you must also change the mount server port to a number other than 0. A value of 0 indicates that the mount server port number should be dynamically allocated by the port mapper, and should only be used when the NFS protocol server is on the standard NFS port number 2049.

                 See Also: Oracle Files Release Notes for detailed information about setting up the NFS protocol server

               • If you do not want to run the native UNIX implementations of the services, you can accept the default port numbers.

                 Note: To provide Oracle Files NFS support to NFS clients running on HP-UX, you must use port 2049 (the default) for Oracle Files and disable the native UNIX NFS protocol server. Linux and Solaris NFS clients do not have this limitation, so you can use both UNIX NFS and Oracle Files NFS protocol servers on the same computer for these clients.

               15. Click Next.

                   The Web Site Information screen appears.

                   

                   Text description of the illustration ifsca_07.gif

                   16. Enter the fully-qualified host name and port number of the computer through which you want the domain to provide HTTP listener services. Select Uses SSL only if you have configured SSL on that computer.

                   17. Click Next.

                       The SMTP Information screen appears.

                   18. Enter the information related to the e-mail server served by this domain. This information is used for sending informational e-mail through Oracle Files. For example, when a user is created, Oracle Files sends an e-mail to that user's e-mail address. Ensure the SMTP server is enabled, or you will not receive any mail sent by Oracle Files.

                   19. Click Next.

                       The Administrator Information screen appears.

                       

                       Text description of the illustration ifsca_08.gif

                       20. Enter the fully-qualified e-mail address to use for sending notifications and other messages to the Oracle Files administrator. For example, username@yourcompany.com.

                       21. Click Next.

                           The Users screen appears. Oracle Files Configuration Assistant creates three new users: system, guest, and site_admin. The Site Administrator is used to create the Subscriber in Oracle Files.

                           

                           Text description of the illustration ifsca_10.gif

                           22. Assign passwords to each of the default users.

                           23. Click Next.

                               The Oracle Internet Directory Login screen appears.

                               

                               Text description of the illustration ifsca_1a.gif

                               24. Enter the login information for the Oracle Internet Directory instance that you want to use for credential management.
                                   1. Enter the fully-qualified host name for the computer running Oracle Internet Directory.

                                   2. Accept the default port number or assign a new number.

                                      The default port number is 389 for LDAP. If this port is in use, port 4032 is used. You can usually leave this unchanged. If you have SSL enabled on Oracle Internet Directory, select Uses SSL and change the port number. The default port number for SSL-enabled mode is 636.

                                   3. Enter the Oracle Internet Directory super user name.

                                      The default Oracle Internet Directory super user name is cn=orcladmin.

                                   4. Enter the Oracle Internet Directory super user password.

                                      The password is whatever was entered when Oracle Internet Directory was installed.

                                   5. Enter the Oracle Context.

                                      The default Oracle Internet Directory root Oracle Context is set to cn=OracleContext. Typically, you can leave this unchanged. If the Oracle Internet Directory administrator changed the root context, you must enter the correct value. The concept of a root context is specific to LDAP directory services.

                               25. Click Next.

                                   The Workflow Schema screen appears if an Oracle Workflow schema has been configured in the same database you specified Oracle Files should point to, during Oracle Files Configuration Assistant Step 2 of 16, Database Selection. If the Workflow Schema screen appears, continue to Step 26.

                                   Otherwise, the Setup Local Machine screen appears. Continue to step 29.

                                   

                                   Text description of the illustration ifsca_11.gif

                               26. Select Integrate with workflow to integrate Oracle Files with Oracle Workflow and continue to step 27. Otherwise, clear the Integrate with workflow box and continue to step 28.

                                   Note: It is strongly recommended that you integrate with Oracle Workflow as part of Oracle Files configuration. However, if you do not initially choose to integrate Oracle Workflow with Oracle Files, you can do so manually as a postconfiguration step. Contact Oracle Support Services for detailed information about integrating Oracle Workflow with Oracle Files as a postconfiguration step.

                               27. Select the Workflow schema name and enter the schema password.

                               28. Click Next.

                                   The Setup Local Machine screen appears.

                                   

                                   Text description of the illustration ifsca_12.gif

                               29. Select one of the following options:
                                   • Select Yes to configure this host as a target that can be managed using the Oracle Enterprise Manager Web Site.

                                   • Select No to create the new host without configuring this domain with the software necessary to manage it as a target from the Oracle Enterprise Manager Web Site.

                               30. Click Next.

                                   The Domain Components screen appears.

                                   

                                   Text description of the illustration ifsca_13.gif

                                   31. Enter the host name that you want to use for Oracle Files if the computer contains multiple network interface cards (NICs).

                                   32. Select Run Domain Controller on this computer and all other processes that you want to configure for the domain. By default, the following processes are selected on this screen:
                                       • Run Domain Controller on this computer configures the Oracle Files Domain Controller process. Only one computer should run this process.

                                       • Run a Node on this computer configures an Oracle Files node to run on this computer.

                                       • Run an HTTP Node on this computer configures an HTTP node to run the Oracle Files DAV server for HTTP and WebDAV access on this computer.

                                   33. Click Next.

                                       The Node Configuration screen appears. This screen lists all the protocol servers and agents that you can choose to run in the domain:

                                       • Node Name is the name by which you want the node to be known. It can include the name of the computer (host name), but it need not. Use any string that makes sense to you.

                                       • Run Oracle 9iFS System Agents configures all the Oracle 9iFS system agents to run on this computer. Note that agents run on only one node in the domain. If agents are already configured to run on another node, this box must be unchecked.

                                       • Run Protocol Servers configures the Oracle 9iFS protocol servers to run on this computer. Protocol Servers include FTP, AFP, NFS, and SMB.

                                         See Also: Chapter 1, "Oracle Files Concepts" in Oracle Files Administration Guide

                                       

                                       Text description of the illustration ifsca_14.gif

                                   34. Enter a node name and configure protocol servers and agents as needed.

                                   35. Click Next.

                                       The HTTP Node Configuration screen appears, if you selected Run an HTTP Node on this computer on the Domain Components screen. This screen enables you to provide a name for the HTTP Node. Continue to step 36.

                                       Otherwise, the Summary screen appears. Continue to step 38.

                                       

                                       Text description of the illustration ifsca_15.gif

                                   36. Enter the name for the HTTP Node.

                                   37. Click Next.

                                       The Summary screen appears. Oracle Files Configuration Assistant now has all the information needed to create a new Oracle Files schema and configure the node and other processes. Note the name and location of the log file and any other important information on this screen.

                                   38. Click Configure to execute the configuration process.

                                       A progress window appears. If an error occurs, check the following log file for more information:

                                       $ORACLE_HOME/ifs/files/log/FilesConfig.log
                                       
                                       

                                       When the process is complete, a message informs you that the configuration was successful. Click OK to close the message. Oracle Files and the Oracle Enterprise Manager Web Site are integrated automatically.

                                       If Oracle Files Configuration Assistant was started by Oracle Universal Installer, then any remaining configuration tools are started.

                                       Setting Up a Computer to Use an Existing Domain

                                       These instructions guide you through the process of setting up a computer to use an existing domain. You must install and configure Oracle Files software into an Oracle home based on Oracle Collaboration Suite. For visual reference, see the screen shots included in the previous section.

                                       The instructions begin from the Oracle Files Configuration Assistant Welcome screen.

                                       1. Click Next to begin the configuration process.

                                          The Domain Operation screen appears

                                       2. Select the Set up this computer to use an existing Oracle Files domain option and click Next.

                                          The Database Selection screen appears.

                                          See Also: "Creating a New Oracle Files Domain"

                                       3. Enter the name of the host on which the database is running (database host name), the listener port number, the database service name, and the password for the database SYS user account.

                                       4. Click Next.

                                          The Database Login Verifications message box appears as the CLASSPATH, database connection to the Oracle9i database, initialization parameters, Oracle JServer installation, and other important requirements are verified.

                                          If an error occurs, you must correct the problem before configuration can continue. For example, if JServer is not installed in the database, you see an error message related to the DBMS_JAVA package.

                                          See Also: Chapter 2, "Preparing for Installation" for more information about preliminary setup requirements

                                          If an "Invalid password for Oracle user SYS" error message is displayed, this is likely due to a missing password file on the database server. Oracle Files Configuration Assistant attempts to make a connection as SYS AS SYSDBA using a database string, and therefore needs the database to be configured with a password file.

                                          See Also: "Password File Administration" in Chapter 1 of Oracle9i Database Administrator's Guide for more information. This manual is available on Oracle Technology Network at http://otn.oracle.com

                                          If additional errors occur, more information on why verification failed can be found in the FilesConfig.log file.

                                          When the verification process completes, the Schema Name screen appears.

                                       5. Enter the schema name of the existing Oracle Files domain and enter the schema password.

                                       6. Click Next.

                                          The Domain Components screen appears after the database connection and schema are verified.

                                       7. Enter the host name that you want to use for Oracle Files if the computer contains multiple network interface cards (NICs).

                                       8. Select Run Domain Controller on this computer and all other processes that you want to configure to run on this computer. By default, the following processes are selected:
                                          • Run Domain Controller on this computer configures the Oracle Files Domain Controller process. Only one computer should run this process.

                                          • Run a Node on this computer configures an Oracle Files node to run on this computer.

                                          • Run an HTTP Node on this computer configures an HTTP node to run the Oracle Files DAV server for HTTP and WebDAV access on this computer.

                                       9. Click Next.

                                          The Node Configuration screen appears.

                                          The Node Configuration screen lists all the protocol servers and agents that you can choose to run in the domain:

                                          • Node Name is the name by which you want the node to be known. It can include the name of the computer (host name), but it need not. Use any string that makes sense to you.

                                          • Run Oracle 9iFS System Agents configures all the Oracle 9iFS system agents to run on this computer. Note that agents run on only one node in the domain. If agents are already configured to run on another node, this box must be unchecked.

                                          • Run Protocol Servers configures the Oracle 9iFS protocol servers to run on this computer. Protocol Servers include FTP, AFP, NFS, and SMB.

                                            See Also: "Oracle Files Concepts" in Chapter 1 of Oracle Files Administration Guide. This manual is available on Oracle Technology Network at http://otn.oracle.com

                                       10. Enter a node name and configure protocol servers and agents as needed.

                                       11. Click Next.

                                           The HTTP Node Configuration screen appears if you selected Run an HTTP Node on this computer on the Domain Components screen. This screen enables you to provide a name for the HTTP Node. Continue to step 12.

                                           Otherwise, the Summary screen appears. Continue to step 14.

                                       12. Enter the name for the HTTP Node.

                                       13. Click Next.

                                           The Summary screen appears. Oracle Files Configuration Assistant now has all the information needed to configure the computer. Note the name and location of the log file and any other important information on this screen.

                                       14. Click Configure to execute the configuration process.

                                           A progress window appears. If an error occurs, check the following log file for more information:

                                           $ORACLE_HOME/ifs/files/log/FilesConfig.log
                                           
                                           

                                       15. When the process completes, a message informs you that the initial configuration was successful. Click OK to close the message.

                                           If Oracle Files Configuration Assistant was started by Oracle Universal Installer, then the remaining configuration tools are started.

                                       Non-Interactive Initial Configuration of Oracle Files

                                       You can configure the Oracle Files domain non-interactively by passing a response file containing all the configuration settings to Oracle Files Configuration Assistant as a parameter at the command line. The location of the response file is:

                                       $ORACLE_HOME/ifs/files/settings/silentconfig.properties
                                       
                                       

                                       The file contains instructions about how to modify and use it. Modify the response file to meet your specific needs.

                                       1. Open the silentconfig.properties file in a text editor.

                                       2. Make any required changes to the settings in the file, and close the file when you are finished.

                                       3. Run Oracle Files Configuration Assistant using your modified response file by entering the following two commands:

                                          cd $ORACLE_HOME/ifs/files/bin
                                          
                                          ./ifsca -file $ORACLE_HOME/ifs/files/settings/silentconfig.properties 
                                          -silent
                                          
                                          

                                          Oracle Files is configured on the computer according to the specifications defined in the response file. If an error occurs, check the following log file for more information:

                                          $ORACLE_HOME/ifs/files/log/FilesConfig.log
                                          
                                          

                                       Setting Up Oracle Files Runtime

                                       Perform the following tasks to complete the initial configuration and start the domain, and to ensure that your system is operational and secure:

                                       • Starting All Necessary Processes

                                       • Creating the Oracle Files Subscriber

                                       • Provisioning Users in Oracle Files

                                       • Accessing the Protocol Servers

                                       • Validating Basic Operations

                                       Starting All Necessary Processes

                                       These instructions assume that Oracle Files has been installed and configured, and that the database and listener are running.

                                       Oracle Files uses the Oracle9iAS Containers for J2EE (OC4J) component of Oracle9iAS Infrastructure to support the DAV Servlet, which is deployed to OC4J automatically during the configuration process.

                                       1. Restart the Oracle Enterprise Manager Web Site by stopping it and then starting it again. Since the Oracle Files Configuration Assistant modifies the targets.xml file, the Oracle Files domain does not appear in the Oracle Enterprise Manager Web Site until you restart Oracle Enterprise Manager.

                                          $ORACLE_HOME/bin/emctl start
                                          

                                          Note: Some Oracle documentation refers to Oracle Enterprise Manager Web Site as the Enterprise Manager Daemon (EMD) or the Oracle Enterprise Manager.

                                          If your Oracle Files domain comprises multiple physical computers, you must run the emctl start command on each computer.

                                       2. From a Web browser on the server computer or from another computer on the network, access the URL to connect to the Oracle Enterprise Manager Web Site on the computer where the Oracle Files domain controller is configured:

                                          http://hostname:1810
                                          
                                          

                                          Alternatively, you can go directly to the Oracle Enterprise Manager page by entering:

                                          http://hostname:1810/emd/console/targets
                                          

                                          If you enter this URL, the page listed in Step 4 appears.

                                          A Username and Password Required or Enter Network Password prompt appears.

                                       3. Enter ias_admin as the user name with the appropriate password for the Oracle9iAS Infrastructure instance.

                                          The Web page displays a list of all Oracle9iAS Infrastructure and Oracle Collaboration Suite components, or Targets, running on the specified host.

                                       4. Click the name of the Oracle Collaboration Suite instance that is hosting the Oracle Files software. If you are prompted for the Oracle Collaboration Suite instance user name and password again, enter ias_admin and the appropriate password to continue.

                                          A page displays all of the system components running on the instance. The list should include the Oracle Files domain, which appears as a concatenation of iFS_ and the database instance's host name, port number, service name, and the name of the schema for Oracle Files. For example:

                                          iFS_myMachineHostname.mycompany.com:1521:myDBServiceName:myFILESSchemaName
                                          
                                          

                                          Note: Although you see Start and Stop buttons on this page, you cannot control Oracle Files from this page.

                                       5. Click the domain name link. On the subsequent page, click Start Local Components. A page prompting you for the host credential to start the Oracle Files node appears.

                                       6. Enter the operating system account name and password for the computer. This is typically the root user name and password.

                                          If your domain comprises multiple nodes across multiple computers, repeat this step for each computer. You must enter the operating system account name and password on each computer running a node that you want to start.

                                       7. Click OK.

                                          Note: In place of steps 1 - 7, you can run the ifsctl start command from $ORACLE_HOME/ifs/files/bin.

                                       8. Click the link that takes you back to the page displaying all of the system components running on the instance.

                                          The Oracle Files top-level management page appears. The domain name displays in the upper-left area of the page. The domain name has the form:

                                          myHostname.mycompany.com:1521:myDBServiceName:myFILESSchemaName 
                                          
                                          

                                       9. Ensure that the OC4J instance is running. To start the OC4J instance, enter:

                                          opmnctl startall
                                          
                                          

                                          To stop the OC4J instance, enter:

                                          opmnctl stopall
                                          
                                          

                                          The Oracle Files domain starts.

                                       10. Check the status of the Oracle Files domain. Run the following command:

                                           $ORACLE_HOME/ifs/files/bin/ifsctl status -n
                                           

                                           Creating the Oracle Files Subscriber

                                           In the following steps, you will log in to Oracle Files as the Site Administrator and create the Subscriber.

                                           1. Go to:

                                              http://httphost:port/files/app/AdminLogin
                                              
                                              

                                              For example:

                                              http://acme.us.oracle.com:7778/files/app/AdminLogin
                                              
                                              

                                              The Administrator Login page appears.

                                           2. Log in as site_admin and use the same site_admin password you used during configuration.

                                           3. Click New Subscriber.

                                              The Subscriber Name page appears. Note that the Subscriber Name is the default subscriber for the Oracle Internet Directory server. The Oracle Internet Directory server is the value entered during Oracle Files configuration (this subscriber is typically "US").

                                           4. Click Next.

                                              The Subscriber Information page appears.

                                           5. Set the quota and maximum number of users. For example, 1 GB total quota, 10 MB quota for each user, and 10 MB quota for each Workspace.

                                           6. Click Next.

                                              The Create Subscriber Administrator Account page appears.

                                           7. Enter the subscriber user login ID. The e-mail address is where the subscriber's password is sent. Specify the Default User Account Settings and Default Workspace Settings.

                                           8. Click Next.

                                              The New Subscriber Confirmation page appears.

                                           9. Review your information, then click Submit.

                                              The Browse Subscribers page appears. You can see that the Subscriber has been created and the Subscriber's password has been automatically e-mailed.

                                           10. To log in as the subscriber, navigate to the following URL:

                                               http://httphost:port/files/app/AdminLogin
                                               
                                               

                                               The Administrator Login page appears.

                                           11. Log in as subscriber_user_login_ID/password using the subscriber user login ID you entered when creating the subscriber in Step 7.

                                           12. Click the USERS tab to view the Users page. Refresh this page to see an updated list of Oracle Files users.

                                               See Also: "Provisioning Users in Oracle Files" for more information about creating users in Oracle Files

                                           Provisioning Users in Oracle Files

                                           In order for users to access Oracle Files, they must first be created as users in Oracle Internet Directory.

                                           See Also: "Preconfiguration Tasks for Oracle Files" in this chapter for information about how to create users in Oracle Internet Directory.

                                           Once users are created in Oracle Internet Directory, and the Oracle Files Site Administrator has created the Oracle Files Subscriber Administrator, they are automatically provisioned in Oracle Files every 24 hours (the default setting) by the FilesOidUserSynchronizationAgent.

                                           To reset the activation period for FilesOidUserSynchronizationAgent from 24 hours to a shorter time period (so that you do not have to wait 24 hours for the agent to provision users in Oracle Files) follow these steps:

                                           1. Start EMD, also known as Oracle Enterprise Manager, from the command line using the script:

                                              $ORACLE_HOME/bin/emctl start
                                              
                                              

                                              If you have more than one Oracle9iAS Infrastructure or Oracle Collaboration Suite home on the same host, start EMD from the ACTIVE_EMD_HOME. You can check your ACTIVE_EMD_HOME by navigating to the location shown in the following table:

                                              Operating System	Location
                                              Solaris	cat /var/opt/oracle/emtab
                                              HP-UX and Linux	cat /etc/emtab

                                           2. Connect to EMD at http://hostname:1810/.
                                              1. Log in as ias_admin using the same password you entered for the Oracle Collaboration Suite instance when you installed Oracle Collaboration Suite.

                                              2. Click the Files Domain link. For example:

                                                 iFS_host:1521:ServiceName_SchemaName 
                                                 
                                                 

                                              The Files Domain page appears.

                                           3. Click Server Configuration.

                                           4. Edit FilesOidUserSynchronizationAgentConfiguration by changing the value of IFS.SERVER.TIMER.ActivationPeriod from 24h to 3m (three minutes).

                                           5. Click OK to save FilesOidUserSynchronizationAgentConfiguration.

                                           6. Stop the FilesOidUserSynchronizationAgent by following these steps:
                                              • Return to the Oracle Files Domain page

                                              • Click on the Node name.

                                              • Click on the button next to FilesOidUserSynchronizationAgent

                                              • Click Stop.

                                           7. Click Load Server.

                                              The Load Server page appears.

                                              1. Enter the following information:
                                                 • Server Name: a name of your choice (this is a temporary designation)

                                                 • Service Name: IfsDefaultService

                                                 • Server Configuration: FilesOidUserSynchronizationAgentConfiguration

                                              2. Click OK.

                                           8. Click Start to start the newly loaded FilesOidUserSynchronizationAgent.

                                              After the FilesOidUserSynchronizationAgent has provisioned users, you can change the ActivationPeriod back to 24 hours (24h) or whatever is your preference.

                                              As a result of the synchronization process, Oracle Files users receive an e-mail confirming that they have an account on Oracle Files, with a URL to the Oracle Files login page and instructions on how to enable protocol access to Oracle Files.

                                              See Also: "Accessing the Protocol Servers"

                                              Accessing the Protocol Servers

                                              To access the protocol servers running on your Oracle Files Domain, each end user should perform the following steps:

                                              1. Connect to the Protocol Access page:

                                                 http://hostname:7778/files/app/ProtocolAccess
                                                 
                                                 

                                                 The Single Sign On page (SSO) appears.

                                              2. Log in using the Oracle Internet Directory user and password.

                                                 The Protocol Access page appears.

                                              3. Enter the SSO password and the Oracle Files-specific password and password confirmation to create these passwords for the user.

                                              4. Click Continue to save.

                                                 Now that you have configured the Oracle Internet Directory user using the Protocol Access page, you can access the protocol servers that may be running on your Oracle Files Domain.

                                                 Note: To access AFP and FTP, use the Oracle Files-specific password. To access SMB, FileSync, WebFolders, or Files Login, use the Oracle Internet Directory password.

                                              See Also: Oracle Files Administration Guide for more information about creating users and accessing protocol servers running on your Files Domain

                                              Validating Basic Operations

                                              To validate that the domain and node started and the core Oracle Files components are working, attempt to connect to the system from another computer on the network.

                                              Table 6-3 Basic Functionality

                                              Protocol or Server	Access Address or Method	Expected Result
                                              HTTP	http://hostname:7778/files/	Log in as a user created in the Oracle Internet Directory server.
                                              SMB	Map a network drive from Windows Explorer. \\hostname\share	A Windows file share appears.

                                              Note that if you attempt to connect to the HTTP Web server and receive a 503 Service Temporarily Unavailable message, the domain (in particular, the HTTP node) has not fully started. You must start the HTTP node.