Installation and User Guide - Fishbowl Solutions

Fishbowl Solutions
Duplicate File Report for
Oracle WebCenter Content
Installation and User Guide
Version 1.0

Copyright
Copyright © 2012 Fishbowl Solutions, Inc. All rights reserved.
Limitation of liability
This document is provided “as-is”. Information expressed in this document, including URL and
other Internet Web site references, may change without notice. You bear the risk of using it.
Some examples depicted herein are provided for illustration only and are fictitious. No real
association or connection is intended or should be inferred.
Intellectual property
This document does not provide you with any legal rights to any intellectual property in any
Fishbowl Solutions, Oracle or Microsoft product.
You may copy and use this document for your internal, reference purposes.
Trademarks
Fishbowl Solutions is a trademark of Fishbowl Solutions, Inc.
All other trademarks are property of their respective owners.
Warranty disclaimer
Fishbowl Solutions disclaims any warranty regarding the samples contained in this documentation,
including the warranties of merchantability and fitness for a particular purpose.
License agreement
Use of this product is covered by a license agreement provided with the software product. If you
have any questions, contact Fishbowl Solutions Customer Support either by email at:
support@fishbowlsolutions.com or by phone at: (952) 465-3407.
Publication Date
September 2012

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
Table of Contents
Chapter 1: Product Overview ......................................................................................................... 4
Purpose of Duplicate File Report .......................................................................... 4
How it Works ................................................................................................................. 4
Product Features .......................................................................................................... 4
Chapter 2: Installation ..................................................................................................................... 5
Installation Requirements .......................................................................................... 5
Before You Begin ............................................................................................. 5
Supported Environments ............................................................................... 5
User Permissions ............................................................................................. 5
Installing the Component ........................................................................................... 5
Installation Steps ............................................................................................. 5
Chapter 3: Using the Duplicate File Report Component ....................................................... 7
Accessing the Report ................................................................................................... 7
Generating Report Data ............................................................................................... 7
About Duplicate File Report Generation ..................................................... 7
Running the Report .......................................................................................... 7
Cancelling & Restarting the Report ............................................................. 9
Interpreting the Results on the Duplicate File Report Page ................ 10
Deleting Report Data ...................................................................................... 11
Chapter 4: FAQ ................................................................................................................................. 12
Chapter 1: Product Overview 3
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
Chapter 1:
Product Overview
Purpose of Duplicate File Report
Many Oracle WebCenter customers suspect they have duplicate files, but lack an objective means
for evaluating the quantity of duplicates in the Content Server. Fishbowl Solutions’ Duplicate File
Report for Oracle WebCenter Content ® offers customers a tool for evaluating the amount of
duplicate content within their system. Removing duplicates from your repository can reduce
storage costs and increase the data integrity of your Oracle WebCenter Content system. The
component provides data on both the number of duplicate files within the Content Server as well
as the amount of disk space occupied by those duplicates.
If an issue exists, Fishbowl Solutions offers a number of products to address duplicate file
concerns. Once the amount of duplicate content is identified, these tools can be used to identify
which files are duplicates, remove duplicate content, and do incremental duplicate checks. To learn
more about these products contact Fishbowl Solutions at sales@fishbowlsolutions.com visit our
Duplicate File Checker page on the web or search keyword “duplicate” on www.fishbowlsolutions.com.
How it Works
The Duplicate File Report component retrieves each file in the Content Server, generates a
checksum, and stores the checksum in a custom database table which is automatically created by
the component. The component will process every revision of each content item stored in the
Content Sever when checking for duplicates and return the report data on the Duplicate File
Report page.
Product Features
Fishbowl’s Duplicate File Report component includes the following features:
●
●
●
●
●
Processes all revisions in the Content Server to check for duplicates
Displays the total number of duplicate files
Displays the total amount of filesystem space that could be reclaimed if duplicate files were
removed
Displays the number of items processed and the report’s start and end times
Allows the report generation process to be stopped and resumed as needed
Chapter 1: Product Overview 4
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
Chapter 2: Installation
Installation Requirements
Before You Begin
Before proceeding, you will need the following:
●
●
●
Fishbowl Duplicate File Report component: DuplicateFileReport.zip
This documentation
Oracle WebCenter Content version 10g or 11g
Supported Environments
The Duplicate File Report component is supported on the following environments:
●
●
●
●
Oracle Content Server - version 10g & 11g
Any Oracle-supported Operating System
Any Oracle-supported Web Server
Oracle Database 10g+ or Microsoft SQL Server 2005+ Databases
User Permissions
In order to complete the installation you will need the following:
●
Administrator access to Oracle WebCenter Content
Installing the Component
The component is installed on the Content Server using the standard component installation
process. These steps should be repeated for every instance of Oracle WebCenter Content which
you wish to check for duplicate files. After installing the component, you will need to restart the
Content Server.
Note:
Installation Steps
We suggest that you first install and run the Duplicate File Report component in your
development environment to ensure there aren't any conflicts with other
components before running it in production.
1.
2.
3.
4.
5.
6.
7.
Log into the Content Server using an administrator account.
Select Administration from the main menu, the select Admin Server.
When the server status screen appears, click on the button that shows the server instance
name. This name will vary based on you particular installation.
Access the Component Manger page:
On UCM 10g: Select the Component Manager on the left.
On WebCenter Content 11g: Select Component Manager on the left, then select advanced
component manager.
On the installation screen, browse to the DuplicateFileReport.zip file and select the Install
button.
Click Continue when prompted.
Read the displayed License Agreement and select Continue to accept it.
Chapter 2: Installation 5
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
8.
Select the option to enable the component.
This completes the component installation. You will need to restart the Content Server in order for
the changes to take effect.
Chapter 2: Installation 6
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
Chapter 3: Using the Duplicate File Report Component
Accessing the Report
The Duplicate File Report page is located under the Administration menu and is only available to
administrators. To access the page, select Administration > Duplicate File Report.
Generating Report Data
About Duplicate File Report Generation
When the Generate Report Data link is clicked, the duplicate file report generation process is started.
During processing, the component retrieves each revision of every item in the Content Server,
generates a checksum for that item, and stores that value in the database. This process may take a
significant amount of time and impact system performance so it is recommended that you run the
report during off-hours.
The amount of time for the report to complete is highly dependent on the number and size of the
files in the Content Server. Report generation took approximately 7 hours to process 70,000 1MB
files.
If the component loses connection to the database during processing, report generation can be
resumed from the Duplicate File Report page, once connection is re-established.
Running the Report
1.
2.
Navigate to the Duplicate File Report page
Select the Generate Report Data link
Chapter 3: Using the Duplicate File Report Component 7
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
3.
Select OK to continue.
4.
To check the status of the report, refresh to page. The report information, including the
number of files processed and the duplicate file data, is updated as the report runs. You
may close the window and the report will continue to process.
5.
When the report generation process is complete, the Complete status will appear in the
Report Generation Summary box and the results of the report will appear under the Duplicate
Files heading.
Chapter 3: Using the Duplicate File Report Component 8
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
6.
To run the report again, select Regenerate Report Data.
Cancelling & Restarting the Report
The Duplicate File Report component allows you to start and stop the report generation process as
needed.
1.
2.
To stop the report generation processes at any time during processing, click Cancel.
Click OK to proceed with cancellation.
Note:
Because the component processes files in batches, there is a small delay
before the reporting process stops. A Cancel Pending status is displayed while
the current batch finishes processing after which a Cancelled status will appear
in the Report Generation Summary box and report processing will terminate.
3.
To start the reporting process after cancellation, select one of the following options:
A.) To resume reporting where you left off, select Resume.
B.) To start the reporting process over, click Regenerate Report Data.
Chapter 3: Using the Duplicate File Report Component 9
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
4.
After selecting one of the above options, report generation will continue as usual.
Interpreting Results on the Duplicate File Report Page
Once complete, the Duplicate File Report provides the following information:
Duplicate Files
Total number of duplicate files found on this server
This value indicates the number of duplicate files found on the Content Server. For example, if
there were 3 identical copies of june_expense_report.docx the total number of duplicates would be 2.
Total amount of filesystem space that could be reclaimed if the duplicates were removed
This value indicates the total amount of disk space the duplicate files occupy. For example, if each
of the 3 copies of june_expense_report.docx occupied 1MB, the total space that could be reclaimed is
2MB.
Report Generation Summary
Report Status
Report Status shows the current status of the duplicate file report generation process.
Possible values include:
●
●
In Process - The report is currently being generated.
Cancelled - The report was started and then cancelled before completion.
Chapter 3: Using the Duplicate File Report Component 10
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
●
●
Cancel Pending - The report was cancelled and is processing its current batch of files,
before cancellation will take effect.
Completed - The report generation process is complete and all files were evaluated.
Report Started
Date and time the report generation process was last started. If the report has never been
generated or the report data has been purged, no value will be displayed.
Report Completed
Date and time the report generation process was last completed. If the report has never been run
to completion or the report data has been purged, no value will be displayed.
Total Files Processed
When the report generation process is running, this field will display the number of files that have
been processed and the total number of files to be processed – for example, 518 out of 6,852. To
update this value, refresh the page.
When report generation is complete or cancelled, this field will display the number of files which
were processed – for example, 6,852.
Deleting the Report Data
1.
To remove all report data from the Duplicate File Report page and checksum values from
the database, select the Purge Report Data link at the top of the Duplicate File Report
page.
2.
Select OK, to remove all report data.
Note:
The Purge Report Data link only deletes the Duplicate File Report information; it
does not delete the duplicate files themselves.
Chapter 3: Using the Duplicate File Report Component 11
©2012 Fishbowl Solutions, Inc.

Duplicate File Report for Oracle WebCenter Content
Installation and User Guide
Chapter 4: FAQ
How do I get rid of duplicate files
The Duplicate File Report component is a tool for evaluating the amount of duplicate content
within the Content Server. It does not provide a means for identifying which items are duplicates or
selecting duplicate items for deletion. These features are available in Fishbowl Solutions’ Duplicate
File Checker product.
Does the Duplicate File Report evaluate new items when they are added to the
Content Server
No, the report only evaluates files that are in the Content Server at the time the report data is
generated. If you add new files to system you must regenerate the report for them to be included
in the report data.
If you are interested in incremental or on-checkin duplicate file detection, please contact Fishbowl
Solutions for information about Duplicate File Checker.
What counts as a duplicate
The Duplicate File Report component only counts identical files as duplicates. It does not include
near-match files within the duplicate file report totals. For near-match reporting functionality
contact Fishbowl Solutions about Duplicate File Checker which provides checks for near-matches
in addition to identical duplicates.
How do I uninstall the Duplicate File Report component
To uninstall the component, go to the Component Manager page within the Content Server. Select the
component from the list of installed components and select Uninstall.
It is recommended that you click the Purge Report Data link from the Duplicate File Report page
before you uninstall the component in order to remove any existing checksums and report data
from the database.
Chapter 4: FAQ 12
©2012 Fishbowl Solutions, Inc.