Setting the external server URL
There are times when a device needs to connect to a link sent by the server. For example, downloading client files, web page URLs, and Apple encrypted mail retrieval. To make sure that the server sends an appropriate link that the device can use, you must first set the External Server URL field on the HCL Traveler tab in the Server document.
This URL sets the HCL Traveler servlet URL as the URL through which to perform all HCL Traveler transactions and data synchronization. This value should be a URL that HCL Traveler users can always access, whether on an internal network or the internet, and should not change.
If there is a reverse proxy in use, the URL should be set using this reverse proxy name. If there is a DNS name or IP that is used to route external traffic to the HCL Traveler server from the internet, the URL should be set using this DNS name or IP address.
This field should specify the complete path to the Traveler servlet,
including http://
or https://
, any
port numbers if non-default values are in use, and should end in /traveler
.
https://traveler.hcl.com/traveler
notes.ini
with the parameter NTS_EXTERNAL_URL
. For example:
NTS_EXTERNAL_URL=https://traveler.hcl.com/traveler
:80
or :443
port, then
the port number must be in the URL. For
example:NTS_EXTERNAL_URL=http://traveler.hcl.com:8080/traveler
NTS_EXTERNAL_URL=https://traveler.hcl.com:8443/traveler
NTS_EXTERNAL_URL
is added to or changed in notes.ini
,
restart the HCL Traveler task to make the change effective. NTS_EXTERNAL_URL
parameter in notes.ini
will take
precedence over the external server URL field in the Server document.{
"appConfiguration": {
"databases": [
{
"filePath": "names.nsf",
"action": "update",
"documents": [
{
"action": "update",
"findDocument": {
"Type": "Server",
"ServerName": "CN=servername/O=orgname"
},
"items": {
"tsExternalURL": "https://travdocker.example.com/traveler"
}
}
]
}
]
}
}
For this document editing to work, findDocument must resolve to exactly one document. Within it, ServerName must be in canonical format.