Skip to main content

Deploying Guzzle on Microsoft Azure

Guzzle software gets deployed on a virtual machine using the pre-built image on the Microsoft Azure cloud. You can deploy Guzzle on an existing Virtual Network or a new Virtual Network.

Prerequisites#

You need an Azure account to proceed. You will be billed only for the virtual machine instance. The Guzzle image itself is free.

Deployment of Guzzle Virtual Machine#

  • You can login to Azure Portal, go to Marketplace and search Guzzle: Data Engineering Workbench V2

  • Open the Guzzle page on Azure marketplace here. Alternatively you can login to Azure Portal, go to Marketplace and search Guzzle: Data Engineering Workbench for Spark

  • Click on "Create" which will take you to Azure Portal, Create virtual machine blade.

  • Enter a name for your Virtual Machine and select your Username and Password or SSH key (do not use "guzzle" as username).

  • Enter a new Resource group name or use existing one.

  • You can retain default values for remaining VM Settings or override them suitable as per your requirement.

  • You can deploy Guzzle VM on existing VNET or a new VNET, restrict network access of Guzzle VM to only allow required inbound and outbound traffic and apply additional best practices for securing VM as per your organization policy.

  • D family size with 2 vCPUs and 8 GB RAM for the virtual machine should be enough for the initial deployment.

  • Review and create virtual machine. Wait for a few minutes for the instance to start.

How tos#

How do I use Guzzle?#

  • Guzzle is available on HTTPS, on the port 443 on the Azure VM instance.

  • To access Guzzle - Launch browser with the URL https://VM_PUBLIC_ADDRESS where VM_PUBLIC_ADDRESS is the instance public IP address (available in the details of your virtual machine). If you have domain name associated for your VM then we can access guzzle using the URL https://DNS_NAME.

  • Guzzle is pre-loaded with a self-signed certificate, so you will get a security warning when you launch it for the first time. Later on you can replace this self-signed certificate with the valid certificate in the VM.

  • The default user and password for the guzzle instance is admin/admin.

note

Only Chrome browser is supported.

  • Before starting to use Guzzle it is recommended to upgrade Guzzle to latest avaliable version. This can be done by going to top menu Manage and further navigate to Maintenance->Upgrade

How do I log into the shell of virtual machine instance?#

Administrative (command-line) access can be obtained by logging-in through SSH using the credentials specified when creating the virtual machine.

Note: Guzzle app does not run under this VM administrator account, but under guzzle user id. The administrative account is sudoer, so from its shell, you can use sudo su — guzzle to get a shell as guzzle user.

You cannot directly login as the guzzle user. Also guzzle user is not sudoer.

What are the Guzzle directories?#

The Guzzle has two key directories that gets deployed on the VM. These are referred in Guzzle App using following environment variables.

  • GUZZLE_PRODUCT_HOME: This is located in the path /guzzle

  • GUZZLE_HOME: This is located in the path /guzzle/guzzlehome

note

Environment variables GUZZLE_PRODUCT_HOME and GUZZLE_HOME are defined in guzzle service startup related configuration. These environment variables are accessible to Guzzle App but by default they are not available when you are on shell as guzzle user.

All operations on these directories (like installing JDBC drivers, …) must be performed as guzzle user.

What is installed by default?#

Guzzle image is based on Ubuntu Server 20.04 LTS. It contains:

  • Guzzle (2.0.1) - A standard installation of Guzzle App running under Linux user account guzzle.
  • MySQL Server (8.0) - A local MySQL server database, with a connection to it pre-configured in Guzzle App.
  • OpenJDK (1.8.0_292)
  • Blobfuse (1.3.8)
  • Nginx (1.18) - Nginx reverse proxy exposing Guzzle API server and Guzzle static resources on the standard HTTPS port 443 using a self-signed certificate. For better security, you can provide your own certificate in the directory /guzzle/cacerts.
  • Apache Spark (3.1.2)

How do I install JDBC drivers and other third party libraries?#

JDBC drivers and external libraries must be installed by copying the relevant files in the "$GUZZLE_HOME/libs/ext" folder (See Installing database drivers).

You can either download files from the virtual machine instance or upload them using SSH. Copying into the "$GUZZLE_HOME/libs/ext" folder must be done as Guzzle user.

Edit this page