Some test text!

WebViewer Server Container on Azure

In this document
chevron_rightBuilding on a Linux VM
chevron_rightBuilding on Container Instances
chevron_rightBuilding on Web Apps for Azure

WebViewer Server can be used on Microsoft Azure, in order to do this we recommend using a Linux VM or the Container Instances service.

linkBuilding on a Linux VM

To build the WebViewer Server on a Linux VM, follow this guide on building docker compose images - https://docs.microsoft.com/en-us/azure/virtual-machines/linux/docker-compose-quickstart - alongside our guide on building the WebViewer Server image.

  • If building with the Azure VM, you may have to change the version specifier in the docker-compose.yml file to version:"2.0" or update docker-compose depending on the VM used.

linkBuilding on Container Instances

If your needs extend to using WebViewer server in a more modular context, you are also able to upload the pdfd-tomcat image as a seperate instance and use it on the Container Instances service. The steps are as follows:

  1. Setup an Azure container respository: https://docs.microsoft.com/en-us/azure/container-registry/container-registry-get-started-portal
  2. Login to your Azure container repository using either the command line interface or docker directly. More on this process can be found herehttps://docs.microsoft.com/en-us/azure/container-registry/container-registry-authentication
  3. Build your pdfd-tomcat container Navigate to your docker directory and call:

    docker-compose build pdfd-tomcat
    docker tag built_image_name azure_repository_addr/pdfd-tomcat
    docker push azure_repository_addr/pdfd-tomcat
  4. Go to Container instances and select Add.
  5. Fill in the required fields.
  6. Set your Container image type to Private.
  7. In Container image write the address of your previously uploaded container azure_repository_addr/pdfd-tomcat
  8. In Image registry login server write the address of your repository azure_repository_addr
  9. In Image registry username write the admin username for the repository.
  10. In Image registry password write the admin password for the repository. Click OK
  11. The Configuration page should now be shown.
  12. Set Port to 8090
  13. Set OS Type to Linux
  14. Set each Environment Variable to the variables you use under the environment section of the docker-compose.yml for example: "INCLUDE_DEMO":"true"
  15. Hit OK twice more and the container should now be deploying.

If you included the demo in this build, you should now be able to access the demo at container_instance_address:8090/demo?s

You can now attach this container instance server to your infrastructure. When attaching this container to your infrastrucutre, keep in mind the caching system for the server requires user stickiness to individual containers in order to work.

linkBuilding on Web Apps for Azure

It is possible to run WebViewer Server on Web Apps for Azure, but not advisable. Web Apps wraps our own web app in an apache container, which can create problems during deployment and after.