Here are some quick troubleshooting solutions that can assist you in your installation and use of DocuShare 4.0. If you require additional assistance during your evaluation of a trial version of 4, visit the DocuShare Support Website or contact 1-800-735-7749. For general support assistance prior to purchase, contact 1-800-835-9013.

1. I completed the installation of DocuShare 4.0. But when I point my web browser to the DocuShare server, I get a HTTP 404 error.
2. The installation of DocuShare 4.0 stops soon after starting but there are no error messages.
3. During installation of DocuShare 4.0 I get an error message stating "Unable to configure target database".
4. DocuShare 4.0 installation fails due to "Not enough disk space" but the system has several gigabytes of free disk space available.
5. How do I license my DocuShare server?
6. How do I upgrade my DocuShare 2.2 server to 4.0?
7. Can I install DocuShare 4.0 into the same directory as DocuShare 2.2?
8. What languages are supported by DocuShare 4.0?
9. Does DocuShare run on Windows XP?
10. What databases can be used with DocuShare to store meta data?
11. Can I run DocuShare and Oracle or SQL Server on the same machine?
12. Does DocuShare use FTP and do I need to use IIS?
13. How do I scan to DocuShare from my Document Centre?
14. Does FlowPort work with DocuShare 4.0?
15. What versions of LDAP are supported by DocuShare 4.0?
16. Does DocuShare provide checking of documents and HTML before publishing them?
17. Will DocuShare 4.0 reveal the internal IP address of my server when sending Subscription Notifications or during communication with client applications such as Upload Helper?
18. Does DocuShare 4.0 have built in virus checking of the content?
19. Is there a Read Me File that tells me exactly what has changed?

1. I completed the installation of DocuShare 4.0. But when I point my web browser to the DocuShare server, I get a HTTP 404 error.

Make sure DocuShare has started.

Open a command prompt window, go to the <doushare-home>\bin directory and run start_docushare to start-up DocuShare. If you installed DocuShare to start as a Windows Service, use the Services Control Panel to start DocuShare.

DocuShare uses the Tomcat Web servlet. By default Tomcat uses port 8080. Point your web browser to
http://<your-server-FQDN-or-IPAddress>:8080/docushare.


2. The installation of DocuShare 4.0 stops soon after starting but there are no error messages.

The DocuShare installation program first installs Java Virtual Machine (JVM). After the Install Shield progress indicator for JVM disappears, the compressed files are unpacked and the installation completes. On a resource constrained system there may be a period of several minutes where there are no progress indicators or installation dialog windows open. Please allow time for JVM installation to complete. Also try closing all open windows, the DocuShare installation window may be behind them.

3. During installation of DocuShare 4.0 I get an error message stating "Unable to configure target database".

If DocuShare is using either Oracle 9i or SQL Server 8, the tablespace for DocuShare must be created prior to installing DocuShare. The exception to this is if SQL Server is already installed on the same system as DocuShare. In this configuration, DocuShare 4.0 will create the tablespace. When using the MSDE database bundled with DocuShare, the tablespace is created during the installation.

Verify that the correct database parameters were provided to the DocuShare installation program. These are:


1. Database User Name
2. Database User Password
3. Database Port
4. Tablespace Name
5. Database Host Name
6. Database SID (Oracle)
If MSDE or SQL Server were previously installed and uninstalled on the machine, entries in the Windows Registry may not have been removed. To prevent corrupting an existing database DocuShare will not install MSDE when the Windows Registry indicates an existing database. Use Windows RegEdit to remove entries left by previous installation of MSDE or SQL Server. Common locations in the registry where registry keys for MSDE or SQL Server can be found are:



HKEY_CURRENT_USER\software\microsoft\SQL or MS SQL and
HKEY_LOCAL_MACHINE\Software\Microsoft\.

MSDE cannot be installed when the installation is started via Windows Terminal Services or Remote Desktop. Start the installation of DocuShare at the local machine.


4. DocuShare 4.0 installation fails due to "Not enough disk space" but the system has several gigabytes of free disk space available.

Check the available disk space in the disk partition used by the system defined TEMP variable. The DocuShare installation program uses this directory for unpacking of files, etc., during installation. If the system's temporary directory does not have enough space, rerun the DocuShare installation program from a command prompt. Key in the command "docushare.exe -is:tempdir <path_to_temp_dir>, where <path_to_temp_dir> is the absolute path to a directory on a disk partition that contains at least 400mb of free disk space.

There is also a known problem with Microsoft's installation of MSDE recognizing available disk space. For information on working around this issue refer to:

http://support.microsoft.com/default.aspx?scid=kb;en-us;Q192139 and
http://support.microsoft.com/default.aspx?scid=kb;en-us;Q316046

5. How do I license my DocuShare server?

After installing and starting DocuShare 4.0, login in as the DocuShare Site Administrator using the Admin password supplied during installation. Click on the Admin Home link on the navigation bar. Using the menu on the Admin Home page navigate to Site Management - License. Copy the Server ID from the Server License Management page. Follow the instructions on the page for obtaining either a 30-Day Trial License or an unrestricted License if you purchased DocuShare 4.0. The license string will be sent to you by return email. Copy the license string from the email and paste into the License field on the Server License Management page.

6. How do I upgrade my DocuShare 2.2 server to 4.0?

Upgrading from DocuShare 2.2 to 4.0 is really a migration process. The user account, content, and meta data from your 2.2 server is migrated to the 4.0 server. This leaves your 2.2 server unchanged and allows you to validate the contents of the 4.0 server before making it available. The migration process can be accomplished with DocuShare 2.2 and 4.0 running on the same server or on two separate servers.

If DocuShare 4.0 is to be installed on the same machine as 2.2, select either the "Full DocuShare 4.0" or the "DocuShare 4.0 without the Scan Feature" during the installation process. These options include the Migration Tool (dsupgrade2.bat).

If DocuShare 4.0 was installed on a separate server from 2.2, run the DocuShare 4.0 installation program on the 2.2 server, selecting only the Migration Tool option. This will install all the files required for the Migration Tool to migrate data from your 2.2 server to the 4.0 over your Intranet. As part of the Migration Tool installation you will be prompted for the host name and RMI port of the DocuShare 4.0 Server. This is used to create the script used by the Migration Tool (dsupgrade2.bat).

Refer to the DocuShare 4.0 Installation Guide and the DocuShare Support Website for more details on using the DocuShare 4.0 Migration Tool.

7. Can I install DocuShare 4.0 into the same directory as DocuShare 2.2?

No, if you install DocuShare 4.0 on the same machine as 2.2 you must install into a different directory than your 2.2 installation. Installing into the same directory as 2.2 will corrupt your current installation and prevent migration of content to 4.0.

8. What languages are supported by DocuShare 4.0?

DocuShare supports International English, French, German, and Spanish, as well as Japanese (through Fuji Xerox in Japan). For more information please visit http://docushare.xerox.com/ds/langpacks.html

9. Does DocuShare run on Windows XP?

The DocuShare Server is supported on Windows Server 2000 with SP2 or greater and Windows Server 2003 with SP1.

Windows XP is a client desktop operating system; it is not designed for server workloads and performance. The DocuShare Windows Client applications (DSClient, DSOutlook Client, and PaperPort Link) are designed to run on Windows XP and provide integration of Windows Explorer, Microsoft Office, and the DocuShare Server.

10. What databases can be used with DocuShare to store meta data?

DocuShare 4.0 ships with MSDE for the Windows platform and PostgreSQL for the Solaris and Linux platforms. An Enterprise Database option is available to provide connections to Oracle 9i, 10g and Microsoft SQLServer 2000 servers.

11. Can I run DocuShare and Oracle or SQL Server on the same machine?

It is recommended that Oracle, SQL Server, and DocuShare run on their own dedicated server. The resource requirements for these server applications will cause poor performance and unpredictable behavior when sharing system resources.

12. Does DocuShare use FTP and do I need to use IIS?

DocuShare does not use the FTP service in Microsoft's Internet Information Service (IIS). DocuShare uses its own FTP service for the Scan-to-DocuShare option. If you do not plan to use the Scan option, select "DocuShare 4.0 without the Scan Feature" when installing DocuShare.

DocuShare can be configured to work with the Web server in IIS. If you want to use IIS as your front-end web server, choose the "Tomcat and IIS" option during installation. Using IIS web services allows you to use SSL, Windows Authentication, and other features of IIS.

13. How do I scan to DocuShare from my WorkCentre Pro or Document Centre?

Setup and configuration of Scan to File varies depending on the model of multifunction device. For specific information on setting up a Scan Repository and Scan Template, refer to your Document Centre documentation. The multifunction device setup will require the following parameters for the DocuShare server:

1. IP Address of the DocuShare Server
2. Directory Path (Either "/" or blank depending on model)
3. User Name (Any name will work since DocuShare's FTP does not authenticate the FTP login)
4. Password (This is optional. Using a password in the multifunction device repository login will require the same password to view the scanned document in the DocuShare Temporary Scan Repository)
14. Does FlowPort work with DocuShare 4.0?

Your FlowPort server must be on the most current version and service pack.

15. What versions of LDAP are supported by DocuShare 4.0?

DocuShare supports LDAP v.3 and has been tested with iPlanet/SunJava Directory Server and Microsoft Active Directory.

16. Does DocuShare provide checking of documents and HTML before publishing them?

DocuShare is initially configured for collaboration in a Workgroup/Departmental environment. This allows all user accounts the ability to immediately start adding content to the repository. There are DocuShare Administrator options that can restrict read/write/manage permissions to individual users or groups.

DocuShare is designed for storing of content from any source and does not check the validity of the content. DocuShare 4.0 includes a Document Approval and Routing feature that can be used for review and approval of documents by other DocuShare users. Document routing is also a collaborative tool and does not check for validity.

17. Will DocuShare 4.0 reveal the internal IP address of my server when sending Subscription Notifications or during communication with client applications such as Upload Helper?

DocuShare includes the host name of the server in the URL sent with Subscription Notifications and when communicating with client applications. It is recommended that the DocuShare server be configured using a fully qualified DNS name (FQDN). If an IP address must be used instead of a FQDN, the DocuShare host name should be configured with a static IP address during installation. The external address should be one that is reachable by all intended users. The DocuShare Upload Helper is not supported in DocuShare 4.

18. Does DocuShare 4.0 have built in virus checking of the content?

No, DocuShare does not ship with virus scanning software. Virus scanning software must be provided, installed and configured according to your organization's security policies. Customer Support has made available some tips on configuring virus scanning software to minimize the performance impact to DocuShare. Visit the DocuShare Support Website for more information.

19. Is there a Read Me File that tells me exactly what has changed?

A PDF of the Read Me File is available for download. (PDF, 222Kb)