When the User Receives a notification email the URL link that is displayed in the body of the email has the wrong http protocol, server name, and/or port number displayed.
For Example: http://servername:8080/docushare instead of http://servername/docushare (In the example provided the port number is displayed incorrectly).
Note: When clicking on the incorrect link, the User is often required to login again even though they were already logged in to the correct link. Example:Error! Hyperlink reference not valid.
Reason / Possible Cause
During a DocuShare installation if port for SSL (443) is not configured in the first installer screen but HTTPS is selected in the second installer screen they will have incorrect information populated in the DocuShare Configuration files (amber.properties) and when subscriptions/notifications are triggered they point to the non SSL port.
Solution
Note: This solution applies to DocuShare 4.x, 5.x and 6.0.x, 6.1.x, 6.5.x and 6.6.x.
Note: You must be a Windows Administrator to perform this solution.
Note: This solution requires that you stop DocuShare.
Method 1: Use dssetup command (Preferred Method)
1. Stop DocuShare.
2. Open a Command Prompt window.
3. Change into the \bin directory.
4. Type dssetup and press Enter.
5. When prompted Would you want to update the configuration? [yes] ? type Y and press Enter.
6. Press Enter to accept the default settings until you are prompted with Subscription port number [8080] ?
7. Enter the appropriate port for your environment.
8. When prompted for the Overall HTTP Protocol Types
0). http
1). https
9. Type the appropriate number for your environment and press Enter.
10. Press Enter to accept the defaults until you reach the Are you happy with your configuration [yes] ? then type Y and press Enter.
Note: If you miss any of the prompts by mistake or make a choice that is incorrect you can rerun dssetup again and make appropriate settings changes again.
Method 2: Manually modifying the subscription.properties file
Note: This option should only be used under the direction of the DocuShare technical support staff.
1. Stop DocuShare.
2. Open Windows Explorer.
3. Browse to the Xerox\Docushare\config directory.
Where is replaced with the installation directory for DocuShare. The default installation path is C:\Xerox\Docushare. Depending on your installation environment the path may vary.
4. Make a copy of the amber.properties file and name it amber.properties.bak.
5. Open the amber.properties file in a text editor such as NotePad.
6. Search for http_protocol=entry (the default value is http).
7. If applicable, change the value from http to https (this value will only need to be changed if you access DocuShare over SSL).
8. Search for the http_port= entry (the default value is 8080).
9. If applicable, change the value from 8080 to 80.
10. Search for the http_host= entry.
11. If applicable, change this host value to the hostname you would like displayed in the URL link provided in the body of the email notification DocuShare sends.
Note: If you change the http_host value. The new value must be a hostname that Tomcat and IIS can resolve.
12. Save the changes that were made to the amber.properties file.
13. Start DocuShare.
14. Test the notifications, they should now display the proper URLs.
Note: Verify that the link that is included in body of the email notification works properly when you click it.
Solution Updated: November 2, 2016
Solution ID: 360
Keywords: Subscription Port
Notification Port
Change Default Port