Install the OVA to try Continuous Delivery for PE

Use the Continuous Delivery for Puppet Enterprise (PE) open virtual appliance (OVA) to quickly install and set up the software without using Docker. The OVA is suitable only for trying out the features and workflows of Continuous Delivery for PE, and should not be used in production.

1. Download the OVA from the Continuous Delivery for PE downloads page.
2. Import the OVA to your virtualization platform following the vendor's documentation.
   Tip: For most desktop virtualization platforms, double-clicking the OVA file will launch the virtualization application and import the disk image.
3. When the virtual machine (VM) is booted, it prints its IP address in the VM console, which you'll need in the next step. Wait a few minutes for Continuous Delivery for PE to begin responding to requests.

   Logging into the VM isn't required, but you can do so with the following credentials:

   • Username: pipelines

   • Password: puppet

4. Navigate to the Continuous Delivery for PE web UI at http://<VM_IP_ADDRESS>:8080. In a second browser tab. open the Artifactory web UI at http://<VM_IP_ADDRESS>:8081.
   Tip: If the VM is not responding at the IP address printed in its console, make sure the VM's network configuration allows traffic to reach the VM.
5. Generate an Artifactory API key. Artifactory is used for storing Continuous Delivery for PE logs, job manifests, and artifacts.
   1. In the Artifactory web UI, click Log In and enter the following credentials:

      • Username: admin

      • Password: password

   2. Click Welcome, admin and select Edit Profile.
   3. In the Current Password field, enter password and click Unlock.
   4. Create an API key by clicking Generate .
   5. Copy the generated key and save it somewhere safe. You'll use it when configuring Continuous Delivery for PE.
6. In the Continuous Delivery for PE web UI, click Get Started and follow the prompts to configure your instance. You'll be asked to:

   1. Select the email address and password that will be associated with the root account.

      Note: The root account is used for installing and configuring your organization's Continuous Delivery for PE instance.
   2. Configure the endpoints Continuous Delivery for PE services will be available on:

      • WebUI: http://<VM_IP_ADDRESS>:8080

      • Backend Service: http://<VM_IP_ADDRESS>:8000

      • Agent Service: dump://<VM_IP_ADDRESS>:7000

   3. Configure storage. Select Artifactory and enter the following:

      • Artifactory Generic Binary Repository Name: generic-local

      • Artifactory Endpoint: http://<VM_IP_ADDRESS>:8081/artifactory/

      • Paste the Artifactory API key you generated earlier into the Artifactory Access Token field.

      • Leave the Path Prefix field blank.

   4. Upload a Continuous Delivery for PE license file. See Generate a license for instructions on creating a free 30-day trial license.
7. When configuration is complete, you'll see a success message. Click Create your user account to sign out of the root account.
   Tip: If your organization uses GitHub, return to the root console and set up your GitHub OAuth application before signing out as root. See Integrate with GitHub for instructions.