Note: This solution applies to DocuShare 4.x, 6.01.x, 6.5.x and 6.6.x.
Note: It is the administrator’s responsibility to make the hostname changes on the DocuShare Server’s Operating System.
Note: It will not be necessary to obtain a new license key after changing the DocuShare server’s hostname.
Warning: If using the Scan Cover Sheet functions of DocuShare (Glyphscan) and you change any of the following information DocuShare Server’s IP Address or Hostname, HTTP Protocol, HTTP Port and/or DocuShare Root it may require you re-create all the scan cover pages. The dataglyph that is located on the bottom of a scan cover sheet has information regarding your server’s URL.
Changing the old Hostname Entries used by DocuShare to the new Hostname information. (If applicable)
Note: The steps below will also need to be followed even if you have only changed the hostname of the Database server. However, the only entry that will need to be changed in dssetup will be the Database Host [ServerName] entry. All other entries will remain the same.
From the DocuShare Server,
1. Open a command prompt window and change into the \bin directory.
Where is replaced with the installation path to DocuShare. The default installation path is C:\Xerox\Docushare. Depending on your installation environment the path may vary.
2. From the bin directory type dssetup.
3. Change any of the values that refer to the old hostname on your DocuShare Server to the new hostname value and then save your changes.
Note: If your DocuShare database is on a different server than DocuShare and you have not changed its hostname, then do not modify the Database Host [ServerName] entry in dssetup. Only modify the other hostname entries to the new hostname.
Bridging to IIS or Apache (Web Page Access) (if applicable)
Changing the Hostname of the server will affect how you access the DocuShare webpage. To access DocuShare you will now need to access it via the new hostname or Fully Qualified Domain Name (FQDN). If you have problems try accessing DocuShare using localhost or 127.0.0.1 instead of your hostname.
You may need to make modifications to your $DSHOME/tomcat/conf/ntiis/uriworkermap.properties file because when you run dssetup (in the steps above) it overwrites the uriworkermap.properties file with the new hostname information but does not include any additional information you may have manually placed in the file such as an IPAddress.
Note: The uriworkermap.properties file contains a list of addresses to be redirected from IIS to DocuShare, if you require more information on how to modify this file please refer to the DocuShare Knowledge Base or contact technical support for DocuShare.
Note: If DocuShare is bound through IIS or Apache to a particular Hostname then you will need to make modifications to IIS or Apache to access DocuShare via IIS.
Note: A workaround is to access DocuShare directly using the Hostname and port 8080 if Tomcat is enabled. Example http://hostname:8080/docushare
Solution Updated: July 27th, 2012
Solution ID: 281