CS Export Project Details screen
The CS Export Tool Project Details screen (shown below) is where you set the CS Export
Tool's configuration parameters.
The user enters the following information:
- The name of the project.
- Login information for the CS database, including the database name, user name and password, and the name of the server where the database is located. The database name must correspond to a previously created ODBC DSN. The user specified must have full read access to the source CS database.
- The shelf drive letter is mapped to the shelf location where the CS content files are located. This mapping must be to the root of the drive where CS Shelf Files are located. This must be performed by the user prior to running the tool. You can use Windows Explorer to map a network drive to the shelf location.
- The timeout value for queries to the CS database. This value defaults to 30 seconds, but might need to be increased for large CS databases.
- Information about the target object store where the CS data will be added.
- The name and location of the Master log file. The tool writes error, warning, and informational messages to this file.
- Information about the export phases to perform and log files to be written:
- The user enables running the Metadata and Folders, Documents and Versions phases by checking the appropriate boxes. The tool provides default name for the log and restart files that can be changed by the user. When the user clicks the “…” button next to a file name, the tool displays a screen where the user can navigate to a new folder location.
- Creating the log file for the Folders, Documents and Versions phase is optional and is disabled by default. Enabling the log file for this phase can significantly affect the performance of the tool. The user also can modify the number of threads and batch size used in this phase. Generally, a relatively low batch size and a high number of threads provide the best performance. The default for these values is a batch size of three with 30 threads.
- The user will have no ability to change the name or location of the restart file. It will be located in the same directory as the export projects configuration file and have a name that is derived from the project name in the following manner. If the project name is MyProject then the restart file will be name MyProject-Restart.rst.
- Information about the documents to be migrated. The user specifies the number of versions, whether searches will be migrated, and whether offline versions will be included by checking appropriate boxes on the left side of the screen. Currently, saved searches are migrated as documents and are not converted to Workplace saved searches.
Other information for running the tool:
When the Dry Run check box is selected, the tool checks for errors in the CS data and writes to the log files, but does not write any information to the Content Engine object store. This feature is intended to be used to correct errors in the source CS data prior to running the actual migration.
If the source CS database is Oracle, the Source database is running Oracle™ check box must be selected. This causes the tool to execute slightly different SQL commands when communicating with an Oracle database.
Selecting the Display warnings for shelves not found check box causes the tool to pause during the Folders, Documents and Versions phase and display a warning if any CS shelves are not found on the mapped drive. When this check box is cleared, the tool continues when this situation is encountered and writes a message to the Master log file.
When Save Changes is clicked, the tool checks for the existence of the User/Group Security Mapping file. If this file does not exist, the tool displays a warning message to that effect. The tool then saves the information displayed to the project’s .ini file and closes the screen. Clicking the Close button causes the screen to be closed without saving changes.
IMPORTANT If the user running the CS Export Tool is not a member of the Content Engine Servers group, an error message is displayed when the tool fails to log into the Windows Content Engine domain when opening the Project Details screen. If the user is added to the Content Engine Servers group, you must stop and restart all Content Engine services and log-off and log-on, on to the server.
Use the CS Export
settings worksheet to gather the required information to run the CS Export Tool. The project details screen is shown below:

CS Export Project Details screen