Note: This applies to DocuShare 6.x,6.6.x and 7.x
Note: It is the administrator’s responsibility to make the IP Address changes on the DocuShare Server’s Operating System.
Note: Running the command start_docushare env will display the hostname or IP address used by DocuShare. If the IP Address information is displayed when running this command, then you are not running using the FQDN or Hostname and that will need to be considered when making your IP Address Changes.
Note: It will not be necessary to obtain a new license key after changing the IP Address.
Things to Consider:
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.
DocuShare
DocuShare should still work fine after an IP Address change, because DocuShare by default points to a Fully Qualified Domain Name and/or Hostname in its settings. It may take an extra minute or two when restarting for the first time to detect the new settings, but once the new settings are detected then it should be ok.
· Verifying if DocuShare is using the current IP Address
From the DocuShare Server,
1. Open a Command Prompt window. When opening, right-click and select Run as Administrator.
2. Change into the \bin directory.
3. Type start_docushare env and press Enter.
4. This will display the Fully Qualified Domain Name (FQDN), Hostname or IP Address that DocuShare is running under.
Note: If you see the IP Address of the DocuShare server displayed, then you will need to run dssetup from the command prompt window in the \bin directory after changing the DocuShare server’s IP Address to reflect these IP Address changes. The changes would be made to the Host DNS name [Fully_Qualified_Domain_Name] entry and RMI host [ServerName] entry of dssetup.
Database
Note: The information provided below assumes that you are changing the IP Address on the Database Server or both DocuShare and the Database if they reside on the same Server.
MSDE or SQL
Changing the IP Address in MSDE or SQL should not have an effect because they are based on hostnames not IP Addresses.
Postgres
If DocuShare connects to Postgres for the database, you may need to modify the pg_hba.conf file with the updated IP address information so that DocuShare can connect to the Database engine. (This will depend on your installation environment)
Bridging to IIS or Apache (Web Page Access)
Changing the IP Address of the server should not affect accessing your webpage for DocuShare. If you have problems try accessing DocuShare using localhost or 127.0.0.1 instead of your IP Address.
Note: You may need to make modifications to your $DSHOME/tomcat/conf/ntiis/uriworkermap.properties file to include the new IP Address. (This file contains a list of addresses to be redirected from IIS to DocuShare)
If DocuShare is bound through IIS or Apache to an IP Address, 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 IP Address and port 8080 if Tomcat is enabled. Example http://IPaddress:8080/docushare
Solution Updated: June 9, 2020
Solution ID: 277