How to upgrade to DocuShare 7.6 (In-place upgrade)

Note: This solution is for in place upgrades only.

Note: This is NOT the process for a migration to a new server. A migration to a new server would involve the installation of Solr and a subsequent full reindex of the site.

Note: DocuShare 7.0 sites running IDOL are updated to DocuShare 7.6 with IDOL. If you want to upgrade from IDOL to Solr, please contact customer support.

Note: The information in this KB article can also be found in the DocuShare 7.6 Installation Guide.

System requirements review
Before making any DocuShare upgrades, review the system requirements for the upgrade version, and make sure your server meets those requirements. Look carefully at the operating system, database, web server, memory, and disk space requirements for the upgrade.
The paths for update from various software version include:
 

• The DocuShare system must be at DocuShare 7.0 Update 1 Patch 3 (DS7Update1p3) to update the system to DocuShare 7.6.
• If you are upgrading from DocuShare 6.6.1 R2 or 6.6.1 Update 2 or later, you must first upgrade to DocuShare 7. Then update DocuShare 7 to DocuShare 7.0 Update 1 Patch 3 (DS7Update1p3).
• If you are upgrading from DocuShare 6.5.3 or earlier, upgrade to DocuShare 6.6.1 R2 before upgrading to DocuShare 7. Then update DocuShare 7 to DocuShare 7.0 Update 1 Patch 3 (DS7Update1p3).

• A day prior to upgrading the site, inform users that the site will be down

1. Go to Site Management l Site Operations.
2. In the Admin Message field, enter a message telling users when the site will be unavailable and for how long; then select Yes in the Show Admin Message field.
3. Click Apply.

• Review the information required for DocuShare software installation presented in Chapter 1. Record all your current configuration settings so you can enter them in the upgrade Wizard windows.

• From the Administration menu, click Site Management | License. On the License page, locate and write down the Host ID number of the server.

• Stop all automated or programmatically generated activities; especially those that use the Content Intake Manager, Content Rules, or Scan to DocuShare services.

• Close site access

1. Log into the DocuShare site as admin.
2. Go to Site Management l Access Policies.
3. Set the Site Access Authority to Administrator, then click Apply.
4. Go to Site Management l Site Operations.
5. In the Admin Message field, enter a message telling users that the site is going down in ten minutes, select Yes in the Show Admin Message field, then click Apply.
6. After ten minutes, enter the message DocuShare is currently in read-only mode in the Admin Message field.
7. In the System Mode field, select Read Only.
8. In the Show Admin Message field select Yes.
1. Click Apply.

• Close all Windows applications that are currently open on the server.

• Backup the IDOL database

1. Make sure the target directory exists and is empty before starting backup. The target directory is represented as <exportdir> in the command.
2. Open a command prompt window (Windows) or terminal window (Linux/Solaris)
3. Change into the <dshome>\ bin directory, where <dshome> is replaced with the installation directory for DocuShare. The default installation directory is C:\Xerox\Docushare. Depending on your installation environment the path may vary.
4. Run the following command: idoltool.bat –s backup <path_to_backup_directory>, where <path to backup directory> is replaced with the path to the backup folder. For a backup folder: D:\content_backup, the command would be: idoltool.bat –s backup D:\content_backup

• Clear the event queue

1. Go to Site Management l Site Operations.
2. In the System Mode field, select Read Write and select No in the Show Admin Message field; then click Apply.
3. Go to Services and Components | Subscription.
4. Set the Weekly Notification Day to the current day of the week and set the Weekly Notification Hour and Weekly Notification Minute to five minutes from the current time; then click Apply.
5. Wait ten minutes before proceeding with the upgrade.

• Stop DocuShare via Services or command line depending on your installation. You must have Windows local server administrator account.

• Backup the site database

1. In your database server manager, stop the database.
2. Perform a system backup of your DocuShare site.
3. When the backup is finished, start the database.
4. The database must be running for the DocuShare Installer to upgrade the database schema.
5. If you are using a Microsoft SQL Server database, run exec sp_fulltext_database enable on the server to enable full text search.

1. Download the DocuShare software to a temporary directory on your server. Unzip and extract the file locally to the system.
2. Upgrade the system by one of two ways:

• Open the file and locate docushare.exe. Right-click docushare.exe and select Run as Administrator.
• If you want the installer to save all configuration and upgrade data, start the upgrade in a command prompt window by entering the command line: docushare.exe -P docushareLog.cleanUp=false.

3. Be patient; it takes several minutes before the system displays the first install Wizard screen.
4. When the Upgrade Option window appears, select the appropriate Upgrade.  Be patient; it takes several minutes for the system to load and start the installer.

5. Follow the onscreen instructions; accept the defaults or enter your own configuration information.

1. When the upgrade successfully completes, click Finish to close the installer.
2. Reboot the server.
3. After the server restarts, if you did not set DocuShare to run as an AutoStart service, do the following:

• In the Administrative Tool, in the Services application, select and start the DocuShare service.

4. If the DocuShare site uses LDAP over a secure SSL channel, you need to import the SSL certificate into in $DSHOME\jdk\lib\security\cacerts. For example, in the case you use your own self-signed certificate. Instructions for importing the LDAP SSL Certificate are in the LDAP Active Directory Guide that is located on the Help page of your DocuShare site.
5. The DocuShare Installer stops the IIS service during the upgrade and restarts it at completion. If the installer does not restart the IIS service, open the IIS console, and restart the service.

1. Use a browser to connect to your newly upgraded site and login as admin.
2. From the Administration menu, click Site Management | License.
3. On the License page, locate and write down the Host ID number exactly as displayed.
4. Follow the instructions that Xerox® DocuShare provided to obtain a site license string.

5. When you have the license string, return to the Site Management | License page and enter the string in the License field.

1. Run database optimization as defined in the DocuShare Administrator Guide database optimization procedures.
2. Refer to the DocuShare VDF Reference Guide to migrate your custom VDFs to the current DocuShare release.
3. If you changed the Subscription Notification settings to clear the event queue, go to the Services and Components | Subscription administration page and return the Weekly Notification Day, Hour, and Minute to their values prior to the upgrade.
4. Go to Site Management l Access Policies.
5. Return the Site Access Authority to the pre-upgrade setting, then click Apply.