Xerox DocuShare Support & Software Installation Guide

DocuShare on a Linux platform

Upgrade DocuShare

DocuShare Installation Guide

4–5

A DocuShare upgrade utility is included with the software install Wizard. The utility can take sites as low as 
v5.0.3 and upgrade them to the current version of DocuShare.

The DocuShare installer records all initial installation activity and stores it in DocuShareInstallLog.txt in 
the /tmp directory of your server. After the installer has created the DocuShare directory, it creates a 
second DocuShareInstallLog.txt file in the home directory where it stores the remaining installation 
information. To save the initial DocuShareInstallLog file, start the installation process in a command prompt 
window by entering the command: ./docushare -P docushareLog.cleanUp=false.

Before you start the upgrade procedure


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

9. Click Apply.



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. Run the command idoltool.sh -s export <exportdir>.



Backup the site database