You can either install a Docker image by downloading a saved Docker image file directly from the Zixi Customer Portal, or you can download a regular Linux installation file for the Broadcaster and then build your own Docker image.
To download a Docker image file:
Access the Zixi Customer Portal at https://portal.zixi.com.
Log in using your Username and Password.
In the Main Navigation, click Software.
The available software versions for Zixi Broadcaster (which are available for your account) are displayed towards the top of the page.Click on the box of the version that you would like to install.
The download options for the selected version are displayed.
To download the Docker image file, click on the Download button next to the Docker file and navigate to the location where you would like to save the file.
Alternatively, you can download the Docker image file by clicking on the >_CLI button next to the Docker image file and executing the “wget” command that is provided.Extract the installation file by typing the following command:
# gzip -d <zixi_product>-<version_number>.docker.tar.gz
where <zixi_product> is “zixi_broadcaster” and <version_number> is similar to “16.4.44543”.Import the .tar Docker file image into your local Docker environment using the load command as shown below:
# docker load --input <zixi_product>-<version_number>.docker.tar
At this point the Docker image is defined in your the local environment, but the Docker container is not yet running.
To build a new Docker image:
Copy the contents of Appendix A and Appendix B into files named “dockerfile_zixi_broadcaster.txt” and “broadcaster-config-template.xml”, respectively.
Place the files into the current working directory.
If you don’t already have the required installation file, you can obtain it as follows:
Access the Zixi Customer Portal at https://portal.zixi.com.
Log in using your Username and Password.
In the Main Navigation, click Software.
The available software versions for Zixi Broadcaster (which are available for your account) are displayed towards the top of the page.Click on the box of the version that you would like to install.
The download options for the selected version are displayed.
Download the installation file using a “wget” command by clicking on the Linux >_CLI button. The complete “wget” CLI command is shown, containing all of the required information about the installation file for the selected product version.
Copy the “wget” and execute it in the Linux console. Alternatively, you can download the installation file by clicking on the Linux Download button or by executing the “curl” command.
Extract the Broadcaster installation file by typing the following command:
# tar xvf <zixi_product>-<version_number>.tar.gz
Copy the Broadcaster .tar.gz installer file into the working directory.
Edit the dockerfile_zixi_broadcaster.txt file with the correct version number for the Broadcaster installer.
Run the following Docker build command which will execute steps in the specified docker file.
# docker build --no-cache --tag <zixi_product>-<version_number> --file ./dockerfile_zixi_broadcaster.txt .
The dockerfile_zixi_broadcaster.txt file contains embedded comments describing how the image is being built. After the image is built you will have an image in your local Docker environment.
Use the following command to see available images:
# docker images
The output will be similar to the following (with different image IDs):
REPOSITORY TAG IMAGE ID CREATED SIZE zixi broadcaster 16.4.44543 855f142a53a7 24 minutes ago 549MB centos 7 B5b4d78bc90c 5 weeks ago 203MB
After building the Docker image, you can save the image to a file that can be easily shared to someone else. To save the image to a file, use the save command as shown below:
# docker save zixi_broadcaster:<version_number> > zixi_broadcaster-<version_number>.docker.tar
The output will be similar to the following (with different image IDs):
You can use the repository and tag to specify the image, as shown as shown above, or you can use the image ID.
After saving the image, you can “gzip” it to save space.