Skip to content

Latest commit

 

History

History
233 lines (166 loc) · 12 KB

Cloud-Provider-Installation-of-Panamax-Client.md

File metadata and controls

233 lines (166 loc) · 12 KB
Raw

Cloud Provider Panamax Client Installation

NOTE: Although we do not recommend installing the Panamax Client(UI/API) on a Cloud Provider it is possible, below are some archived directions prior to the remote agent/adapter capability being available.

Do not treat any data on a publicly accessible provisioned Panamax Sever as private.

When installing Panamax Client on a cloud provider, ensure the CoreOS version matches the version listed on our release notes page for our stable release.

When installed on a cloud provider, Panamax will not alert you of updates. Check our release notes page frequently for information about the latest releases and features.

CenturyLink Cloud

This is a guide to installing Panamax on CenturyLink Cloud

Create a DHCP_PXE Server in CLC

  1. Login to your CLC control panel
  2. Add a VLAN (e.g. CoreOSVLAN) in the data center you want to deploy Panamax to. You need to add a VLAN specific for panamax. Here are specific steps to add a VLAN.
  3. Browse to Blueprints Library and deploy the DHCP-PXE Server blueprint. NOTE: Be sure to select the VLAN created above for network.

Create a CoreOS Server with Panamax

  1. Deploy the CoreOS Server with Panamax blueprint being sure to select the VLAN created above for the network.
  2. For the Execute on Server option, be sure to select the name of the DHCP_PXE server you created in the previous step, not the CoreOS machine you are currently creating. This is a very important step. The server credentials entered will NOT actually be used to login to the server as you will use SSH key authorization to access your CoreOS servers.
  3. After the Blueprint task is complete, view the build log and search for the text "IP Address of CoreOS Server" to obtain the IP address that was used for deploying the server. Take note of this address for future use as it will not be displayed in the control panel.

Panamax will be installed on the CoreOS machine by this point.

Final Configuration

  1. Add public access for Panamax by adding a public IP to the DHCP_PXE server from the control panel
  2. Open ports 22, 3000 for the Public IP
  3. SSH to the DHCP_PXE server on the Public IP with root & password given during blueprint creation: $ ssh root@<public IP>
  4. Make note of the IP of the CoreOS VM by running the following: $ tail /var/log/syslog.
  5. Make note of the private IP of the DHCP_PXE server by running: $ ifconfig.
  6. Change the sshd_config file on the DHCP_PXE server so that public access is allowed:
    • Add "GatewayPorts yes" to the file /etc/ssh/sshd_config
    • Run: $ service ssh restart
  7. Run the following command on the DHCP_PXE server to give access to 3000 from public IP: $ ssh -f -N root@<DHCP server private IP> -R *:3000:<Core OS Vm IP>:3000
  8. Access Panamax at http://public-IP:3000 !

NOTE: If you prefer not to expose a public IP to access Panamax, see these instructions.

Reconfiguration after DHCP_PXE reboots

When ever your DHCP_PXE server is rebooted, you need to restart the SSH tunnels between the DHCP server and the CoreOS VM. Following these steps to re-establish:

  1. Make note of the CoreOS private IP address by running the following on the DHCP_PXE server: $ cat /var/log/syslog - The IP will be included in the last entry.
  2. Run the following command on the DHCP_PXE server adding the IP address from above: $ ssh -f -N root@<DHCP_server_private_IP> -R *:3000:<CoreOS_private_IP>:3000

Amazon Web Services - EC2

This is a guide to installing Panamax on EC2 CoreOS AMI

Create a CoreOS VM in EC2

  1. Choose Launch Instance in EC2 Dashboard
  2. Select Community AMIs in AMI Selection wizard and search for CoreOS Stable.
  3. Make sure the AMI has the following specs at minimum: 1 vCPU, 4 GB RAM, 40 GB HDD. For example, m3.medium at a minimum.
  4. Select Auto-assign Public IP as enabled.
  5. Change storage to Root (/dev/xvda) to 40GB General Purpose (SSD)
  6. Configure the following security rules by opening the following ports:
    • 22,TCP, Source= Anywhere
    • 3000, TCP, Source = Anywhere
    • If your App requires additional ports, make sure to go back and add them.)
  7. Create and save your key as a local file (e.g coreos-private-key.pem).
  8. Run $ chmod 400 coreos-private-key.pem to change permission on .pem file to use in SSH

Install Panamax

  1. Once the VM is created, SSH into the box with:

    $ ssh -i coreos-private-key.pem core@<AMI public DNS ID or Public IP of the VM>

  2. Run: $ sudo su

  3. Download & unzip the latest setup script from http://download.panamax.io/installer/panamax-latest.tar.gz:

    $ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz && mkdir -p /var/panamax && tar -C /var/panamax -zxvf panamax-latest.tar.gz

  4. Change to the /var/panamax directory: $ cd /var/panamax

  5. Run: $ ./coreos install --stable

  6. Once the installer completes, you can access panamax at: http:// _Public IP_ :3000/

See our Known Issues page for items related to an EC2 installation.

Brightbox

Create a CoreOS VM on Brightbox

  1. Create a new server group with the following Firewall rules:
    • 22,TCP, Source= Anywhere
    • 3000, TCP, Source = Anywhere
    • Any additional ports your application requires
  2. On the Image Library dashboard, search for the CoreOS Stable, and create a new Cloud Server
    • Select the server cloud create above
    • Use, at minimum, the Small (2GB) Server type
  3. Create a new public IP on the Cloud IPs dashboard and assign it to the newly created CoreOS server

Install Panamax

  1. Once the VM is created, SSH into the box. NOTE: you previously needed to upload your public key to Brightbox.

    $ ssh core@<Public IP of the VM>

  2. Run: $ sudo su

  3. Download & unzip the latest setup script from http://download.panamax.io/installer/panamax-latest.tar.gz:

    $ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz && mkdir -p /var/panamax && tar -C /var/panamax -zxvf panamax-latest.tar.gz

  4. Change to the /var/panamax directory: $ cd /var/panamax

  5. Run: $ ./coreos install --stable

  6. Once the installer completes, you can access panamax at: http:// _Public IP_ :3000/

Digital Ocean

Create a CoreOS VM on Digital Ocean

  1. Be sure to upload your Public ssh key to Digital Ocean prior to creating your CoreOS VM
  2. Create a new droplet and select CoreOS Stable - Use, at minimum, the 2GB server type
  3. After the droplet is created, view its detail and via the Settings section, select the Networking tab - make note of your public IP address.

Install Panamax

  1. Once the VM is created, SSH into the box. NOTE: you previously needed to upload your public key to Digital Ocean.

    $ ssh core@<Public IP of the VM>

  2. Run: $ sudo su

  3. Download & unzip the latest setup script from http://download.panamax.io/installer/panamax-latest.tar.gz:

    $ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz && mkdir -p /var/panamax && tar -C /var/panamax -zxvf panamax-latest.tar.gz

  4. Change to the /var/panamax directory: $ cd /var/panamax

  5. Run: $ ./coreos install --stable

  6. Once the installer completes, you can access panamax at: http:// _Public IP_ :3000/

Vultr

Create a CoreOS VM on Vultr

  1. Follow these instructions using http://stable.release.core-os.net/amd64-usr/<stable_version_number>/ in the set base-url statement.
  2. When creating your VM, be sure to select the 2CPU, 2GB flavor at a minimum.
  3. Make note of the public IP for your CoreOS VM after its created

Install Panamax

  1. Once the VM is created, SSH into the box.

    $ ssh core@<Public IP of the VM>

  2. Run: $ sudo su

  3. Download & unzip the latest setup script from http://download.panamax.io/installer/panamax-latest.tar.gz:

    $ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz && mkdir -p /var/panamax && tar -C /var/panamax -zxvf panamax-latest.tar.gz

  4. Change to the /var/panamax directory: $ cd /var/panamax

  5. Run: $ ./coreos install --stable

  6. Once the installer completes, you can access panamax at: http:// _Public IP_ :3000/

OpenStack

Running Panamax In CoreOS On Top Of OpenStack

Rackspace

Create a CoreOS VM on Rackspace

  1. Go to the Cloud Control Panel
  2. Click Create Server
  3. Name: panamax
  4. Image: Linux > CoreOS > Stable
  5. Flavor: Performance 1 > 4 GB Performance
  6. Advanced Options: (Optional) Create or use an existing SSH key for this server
  7. Click Create Server
  8. Note the password and IPv4 address (when it appears)

Install Panamax

  1. Once the VM is created, SSH into the box. If you used an SSH key, you can use that here instead of the password.

    $ ssh root@<Public IPv4 of the VM>

  2. Download & unzip the latest setup script from http://download.panamax.io/installer/panamax-latest.tar.gz:

    $ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz && mkdir -p /var/panamax && tar -C /var/panamax -zxvf panamax-latest.tar.gz

  3. Change to the /var/panamax directory: $ cd /var/panamax

  4. Run: $ ./coreos install --stable

  5. Once the installer completes, you can access panamax at: http://<Public IPv4 of the VM>:3000/

Google Compute Engine

First, install the Google Cloud SDK and log in.

$ gcloud auth login

Next, create a project in the developer console. The project ID should look something like golden-cove-408. For convenience, you should set that as the default in the tools.

$ gcloud config set project golden-cove-408

Now enable billing. Note that anything you do past this point can and will cost you money. Navigate to the project console and choose the billing settings, then click enable.

In order to create GCE machines, you need to initialize it in the browser at least once. Go to Compute->Compute Engine->VM instances and wait for it to show up with a screen that has a "create an instance" button.

The included cloud-config.yaml file will set up the CoreOS machine to automatically download and install Panamax on the first boot.

Run ./provision.sh (from: https://github.com/CenturyLinkLabs/panamax-contrib/tree/master/providers/gce) with the first argument as the hostname of the machine. The script will automatically provision a 50GB data drive for docker containers as well as the machine Panamax will run on.

Before provisioning, you might want to add a user config to the user-data. Here is an example:

users:
  - name: xena
    gecos: Xena Cadenza
    groups:
      - sudo
      - docker
    coreos-ssh-import-github: Xe

PLEASE NOTE THAT IF YOU DO NOT DO THIS STEP YOU MAY NOT BE ABLE TO SSH INTO YOUR MACHINE. YOU HAVE BEEN WARNED.

$ ./provision.sh caml

In testing the install of Panamax takes about 15 minutes. If you want you can monitor this install by ssh'ing into the machine as soon as you can and then running journalctl -u install-panamax.service -f.

As soon as the unit finishes, Panamax will be installed on your GCE node.