Troubleshooting

Unable to Get a License Request Code

This indicates one of the following issues with the iQs container:

• It is not configured to connect to the license server

• There is no license server installed

• The docker container is not communicating to the license server

Not Configured to Connect to the License Server

Please follow the instructions on how to license the iQs Surface

There is No License Server Installed

Please follow the instructions on installing the license server. There are two options, one for Windows and one for Linux.

Docker Container Is Not Communicating to the Server

Know the IP address of the license server and verify if the container has basic connectivity to the IP. From the command prompt of the Linux machine, type the below string while replacing the "your_studio_name" and "IP_address" with appropriate names.

docker exec "your_studio_name" ping "IP_address"

This could look something like the following: docker exec studio1 ping 192.168.101.12

Press CTRL-C to exit the command.

A failure to ping indicates the container does not have access to that IP address. A successful ping to the address but failure to generate a license request suggests the license server is not running.

Ping Failure - Routing Problem with Address

Make sure the IP address is within the same subnet (192.168.2.x). If it is not withhin the same subnet, make sure there is a router in place that is set up to route between subnets.

If the docker container is deployed with the use of macvlan, make sure the Linux box has a route defined for routing between the macvlan and the subnet.

Ping Success - Problem with the License Server

Check that the services are running. From the command line, issue a systemctl and look for codemeter services and license server service.