The Synergy SKY Platform is a Linux based VM image that can be hosted within most virtualized environments. This article describes deployment within Google Cloud Platform (GCP) environments including how to:
- Create the image in your cloud portal
- Create the VM Instance
- How to log into the Synergy SKY platform over SSH for the first time
- Generate SSH-Keys (Windows 10/OS X/Linux)
- Add your public key into Google
- Perform post install tasks
e2-standard-4 - 4 CPU, 16 GB RAM, 500 GB HDD (SSD mandatory)
n2-standard-4 - 4 CPU, 16 GB RAM, 500GB HDD (SSD mandatory)
Please refer to the General Requirements
|Google Cloud Account||
You have already signed up for a Google Cloud subscription
Step by Step Guide
Create the Image in Your Cloud Portal Images
- Starting from your GCP project dashboard, expand the left hamburger menu
- Scroll to 'Compute' section
- Expand the 'Compute Engine' menu
- Under 'Storage' select 'Images'
- Enable the Compute Engine & API if asked
Note: It may take a few minutes to spin up if this is the first time using these services
- At the top, click "[+]CREATE IMAGE"
- Name your image. e.g. "synergyskysuite"
- Change 'Source' to 'Cloud Storage file'
- Copy the following line into the 'Cloud Storage file' field
synergyskyappliance_images/synergysky-appliance-20.tar.gzNote: You should see a green checkbox confirming the path as correct
- Select a location that works best for your company
- Click 'Create' at bottom
This process will take a few minutes to complete. This image will be used for creating the virtual machine hosting the Appliance.
Creating the VM instance
- In the Compute Engine menu on the left, under 'Virtual machines' click 'VM instances'
- At the top, click '[+]CREATE INSTANCE'
- Name your Virtual machine according to your hostname standard
- Select appropriate region and zone
- In machine configuration select a configuration fulfilling the server requirements listed previously
- Under Boot disk section, click “change”
- Select the tab named “Custom images”
- Find “synergyskysuite” in the image list (make sure you are in the same project as you created the image in first paragraph).
- Set the boot disk type to: Standard persistent disk, 10GB
- Press select at the bottom of the screen
- Under Firewall, check both boxes for Allow HTTP & HTTPS traffic
- Expand the 'Management, security, disks, networking, sole tenancy' link
- Select the 'Disks' tab
- Click '+Add new disk'
- Name your disk e.g. "synergy-appliance1"
- Select type: SSD persistent disk
- Snapshot schedule can be set up to your company policy - but will effectively work as an automated backup, which is highly recommended.
- Source type: Blank
- Mode: Read/Write
- Size: 100GB or more
- Press Done.
- Now that the secondary disk is created, click Create. This will create our Platform instance on the GCP.
Logging in to the Synergy SKY platform over SSH for the first time
Google uses a login system that is based on public key login (not password), which means the client computer where you access the appliance from must have its SSH-public key added to Google. If you are already familiar with private/public keys over SSH, you can skip the following section.
Generate SSH-Keys (Windows 10/OS X/Linux)
- Open CMD/Powershell/terminal prompt.
- Generate your new pair of keys by typing: ssh-keygen
- Follow the prompt on the screen, for simplicity press enter now to not include password in your key-pair. However it is recommended to set a complex password on your private key.
- After the key has been generated, print the key out by opening the following file.
- <home directory>\.ssh\id_rsa.pub.
- Windows: notepad.exe .ssh\id_rsa.pub
- Linux/OS X: cat .ssh/id_rsa.pub
- Copy the content/key to your clipboard.
- You are now ready to add it into Google.
Add your public key into Google
- In the Compute Engine menu, under 'Settings', click 'Metadata'
- Select the 'SSH Keys' tab
- Click 'Add SSH Keys'
- Paste your public key (from the last paragraph) into the large text box.
- To add more keys, click the large '+ Add item' button
- At the end of the key - there is a username followed by @ and a hostname, change the username to “admin”
- joe@computername should say admin@computername
Post Install Tasks
- The first time you log into the Synergy SKY platform over SSH with the user admin, a process of setup the data-disk will start. It should take about a minute.
- Then additional first-time procedures will run for about 2 minutes.
- When you see the menu screen, you are ready to continue with the next step
Your instance should now be running and when you see the menu screen you can continue with the configuration as described in this article.