Page Comparison

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:

1. Access the Zixi Customer Portal at https://portal.zixi.com.

2. Log in using your Username and Password.

3. 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.  The “raspberry” build is a generic ARM64 build that should run on any ARM64 system.

4. Click on the box of the version that you would like to install.
   The download options for the selected version are displayed.
   

   

5. 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.

6. Extract the installation file by typing the following command:

   Code Block
   # gzip -d <zixi_product>-<version_number>.docker.tar.gz

   where <zixi_product> is “zixi_broadcaster” and <version_number> is similar to “16.3.44466”.

7. Import the .tar Docker file image into your local Docker environment using the load command as shown below:

   Code Block
   # 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:

1. Copy the contents of Appendix A and Appendix B into files named “dockerfile_zixi_broadcaster.txt” and “broadcaster-config-template.xml”, respectively.

2. Place the files into the current working directory.

3. If you don’t already have the required installation file, you can obtain it as follows:

   1. Access the Zixi Customer Portal at https://portal.zixi.com.

   2. Log in using your Username and Password.

   3. 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.  The “raspberry” build is a generic ARM64 build that should run on any ARM64 system.

   4. Click on the box of the version that you would like to install.
      The download options for the selected version are displayed.
      

      

   5. 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.
      

      

   6. 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.

   7. Extract the Broadcaster installation file by typing the following command:

      Code Block
      # tar xvf <zixi_product>-<version_number>.tar.gz

4. Copy the Broadcaster .tar.gz installer file into the working directory.

5. Edit the dockerfile_zixi_broadcaster.txt file with the correct version number for the Broadcaster installer.
   

   

6. Run the following Docker build command which will execute steps in the specified dockerfile.  Note, you must be doing the docker build on an ARM64 system.  While it is possible to build Docker images on a different CPU platform than the target, that is outside the scope of this document.

   Code Block
   # docker build --no-cache --tag <zixi_product>-<version_number> --file ./dockerfile_zixi_broadcaster.raspberry.txt .

   The dockerfile_zixi_broadcaster.raspberry.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.

7. Use the following command to see available images:

   Code Block
   # docker images

   The output will be similar to the following (with different image IDs):

   Code Block
   REPOSITORY TAG IMAGE ID CREATED SIZE zixi broadcaster 16.4.44543 855f142a53a7 24 minutes ago 549MB centos 7 B5b4d78bc90c 5 weeks ago 203MB

8. 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:

   Code Block
   # docker save zixi_broadcaster:<version_number> > zixi_broadcaster-<version_number>.raspberry.docker.tar

9. The output will be similar to the following (with different image IDs):

10. You can use the repository and tag to specify the image, as shown as shown above, or you can use the image ID.

11. After saving the image, you can “gzip” it to save space.