Lumina SDN Controller (LSC) is Lumina’s SDN controller distribution based on the industry leading OpenDaylight project. We recently released version 7 of LSC which is based on OpenDaylight Nitrogen release. Lumina offers a free license for LSC (to manage up to 5 network nodes for 1 year) so that interested users can try it out for themselves. In this introductory blog post, we will take you through the steps for downloading and installing LSC. Detailed steps for the same are available in LSC Software Installation Guide.

Step 1: Create an account by visiting the My Account link on Lumina Networks website. Submit your information using Register form. Upon registering, you will receive two emails from Lumina – one for email verification and another with your Lumina user-id. Click on the verification link in email to complete the registration process.

Step 2: Login to the web site using Login form with your registered credentials.

Step 3: Once you are logged in, click on the down arrow next to Download link. Select the first option – Lumina SDN Controller Trial.

Step 4: Click on the “Download Trial” at the end of the description.

Step 5: Click on “Free Trial” button.

Step 6: Enter the billing details. Review and accept the Terms & Conditions and EULA. Click the Submit button.

Step 7: Depending on the target installation platform type, download either the Debian or RPM LSC package. (Optional) Download the LSC Documentation package.

LSC Documentation package contains below doc files:

You can review information in these files to become more familiar with LSC and the installation process.

Doc Name Description
lumina-sdn-controller-7.1.0-quick-start-guide.pdf Summary of steps for installing LSC
lumina-sdn-controller-7.1.0-software-installation-guide.pdf Detailed instructions for installing and configuring LSC
lumina-sdn-controller-7.1.0-release-notes.pdf List of modified features and known issues in this version of LSC
lsc-app-topology-manager-7.1.0-release-notes.pdf List of modified features and known issues in this version of Lumina Topology Manager application that is part of LSC distribution

LSC DEB/RPM package contains below files:

Step 8: Extract the LSC package on the target machine. Depending on which LSC feature you want to use, run either the “install” or “unpack” script.

Running the “install” script will install all the packages bundled in the distribution.
Running the “unpack” script will only unpack the packages bundled in the distribution and make them available for installation. You can then use the package manager manager commands for the target platform (i.e. apt-get or yum) to selectively install only the required packages.

NOTE: Both “install” and “unpack” must be run with superuser (sudo) privileges.

When “install” script is run, output like below will be displayed:

When prompted for confirmation, reply in affirmative by typing “y” and press Enter.

The following screenshot shows sample output generated when “unpack” script is run. It will by default print out all available extensions and apps that you can install.

After “unpack” script execution finishes, you can install individual packages as needed. The following screenshot shows the installation of BGP/PCEP extension of Lumina SDN Controller.

Again, when prompted, answer in affirmative by typing “y” and press Enter.

Step 9: Start the Lumina controller by running “sudo service lumina-lsc start” command.

Step 10: Check the karaf log (located under directory /opt/lumina/lsc/controller/data/log) and verify that the installed extensions come up successfully. Taking BGP/PCEP module as an example, you will find lines in the log indicating that the corresponding module has got loaded.

Step 11: Login to the Karaf client with command “sudo -u lumina /opt/lumina/lsc/bin/client”.

Step 12: Verify that the LSC core and extensions are successfully installed and service is started. For example, if you want to verify BGP/PCEP module is installed, execute command “feature:list -i | grep bgpcep” in karaf console. You should be able to see the LSC bgpcep extension listed.

“feature:list” will list all features available to the controller and managed by karaf.
“-i” option will filter the feature list and display installed ones only
“grep xxx” will filter the output and display entries contain keyword “xxx” only.

Optionally, you can verify all installed LSC modules with command “feature:list -i | grep lsc”. You should see a bunch of LSC features listed.

Congratulations! You have successfully downloaded and installed the Lumina SDN Controller (LSC) distribution. More details about LSC components and installation options are available in the Software Installation Guide provided in LSC Documentation package.

See How Lumina Can Transform Your Network.