Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Launching Pentaho VMI in Azure

You can launch a new Pentaho Virtual Machine Image (VMI) from the Microsoft Azure Marketplace. To use the Pentaho VMI, you must create a customized netwwork security group (NSG) and select or create an SSH key pair during the launch configuration. You can then install your licenses to activate the software after you launch an instance of the VMI.

Launch the Pentaho VMI instance

Perform the following steps to launch an instance of the Pentaho VMI from the Azure Marketplace:


  1. Go to the Azure Marketplace, then search for Pentaho VMI.

  2. Click the Pentaho VMI card found in the serach results to view details and terms.

  3. Review the product details and terms, then click Create to initiate the launch. The Create a virtual machine page opens.

  4. Provide the following information for the fields in the Project details and Instance details sections of the Create a virtual machine page:

    SubscriptionSelect your Microsoft Azure subscription.
    Resource groupSelect an existing resource group or create a new one.
    Virtual machine nameSpecify a name for your virtual machine.
    RegionSelect the Azure region where you want to deploy your virtual machine.
    Availability optionsSelect the availability option that best suits your requirements.
    ImageDo not change the pre-populated value for this field.
  5. In the Administrator account section of the Create a virtual machine page, specify Username and Password or select SSH public key if you already have a valid key pair.

    NoteIf you select SSH public key, you must specify a public key that corresponds to the private key you will use to securely connect to the VMI instance.
  6. Click Next: Disks > to proceed to the OS disk section of the Create a virtual machine page, then select the desired OS disk type and adjust disk size and type as needed.

  7. Click Next: Networking > to proceed to the Network interface section of the Create a virtual machine page, then specify the virtual network and subset of a Network Security Group (NSG) that has access to ports 22 and 8080.

  8. (Optional) Click through the remaining sections of the Create a virtual machine page to configure any additional settings as needed.

  9. Click Review + Create to review the launch configuration, then click Create instance to start the instance.

Next steps

Once the instance is running, you can connect to it using SSH and the private key file for the key pair you selected or created.

Apply licenses

After launching an instance of Pentaho in the marketplace, perform the following steps to apply your Pentaho licenses to the instance:


  1. Copy or download the Pentaho license files to your local computer.

    NoteIf you do not already have your Pentaho license keys, you can obtain them from your Pentaho sales representative in the form of Pentaho license files.
  2. Navigate to the Pentaho Server at http://<private ip>:8080

  3. Log in as the Evaluation Admin User.

    You are redirected to the License Management page in the Administrative perspective.
  4. Click the Add (+) icon in License Keys to add a new license.

  5. Click Choose Files.

    1. Select the server license file from your local computer.

    2. Click Upload to upload the license keys.

    After you enter the server license key, the Pentaho Server activates, and you are redirected to the Home page in the Pentaho User Console.
  6. (Optional) Navigate back to the License Management page to complete any additional license key entries needed.


Your instance is licensed and ready to use.

See also

Also refer to the follow information regarding administration of the Pentaho installation, upgrades, and client tools

Administration of Pentaho in your instance

The Pentaho software is owned by the pentaho user. A PostgreSQL repository is also installed on this instance and owned by the postgres user. Neither user has a password. You can only access these users via the sudo command.

The Pentaho software and the PostgreSQL data files are installed on the second volume (/install). The /install/pentaho directory is symlinked to the /opt/pentaho directory.

Pentaho Server

Pentaho is installed as an auto-start service in your instance. To check the status of the Pentaho Server, SSH to the machine and run the following command:

sudo systemctl status pentaho

See Logging and performance monitoring and Troubleshooting for further details on maintaining the Pentaho Server.


See Pentaho upgrade for instructions on how to apply service packs and upgrades with the Pentaho Upgrade Installer.

Client tools

The following information helps to extend your knowledge of client tool installation, the Pentaho Repository, and run configurations of remote jobs from the Pentaho Data Integration (PDI) client (also known as Spoon):