Run applications in Docker containers with offline entitlements
Activate the offline Runtime entitlement on the host, pass the offline entitlement value when you start the Docker container, and verify that the container runs.
TIP:
For complete examples of configuration files,
certificates, and other items required to validate entitlements, See https://github.com/FactoryTalk-Optix/Optix_Docker_FTOptixUpdateServer.
IMPORTANT:
Without a valid entitlement, the
FactoryTalk Optix Application
stops running after 120 minutes.Prerequisites
- Create the Docker image for theFactoryTalk Optix Application. See Create a Docker image with a FactoryTalk Optix Application.
- Activate the offline Runtime entitlement on the host before you start the container. See Activate FactoryTalk Optix Runtime on offline devices.
TIP:
Before you deploy or update an application in the container, the runtime log might not contain the usual startup entry. This behavior is expected.
- To run applications in Docker containers with offline entitlements
- Get the offline entitlement value for the activated host.Use the offline entitlement value that matches the offline entitlement activated on the host.
- In the terminal, enter:docker run --publish 49100:49100 --env ADMIN_PASSWORD=admin_password[--namecontainer_name] [--publishexternal_port:internal_port] [--restart unless-stopped] --envlicense_environment_variable=offline_entitlement_value[-d] [-vlocal_folder:/root/FTOptixApplication/Projects/app_name]image_nameFor parameter descriptions, see Docker parameters.
To verify that the container displays in the container list, enter
docker
ps -a
in the terminal.Example command:
docker run --publish 49100:49100 --publish 8080:8080 --env ADMIN_PASSWORD=AdminPassword --name ftoptix-runtime --restart unless-stopped --env LICENSE_ENVIRONMENT_VARIABLE=offline_entitlement_value ftoptix-runtime
- Confirm that the status column showsUpafter the container starts.
- If the container does not start with the entitlement, verify that the offline entitlement matches the deployed application.
- If the container does not start with the entitlement, verify that the offline entitlement is not already bound to another host or container instance.
Docker runtime
offline licensing
offline activation
container licensing
host activation
Provide Feedback