Helix Core and DigitalOcean give your teams everything they need to build the next great game and more. Learn how to deploy your DigitalOcean server and start developing.

Define Your DigitalOcean Environment

  1. Sign up for a DigitalOcean account.
  2. Once signed in, you can:
    1. Go to our marketplace listing.
    2. Search for “perforce” in the marketplace.
      Search for Perforce in the Marketplace
  3. Click Create Perforce Helix Core Droplet.
    Create Perforce Helix Core Droplet
  4. On the Helix Core deployment page, fill out the parameters to configure your deployment to match your needs.
    1. Choose a plan: We recommend starting with a “Regular Intel with SSD” $15 per month instance. This can be changed any time in the future to scale up or down.
    2. Choose a datacenter region: For the region, we recommend selecting a region closest to your end users or a region that meets your compliance/security needs.
    3. Authentication: We highly recommend selecting an existing SSH key or uploading a new SSH key. It is not recommended to use a password for the root user.
    4. Choose a hostname: Give your droplet a name.  We recommend helix-core-${environment}.  For example: helix-core-production
    5. Add Backups
      1. We highly recommend enabling backups. A daily checkpoint will be created and will back up the Helix Core P4D metadata database to the local filesystem. By adding DigitalOcean droplet backups, a snapshot of the entire volume will be created. This snapshot will include all your depot data and your checkpoints. This would allow you to perform a restore if something happened to your droplet.
    6. Click Create Droplet.
      Create Droplet

DigitalOcean Console Overview

Your deployment is complete when the blue progress bar disappears. Click on your droplet name to be taken to the droplet details page.

Find Your Deployment Outputs

Once on the droplet details page, take note of the following areas:

  • IPv4 – This is the public IP address of your Helix Core (P4D) server and will be used when connecting clients like, Helix Visual Client (P4V) and Helix Sync.
  • On/Off – This switch can be used to turn your droplet on and off.
  • Access – If you are not familiar with using SSH but need to gain command line access to the operating system, this access page is a good solution.
  • Resize – Scale up or down the size of your CPU, memory, etc. on this page.
  • Backups – If you did not opt into backups at initial deployment, you can enable backups any time.
Perforce Helix Core Development

Connection Options

You can also use the DigitalOcean web UI to connect to your instance. To connect:

Web Console

  1. Navigate to your droplet.
  2. Click on your Perforce Helix Core droplet.
  3. In the left sidebar, click Access.
  4. Type in “root” as the user.
  5. Click Launch Droplet Console.
  6. Once logged in, you can see the message of the day on how to switch to the “perforce” user.
  7. Switch to the “perforce” user and try the command “p4 info”.
  8. Close window as necessary.
Connection Options

SSH

Username: root
Server: <IPv4>

Example command:
ssh [email protected]

Your Credentials

Helix Core Credentials

Use the following connection details for connecting to Helix Core using Helix Visual Client (P4V) and the Helix Core Command-line (P4 CLI).

Server = ssl:<IPv4>:1666
User = perforce
Password = << a GUID in the file /root/perforce.password >>

You will need to connect to your Droplet via one of the options detailed under “Connection Options”.  Once connected run ‘cat /root/perforce.password’ to find your Helix Core password

<IPv4> correspond to your droplet’s IPv4 public IP address found in the Find Your Deployment Outputs section.

Example:
Server = ssl:52.186.76.548:1666
User = perforce
Password = c6ec239f-876f-424d-b575-994986b37330

Access Your Helix Core Server Using Helix Visual Client (P4V)

  1. Download Helix Visual Client (P4V).
  2. Enter in the connection details on the Remote Server tab:
    Server = ssl:“<IPv4>:1666
    User = perforce
    Password = See Your Credentials tab for details
  3. Click OK.
  4. Establish connection by clicking the checkbox “Trust this fingerprint” and click Connect.
  5. In the displayed password prompt, enter the password for the perforce user, which defaults to <HelixCoreInstanceID> output value.
    Open Connection 1
    Open Connection 2
    Perforce Password Required
  6. For more information, see the P4V User Guide.

Access Your Helix Core Server Using Helix Sync

  1. Download Helix Sync.
  2. Enter in the connection details:
    Server = ssl:“<IPv4>:1666
    Username: perforce
    Password = See Your Credentials tab for details
  3. Click Connect.
    HelixSync Connect
  4. For more information, see the Helix Sync User Guide.

Update Firewall Rules

Initial deployment of Helix Core on DigitalOcean does not come with any firewall rules. This means a person that holds valid Helix Core credentials can connect from anywhere in the world.

We recommend using a security best practice by implmenting a layered approach. The first layer is providing each user with their own username and password. A recommended second layer is to add DigitalOcean firewall rules. DigitalOcean provides this feature at no charge.  Review the DigitalOcean documentation for adding a firewall rule to your droplet.

For the type, use custom. For the Protocol, use TCP. For the Port Range, use 1666. For the source, we recommend you visit https://whatismyipaddress.com and use the value from IPv4.

Authenticating to the Helix Core Operating System

Username: root
Server: <P4CommitPublicIP>

Example command:
ssh [email protected]

Now you are logged in as the root user. To perform any Helix Core administration task, switch to the perforce user and log into Helix Core with the following commands:

sudo su - perforce
p4login -v 1

You are now logged into Helix Core (P4D) as the perforce user. You have the P4 CLI binaries in your $PATH

To perform OS administration, you can become root with the following command:
sudo -s

What’s Next: Day 2 Operations

Congrats on launching your Perforce Helix Core droplet!

This is just the first step in your journey. Since you’re now using just a virtual machine (VM), that’s only one piece of the puzzle. In order to scale this VM to be globally replicated, secure, compliant and scalable , check out our Enhanced Studio Pack offerings.

The Enhanced Studio Pack offers pre-configured templates that include set smart defaults. It allows you to quickly set up your Helix Core environment and get up and running fast on your cloud provider.  the cloud. Learn how we have companies accelerate in the cloud.

This DigitalOcean listing only includes a virtual machine image, in comparison to our Enhanced Studio Pack offerings on Azure and AWS. These offerings include infrastructure as code (ARM Template and Cloudformation respectively) and various virtual machine images across our product suite.  If you compare our best practices on Azure and on AWS, you will notice a large difference between what is offered.

Need Support?

Support can be reached by emailing: [email protected]

When emailing support, please include details about your Helix Core server configuration.

  1. Go into Helix Visual Client P4V.
  2. Click Help.
  3. Click System Info.
  4. Copy and paste the contents of System Info into your email to support.
Support

Need Help

Contact our professional service team to talk to experts.

More on Cloud

Review your options.

Read Docs

We're here every step.