This step is optional and only relevant to producers. License server administrators can skip this section.
This section describes the ways in which producers can customize the
Instead of the Revenera logo,
The labels and icons of the navigation menu on the left side can be customized.
Producers edit the Docker container and create a new Docker image. They then distribute the Docker image to their customers who install the
This section assumes Docker is already installed and running. For information about downloading and installing Docker, see the Get Docker topic in the Docker documentation.
To customize the
Navigate to the directory where the image file is located.
Run the following command to load the image into Docker:
docker load -i <Flexnet License Server Manager image .zip file>
You will see output similar to the following:
D:\Git\FLSM>docker load -i FlexnetLicenseServerManager-2024-03.zip
7cd52847ad77: Loading layer [==============================================>] 7.338MB/7.338MB
d8a5a02a8c2d: Loading layer [==============================================>] 5.32MB/5.32MB
5e59460a18a3: Loading layer [==============================================>] 3.584kB/3.584kB
152a948bab3b: Loading layer [==============================================>] 4.608kB/4.608kB
c4d67a5827ca: Loading layer [==============================================>] 3.584kB/3.584kB
f1bee861c2ba: Loading layer [==============================================>] 7.168kB/7.168kB
042cd3f87f43: Loading layer [==============================================>] 29.85MB/29.85MB
dd9369c9bea6: Loading layer [==============================================>] 4.096kB/4.096kB
bf8fe155c7b7: Loading layer [==============================================>] 6.38MB/6.38MB
Loaded image: revenera/flsm:2024-03
Use the following command to verify the image:
docker images
You will see output similar to the following:
REPOSITORY TAG IMAGE ID CREATED SIZE
revenera/flsm 2024-03 1c0383a444f7 5 hours ago 49.4MB
revenera/flsm 2023-09 c829323eea31 5 months ago 47.7MB
Use a command like the following to run the
docker run -p 8080:80 -e API_PORT=8080 -t revenera/flsm:2024-03
The command above uses the following flags:
-p: Assigns the port configuration. Adjust the port numbers as required for your application environment. The first port is the Docker host and the second port is the port used by the
-e: Sets an environment variable in the container.
-t: Creates a tag that refers to the source image. In the example above, the image name is revenera/flsm and the tag value is 2024-03.
You will see output similar to the following (shortened for brevity):
2024/03/04 11:53:20 [notice] 1#1: using the "epoll" event method
2024/03/04 11:53:20 [notice] 1#1: nginx/1.25.4
2024/03/04 11:53:20 [notice] 1#1: built by gcc 12.2.1 20220924 (Alpine 12.2.1_git20220924-r10)
2024/03/04 11:53:20 [notice] 1#1: OS: Linux 5.10.102.1-microsoft-standard-WSL2
2024/03/04 11:53:20 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2024/03/04 11:53:20 [notice] 1#1: start worker processes
2024/03/04 11:53:20 [notice] 1#1: start worker process 19
2024/03/04 11:53:20 [notice] 1#1: start worker process 20
2024/03/04 11:53:20 [notice] 1#1: start worker process 21
2024/03/04 11:53:20 [notice] 1#1: start worker process 22
2024/03/04 11:53:20 [notice] 1#1: start worker process 23
Open a separate command-line terminal and use the following command to locate the ID or name of the active
docker ps
You will see output similar to the following (shortened for brevity):
CONTAINER ID IMAGE COMMAND CREATED STATUS
8d2b9756f86a revenera/flsm:2024-03 "/docker-entrypoint.…" 2 weeks ago Up 7 minutes
You can now perform one or both of the following customizations:
Add a custom logo:
Use the following command to copy the image file for your organization’s logo to the specified path within the running
docker cp <path>\logo.jpg <container_ID>:/usr/share/nginx/assets/logo.jpg
Valid names for the logo are logo.jpg, logo.jpeg, or logo.png. If the logo has a different file name or a different extension, Docker returns an error.
You will see output similar to the following:
Successfully copied 37.9kB to 8d2b9756f86a:/usr/share/nginx/assets/logo.jpg
Customize the left navigation menu:
You can edit the labels and icons that appear in the left navigation menu. When you edit a label in the navigation bar, the corresponding heading will also be changed, as shown in the following example screenshot:
The labels and icons are specified in a file called data.json. Prepare a custom data.json file where you edit the labels and icons as required. Use the icons from Material UI (see https://mui.com/material-ui/material-icons). Copy the icon name without the suffix; for example, to use the icon PermDataSettingIcon, specify PermDataSetting.
The Docker container contains a sampleData.json (located under <container_ID>:/usr/share/nginx/assets/) which helps you prepare your custom data.json.
Only edit fields called either “label” or “icon”. Editing any other fields will result in errors.
When you prepared your custom data.json file, use the following command to copy it to the specified path within the running
docker cp <path>\data.json <container_ID>:/usr/share/nginx/assets/data.json
You will see output similar to the following:
Successfully copied 37.9kB to 8d2b9756f86a:/usr/share/nginx/assets/data.json
Commit the changes made to the
docker commit <container_ID> <image>:<tag>
where <container_ID> is the ID output by the docker ps command (see
docker commit 8d2b9756f86a revenera/flsm-custom:2024-03
You will see output similar to the following:
sha256:7272b5523871c7d4f61b91b358613f8d20dacc5dc352ff6790023bf0a13b4c26
Use the following command to verify the new image:
docker images
You will see output similar to the following:
REPOSITORY TAG IMAGE ID CREATED SIZE
revenera/flsm-custom 2024-03 20413816ea62 About a minute ago 49.5MB
revenera/flsm 2024-03 1c0383a444f7 5 hours ago 49.4MB
revenera/flsm 2023-09 c829323eea31 5 months ago 47.7MB
Optionally, use the following command to save the image as a zip file:
docker save -o <file_name>.zip image_name:<tag>
You can now distribute the customized Docker image or zip to your customers.
To install the customized