RiftWare installation (release 0)

There are two ways to set up a build environment suitable for building RIFT.ware.

OPTION 1 - If you have a recent Fedora machine (fc20 or later), you can extract the code from the ETSI repo, run the mkvmimg script in the scripts/vm_image directory with the -m build option and build your own VM image:

 # git clone https://osm.etsi.org/gerrit/osm/riftware.git rift
 # cd rift
 # ./rift-shell
 # ./scripts/vm_image/mkvmimage -c -m build -e 8

Note that the same procedure can produce a smaller image that only has the components needed to run RIFT.ware Launchpad

 # ./scripts/vm_image/mkvmimage -c -m ui

If you are curious about the packages needed to build and/or run RIFT.ware, examine the files in script/vm_image.

OPTION 2 - you can download the images from http://repo.riftio.com/releases/open.riftio.com/latest/rift-build-latest.qcow2

Launch the build VM, and log in with username/password root/toor or use Horizon to install your own ssh keys. Please allocate at least the following resources to the VM:

• 1 VCPU (16 recommended)
• 8 GB RAM (32 GB recommended)
• 40 GB disk storage available on the hypervisor to hold the disk image

Download the RIFT.ware source code from ETSI

# rm -rf /home/rift 
# cd /home
# git clone https://osm.etsi.org/gerrit/osm/riftware.git rift
# cd rift
# ./rift-shell
# make rw.ext

Download confd-basic-6.0.linux.x86_64.zip from Cisco DevNet Downloads and extract the file to a location on your system.

The zip archive contains several files, but you need only the following two:

• confd-basic-6.0.linux.x86_64.installer.bin
• confd-basic-6.0.libconfd.tar.gz

Move or copy the extracted confd files to the following directories on the VM. Type y (yes) if you are prompted to overwrite existing files.

# cd /home/rift
# mv confd-basic-6.0.linux.x86_64.installer.bin modules/ext/mgmt/confd_basic
# mv confd-basic-6.0.libconfd.tar.gz modules/ext/mgmt/libconfd/libconfd-basic-6.0
# chmod +x modules/ext/mgmt/confd_basic/confd-basic-6.0.linux.x86_64.installer.bin
# chmod +x modules/ext/mgmt/libconfd/libconfd-basic-6.0/confd-basic-6.0.libconfd.tar.gz

Note: In RIFT.ware 4.1.1, if the operator tries to use the Logs feature, LogAnalyzer is unable to access /var/log/rift/rift.log because permissions on /var/log/rift are set to 600. To resolve permissions issues, run: chmod 755 /var/log/rift

Build.

# make -j8 CONFD=BASIC rw

Start the RIFT.ware Launchpad service

Change to the /home/rift directory:

# cd /home/rift

Create the riftware-launchpad services directory:

# mkdir -p .install/var/rift/services/riftware-launchpad/

Copy the Launchpad helper scripts:

# cp -p scripts/packaging/services/riftware-launchpad/rwlp-start.sh .install/var/rift/services/riftware-launchpad
# cp -p scripts/packaging/services/riftware-launchpad/rwlp-stop.sh .install/var/rift/services/riftware-launchpad
# cp -p scripts/packaging/services/riftware-launchpad/rwlp.screenrc .install/var/rift/services/riftware-launchpad

Copy the rwlp.service to systemd location:

# install -p -D -m 644 scripts/packaging/services/riftware-launchpad/rwlp.service /usr/lib/systemd/system/rwlp.service

Reload systemd to process the new service:

# systemctl daemon-reload

Start the RIFT.ware Launchpad service:

# service rwlp start

if you have questions or hit any problems, please contact us at support-team@riftio.com