Skip to content

getting-started.md

Latest commit

 

History

History
64 lines (49 loc) · 4.18 KB

getting-started.md

File metadata and controls

64 lines (49 loc) · 4.18 KB
layout blog_section
title Getting Started
permalink /getting-started/

The CloudRouter project aims to provide a variety of cloud-ready distribution formats, including disk images, Docker images and OSv images. The CloudRouter 1.0 beta release is currently available as a pre-configured disk image. To install it, follow the instructions below.

Download

Two CloudRouter 1.0 Beta images are available: minimal and full. The minimal image includes the Fedora 20 base with updates applied and the CloudRouter repo pre-configured. The full image also includes several pre-installed packages to support software-defined interconnect, such as Bird, Quagga, and OpenDaylight.

Version x86_64 Image Image Checksum Manifest
Minimal Download 374 MB Download Download 8 KB
Full Download 947 MB Download Download 12 KB

Install

  • CloudRouter can be run on a variety of cloud hosts. For local testing purposes, the KVM hypervisor with virt-manager is recommended. To install the image using virt-manager, follow these steps:
  • Uncompress the image:
$ unxz CloudRouter-Beta-Full-20150321.x86_64.raw.xz
  • Verify that the SHA-512 checksum is correct:
$ sha512sum CloudRouter-Beta-Full-20150321.x86_64.raw.xz
d73619f8aea2df8be134ab6ad28cb7ad89711388a0774ac6009cefcfa82aa3ccd4a7a3de4b59c4503307c39258b2c6934234b501059cca693d6f76664bae8ac2  CloudRouter-Beta-Full-20150321.x86_64.raw.xz
  • Create a new virtual machine in virt-manager. When prompted, select the “Import existing disk image” option. Select CloudRouter-Beta-Full-20150321.x86_64.raw as the disk image. Alternatively, use virsh as shown in this video.
  • Select appropriate memory and CPU resources. 2048MB memory and 2 vCPUs are recommended.
  • Start the virtual machine.

At this point you have CloudRouter running, but cannot login. For enhanced security, the CloudRouter image ships without any default credentials. A default “cloudrouter” user is provided, but no password is set. To set a password, you must create a metadata ISO image.

  • Create a metadata ISO based on the instructions in this blog post. Alternatively, a pre-built metadata ISO is available here. This ISO sets the fedora user’s password to “CloudRouter”. DO NOT use this ISO in production, it is strictly for test and demonstration purposes.
  • In virt-manager, attach the metadata ISO to the CloudRouter VM as a CDROM storage device.
  • Reboot your VM and login. Enjoy!

Next Steps

CloudRouter 1.0 beta is based on the Fedora 20 cloud image, and includes a distribution of OpenDaylight Helium SR3. For information on installing and running OpenDaylight on CloudRouter, see the Running OpenDaylight wiki page. For more details on using OpenDaylight, see the upstream OpenDaylight Getting Started Guide.