How to Install Helix Core on Azure
Get Started with Azure Resource Manager (ARM)
The Perforce Helix Core ARM template uses our best practice Server Deployment Package (SDP) to set up a single VM instance with a single Data volume. This includes licenses for 5 free users and up to 20 workspaces.
Use the following instructions to get started in minutes.
- Navigate to the template, located on the Azure Marketplace.
- Click Deploy Azure or browse on Github. This allows you to create your own resource group.
- Fill out required parameters for your virtual machine (VM).
|_artifactsLocation||Define a location where artifacts required by this template are stored including a trailing '/'. The default value is correct for normal deployments so does not need to be modified.|
|artifactsLocationSasToken||For testing only – leave it blank.|
|location||Define an Azure location (region) where these resources will be deployed. Defaults to the current user location within Azure portal.|
|OS||Define the operating system (OS) of the VM. Select "CentOS 7.x" (7.8+), "RHEL 7.x" (7.8+), or "Ubuntu 18.04 LTS". Defaults to "CentOS 7.x"|
|VMSize||Select the size of the VM you wish to deploy. Read more about sizing options here.|
We recommend compute-optimized instances, e.g. Fsv2 series options such as "Standard_F4s_v2" or "Standard_F8s_v2" etc depending on how many cores/RAM required.
Note: You can use a cheaper instance type to create and test, and then migrate to a more powerful (and expensive) for production.
Not sure what size you need? Start here >>
|dataDiskSize||Select the size of the data disk you want to deploy to hold your metadata, logs, and depot (archive files). This is an integer value in GB, with a minimum of 10 and a maximum of 2,048 (meaning 2TB).|
|p4Port||Define a P4PORT value to connect to server from your Helix Core client programs such as P4V (via ssl). Defaults to 1666.|
|swarmPort||Define a port for Helix Swarm (Apache) to be setup. Defaults to 80. Setting up with https will require suitable certificates to be installed.|
|adminUsername||Define a username to use with ssh to access your VM. Default is "p4admin". Your ssh command would be “ssh [email protected]” if you leave it as the default value.|
|adminSSHPubKey||Specify a public key to access the VM via SSH for the adminUsername. You may use your own public SSH key or create one specifically for use with this instance.|
|source_CIDR||Define an IP access list. For security, we strongly recommend you only allow specific whitelisted IP addresses to access the server. By default, the server is wide open ("0.0.0.0/0") which allows anyone to connect.|
|helix_admin_password||Define a password to access Helix Core as a super user for the account “perforce”. You will need to remember this value to login to the Helix Core server once installed and perform administrative tasks (such as creating depots or administering other user accounts).|
- Click Review and Create.
- Once you have thoroughly reviewed, you are ready to deploy your instance.
Connect to Your Instance
- Connect to the provisioned instance with the P4PORT ssl:<IP Adress>:1666 as user “perforce” with the configured password (helix_admin_password) using a standard Helix Core client application such as P4V or the “p4” command line interface.
- Start coding!
Want Help Setting Up Perforce?
Contact our professional services team to talk with our experts. They can optimize your Helix Core servers for top performance.
Do More With P4V
Setting Perforce is easy with our P4V cheat sheet.
Read the Docs
Get step-by-step instructions on how to install, administer, optimize, and use Helix Core.