Example 2 - Deploying an S-63 application with Carmenta Engine runtime
This example shows the extra steps you need to take to deploy a Carmenta Engine application with S-63 data, using a node-locked Carmenta Engine runtime license. Note that you can not copy the database from your SDK machine; you will have to create and prepare a new database on each target machine. See Working with S-63 Electronic Nautical Chart Data for a detailed description of the S-63 support in Carmenta Engine.
The functions performed by the utility programs mentioned below are also available through the Carmenta Engine API. If you wish wish to provide a better user experience for your end users, you could build components in your application to perform the steps described here.
Step 1 - Deploy your application to target machine
Use an installer or build an xcopy installation and install the application on the target machine, without a license file. Include both the RuntimeLicenseKeyManager and the S63Manager utilities from the SDK in the installation.
Step 2 - Acquire node-locked runtime license with S-63 user permit
Contact Carmenta to get a runtime license. State that you will be using S-63 data.
You will receive a license that needs activation on the target machine. Copy the license to the target machine and use RuntimeLicenseKeyManager to create an activation request:
RuntimeLicenseKeyManager64.exe request_activation <input license file> <output license file>
Send the activation request to us, and inform us that you also need an S-63 user permit embedded in the license.
When you receive the activation, copy it to the development machine, where your application expects to find it.
Set the environment variable CARMENTA_ENGINE_S63_MANAGER_LICENSE_FILE to point to the license file, then use the S63Manager utility to display the S-63 user permit now bound to your target machine:
S63Manager64.exe list_userpermit
Step 3 - Purchase and install data to target machine
The next steps steps are same you did on the SDK machine, i.e. steps 2 - 5 in the previous example. Once completed, you should be able to load and display the S-63 data on the target machine.