Skip Headers

Oracle Collaboration Suite Installation Guide
Release 1, Version 9.0.3.1.0 for Windows
Part Number B10262-01
Go To Table Of Contents
Contents		 Go To Index
Index

Go to previous page Go to next page

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

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.

Important:

Oracle Files is dependent on Oracle Workflow 2.6.2. In order to integrate Oracle Files and Oracle Workflow, you must configure Oracle Workflow before configuring Oracle Files. If Oracle Workflow is not configured, then do not configure Oracle Files during the Oracle Collaboration Suite middle tier installation.

See Also:

Before you configure Oracle Files, you should complete the tasks in this section. This section contains these topics:

Table 6-1 lists additional configuration and usage information for Oracle Files.

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

Configuring Oracle Workflow prior to configuring Oracle Files

"Integrating Oracle Workflow With Oracle Collaboration Suite"

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

Configuring the NTFS 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"

Starting the Database and Database Listener

Ensure the Oracle9i database and listener process are running on the database server computer. If necessary, you can start these processes 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

Creating 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

Integrating Oracle Workflow With Oracle Collaboration Suite

The following sections guide you through properly configuring Oracle Workflow, integrating Oracle Workflow with Oracle Internet Directory and Oracle9iAS Single Sign-On, and enabling languages in the Oracle Workflow schema. All of these tasks are necessary in order for Oracle Workflow to function properly with the Oracle Collaboration Suite, and for Oracle Workflow to automatically integrate with Oracle Files during the Oracle Files configuration process.

This section contains these topics:

Configuring Oracle Workflow

The steps detailed in this section must be performed to properly configure Oracle Workflow.

Note:

During the Oracle Workflow configuration process, several command windows open and close automatically. Do not close these windows or you will interrupt the configuration process.

  1. Run Oracle Workflow Configuration Assistant in the middle tier computer by executing the following script: 

    ocsmtier_ORACLE_HOME\wf\install\wfinstall.bat
  2. Enter the user information listed in Table 6-2:

    Table 6-2 Oracle Workflow Configuration Assistant Values  
    Field Value

    Workflow Account

    The username of your Oracle Workflow database account. The default Workflow account is OWF_MGR.

    Workflow Password

    The password for your Oracle Workflow database account.

    SYS Password

    Enter your SYS password. See your Oracle DBA if you need more information.

    SYSTEM Password

    Enter your SYSTEM password. See your Oracle DBA if you need more information.

    Install Option

    Select Install to perform a fresh installation of Oracle Workflow, Upgrade to upgrade an existing installation of Oracle Workflow, or Add language to load a language into your existing installation of Oracle Workflow.

    Language Selection

    If you chose the Add language install option, select the language abbreviation for the language you want to add.

    See Also: Appendix A, "Locale Data" in Oracle9i Globalization Support Guide for a list of standard language abbreviations

    Connect Method

    Select Local to connect to a local database using the Oracle SID, or Remote to connect to a remote database through Oracle Net using LOCAL.

    Connect String

    If you choose the Remote connect method, enter the connect string for the remote database.

    Important: To ensure that the Oracle Workflow schema is created on the same database where the Oracle Files schema is to be created, use the Files Store CONNECT_STRING.

  1. Click Submit to begin Oracle Workflow configuration.

    When Oracle Workflow configuration is complete, a confirmation window appears.

  2. Click OK.

    Oracle Workflow configuration is now complete. You can check the status of the Oracle Workflow configuration by reviewing the workflow.log log file located in the following directory: 

    ORACLE_HOME\wf\install\workflow.log

    Important:

    The workflow.log file produced during installation and configuration of Oracle Workflow may contain sensitive information. To protect this sensitive information, delete this file after the installation is complete or change the permissions for the file so that only authorized administrators can access it.

    Integrating Oracle Workflow with Oracle Internet Directory and Oracle9iAS Single Sign-On

    The following steps must be performed in order to successfully integrate Oracle Workflow with Oracle Internet Directory and Oracle9iAS Single Sign-On.

    1. Create a Database Access Descriptor (DAD) through Oracle Enterprise Manager Web Site:

      1. Connect to Oracle Enterprise Manager Web Site: 

        http://hostname:1810
      2. Select infrastructure_instance_name.hostname from the Standalone Instances section.

        The Application Server.instance_name page displays.

      3. Select HTTP Server from the System Components section.

        The HTTP Server page appears.

      4. Select PL/SQL Properties from the Administration section.

        The mod_plsql Services page appears.

      5. Click Create in the DAD Status section.

        The Create DAD: DAD Type page appears.

      6. Select General as the DAD type, then click Next.

        The Create DAD: Database Connection page appears.

    2. Create the DAD with the values listed in Table 6-3:

      Table 6-3 Database Access Descriptor Values  
      Property Value

      DAD Name

      Enter a name for the new Oracle Workflow DAD. You must use pls/ prior to the name.

      pls/new_workflowDAD

      For example: 

      pls/ocs_wf

      Database Username

      Leave this setting blank to enable mod_plsql database authentication

      Database User Password

      Leave this setting blank to enable mod_plsql database authentication

      Database Connect String

      CONNECT_STRING

      Enter the CONNECT_STRING for the Files Store. For example: 

      acme:1521:files

      Default Page

      Specify a name for your Oracle Workflow default Home Page.

      default_homepage.home

      For example: 

      wfa_html.home

      Authentication Mode

      Basic

    1. Click Next.

      The Create DAD: Document, Alias and Session page appears.

    2. Select Stateless - ResetPackageState from the Session State Management field.

    3. Leave the remaining settings blank and click Finish.

    4. Click OK on the confirmation screen.

    5. Restart Oracle HTTP Server to pick up the new DAD settings:

      1. Click HTTP Server at the top of the page.

        The HTTP Server page appears.

      2. Click Restart.

    6. Access Oracle Workflow from the following URL: 

      http://server_name[:portID]/pls/new_workflowDAD/default_homepage.home

      For example: 

      http://myserver:8799/pls/ocs_wf/wfa_html.home
    7. Enter the Workflow schema name and password.

      • username: workflow_schema_name (The default is OWF_MGR.)

      • password: workflow_schema_password

    8. Restart Oracle HTTP Server from the following URL, selecting the Oracle HTTP Server, and clicking Restart: 

      http://hostname:1810
    9. Access Oracle Workflow as described in step 8.

    10. Set the Global Preferences listed in Table 6-4:

      Table 6-4 Global Preferences Values  
      Property Value

      LDAP Host

      fully_qualified_hostname

      For example: myinfrabox.mycompany.com

      LDAP Port

      oid_port

      This value is typically 389.

      LDAP Admin

      Typically cn=orcladmin

      LDAP Admin password

      password_of_LDAP_Admin_User

      Typically, the LDAP admin user is orcladmin. This password should have been manually recorded on a checklist provided for Oracle Collaboration Suite installation.

      Change Log Location

      This is the Oracle Internet Directory user that will own the change log, and is typically: 

      cn=changelog

      User Base Directory

      Must be the default subscriber for Oracle Internet Directory, for example: 

      cn=Users,dc=us,dc=oracle,dc=com

      Workflow Administrator

      typically orcladmin

      Workflow Web Agent

      The URL for Oracle Workflow is:

      http://server_name:[portID]/pls/new_workflowDAD

      For example:

      http://myserver:8799/pls/ocs_wf

    1. Download and apply ARU Patch 2283128 for Bug 2579824 (contact Oracle Support Services for download location, username, and password), then go to the following directory: 

      cd bug2579824
    2. Enter the following SQL*Plus command: 

      sqlplus workflow_schema_name\workflow_schema_password
    3. Execute the following five commands as Oracle Workflow schema user (typically owf_mgr): 

      SQL> @wfsecs.pls
SQL> @wfsecssb.pls
SQL> @WFLDAPB.pls
SQL> @wfsscb.pls
SQL> @ORACLE_HOME\wf\sql\wfdircsv.sql

      Note:

      If you encounter the ldap_dbms package not found error after running the WFLDAPB.pls script (9.2 database only), run the following script, then run WFLDAPB.pls again:

      SQL> @ORACLE_HOME\rdbms\admin\catldap.sql

    1. Go to Event Subscription in the Oracle Workflow interface. This page lists numerous events. Locate the following event: 

      ORACLE.APPS.WF.PUBLIC.USER.CHANGE.

      Scroll to the right to find the Edit link next to this event.

    2. Click Edit. On the resulting page, under Execution Control, change the status to Enabled, and click Submit.

    3. Enter the following SQL commands: 

      SQL> begin
SQL> exec wf_ldap.synch_all
SQL> end

      This is the PL/SQL procedure to provision existing Oracle Internet Directory users as Oracle Workflow users.

    4. Run the following PL/SQL procedure to provision new Oracle Internet Directory users, as they are created, in Oracle Workflow: 

      SQL> begin
SQL> wf_ldap.synch_changes()
SQL> end

      Note:

      It is recommended that you create a DBMS_JOB to automatically run the scripts in steps 18 and 19 at regular intervals.

    5. Add the following entry in the ORACLE_HOME/Apache/Apache/conf/mod_osso.conf file: 

      <Location new_workflowDAD>
require valid-user
AuthType Basic
</Location>
    6. Back up the ORACLE_HOME/Apache/modplsql/conf/dads.conf file.

    7. Find the new_workflowDAD location. Between the Location and /Location lines, insert the following entries: 

      PlSqlDatabaseUsername workflow_schema_name
PlSqlDatabasePassword workflow_schema_password
    8. Restart the Oracle HTTP Server as described in step 10.

    Enabling All Languages in the Oracle Workflow Schema

    Perform the following steps to enable all languages in the Oracle Workflow schema.

    Note:

    • You must add all nine languages listed in step 5 to properly integrate Oracle Files and Oracle Workflow during Oracle Files configuration.

    • Oracle Workflow Configuration Assistant may hang when installing the Spanish (E) and French (F) languages. If Oracle Workflow Configuration Assistant hangs, stop the installation of these languages and proceed with Oracle Files configuration.

    1. Start Oracle Workflow Configuration Assistant: 

      ORACLE_HOME\wf\install\wfinstall.bat
    2. Select Add Language from the Install Options field.

    3. Choose a language from the list and provide other required information.

    4. Click Submit, then click OK in the confirmation dialog box.

    5. Execute steps 1 through 4 for the following nine languages:

      • PTB (Brazilian Portuguese)

      • D (German)

      • E (Spanish)

      • F (French)

      • I (Italian)

      • JA (Japanese)

      • KO (Korean)

      • ZHS (Simplified Chinese)

      • ZHT (Traditional Chinese)

    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-5. 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.bat from the command line: 

    ORACLE_HOME\ifs\files\bin

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

    Table 6-5 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 ifsca_01.gif follows.

      Text description of the illustration ifsca_01.gif

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

    2. Click Next.

      The Database Selection screen appears.

      Text description of ifsca_02.gif follows.

      Text description of the illustration ifsca_02.gif

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

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

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

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

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

        Tablespaces screen appears after you close the message box.

        Text description of ifsca_04.gif follows.

        Text description of the illustration ifsca_04.gif

        1. Select one of the following options:

        2. 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 integrate with Oracle Workflow. No warning box appears if an Oracle Workflow instance is installed and configured. Go to step 11

          1. Make a selection based on your configuration needs:

            Text description of ifsca_05.gif follows.

            Text description of the illustration ifsca_05.gif

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

          3. Click Next.

            The Default Port Numbers screen appears. 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.

            Text description of ifsca_06.gif follows.

            Text description of the illustration ifsca_06.gif

            1. Change any of the port numbers as needed.

              • To run both third-party Windows and 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.

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

              1. Click Next.

                The Website Information screen appears.

                Text description of ifsca_07.gif follows.

                Text description of the illustration ifsca_07.gif

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

                2. Click Next.

                  The SMTP Information screen appears.

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

                4. Click Next.

                  The Administrator Information screen appears.

                  Text description of ifsca_08.gif follows.

                  Text description of the illustration ifsca_08.gif

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

                  2. 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 ifsca_10.gif follows.

                    Text description of the illustration ifsca_10.gif

                    1. Assign passwords to each of the default users.

                    2. Click Next.

                      The Oracle Internet Directory Login screen appears.

                      Text description of ifsca_1a.gif follows.

                      Text description of the illustration ifsca_1a.gif

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

                      2. 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 4, Database Selection. If the Workflow Schema screen appears, go to step 26.

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

                        Text description of ifsca_11.gif follows.

                        Text description of the illustration ifsca_11.gif

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

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

                        3. Click Next.

                          The Setup Local Machine screen appears.

                          Text description of ifsca_12.gif follows.

                          Text description of the illustration ifsca_12.gif

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

                        5. Click Next.

                          The Domain Components screen appears.

                          Text description of ifsca_13.gif follows.

                          Text description of the illustration ifsca_13.gif

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

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

                          3. 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 Files protocol servers to run on this computer. Protocol Servers include FTP, AFP, NFS, and NTFS.

                            Text description of ifsca_14.gif follows.

                            Text description of the illustration ifsca_14.gif

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

                          5. 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 ifsca_15.gif follows.

                            Text description of the illustration ifsca_15.gif

                          6. Enter the name for the HTTP Node.

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

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

                            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

                              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. If following error message is likely due to a missing password file on the database server: 

                              Invalid password for Oracle user SYS

                              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.

                              The Schema Name screen appears when the verification process completes.

                            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:

                            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 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.bat -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:

                            Grant the Administrator Account "Logon as Batch Job" Privileges

                            You need to grant the Windows NT and 2000 Administrator account (or other account you're using to install and configure Oracle Collaboration Suite) the Logon as Batch Job privilege in order to start the Domain Controller and Nodes from the Oracle Enterprise Manager Web Site.

                            These instructions presume you are still logged on to the Windows NT or Windows 2000 machine as the Administrator (or other user account with administration privileges).

                            Granting Privileges on Windows NT

                            1. Open User Manager (Start > Programs > Administrative Tools (Common) > User Manager).

                              User Manager (or User Manager for Domains for Windows NT Server) displays.

                            2. Select Polices > User Rights.

                              The User Rights Policy screen displays.

                            3. Select Show Advanced User Rights, located in the lower-left corner of the display.

                            4. Select Logon as Batch Job from the drop-down menu of rights.

                            5. Click Add.

                            6. Add the user account that was used to install Oracle Collaboration Suite, typically Administrator or another user account from the Administrators group.

                            7. Click OK to close the dialog.

                            8. Click OK to save the change and exit the User Rights Policy dialog.

                            Granting Privileges on Windows 2000

                            1. Open Local Security Policy (Start > Programs > Administrative Tools > Local Security Policy).

                              The Local Security Settings window appears.

                            2. From the tree on the left side pane, open Local Policies and select User Rights Assignment.

                              A list of policies will appear in the right side panel.

                            3. Select Logon as Batch Job.

                            4. Click Add.

                            5. Add the user account that was used to install Oracle Collaboration Suite, typically Administrator or another user account from the Administrators group.

                            6. Click OK to close the dialog.

                            7. Click OK to save the change and exit the Local Security Settings window.

                            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 service, OracleHOME_NAMEEMWebsite, 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.

                              If your Oracle Files domain comprises multiple physical computers, you must stop or start the service 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.

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

                            2. Enter the operating system account name and password for the Windows NT or 2000 administrator.

                              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.

                            3. Click OK.

                            1. 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
                            2. Ensure that the OC4J instance is running. To start the OC4J instance:

                              1. Select OC4J_IFS_FILES.

                              2. Click Restart.

                              3. Click Confirm.

                              The Oracle Files domain starts.

                            3. 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 in step 24 during Oracle Files configuration. This subscriber is typically US.

                              4. Accept the defaults.

                              5. Click Next.

                                The Subscriber Information page appears.

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

                              7. Click Next.

                                The Create Subscriber Administrator Account page appears.

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

                              9. Click Next.

                                The New Subscriber Confirmation page appears.

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

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

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

                                The Administrator Login page appears.

                              12. Log in as subscriber_user_login_ID/password using the subscriber user login ID you entered when creating the subscriber in step 8.

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

                              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 the Oracle Enterprise Manager Web Site service, OracleHOME_NAMEEMWebsite.

                                  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 following Windows registry key: 

                                  HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\em_loc
                              2. Connect to Oracle Enterprise Manager Web Site 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. This page displays the status of the following Oracle Files components: Domain Controller, host_name Node, and host_name HTTP Node.

                              3. Click Server Configuration.

                              4. Click FilesOidUserSynchronizationAgentConfiguration.

                              5. Select IFS.SERVER.TIMER.ActivationPeriod and click Edit.

                              6. Change the value from 24h to 3m (three minutes).

                              7. Click OK to save FilesOidUserSynchronizationAgentConfiguration.

                              8. Stop the FilesOidUserSynchronizationAgent by following these steps:

                                1. Return to the Oracle Files Domain page.

                                2. Click host_name Node. The host_name Node page appears, listing all the running Oracle Files agents and protocol servers.

                                3. Select FilesOidUserSynchronizationAgent.

                                4. Click Stop.

                                5. Click Yes to confirm.

                              9. Select FilesOidUserSynchronizationAgent again, click Unload, and confirm the action.

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

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

                              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 NTFS, FileSync, WebFolders, or Files Login, use the Oracle Internet Directory password.

                                Important:

                                In order to start the NTFS protocol server, a user must first have been created in Oracle Internet Directory and provisioned in Oracle Files by the FilesOidUserSynchronizationAgent. For a step-by-step description of this process, see "Creating the Oracle Files Subscriber" and "Provisioning Users in Oracle Files". When this process is complete, the user must restart the NTFS server.

                                For detailed information on configuring the NTFS server, see Oracle Files Release Notes.

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

                              NTFS

                              At the command prompt, enter:

                              C:\> dir O: where O is the mapped drive

                              A listing of directory appears.

                              Important:

                              In order to start the NTFS protocol server, a user must first have been created in Oracle Internet Directory and provisioned in Oracle Files by the FilesOidUserSynchronizationAgent. For a step-by-step description of this process, see "Creating the Oracle Files Subscriber" and "Provisioning Users in Oracle Files". When this process is complete, the user must restart the NTFS server.

                              For detailed information on configuring the NTFS server, see Oracle Files Release Notes.

                              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.

Go to previous page Go to next page
Oracle
Copyright © 2002 Oracle Corporation.
All Rights Reserved.
Go To Table Of Contents
Contents		 Go To Index
Index