Professional Documents
Culture Documents
WiseCloud Connectivity and Troubleshooting Guide
WiseCloud Connectivity and Troubleshooting Guide
WiseCloud Connectivity and Troubleshooting Guide
Contents
1. Introduction ...................................................................................................................................................... 2
1.1 Overview of the CargoWise Cloud connection process .............................................................................. 3
2. Install and launch the CargoWise Cloud Client Application ........................................................... 4
3. Log in to the CargoWise Cloud Client Application Servers ............................................................. 4
4. Launch CargoWise .......................................................................................................................................... 6
5. Additional technical information .............................................................................................................. 8
5.1 IP Address Filtering ................................................................................................................................................................... 8
5.2 Port requirements ..................................................................................................................................................................... 9
5.3 Proxies ............................................................................................................................................................................................... 9
5.4 RDG HTTP methods ................................................................................................................................................................. 9
5.5 CDN failsafe ................................................................................................................................................................................... 9
5.6 NTLM authentication level setting .............................................................................................................................. 10
6. Troubleshooting ..............................................................................................................................................12
6.1 Overview of the troubleshooting process ............................................................................................................ 13
6.1.1 Example 1: unable to connect to CargoWise Cloud Client Application ........................... 14
6.1.2 Example 2: Frequent disconnection from the CargoWise Cloud Client
Application ................................................................................................................................................................................... 16
6.1.3 Example 3: Slow response times while using the hosted application .............................. 18
7. Appendix .......................................................................................................................................................... 19
7.1 Locate the CargoWise Cloud DNS gateway ........................................................................................................ 19
7.2 PsPing Test Instructions ....................................................................................................................................................20
7.3 Traceroute Test and DNS lookup Instructions ....................................................................................................21
7.4 Proxy recommendations for Cargowise Cloud client software .............................................................21
7.5 WinMTR test ............................................................................................................................................................................... 22
7.6 CargoWise Cloud DNS lookup recommendations ........................................................................................ 22
At a high level, there are three discrete phases to setting up and running the CargoWise Cloud
hosted environment:
This document details the technical and connectivity information for each phase, and
corresponding troubleshooting tips for each. It also outlines several brief troubleshooting steps
for some common network connectivity and performance issues that may occur while using the
CargoWise Cloud Client Application.
We recommend that your IT administrators and technicians review this document and assist with
gathering information that will either help to solve or provide the support team with details to
investigate further. We also recommend your IT administrators and technicians ensure that user
workstations have the latest windows updates applied to ensure any problems from lack of
updates or version issues are eliminated.
Before you start, it is recommended you understand documents and how eRequest
Incidents are created. For more information refer to:
Stage 1
CargoWise Cloud
Client Applicaiton
installed on
workstation or
terminal server
environment
Stage 2
CargoWise Cloud
successfully
launched
Stage 3
The correct
credentials are
entered
Stage 4
CargoWise Cloud
client uses Microsoft
remote desktop
connection over
https/433 port to
successfully connect
to one of the
CargoWise Cloud
Gateways
Stage 5
Successfully
logged into the
CargoWise hosted
application
Click here to access the CargoWise Cloud Client Application installer file.
Click here for a detailed Installation Guide for the CargoWise Cloud Client Application.
For most customers, this step is a case of simply downloading and running the installer file. For
large scale enterprise distribution, the installer can also be extracted as an MSI package. Further
information on how to deploy using the MSI format are included in the Installation Guide.
The CargoWise Cloud Client Application installation process must be run as a local administrator
for the initial installation. Once this has been completed it can be run by a non-administrative
user account. If you have any difficulty installing or launching the CargoWise Cloud Client
Application software, please refer to the technical notes in the Installation Guide.
Enter the login Username and Password here, then click on the Login button. The WCA Client
Application will attempt to contact the WCA Application Servers. It will also retrieve a list of
applications where access has been authorized.
• lonwca.wisegrid.net
• ordwca.wisegrid.net
• sydwca.wisegrid.net
• de1wca.wisegrid.net
It is important that all four of these hostnames can be connected to. Any of these servers can be
used to authenticate the login user and provide the list of applications that are permitted for
access. Allowing access to all three of these destinations provides geo-redundancy for this
component and ensures the highest possible level of uptime.
If this step is successful, a set of icons will be presented representing the applications where
access has been granted.
• Check that the proxy settings on the client machine and/or proxy.pac file are correct and are
directing traffic to these destinations to route via your proxy
• Check that your proxy policy has been configured to allow traffic to these destinations on
HTTPS
• Check that any external firewall in the traffic path allows traffic from the proxy to these
destinations.
4. Launch CargoWise
From the set of available icons to access the application, double click on an icon to launch that
application.
When an application is launched, the computer being used will attempt to contact the
CargoWise Gateway on HTTPS (TCP/443) to open an application session.
• aucloud3.wisegrid.net
• ukcloud3.wisegrid.net
• uscloud3.wisegrid.net
• decloud-de1.wisegrid.net
When launching an application, a RemoteApp Window similar to the one shown below will display.
This is the indication that an initial connection establishment is now taking place. This can take a
few seconds and no input is required. While this window is present, the machine is attempting to
reach and establish a connection to a CargoWise Gateway.
• Check that the computer being used can resolve all three of the gateway server hostnames in
their local DNS. Use an nslookup tool from a command prompt to confirm this
• Check that the computer being used can connect to the CargoWise Gateway hostnames on
port HTTPS/443. This can be checked using a web browser and browsing to these hostnames.
If successful, you should see a webpage that advises you that direct login via this webpage is
not available, with links and information to download WCA. If unsuccessful, you should see no
webpage at all or a 404 timeout error
• Check that any firewall in the local network has been configured to allow connectivity to these
three destinations
• Check the Connection Log in WCA for further information. This can be accessed by clicking on
the Info Button in the top right-hand corner of WCA.
If you are using a proxy, the application will utilize any proxy settings configured in Internet
Explorer so there are some additional troubleshooting steps:
• Check that the proxy settings on the computer being used and/or proxy.pac file are correct
and are directing traffic to these destinations via your proxy,
• Check that your proxy policy has been configured to allow traffic to these destinations on
HTTPS,
• Check that any external firewall in the traffic path allows traffic from the proxy to these
destinations.
180.235.156.0/23
180.235.158.0/24
SYD
203.62.210.0/23
203.62.214.0/24
ORD 203.62.212.0/23
LON 203.62.208.0/23
DE1 203.62.215.0/24
5.3 Proxies
The application uses the operating system’s proxy settings, which are the same settings
configured in Internet Explorer. The application is proxy compatible and a number of our
customers access our application via a proxy server.
We strongly recommend all customers include these hostnames in any configuration changes
made in their topologies to provide increased resilience and minimize any interruption in the
event of an upstream internet provider failure.
If NTLM authentication level on your local workstation is not set as above, please follow the below
options:
Option 1
Option 2
Ensure you create a backup of your Windows registry before you make any changes.
Step 1
Identify the
symptoms
Step 2
Basic fault finding
process
Step 3
Advanced data
gathering process
Step 4
Interpret the test
results
Step 5
Apply suggested
solutions
When you are unable to connect via the CargoWise Cloud Client Application, the following error
may display:
• Ensure the workstation or terminal server environment has a good reliable network
connection, for example using a cabled network connection is preferred over wireless for
better overall stability.
• Ensure the workstation or terminal server environment has a good reliable internet
connection.
• Ensure all relevant Windows updates have been applied to all workstations and servers
involved in the connection to CargoWise Cloud.
• Proceed to the below steps if the above conditions have been checked and are resolved.
Carry out the following steps on the workstation, or corporate terminal server, where CargoWise
Cloud Client Application is installed:
• Perform a 5 minutes PsPing test to determine if the https port 443 has been blocked
• Capture the tracert and DNS lookup test to determine the geo-location target of the
CargoWise Cloud gateway DNS address.
For more information on these tests, refer to Step 4 & 5: Interpret the test results and apply
suggested solutions.
Results Description
Psping test latency values This is most likely due to traffic being blocked. Please review
are blank your corporate proxy servers or firewalls involved in the
connection to ensure they are not blocking access. Make any
appropriate adjustments if necessary. Refer to the Appendix –
Proxy recommendations for CargoWise Cloud Client Application.
Psping test latency values The network path to the CargoWise Cloud gateway servers is
are mostly over 100ms possibly being routed to a non-optimized or incorrect
geographic location. Please check the Geo-location of the
CargoWise Cloud gateway from the Tracert and DNS tests. Refer
to the Appendix – CargoWise Cloud DNS lookup
recommendations for CargoWise Cloud Client Application.
Psping test latency values These are workable latency values, but further investigation may
are between 5 to 100ms be needed to optimize the performance, and you may need to
work with internet providers or other IT staff to improve
connections.
Psping test latency values Network connectivity should be ideal in this range.
are mostly between 0 to
5ms The issue is likely not related to your internet performance, but
possibly your workstation environment or other network
connection restrictions as listed above.
Other issues Please use the CargoWise Cloud Client Application to re-test,
and if there are frequent failures, raise an eRequest Incident.
For any further enquiries, raise an eRequest Incident ensuring to include all tests carried out
and the related results.
When you are experiencing connection dropouts on a frequent occasion while using the
CargoWise Cloud Client Application, the following prompt may display:
• Ensure the workstation or terminal server environment has a good reliable network
connection, for example using a cable network connection is preferred over wireless for more
overall stability.
• Ensure the workstation or terminal server environment has a good reliable internet
connection.
• Ensure all relevant Windows updates have been applied to all workstations and servers
involved in the connection to CargoWise Cloud.
• Proceed to the below steps if the above conditions are checked and are resolved.
Carry out the following steps on the workstation, or corporate terminal server, where CargoWise
Cloud Client Application is installed:
• Perform a 5 minutes PsPing test to determine if the https port 443 has been blocked.
• Capture the tracert and DNS lookup test to determine the geo-location target of the
CargoWise Cloud gateway DNS address.
For more information on these tests, refer to Step 4 & 5: Interpret the test results and apply
suggested solutions.
Results Description
Psping test latency values This is most likely due to traffic being blocked. Please review
are blank your corporate proxy servers or firewalls involved in the
connection, to ensure they are not blocking access. Make any
appropriate adjustment if necessary. Refer to Appendix – Proxy
recommendations for CargoWise Cloud Client Application.
Psping test latency values The network path to the CargoWise Cloud gateway servers is
are mostly over 100ms possibly being routed to a non-optimized or incorrect
geographic location. Please check the Geo-location of the
CargoWise Cloud gateway from the Tracert and DNS tests. Refer
to Appendix – CargoWise Cloud DNS lookup recommendations
for CargoWise Cloud Client Application.
Psping test latency values These are workable latency values, but further investigations
are between 5 to 100ms may be needed to optimize the performance and may need to
work with internet providers or other IT staff to improve
connections.
Psping test latency values Network connectivity should be ideal in this range.
are mostly between 0 to
5ms The issue is likely not related to your internet performance, but
possibly your workstation environment or other network
connection restrictions as listed above.
Other issues Please use the CargoWise Cloud Client Application to re-test,
and if there are frequent failures, raise an eRequest Incident.
For any further enquiries, raise an eRequest Incident ensuring to include all tests carried out
and the related results.
Examples include:
• The response times for certain operational actions inside the application, are taking longer
than expected compared to recent experience, for example from one or two week(s) ago
• The hosted application at numerous occasions appears to be non-responsive during a
working day.
You can gather some diagnostic information within your CargoWise system at the time of the
issue occurring. Please follow the below steps an attach all the findings to an eRequest Incident:
For a more detailed outline of the above steps, refer to the Performance Issues section within
How-To Document your eRequest Incident.
1. Ensure that the user has successfully logged into the CargoWise Cloud Client Application and
attempted to connect at least once.
2. Click on the icon on the top right-hand side of the CargoWise Cloud Client Application
software.
3. In the Connection Log window, the CargoWise Cloud gateway value displays along the line
that displays the following: Date-time: RDP to CargoWise_cloud_dns_value.
For example:
4. Carry out the CargoWise_cloud_dns_value for psping tests and Tracert tests.
For more information on CargoWise Cloud Client Application usage and installation process,
refer to How to Connect to CargoWise via WCA.
Carry out the following steps to get a better idea of the connectivity and possible issues being
reported. Note, there are a different set of values to be used on the PsPing tool depending on the
frequency and hosted system location.
Follow the steps described on Locate CargoWise Cloud DNS gateway to obtain the
CargoWise Cloud_dns_value.
Note: the count value used on the command line is usually at 60 for a 5 minute test duration
or 360 for one-hour test duration.
4. At the same time, we also recommend opening a new elevated command prompt window and
run the following command (point of reference):
Note: alternatives such as baidu.com.cn or any other local public website name instead of
google.com, can be used to determine a baseline reference.
5. Once the test has finished, save the text file results onto the eDocs tab of the eRequest.
1. nslookup CargoWise_cloud_dns_value
2. tracert CargoWise_cloud_dns_value
3. nslookup (Canonical Name of the CargoWise_cloud_dns_value)
4. tracert (Canonical Name of the CargoWise_cloud_dns_value)
Follow the steps described in Locate CargoWise Cloud DNS gateway to obtain the
CargoWise_cloud_dns_value. Take note of the Canonical Name of the
CargoWise_cloud_dns_value as this will be part of the data gathering steps. The Canonical
name can be determined from public dns lookup website such as www.mxtoolbox.com
• IP address filtering
• Port requirements
• Proxies
• RDG HTTP methods.
For example, if there are proxies in place within the office network, we typically recommend that
customers implement a proxy bypass for the *.wisegrid.net domain if possible.
Note: allow https connection to the list of DNS addresses noted earlier, e.g. port 443 on
*.wisegrid.net and/or *. wisetechglobal.cn addresses.
Follow the steps described on Locate CargoWise Cloud DNS gateway to obtain the
CargoWise Cloud_dns_value.
The DNS response received is determined by the 'geolocation' of your external DNS server that is
issuing the DNS request to the internet. For example, if your external DNS server is geolocated in
location A or country A, then it will receive the location A or country A POP address from our CDN
provider’s DNS servers.
We do not recommend hardcoding any single IP address on your internal DNS servers to override
this behavior, as this will lead to loss of redundancy and automatic failover in the event of an
incident affecting one POP.
To resolve this issue and retain automatic failover, we suggest you utilize an external DNS server
that is local to your users’ geography - typically your ISPs DNS server. Please note that if you use
a geographically distributed DNS system (e.g. GoogleDNS, OpenDNS), then the IP address that
you receive for our service may vary and may lead to a less than optimal path.
Wherever, possible, the IT technician should discuss with the corporate office ISP if a better
internet connection can be obtained against the CargoWise Cloud DNS address if the users
are reporting instability in the connection.
Support: Press the F1 key from anywhere within CargoWise to raise an eRequest.