Leapfrog Start is an application that checks to see if your network will support the connection of Leapfrog web based services to your desktop applications.

Confidence to start

Leapfrog Start is with you all the way through this process. As you run ‘Start’ it instantly reports back on your connectivity to integrated Leapfrog web based applications, if license information can be requested and received and what action you may need to take to remedy any issues – from either an IT or operational perspective.

  • Check connectivity endpoints between Leapfrog services and your network
  • Leapfrog Start runs within a minute and reports back on the progress
  • Pinpoints any action you may need to take and directs you to appropriate help

Check access to Leapfrog web services

Leapfrog Start is designed to ensure you have a seamless experience with Leapfrog Software and it’s associated web services such as licensing, reporting and API connections.

  • Tests access to Leapfrog web services from within your current web environment
  • Creates a report of any issues for review by your Network Administrator or your local Leapfrog team

Webpages

  • Redirect
  • Online help

Licensing

  • Fixed dongle
  • Activation Code
  • On Demand
  • My Leapfrog ID

 

Reporting

  • Licenced items
  • Reference codes
  • Email report
  • System report
  • Time

 

Products

  • Access to View
  • Access to Central
  • Central hosted server

 

Download Leapfrog Start

Download

Understanding your Leapfrog web services test report

Access to Leapfrog web services can be tested using Leapfrog Start or from within your Leapfrog application. When you test whether Leapfrog web services are available, a report is generated that you can save for your own review. The report is also sent to Leapfrog, but your personal details will not be included if all tests pass. If a test fails, a Leapfrog support case will automatically be created, and someone from Leapfrog support will contact you to help you resolve the issue.

This guide provides information that will help you and your Network Administrator to interpret your web services test report. The Error Scenarios section of this guide includes information for Network Administrators that may help resolve any issues found. The Endpoint Impacts section describes the effects of any failure to connect to a particular endpoint.

This is applicable to reports generated from

  • Start v2.0
  • Leapfrog Works v3.0
  • Leapfrog Geo v5.0
  • Leapfrog Geothermal v4.0

If you need any further assistance interpreting Leapfrog Start test reports, contact support.

Error Scenarios

The error scenarios described include a generalised example of the errors displayed, along with suggestions for mitigating the issue.

Authenticated Proxy Problems

Cause: The active network configuration requires connections to the named endpoints to go through an authenticated proxy and the credentials are wrong.

Error Displayed
Endpoints
Error: Expected HTTP Code: 200, Actual HTTP Code: 407
http://help.leapfrog3d.com/[product]/[version]
Error: Request error: ('Cannot connect to proxy.', error('Tunnel connection failed: 407 ))
All https endpoints

Actions to take: Check the credentials used in Leapfrog under the main menu (Settings > Network). If this does not fix the problem, consider whitelisting the failing hosts

Timeouts

Cause: Slow/intermittent internet connections can cause timeouts.

Error Displayed
Endpoints
Expected HTTP Code: 200, Actual HTTP Code: 502
http://help.leapfrog3d.com/[product]/[version]
Error: Request error: ('Cannot connect to proxy.', error('Tunnel connection failed: 502 Could not connect to destination "[destination host]" - proxy list exhausted',))
All https endpoints

Actions to take: Unfortunately causes of timeouts are varied and often tricky to diagnose.

  • The cause can be temporary so the first action to try is to wait a while and try again.
  • The problem can sometimes be caused by network connections not being closed properly (e.g. when switching between VPN and no VPN when a laptop is transitioned from home to work or vice-versa). The best thing to try here is restarting the machine and trying again.
  • The proxy autodetection may not be working – try manually setting the proxy server (if there is one) or turn proxy support off (if there is no proxy server) under Settings> Network
  • The proxy address may not be correct – check the proxy settings under Settings> Network

Poor Connections

Error Displayed
Endpoints
Request error: ('Connection aborted.', BadStatusLine("''",))
Any

Actions to take

  • Failures due to poor connections occur intermittently. By their very nature, the best cause of action is often to wait a while and try again.
  • The problem can sometimes be caused by network connections not being closed properly (e.g. when switching between VPN and no VPN when a laptop is transitioned from home to work or vice-versa). The best thing to try here is restarting the machine and trying again.

Back End Failure

Error Displayed
Endpoints
Expected HTTP Code: 200, Actual HTTP Code: 502
http://help.leapfrog3d.com/[product]/[version]
Error: Request error: ('Cannot connect to proxy.', error('Tunnel connection failed: 502 Could not connect to destination "[destination host]" - proxy list exhausted',))
All https endpoints

Actions to take: Contact support, providing the test report, to further investigate the backend issue

HTTPS Certification Verification Problems

Cause: The HTTPS traffic is being inspected by web security software and the certificate used to resign the packets is not being recognised.

Error Displayed
Endpoints
Error: SSL error: bad handshake: Error([('SSL routines', 'ssl3_get_server_certificate', 'certificate verify failed')],)
All https endpoints

Actions to take: Connections from Start and the Leapfrog Application to the HOSTNAME should be whitelisted to allow direct connections so the packets are not scanned and re-signed with the unknown certificate.

Contact Support, providing the Start testing report, to get help with adding the certificate used by the web security software to re-sign the packets to the certificate store used by the Leapfrog Applications.

Endpoint impacts

When Leapfrog reports an error in trying to connect to an endpoint, some failures are more critical than others. This section describes the severity of impact of not being able to successfully connect to an endpoint.

Severity
Endpoints
Notes
High
https://api.seequent.systems /v1/licenses/dongle/status
This is the endpoint used to determine the validity of a dongle. Without connectivity, the Leapfrog applications will not understand the correct status of the dongle, leading to a failure to issue a license.
High
https://api.seequent.systems /v1/licenses/soft/activate
This is the endpoint used to activate soft licenses. Without connectivity, the Leapfrog applications will not be able to use a soft licence.
High
https://api.seequent.systems /v1/licenses/dongle/on_demand/activate
This is the endpoint used to activate On Demand licences. Without connectivity, the Leapfrog applications will not be able to obtain On Demand licences.
High
https://id.seequent.systems/
This is the endpoint for the My Leapfrog authorisation and entitlement licence server. Without connectivity, the Leapfrog applications will not be able to obtain or renew licenses.
High
https://geoapi.lfview.com /apikey/v1/generate /apikey/v1/oauth_generate https://api.seequent.systems /v1/integrations
These endpoints relate to the normal operation between the Leapfrog desktop applications and Leapfrog View. Without connectivity, the Leapfrog applications will not be able to upload scenes to Leapfrog View
High
https://api.seequent.systems /v1/metrics/applications/leapfrog?hmac=xxx
This endpoint is used to send reference codes and usage data to Seequent. The reference codes and usage are reported to users and administrators in My Leapfrog. The usage data includes product and module use for billing purposes. Apart from billing data no personal data is stored. Without connectivity, the Leapfrog applications will not be able to send the reference code or usage data.
Medium
https://hq.leapfrog3d.com/
This is the endpoint used to submit problem reports to Leapfrog for further analysis. Without connectivity, the Leapfrog applications will not be able to send the problem report details. Whilst this will not interfere with the ordinary running of the software, having the connectivity available will enable seamless reporting of errors and enable a more efficient response.
Medium
https://lfview.com/signup
This is the endpoint used to sign up a new user to Leapfrog View. Without connectivity, the user will not be able to sign up for the Leapfrog View service from within the Leapfrog applications. It may be possible to sign up in an internet browser instead.
Low
https://api.seequent.systems /v1/redirects/viewer
This endpoint is representative of all the redirection URLs. Many URLs & links used within the Leapfrog applications are obtained by first querying the redirection endpoint to get the actual destination. Examples include help and support links. Without connectivity, the Leapfrog applications will not be able to correctly determine URLs such as for extra help, support and downloads.
Low
http://help.leapfrog3d.com /Geo/5.0/en-GB/Content/intro.htm
This is the landing page for the Leapfrog Geo 5.0 online help and is representative of all the online help links. Without connectivity, Leapfrog applications will not be able to access to online help. Offline help can be downloaded independently using a web browser and installed locally on a user’s machine.
Low
https://api.seequent.systems /v1/leapfrog /product_information/GetCurrentVersion/Start
This endpoint is used to obtain new version release information. Without connectivity, the Leapfrog applications will not automatically inform the user that a new version of the software is available.