Build UI and SO from Source

This topic describes how to install the RIFT.ware platform using packages. Then you clone the UI and SO repos from the RIFT.ware GitHub repository and build them. Finally, you'll start the Launchpad application.

Note: If you prefer to build the RIFT.ware platform from source, see Build Platform from Source. Then return to this topic and start with Step 4 ("Clone UI and SO from GitHub and build") under Install UI and SO .

Requirements

Dependency	Requirement	Notes
Release Notes	Read the Release Notes at https://open.riftio.com/documentation/. Filter the Branch drop-down menu for the version of RIFT.ware that you plan to install.	This document contains important information you need to know about before you install RIFT.ware.
Workspace	Have a single virtual machine or containerSelf-contained execution environments that contain their own CPU, memory, I/O, and network resources – anything you can install on a server. Containers share the kernel of the host operating system, which makes them feel like a virtual machine without the added overhead of a guest operating system. or server with Ubuntu 18.04 LTS as the base image.	You can download an image from http://releases.ubuntu.com/18.04/. RIFT.ware supports AMD64 images.
Host machine	The host machine (virtual machine or container or server) must be able to allocate the following minimum resources to the RIFT.ware Launchpad: Recommended 8 vCPU (1 vCPU minimum) Recommended 32768 MB RAM (8192 MB minimum) Recommended 40 GB disk storage (30 GB minimum)	The minimum resources support a proof-of-concept environment.
Port availability	Your system must not be running services or software that the RIFT.ware Launchpad uses. If you are using a container environment, ports must be forwarded from the host.	See Port Requirements.

Install UI and SO

To transfer files from a Linux or Macintosh client, use curl or wget. From a windows client, use PuTTY or WinSCP. In the fetch, specify the URL, instead of an IP address. For example, wget -option URL.

Note: If you have already built the RIFT.ware platform from source, proceed directly to Step 4.

1. Create a container for Ubuntu 18.04 with port-forwarding for the standard list of ports (see Port Requirements). Alternatively, use a bare-metal host or a VM running Ubuntu 18.04.

2. Download the RIFT.ware platform script.

   wget -nd http://repo.riftio.com/releases/open.riftio.com/5.1.2/install-riftware 
   

3. Install the RIFT.ware platform from packages:

   bash install-riftware platform
   

4. Clone the UI and SO repos from GitHub and build the software:

   git clone https://github.com/RIFTIO/UI
   cd UI
   git checkout RIFT.ware-5.1.2.0
   make -j<XX> CONFD=CONFD_BASIC
   sudo make install CONFD=CONFD_BASIC
   cd ..
   git clone https://github.com/RIFTIO/SO
   cd SO
   git checkout RIFT.ware-5.1.2.0
   make -j<XX> CONFD=CONFD_BASIC
   sudo make install CONFD=CONFD_BASIC
   

   Note: For -j <XX> commands, replace <XX> with a value no greater than the total number of vCPUs in the VM.

   If you are using less than the recommended RAM, replace <XX> with the value 1.

5. Start the Launchpad application.

   sudo -b -H /usr/rift/rift-shell -r -i /usr/rift -a /usr/rift/.artifacts -- ./demos/launchpad.py

6. Browse to the RIFT.ware UI.