E Completing Installation of Oracle WebCenter Interaction Content Service for Windows Files

If you installed Oracle WebCenter Interaction Content Service for Windows Files for the first time, perform the following tasks to complete the installation:

1. Setting Up Security Rights for Oracle WebCenter Interaction Content Service for Windows Files

2. Verifying the Security Library

3. Configuring Security for Document Discovery

4. Creating a Content Source

5. Creating a Content Crawler

6. Creating a Job

7. Advanced Configuration

Note:

IIS must be running to complete the tasks in this chapter.

Note:

There are no post-install steps if you upgraded Oracle WebCenter Interaction Content Service for Windows Files.

Setting Up Security Rights for Oracle WebCenter Interaction Content Service for Windows Files

Each content source you set up must impersonate an NT domain user to access your file system. You might want to create an NT user specifically for use with each content source you intend to create and then ensure that those users have write access to the directory where Oracle WebCenter Interaction Content Service for Windows Files is installed. Use the following steps if you must add a user.

1. From the Start menu, click Settings, then Control Panel, then Administrative Tools.

2. Double-click Local Security Policy.

3. Expand the Local Policies folder.

4. Click the User Rights Assignment folder.

5. Double-click Log on as Service.

6. In the Local Security Policy Setting dialog box, click Add.

7. In the Select Users or Groups dialog box, select the user and click Add.

8. Click OK, and then OK again.

9. Double-click Log on as Batch Job and repeat steps 6-8.

10. Reboot your computer after the user rights are added.

Verifying the Security Library

To verify that Oracle WebCenter Interaction security library is encrypting and decrypting passwords properly:

1. Go to the directory on the computer on which you installed Oracle WebCenter Interaction Content Service for Windows Files. The default installation location is: C:\Oracle\Middleware\wci\ptntcws\10.3.3.

2. Navigate to the bin\native directory, relative to the folder designated in the previous step.

3. Double-click the ptcryptotest.exe file. This file includes a test application used to test Oracle WebCenter Interaction encryption and decryption.

4. A console opens and prints the progress of encrypting and decrypting a password. If the test has finished successfully, the console displays Success! and asks the user to press ENTER to finish. Verify that Success! is displayed on the console, then press ENTER to close the test application.

Configuring Security for Document Discovery

You must configure security settings for the Oracle WebCenter Interaction Content Service for Windows Files. Portal users discover documents by browsing the Knowledge Directory and using portal search tools. In the portal, you manage document discovery with access control lists (ACLs) that are associated with portal directories.

If you want users to be able to browse files crawled into the portal from Microsoft Windows with a similar level of privilege they experience in the Microsoft Windows environment, you map the configuration for Microsoft Windows user privileges to the portal ACL Read privilege and ensure that their credentials are used for document access.

To configure security settings for the Oracle WebCenter Interaction Content Service for Windows Files:

1. Deploy an authentication source (for example, Active Directory) to manage Microsoft Windows users. For details, refer to Microsoft Windows documentation.

2. Create a remote authentication source in the portal to import the Microsoft Windows users. For details, refer to the portal's online help or the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Interaction.

3. Configure the Global ACL Sync Map to associate the Microsoft Windows domain name with the authentication source:

   1. Log in to the portal as an administrator.

   2. Click Administration.

   3. From the Select Utility menu, select Global ACL Sync Map.

   4. Click Add Mapping and choose the authentication source you created in step 2.

   5. In the Domain Name column, click the edit icon and enter the domain name of the Microsoft Windows users.

   6. Click Finish.

You will configure additional security settings in the Content Crawler Editor as described in Creating a Content Crawler.

Stay logged in to the portal for the next procedure.

Creating a Content Source

Create a content source to define the area of Microsoft Windows from which you want to import content. To create a content source, perform the following steps in the portal:

1. Open the Oracle WebCenter Interaction Content Service for Windows Files folder.

2. From the Create Object menu, select Content Source - Remote.

3. In the Choose Web Service dialog box, choose the Oracle WebCenter Interaction Content Service for Windows Files Web service.

4. Configure the content source as described in the online help.

Stay logged in to the portal with the Oracle WebCenter Interaction Content Service for Windows Files folder open for the next procedure.

Creating a Content Crawler

Create a content crawler to import content from the content source. To create a content crawler, perform the following steps in the Oracle WebCenter Interaction Content Service for Windows Files folder of the portal:

1. From the Create Object menu, select Content Crawler - Remote.

2. In the Choose Content Source dialog box, choose the content source you created in the previous procedure.

3. On the Main Settings page of the Content Crawler Editor, select Import security with each document. Configure the rest of the content crawler as described in the online help.

Stay logged in to the portal with the Oracle WebCenter Interaction Content Service for Windows Files folder open for the next procedure.

Creating a Job

To import content, you must associate the content crawler with a job and run the job. To create and run a job, perform the following steps in the Oracle WebCenter Interaction Content Service for Windows Files folder of the portal:

1. From the Create Object menu, select Job.

2. Click Add Operation.

3. Choose the content crawler created in the previous procedure.

4. Choose the scheduling values for the job and click Finish.

5. Name the job and click OK.

6. When you are finished creating the job, ensure that the Oracle WebCenter Interaction Content Service for Windows Files folder is associated with an Automation Service. For assistance, see the online help under Select Utilities, then Automation Service.

Advanced Configuration

This chapter provides instructions for editing advanced settings in the configuration file.

There are several advanced configuration settings that can be set in the configuration file Web.config. The default location is on the Oracle WebCenter Interaction Content Service for Windows Files host computer is C:\Oracle\Middleware\wci\ptntcws\10.3.3\Webapp\ntcws.

Note:

Only the parameters listed below should be changed in the Web.config file. Do not change any of the other parameters in the file.

1. Open Web.config in a text editor.

2. Oracle WebCenter Interaction Content Service for Windows Files keeps a log of errors and other information on the remote server. If a problem occurs with Oracle WebCenter Interaction Content Service for Windows Files, you might be directed by customer support to change the logging level from the default level of ERROR to DEBUG. To do so, find the text <level value="ERROR"/> and change the value to DEBUG: <level value="DEBUG"/>.

   Note:

   The default location of the log files on the remote server is: C:\oracle\middlware\wci\ptntcws\10.3.3\Webapp\settings\logs.

3. If you do not want to use basic authentication information passed in the Basic Authentication headers for Oracle WebCenter Interaction Content Service for Windows Files content sources, but would rather specify a particular NT domain user to impersonate, find the text <identity impersonate="false"/> and change the value to TRUE: <identity impersonate="true"/>.

   For more information on content source authentication, refer to the online help.

4. It is possible for crawl jobs that handle a very large number of documents to fail as a result of a session having timed out.

   When you run a crawl, there are two sessions that are created: one for crawling folders and one for crawling documents.The folder session remains inactive while the document session is used to crawl all the documents in the folder. If you are crawling a folder with a very large number of documents, the folder session might exceed the default IIS session timeout of 80 minutes. When the portal attempts to hit this session that has timed out, the job fails.

   If you encounter this problem, increase the IIS session timeout in Web.config and on the ntcws virtual directory in IIS. To increase the timeout value in Web.config, find the following text and increase the timeout value in the last line:

   <sessionState cookieless="false"
   mode="InProc"
   sqlConnectionString="data source=127.0.0.1;user id=sa;password="
   stateConnectionString="tcpip=127.0.0.1:42424"
   timeout="80"/> 
   

   Note:

   To avoid having a large timeout setting, we recommend that you modify your directory structure such that there are not folders that have a large number of documents in them.

5. Save the file and restart IIS for the changes to take effect.