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
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.
# 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
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
Load rift shell and build
# rwmake CONFD=BASIC
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