Launch a NetFoundry Gateway on Linode

We look forward to general availability of Linode's one-click app offering. That will make it easier to launch NF on Linode. Meanwhile, we'll give you some guidance here for uploading our RAW disk image to a Linode that you'll use to create a disk image saved in Linode Cloud Manager. You can then create any number of Linodes from the saved image.

Important! Cloud Manager's images are at first limited to 2GB, and NF's image is 3GB. You will need to first ask Linode Support to raise your image size limit to allow the image to be created.

Create a Linode Cloud Manager Image

  1. Create a Linode of standard size 2GB or larger with the Linode CentOS 7 image. This will be used only to save the image in Cloud Manager. We’ll call this Linode the “prototype”. You will notboot this Linode after writing the RAW .img file to the disk. You can delete the prototype Linode after the “Imagize” step is complete.

  2. Reference Linode’s documentation for copying a disk image over SSHto write the RAW disk .img file to the unmounted block device that will become the NF GW's root disk. Here’s a summary of the steps you’ll need in that linked document.

    1. Download the compressed RAW .img file for Linode from the NF web site.

    2. Boot the prototype Linode in rescue mode assigning the “CentOS 7” disk to the /dev/sda device.

    3. Set root’s password and start sshd.

    4. passwd && service ssh start
    5. Run a command on the computer where the compressed RAW image file was downloaded.

    6. ssh root@1.2.3.4 "bunzip2 | dd of=/dev/sda” < ./NFN_VCPE_RAW.img.bz2
    7. In the rescue session’s terminal perform a filesystem check.

    8. e2fsck -f /dev/sda
    9. Power off the prototype Linode. Do not boot!

  3. Go to Linode > Advanced > Configuration and use the context menu for the “CentOS 7” disk to select “Imagize”. This will create a saved image in Cloud Manager. Give it a name like “NF GW 2019-05-13”.
    This step will fail if you have not yet obtained an image size limit increase from Linode Support.

  4. You may delete the prototype Linode when the Imagize step is complete.

Deploy a New Linode from the Image

  1. In the Cloud Manager left sidebar navigate to Images

  2. Use the context menu for the newly created image named like “NF GW 2019-05-13” to “Deploy New Linode”. We’ll refer to this as the “gateway” , and you can repeat these steps to create additional gateways.

  3. Choose a Linode of standard size 2GB or larger.

  4. Choose “Create” and wait for first boot of the gateway to complete.

  5. Power off the gateway Linode to allow the disk to be resized.

  6. Navigate to the Linode in Cloud Manager and go to Advanced > Disks and use the context menu to Resize as desired e.g. the value for “Maximum size”.

  7. Back in Cloud Manager > Linode > Advanced > Configuration modify the boot configuration with the context menu > Edit to set the Boot Settings > Kernel to “GRUB2”. Save this change.

  8. Use the context menu to "Boot This Config".

  9. Use the console to log in with the password you assigned to root when the gateway Linode was created.

  10. NF Cloud Gateway enforces mandatory access controls with SELinux, and so some files must be removed that were improperly created during the first boot. NF is working with Linode developers on a workflow that is more SELinux-friendly.
    touch /.autorelabel
  11.  

    Reboot the Linode to re-generate the files with proper security context.

  12. Proceed to login with SSH and register with your NF network!

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.