Docker Tools Installation 

1- Access the download link: Visit the Docker for Windows installation page

2- Download: On the website, select the Docker Desktop for Windows (x86_64) option to download the latest version of Docker.

→ For more information see Custom Docker Generation.

Configuration Procedure

About the Image

This Docker image includes the files needed for FrameworX execution. The TWebServices allows you to upload any Solution and work on it remotely. Additionally, we have the Designer (on the PC connected to the Docker container), which allows the user to edit the Solution. The WebClient Runtime and SmartClient Runtime allow the user to run a solution using a web browser, such as Microsoft Edge.

How to pull the image

Before starting to use this image, it is necessary to pull it, type the following command in Command Prompt (CMD): docker pull tatsoftdockerhub/program:latest

The command docker pull tatsoftdockerhub/program:latest allows the user to download an image called program (from the repository tatsoftdockerhub) to their local Docker environment. After downloading the image, the user can use it to create and run containers, which are running instances of that application or service.

1. docker pull: This is a Docker command used to download an image from a Docker registry (typically Docker Hub, but it can also be a private registry). It fetches the image and stores it locally, allowing you to use it later to create containers.
2. tatsoftdockerhub/program: This part specifies the image and repository. Docker Hub organizes images in the format <user>/<image>.

• tatsoftdockerhub is the username or organization that published the image.
• program is the name of the image, likely representing a web service related to Tatsoft.

1. :latest: This is the tag for the image, indicating its version. The :latest tag refers to the most recent version of the image available in the repository. Tags allow users to specify different versions of an image. If no tag is provided, Docker will automatically attempt to pull the latest version. However, explicitly including :latest ensures that the most up-to-date version is retrieved.

Visit the Docker Hub repository to view the program image details.

Creating and running the container from the Docker image:

After pulling the Docker image, type the following command in  CMD (Command Prompt) to create and run a container:

docker run --name <container_name> -p 3101:3101 -p 10108:10108 tatsoftdockerhub/program

If the container already exists, do not use “--name”. You can start it with the following command: docker start <container_name>, Alternatively, you can open Docker Desktop and click the Start button in the Containers section.

Editing the IP of RemoteLicenseService:

After creating the container, open a new window in Command Prompt (CMD) and type the following command to copy the RemoteLicenseService.config file to the to the desired directory:

docker cp <container_name>:Documents/Program/MachineSettings/RemoteLicenseService.config <destination_path_on_host>.

Once this is done, you need to edit the file. Right-click on it, select Edit in Notepad, enter your IP address, and save the file. The syntax is as follows:

 RemoteServer=<IpAddress>:<PortNumber>.

// IP:Port where the licensing server is Running RemoteServer=192.168.1.1:10108

The port should point to the same port as your WebServices (TWebServices) running on the Server computer and you can check in the Server tab of FrameworX:

After editing, use the following command to copy the updated file back to the container:

docker cp <file_path_on_host> <container_name>:Documents/Program/MachineSettings/RemoteLicenseService.config.

After that, you can check if the file is inside of container, start the container (if you stopped it) by typing docker exec -it program /bin/bash, once you have done that, navigate to the directory by typing: cd Documents/Program/MachineSettings and then type ls to list the files inside the container and verify the file is there.

Running the container

Open the FrameworX and go to the Server Information section, and then edit the Remote Server by specifying the Docker IP. To find your IP, open Command Prompt (CMD) and type ipconfig. Copy the IPv4 address from the Ethernet adapter vEthernet (WSL).

Afterwards, click the Connect button and wait for the process to finish. Once connected, upload a multi-platform solution that you want to run or edit by clicking the Upload File button.

In this section...