Part 2: Blue Planet Software Installation

You will complete all Blue Planet installation procedures as the non-root bpadmin user created in the Create the bpadmin user and Create the bpadmin user sudo privileges procedures.

Download the Blue Planet installation package

The following steps describe how to download and untar the Blue Planet installation package. Before you begin, contact your Ciena account representative for the installation package location and access credentials specific for your installation.

In a multi-host cluster, you can download the Blue Planet installation package to any host and complete the installation at each host in the cluster.

  1. Log in as the bpadmin user.

    su bpadmin

  2. Navigate to the bpadmin directory.

    cd /home/bpadmin

  3. Download and then untar Blue Planet installation package.

    tar -zxvf bp-docker-installer-16.10-0.2.7-3.0.0.tar.gz

Modify the log rotation settings (optional)

By default, Blue Planet keeps a maximum of 20 log files and limits the file size to 10 GB. If you want to change these settings, complete the following steps:

  1. Navigate to /home/bpadmin/bp-docker-installer/files/bp2-messages

    cd /home/bpadmin/bp-docker-installer/files/
cd bp2-messages

  2. Open the bp2-messages in a text editor and modify the rotate and maxsize parameters as needed.

/var/log/messages
{
    compress
    create 0644 root root
    rotate 20           // Maximum number of files to retain//
    maxsize 500M        // Maximimum file size//
    weekly
    missingok
    sharedscripts
    nodateext
    postrotate
        /bin/kill -HUP `cat /var/run/syslogd.pid 2> /dev/null` 2> /dev/null || true
    endscript
}

Configure the Docker container settings

Complete the following steps on the host where you downloaded the Blue Planet installation package to configure the settings.cfg file. This file will configure the Blue Planet Docker container.

  1. Switch to the bpadmin user, then navigate to /home/bpadmin/bp-docker-installer directory.

    su bpadmin
cd /home/bpadmin/bp-docker-installer/

  2. Open settings.cfg in a text editor and modify the following parameters as needed:

    • HOST_IPS--Add the IP address of each host, separated by a space, for example: 10.10.0.1 10.10.0.2 10.10.0.3.

    • DOCKER_DISK--Enter the Docker storage setup value. If you configured the server with a second disk for storage, enter DOCKER_DISK=/dev/sdb. If the server has a single storage disk, enter DOCKER_DISK=AUTO.

    • ILAN_INTF--Enter the appropriate value for the host environment Ethernet interface. In most cases, the interface name is eth0. To verify, enter the ifconfig command. A sample settings.cfg file is shown below.

######################
#  added host names
######################
#HOST_IPS=(10.10.0.1 10.10.0.2 10.10.0.3)
HOST_IPS=(10.10.0.1 10.10.0.2 10.10.0.3)

######################
#  ILAN NET
######################
ILAN_NET="172.16.0.0/16/24"

######################
#  Interface Name
######################
ILAN_INTF="eth0"

###########################################
#  Disk to use for Docker storage
# ex: /dev/sdb
# AUTO if you want the installer to find it
###########################################
DOCKER_DISK="/dev/sdb"

######################
#  Type of registries
#  Options:
#      BPDR
#      DOCKERREG
#      ARTIFACTORY
#      NONE
######################
REGISTRY="BPDR"
REMOTEUSER="bpadmin"

Install the Blue Planet host environment

Complete the following steps to install the Blue Planet host environment. The host environment includes the Ciena bp2hosttools package, Blue Planet Docker container, and Open vSwitch. The installation will configure the Blue Planet Docker container based on the configurations you entered in the Configure the Blue Planet Docker container settings procedure.

  1. Navigate to the bp-docker-installer directory.

    cd /home/bpadmin/bp-docker-installer/

  2. Switch to the bpadmin user, then run the `bp-docker-install.sh script. Complete this step on each host. (You will be required to enter the sudo password for bpadmin.)

    $ sudo su bpadmin
./bp-docker-install.sh --cfg settings.cfg

  3. Enter a basic Docker command to confirm the bp-docker-install.sh script automatically started Docker. Complete this step on each host.

    $ docker ps

  4. Configure the host names.

    [bpadmin@test ~]# bpssh hostname
host-0 ec: 0
   servername1.company.com
host-1 ec: 0
   servername2.company.com
host-2 ec: 0
   servername3.company.com
[bpadmin@test ~]#

Set the multi-host cluster site IP addresses

Setting the Blue Planet site IP address for multi-host clusters allows you to log in to the Blue Planet platform using a web browser. The site IP address must be on the same subnet for all hosts in the cluster.

NOTE: This procedure only applies to multi-host clusters and only needs to be completed on the host where you downloaded the Blue Planet installation package. It does not apply to single-host installations.

To provision the site IP address, enter the bpssh set-site-ip command, then provision the IP address for all hosts. The following is an example.

#  bpssh set-site-ip 10.0.3.250/24
host-1 ec: 0
Set site ip to 10.0.3.250/24
host-2 ec: 0
Set site ip to 10.0.3.250/24
host-3 ec: 0
Set site ip to 10.0.3.250/24
#

Verify host environment installation

Complete the following steps to verify the Blue Planet host environment installation.

  1. For a multi-host clusters, verify that no configuration differences exist across the hosts. (If your installation is single-host, you can skip this step.)

    $ sudo bp2-site diff-site-config

  2. Verify the ILAN connectivity.

    sudo bp2-site check-ilan

results matching ""

    No results matching ""