Step 1

Log in to the Ubuntu server or Red Hat server as root or a user with sudo privileges, where Cisco ONP is to be installed.

Step 2

Create the 25.1.1_Build folder under ONP_Builds to keep all the required files for the installation.

user@host:~/Desktop$ mkdir ONP_Builds/25.1.1_Build

Step 3

Copy or download the Cisco ONP build tar, signature file, and public key file to the created ONP_Builds directory.

Step 4

Go to the $ONP_HOME directory and perform these steps:

1. Assign full permission to the build tar.

   Example:

   cd /home/user/Desktop/ONP_Builds

   sudo chmod 777 CONP-xx-xx.xx.xx.tar.gz

2. Untar the Cisco ONP build.

   tar -xvf CONP-xx-xx-xx.xx.tar.gz

3. Set read, write, and execute permissions for the Install script, and ONP folders using these commands.

   sudo chmod -R 777 ONP
   sudo chmod 777 Installer.sh
   

4. Check whether curl is installed in the server by entering this command.

   root:~/$ONP_HOME# curl

   If you see this output, curl is installed. Otherwise, install curl.

   curl: try 'curl --help' or 'curl --manual' for more information

   To install curl, run this command.

   root:~/$ONP_HOME# sudo apt install curl

5. Enter y or n to change the default IP address.

   Would you like to change the IP (y/n)

   If you enter n, the installation proceeds with the same IP address as mentioned above and if you enter y, you must provide the IP address and the installation proceeds with the IP address that is provided by you.

   ONP Host IP: 10.76.82.14

Step 5

Start Cisco ONP installation. Type the command sudo ./<install file> <tar file> <public key>,” and press Enter.

sudo ./Installer.sh CONP-xx.xx.xx.xx.tar.gz CONP-xx.xx.xx.xx_pem.pubkey

1. Enter y or n to change the default IP address.

   Would you like to change the IP (y/n)

   If you enter n, the installation proceeds with the same IP address as mentioned above and if you enter y, you must provide the IP address and the installation proceeds with the IP address that is provided by you.

   ONP Host IP: 10.76.82.14

2. Enter your ONP database credentials.

   Note

   Make sure to use ONLY alphabets or numbers. If you are installing Cisco ONP for the first time, you must set the username and password for the database. Would you like to set database username and password (y/n). The above option appears only when you already have the 24.3.1 image installed and upgrade to 25.1.1. Otherwise you are prompted to enter ONP database username. If you enter y, then prompt appears and asks you to enter username and password. If you enter n, you can proceed with the next step.

   Enter your ONP database username, only alphanumeric characters are valid [user]:

   Enter your ONP database password, only alpha numeric characters are valid (len >= 8 and <= 64 characters) [password]:

   Repeat your ONP database password.

Step 6

Wait for the installation to complete.

root:~/$ONP_HOME# sudo docker ps

Step 7

After you confirm that all the mentioned services in the previous step are up, you can access the Cisco ONP using the Google Chrome, Mozilla Firefox, or Microsoft Edge browser pointing to Ubuntu server hostname or IP address.

Step 8

To install the SSF component, refer the README file for SSF installation.

Step 1

Install Cisco ONP 25.1.1 image using the steps 1 to 5 of the procedure Install Cisco ONP.

Step 2

In the displayed table, find out the container ID that is corresponding to the image "cnp_postgress image - dockerhub.cisco.com/cnp-rpt-dev-docker/postgres:14.9"

Step 3

Use this command to enter inside the container.

#docker exec -it <cnp_postgress container ID> bash 

1. Use the command in the container to log into the database.

   psql -U <db_username> CnpDB

2. After you log in the database you will see this message.

   psql (14.9)
    Type "help" for help
    CnpDB=#

3. Enter the command Analyze;.

   This command takes a few minutes based on your database size.

4. Enter the command DROP TABLE IF EXISTS databasechangeloglock.

   This command removes Liquibase Lock if it exists and enables seamless login and design activities after upgrade from R24.3.1 to R25.1.1.

5. Enter Exit to come out of the database.

Step 4

Enter Exit to come out of the container.

Step 1

Open the Google Chrome browser.

Step 2

In the browser's address bar, enter https://hostname or https://ipaddress, where hostname or IP address belongs to the Ubuntu server used for Cisco ONP installation, for example: https://cisco-onp-server.cisco.com or https://10.76.82.14.

Step 3

Enter admin and cisco123 as the default username and password.

Step 4

Click Login to log into Cisco ONP.

Step 5

To change the administrator password, perform these actions in the prompt.

1. Enter Old Password.

2. Enter New Password.

   As you enter the password, the Cisco ONP prompt displays the strength of the password in different colors.

3. Enter Repeat New Password to confirm the new password.

4. Click Update.

   Wait until the Password updated successfully message appear.

Step 1

Log into the server where Cisco ONP is hosted.

Step 2

Use the cd command, to go to the path /opt/cnp/nginx/conf/ssl.

cd /opt/cnp/nginx/conf/ssl 

Step 3

Delete the existing self-signed certificates.

Step 4

Copy the Certificate Authority (CA)-signed certificates, then paste the certificates and key.

Step 5

Edit the ssl_certificate and ssl_certificate_key filenames in the default.conf file (located at /opt/cnp/nginx/conf) so that they match the new certificate and key filenames.

server { 
listen 443 ssl default_server;
server_name localhost;
ssl_certificate /etc/nginx/ssl/cnp_dev_selfsigned.crt;
ssl_certificate_key /etc/nginx/ssl/cnp_dev_selfsigned.key;
ssl_protocols TLSv1.2 TLSv1.3;
client_max_body_size 200M;

Step 6

Restart Cisco ONP. See Restart Cisco ONP.

Step 1

Go to $ONP_HOME.

Step 2

Execute this command:

sudo docker stack rm cnp

Step 3

Go to $ONP_HOME/ONP:

cd /home/user/Desktop/ONP_Builds/ONP

sudo docker stack deploy -c images/conf/docker-compose.yml --resolve-image=never cnp  

Run these commands one-by-one:

sudo docker stack rm cnp
sudo docker swarm leave --force

sudo apt -y purge docker-ce
sudo apt -y purge docker-ce-cli
sudo rm -rf /var/lib/postgresdb_cnp
sudo rm -rf /opt/cnp
sudo rm -rf /var/log/cnp
sudo rm -rf /var/log/nginx
sudo docker image prune -a -f
sudo rm -rf ONP
sudo rm -rf Installer.sh
sudo rm -rf SSF.sh
sudo rm -rf README.md

Step 1

Download and install the latest version of Oracle VirtualBox on your Windows or Mac laptop. See https://www.virtualbox.org/wiki/Downloads and https://www.youtube.com/watch?v=x5MhydijWmc.

Step 2

Download the Ubuntu 22.04 Desktop AMD64 image from the link: https://releases.ubuntu.com/focal/ and install it on the VirtualBox.

Step 3

Install VirtualBox Guest Additions to share the clipboard operations and to share the folder access between the Host and Guest operating systems. See Installing and Maintaining Guest Additions.

Step 4

Download the Cisco ONP tar build, public key, and signature files from https://www.cisco.com/c/en/us/support/optical-networking/optical-network-planner/series.html#%7Etab-downloads to the Host Windows laptop or MacBook, and copy it into the shared folder mounted as in Step 3.

Step 5

Log in to the VirtualBox and access the Cisco ONP tar build, public key, and signature files through the shared folder.

Step 6

Open the terminal in the VirtualBox, navigate to the shared folder and, install Cisco ONP. See 4.a .

Step 7

To log into Cisco ONP see Log into Cisco ONP.

Step 1

Click on the Windows Start button and search for Ubuntu.

Step 2

Right click on Ubuntu and select and click Uninstall.

Step 3

Open Windows PowerShell and type the command wsl -l .

Step 4

Unregister Ubuntu by typing the command wsl --unregister Ubuntu .

Run this command to list all running containers.

$sudo docker ps