FAQ Optics Lab

Answers to common questions about the WS Labs are provided below. If you have additional questions, please contact us



Who can use the Optics Labs?

Any potential customer who wants to explore applications and solutions based on Optics technology. Register now to get started!

What Optics Labs are offered?

We offer a Dedicated Private Labs which can be requested from our Lab Catalog. While we continue to enrich our offering, we welcome your feedback to help us build the labs that meet your needs.

Where are the labs hosted?

All Labs are deployed on bare metal servers in the Equinix public cloud. You can choose to deploy in their Silicon Valley or Amsterdam data centers.

What happens on the lab teardown date?

Your lab is available until 23:59 UTC of the teardown date. After that it will be automatically torn down.

Can I change the teardown date of my deployed lab?

Yes, the teardown date can be changed by requesting for a new teardown date. Select the Info icon info icon from My Labs to see the lab details and request a new teardown date.

Can I delete my lab prior to the teardown date?

Yes, simply select the Delete icon delete icon for your lab from My Labs.

Do you provide support for my Optics labs?

There is no SLA for the Sandbox. Please contact us with your questions. We will make our best effort to get back to you.

How do I setup a VPN tunnel to my lab?

You can setup a VPN tunnel to your lab following the platform specific instructions:

Windows
  1. Download the latest Open VPN client from: https://openvpn.net/index.php/open-source/downloads.html
  2. Install the Open VPN client, by running the installation file you downloaded as Administrator and perform a default installation
  3. Copy the client.ovpn file that you were emailed to the directory C:\Users\<user_name>\OpenVPN\config where <user_name> is your windows login
  4. Run the Open Vpn GUI client as Administrator
  5. Right click on the OpenVPN client icon in the taskbar and select Connect
  6. The VPN tunnel is established when the Open VPN client icon is green

NOTE: If you are connectting through a HTTP proxy then you will need to enable the http-proxy option in the client.ovpn file

See https://community.openvpn.net/openvpn/wiki/Openvpn24ManPage for more details

MacOS

A popular OpenVPN client for MacOSX is Tunnelblick. It can be obtained for free from https://tunnelblick.net/. Follow these basic steps to use Tunnelblick with OpenVPN

  1. Download the Tunnelblick_version.dmg file from https://tunnelblick.net/
  2. Open the downloaded disk image file (which mounts the disk image)
  3. Drag the Tunnelblick icon (may be labelled "Tunnelblick.app") to your Applications folder
  4. Copy the config.ovpn configuration filke that was emailed to you to ~/Library/Application Support/Tunnelblick/Configurations folder on the Mac
  5. Run Tunnelblick by double-clicking its icon in the Applications folder
  6. The first time Tunnelblick is run on a given Mac, it will ask the user for the user's password (on the Mac system). This is because Tunnelblick must have root privileges to run, as it modifies network settings as part of connecting to the VPN

For more information on using Tunnelblick, see https://tunnelblick.net/czUsing.html

NOTE: If you are connectting through a HTTP proxy then you will need to enable the http-proxy option in the client.ovpn file

See https://community.openvpn.net/openvpn/wiki/Openvpn24ManPage for more details

Linux
  1. Install an OpenVPN client
    Usually the easiest way to install an OpenVPN client is to use the package management system for your particular Linux distribution
    Run one of the following commands as root:
    • Fedora/CenOS/RedHat:
      yum install openvpn
    • Ubuntu/Debian:
      apt-get install openvpn
  2. Copy the client configuration file (client.ovpn) that you were emailed to a directory on the Linux machine
  3. Run the following command in the directory wher you saved the client configuration file
    openvpn --config client.ovpn

NOTE: If you are connectting through a HTTP proxy then you will need to enable the http-proxy option in the client.ovpn file

See https://community.openvpn.net/openvpn/wiki/Openvpn24ManPage for more details

Please refer to the OpenVPN site for more details.

How to create backup of my lab?

Go to My Labs page, click on  icon to exand the lab details section. Select the 'Backup and Restore' tab, provide a description and click on the Backup button as shown below.

How to restore the backup of my lab?

Go to My Labs page, click on  icon to exand the lab details section. Select the 'Backup and Restore' tab, select the Default or custom created backup from the drop-down and click on the Restore button as shown below.

Can the access to the lab be granted to a customer that wants to test integration of its OSS with WS-NOC?

The lab can be accessed by anyone who is connected to the vpn (openvpn in this case), details of which is provided in the email that the user receives upon successful deployment of the lab. If the customer connects to the openvpn from his OSS server then the applications in lab will be accessible for integration from the OSS server.

What are the important features a user should know for WaveSuite applications?

Important features for WaveSuite application are captured as How-to use cases. User can access HTML page of swagger and also the postman collection for each use case. From network developer portal home page, navigate to navigate to Resources > Optical Networking and click required WaveSuite application How-to for the list of use-cases.

Where are the User Guides hosted and how to get access to view the same?

WaveSuite application user guides are hosted in the Nokia Doc center. New users will be prompted to login when trying to access restricted content from the Doc Center. 
There is a link to a form labeled “New User?” that needs to be completed to gain access to the Nokia Doc Center documentation. The Portal Registration form is located at https://online.networks.nokia.com/newaccount/email.faces. To know more about the support Portal User Registration Process, see the video https://onestore.nokia.com/asset/212293 .

How to enable Swagger for WS-P? (As swagger is by default not enabled in WS-P)

Follow the steps below to enable swagger in WS-P application:
a. Navigate to the service configuration file by entering the following command: /usr/lib/systemd/system/wsp-xx.x.service.d/ where xx.x is the WaveSuite Planner release number.
Example: /usr/lib/systemd/system/wsp-23.7.service.d

b. Edit wsp.conf configuration file, for the WSP_OPTIONS variable, add the swagger ui enable command and set it to true as shown in the example and save the configuration file.

Example: --springdoc.swagger-ui.enabled=true


c. Reload the configuration and restart the WaveSuite Planner. # sudo systemctl daemon-reload # sudo systemctl restart wsp-xx.x where xx.x is the WaveSuite Planner release number

d. Enable the service if disabled. # sudo systemctl enable wsp-xx.x where xx.x is the WaveSuite Planner release number.

For more details, see Enabling Swagger from the WaveSuite Planner application section in WaveSuite Planner REST API Guide. Release specific link for REST API Guide can be found at https://network.developer.nokia.com/learn/optical-management-apis/ws-p-downloads/

Quick links to all the resources in the DevOps portal

Quick links to resources in network developer portal can be accessed here:

https://network.developer.nokia.com/learn/wavesuite/optical-network-automation/#Quick_links_to_resources

How to create an account in network developer portal to access the WaveSuite application?

On the home page of network developer portal, User can click Create account and register in the network developer portal.
Email, Name, Company, Role and Password details are required to create a new account. Once an account is created, user can login using the registered the Email.

What is the authentication procedure for the WaveSuite application?

Single step authentication procedure is specifically designed to be used for North Bound Interface (NBI) in WS-NOC, WS-RC, and WS-O. The authentication procedure includes the REST calls to Get token and Refresh token. Revoke token can be used to invalidate the token and prevent any further calls to the applications.

Note: Refer the table to execute the deployment scenarios. n the following table:

  • For stand-alone mode configuration, the serverIP is mainVMIP.
  • For shared mode configuration, the serverIP is NSP server IP. Do not specify the port number (for example, 8443) with the NSP server IP.
  HTTP Method Type Sample URL Body Returns HTTP Status Code
Get Token POST https://{{serverIP}}/rest-gateway/rest/api/v1/auth/token grant_type=client_credentials {access_token}, {refresh_token}, {expires_in} 200
Refresh Token POST https://{{serverIP}}/rest-gateway/rest/api/v1/auth/token grant_type=refresh_token {access_token}, {refresh_token}, {expires_in} 200
Revoke Token POST https://{{serverIP}}/rest-gateway/rest/api/v1/auth/token token = VEtOLWFkbWluOTI5ZjU3NjktMTBkNy0 & token_type_hint=token   200

 

How do I get to know the features of a release?

Optical Network Release Changes page in network developer portal gives the release specific features for WaveSuite application.
Navigate from Learn > Optical Networking and click required wavesuite application. To view the list of new and updated features supported for the release, click Optical Networking Releases link. Also, Release Change link for each application can be found at https://network.developer.nokia.com/learn/wavesuite/optical-network-automation/#Quick_links_to_resources

What is the difference in the APIs for two releases?

API Diff tab in the API documentation page provides the API change log between two releases. To view the list of APIs that are new, deleted/deprecated, and changed, select the Source and Target releases from the drop-down. From the network developer portal home page, navigate to Resources > Optical Networking and click required WaveSuite application API documentation to see API Diff tab.