RiftWare installation (release 0)

From OSM Public Wiki
Revision as of 19:32, 30 March 2016 by Mordkoff (talk | contribs) (Created page with "There are two ways to set up a build environment suitable for building RIFT.ware. You can extract the code from the ETSI repo, run the mkvmimg script in the scripts/vm_image d...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

There are two ways to set up a build environment suitable for building RIFT.ware. You can extract the code from the ETSI repo, run the mkvmimg script in the scripts/vm_image directory with the -m build option or you can download it from open.riftio.com Download under Binary Resources, save the Fedora based build VM (rift-build-latest) to your system.

building your own build VM image on any recent fedora system

 # 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

or you can download the images from https://open.riftio.com/download/

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://github.com/RIFTIO/RIFT.ware.git rift
# git clone https://osm.etsi.org/gerrit/osm/riftware.git rift
# cd rift

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

# ./rift-shell
# 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