Hexagon Geospatial
MENU

GMSC Tutorials

Not sure on how to get started or looking for a workflow to get GeoMedia Smart Client up and running. Tutorials provide step by instruction on some of the most common configurations and workflows to get GeoMedia Smart Client configured up and running quickly.
Showing results for 
Search instead for 
Do you mean 

GMSC 2018.3 - Hexagon App Launcher

by Technical Evangelist 2 weeks ago - edited yesterday by Technical Evangelist (107 Views)

With the release of GeoMedia Smart Client 2018 Update 3, the technology stack will change for the Java platform.

  • OpenJDK will now be used as standard virtual machine
  • Java Web Start is replaced by a component called “Hexagon App Launcher”
  • OpenJFX replaces JavaFX

 

In this article we want to focus on the Hexagon App Launcher.


Starting with the 2018 Update 3 release, GMSC is no longer dependent on a specific Java runtime version which must be pre-installed on the machine.  
 
The GeoMedia Smart Client setup includes its own custom runtime image. Java version management inside your organization are now a thing of the past. Switching between production and test environments are easier than ever before. 

 

 

DOES ANYTHING HAVE TO BE PRE-INSTALLED ON A CLIENT MACHINE? 

Yes. The Hexagon App Launcher must be pre-installed on a client machine. Once installed the Hexagon App Launcher will be updated automatically. 
 

We will ensure that future versions of Hexagon App Launcher will remain compatible with all released versions after GMSC 2018.3 so there will be no version conflicts in the future when accessing different GMSC versions from the same client machine. 

 

WHERE CAN I FIND THE HEXAGON APP LAUNCHER? 

The Hexagon App Launcher comes with the GeoMedia Smart Client setup. 

 

If the App Launcher is not already installed the download will start automaticaly when starting the GMSC client. 

By default the Hexagon App Launcher setup can be found at https://{HOST}/GMSC/AppLauncher/AppLauncher.exe

or if https is not enabled http://{HOST}/GMSC/AppLauncher/AppLauncher.exe.

 

WHAT DOES THE HEXAGON APP LAUNCHER DO?

The Hexagon App Launcher downloads all necessary resources and uses a custom runtime image to start the application.

 

WHAT IS A CUSTOM RUNTIME IMAGE?

Since Java 9, the JDK includes a tool which is called jlink. This tool can be used for the generation of a custom runtime image which includes only the used Java modules. 
 
More information can be found at: 

WHY NOT JUST A JAVA RUNTIME?

“Oracle will no longer offer a stand-alone JRE for desktops. Starting with JDK 11 Oracle will only produce a JDK and a Server JRE.” 
Quote: http://jdk.java.net/11/

 

WHICH MODULES ARE INCLUDED AT THE GMSC’S CUSTOM RUNTIME IMAGE? 

The custom runtime image of GeoMedia Smart Client 2018 Update 3 includes the following modules: 

Please note that this list could change in future versions of GeoMedia Smart Client. 

 

DOES GMSC USE ORACLE JDK OR OPENJDK? 

GeoMedia Smart Client Update 3 uses OpenJDK 11+28. 
 

IS THERE A DIFFERENCE BETWEEN THE ORACLE JDK AND THE OPENJDK? 

“As announced in September 2017, with the OracleJDK and builds of Oracle OpenJDK being interchangeable for releases of Java SE 11 and later, the Oracle JDK will primarily be for commercial and support customers and OpenJDK builds from Oracle are for those who do not want commercial support or enterprise management tools.” 

Quote: http://www.oracle.com/technetwork/java/javase/eol-135779.html 

 

WHERE CAN I FIND THE HEXAGON APP LAUNCHER ON MY MACHINE?

You can find the App Launcher directory at %LOCALAPPDATA%\Hexagon 

 

DOES THE HEXAGON APP LAUNCHER CREATE APPLICATION SHORTCUTS?

Yes, the Hexagon App Launcher creates an application shortcut at Start Menu\Programs\GeoMedia Smart Client which can be used for online and offline starts.

 

HOW TO REMOVE CACHED APPLICATION WITH HEXAGON APP LAUNCHER?

A remove shortcut will be created at Start Menu\Programs\Hexagon App Launcher.

 

HOW CAN I SET A PROXY?

The Hexagon App Launcher sets the 'java.net.useSystemProxies' system property to true which means: 
"On Windows systems, macOS systems and on Gnome systems it is possible to tell the java.net stack, setting this property to true, to use the system proxy settings (both these systems let you set proxies globally through their user interface). Note that this property is checked only once at startup." 

Quote: 
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/net/doc-files/net-properties.html

 

If you use proxy exceptions, please ensure that you don't use wildcards (*). This restriction is a known bug and was reported at the JDK Bug System: https://bugs.openjdk.java.net/browse/JDK-7014531

 

THE HEXAGON APP LAUNCHER TELLS ME THAT THE ISSUER OF MY CERTIFICATE ISN’T TRUSTED BY DEFAULT, WHY?

The Java Runtime Environment supports only specific root certificates. If the issuer of your certificate is not in the list than you will  get this warning for security reasons.
Appendix A shows the list of supported root certificates and we advise to buy a certificate from one of these issuers.
 

 

Appendix A – List of support certificates

 

AAA Certificate Services  

Actalis Authentication Root CA  

AddTrust Class 1 CA Root  

AddTrust External CA Root  

AddTrust Qualified CA Root  

AffirmTrust Commercial  

AffirmTrust Networking  

AffirmTrust Premium  

AffirmTrust Premium ECC  

Baltimore CyberTrust Root  

Buypass Class 2 Root CA  

Buypass Class 3 Root CA  

Certum CA  

Certum Trusted Network CA  

Chambers of Commerce Root  

Chambers of Commerce Root - 2008  

Class 2 Primary CA  

Class 2 Public Primary Certification Authority - G2  

Class 3 Public Primary Certification Authority  

Class 3 Public Primary Certification Authority - G2  

Class 3P Primary CA  

COMODO ECC Certification Authority  

COMODO RSA Certification Authority  

Deutsche Telekom Root CA 2  

DigiCert Assured ID Root CA  

DigiCert Assured ID Root G2  

DigiCert Assured ID Root G3  

DigiCert Global Root CA  

DigiCert Global Root G2  

DigiCert Global Root G3  

DigiCert High Assurance EV Root CA  

DigiCert Trusted Root G4  

DST Root CA X3  

D-TRUST Root Class 3 CA 2 2009  

D-TRUST Root Class 3 CA 2 EV 2009  

Entrust Root Certification Authority  

Entrust Root Certification Authority - EC1  

Entrust Root Certification Authority - G2  

Entrust.net Certification Authority (2048)  

ePKI Root Certification Authority  

GeoTrust Global CA  

GeoTrust Primary Certification Authority  

GeoTrust Primary Certification Authority - G2  

GeoTrust Primary Certification Authority - G3  

GeoTrust Universal CA Global Chambersign Root - 2008  

GlobalSign Root CA  

Go Daddy Class 2 Certification Authority  

Go Daddy Root Certificate Authority - G2  

GTE CyberTrust Global Root  

IdenTrust Commercial Root CA 1  

IdenTrust Public Sector Root CA 1  

ISRG Root X1  

KEYNECTIS ROOT CA  

LuxTrust Global Root  

QuoVadis Root CA 1 G3  

QuoVadis Root CA 2  

QuoVadis Root CA 2 G3  

QuoVadis Root CA 3  

QuoVadis Root CA 3 G3  

QuoVadis Root Certification Authority  

SecureTrust CA  

Security Communication RootCA1  

Security Communication RootCA2  

Sonera Class2 CA  

Starfield Class 2 Certification Authority  

Starfield Root Certificate Authority - G2  

Starfield Services Root Certificate Authority - G2  

SwissSign Gold CA - G2  

SwissSign Platinum CA - G2  

SwissSign Silver CA - G2  

Thawte Premium Server CA  

thawte Primary Root CA  

thawte Primary Root CA - G2  

thawte Primary Root CA - G3  

Thawte Timestamping CA  

T-TeleSec GlobalRoot Class 2  

T-TeleSec GlobalRoot Class 3  

USERTrust ECC Certification Authority  

USERTrust RSA Certification Authority  

UTN-USERFirst-Client Authentication and Email  

UTN-USERFirst-Hardware  

UTN-USERFirst-Object  

VeriSign Class 3 Public Primary Certification Authority - G3  

VeriSign Class 3 Public Primary Certification Authority - G4  

VeriSign Class 3 Public Primary Certification Authority - G5  

VeriSign Universal Root Certification Authority  

XRamp Global Certification Authority

 

Overview