installers/charmed_install.sh

   1 #! /bin/bash
   2 #
   3 #   Licensed under the Apache License, Version 2.0 (the "License");
   4 #   you may not use this file except in compliance with the License.
   5 #   You may obtain a copy of the License at
   6 #
   7 #       http://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 #   Unless required by applicable law or agreed to in writing, software
  10 #   distributed under the License is distributed on an "AS IS" BASIS,
  11 #   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 #   See the License for the specific language governing permissions and
  13 #   limitations under the License.
  14 #
  15
  16 # set -eux
  17
  18 LXD_VERSION=4.0
  19 JUJU_VERSION=2.9
  20 JUJU_AGENT_VERSION=2.9.22
  21 K8S_CLOUD_NAME="k8s-cloud"
  22 KUBECTL="microk8s.kubectl"
  23 MICROK8S_VERSION=1.23
  24 OSMCLIENT_VERSION=10.0
  25 IMAGES_OVERLAY_FILE=~/.osm/images-overlay.yaml
  26 PATH=/snap/bin:${PATH}
  27
  28 MODEL_NAME=osm
  29
  30
  31 OSM_BUNDLE=ch:osm
  32 OSM_HA_BUNDLE=ch:osm-ha
  33 CHARMHUB_CHANNEL=10.0/edge
  34 unset TAG
  35
  36 function check_arguments(){
  37     while [ $# -gt 0 ] ; do
  38         case $1 in
  39             --bundle) BUNDLE="$2" ;;
  40             --overlay) OVERLAY="$2" ;;
  41             --k8s) KUBECFG="$2" ;;
  42             --vca) CONTROLLER="$2" ;;
  43             --lxd) LXD_CLOUD="$2" ;;
  44             --lxd-cred) LXD_CREDENTIALS="$2" ;;
  45             --microstack) MICROSTACK=y ;;
  46             --ha) BUNDLE=$OSM_HA_BUNDLE ;;
  47             --tag) TAG="$2" ;;
  48             --registry) REGISTRY_INFO="$2" ;;
  49             --only-vca) ONLY_VCA=y ;;
  50         esac
  51         shift
  52     done
  53
  54     # echo $BUNDLE $KUBECONFIG $LXDENDPOINT
  55 }
  56
  57 function install_snaps(){
  58     if [ ! -v KUBECFG ]; then
  59         KUBEGRP="microk8s"
  60         sudo snap install microk8s --classic --channel=${MICROK8S_VERSION}/stable
  61         sudo usermod -a -G microk8s `whoami`
  62         sudo cat /var/snap/microk8s/current/args/kube-apiserver | grep advertise-address || (
  63                 echo "--advertise-address $DEFAULT_IP" | sudo tee -a /var/snap/microk8s/current/args/kube-apiserver
  64                 sg ${KUBEGRP} -c microk8s.stop
  65                 sg ${KUBEGRP} -c microk8s.start
  66             )
  67         mkdir -p ~/.kube
  68         sudo chown -f -R `whoami` ~/.kube
  69         sg ${KUBEGRP} -c "microk8s status --wait-ready"
  70         KUBECONFIG=~/.osm/microk8s-config.yaml
  71         sg ${KUBEGRP} -c "microk8s config" | tee ${KUBECONFIG}
  72     else
  73         KUBECTL="kubectl"
  74         sudo snap install kubectl --classic
  75         export KUBECONFIG=${KUBECFG}
  76         KUBEGRP=$(id -g -n)
  77     fi
  78     sudo snap install juju --classic --channel=$JUJU_VERSION/stable
  79 }
  80
  81 function bootstrap_k8s_lxd(){
  82     [ -v CONTROLLER ] && ADD_K8S_OPTS="--controller ${CONTROLLER}" && CONTROLLER_NAME=$CONTROLLER
  83     [ ! -v CONTROLLER ] && ADD_K8S_OPTS="--client" && BOOTSTRAP_NEEDED="yes" && CONTROLLER_NAME="osm-vca"
  84
  85     if [ -v BOOTSTRAP_NEEDED ]; then
  86         CONTROLLER_PRESENT=$(juju controllers 2>/dev/null| grep ${CONTROLLER_NAME} | wc -l)
  87         if [ $CONTROLLER_PRESENT -ge 1 ]; then
  88             cat << EOF
  89 Threre is already a VCA present with the installer reserved name of "${CONTROLLER_NAME}".
  90 You may either explicitly use this VCA with the "--vca ${CONTROLLER_NAME}" option, or remove it
  91 using this command:
  92
  93    juju destroy-controller --release-storage --destroy-all-models -y ${CONTROLLER_NAME}
  94
  95 Please retry the installation once this conflict has been resolved.
  96 EOF
  97             exit 1
  98         fi
  99     else
 100         CONTROLLER_PRESENT=$(juju controllers 2>/dev/null| grep ${CONTROLLER_NAME} | wc -l)
 101         if [ $CONTROLLER_PRESENT -le 0 ]; then
 102             cat << EOF
 103 Threre is no VCA present with the name "${CONTROLLER_NAME}".  Please specify a VCA
 104 that exists, or remove the --vca ${CONTROLLER_NAME} option.
 105
 106 Please retry the installation with one of the solutions applied.
 107 EOF
 108             exit 1
 109         fi
 110     fi
 111
 112     if [ -v KUBECFG ]; then
 113         cat $KUBECFG | juju add-k8s $K8S_CLOUD_NAME $ADD_K8S_OPTS
 114         [ -v BOOTSTRAP_NEEDED ] && juju bootstrap $K8S_CLOUD_NAME $CONTROLLER_NAME \
 115             --config controller-service-type=loadbalancer \
 116             --agent-version=$JUJU_AGENT_VERSION
 117     else
 118         sg ${KUBEGRP} -c "echo ${DEFAULT_IP}-${DEFAULT_IP} | microk8s.enable metallb"
 119         sg ${KUBEGRP} -c "microk8s.enable ingress"
 120         sg ${KUBEGRP} -c "microk8s.enable storage dns"
 121         TIME_TO_WAIT=30
 122         start_time="$(date -u +%s)"
 123         while true
 124         do
 125             now="$(date -u +%s)"
 126             if [[ $(( now - start_time )) -gt $TIME_TO_WAIT ]];then
 127                 echo "Microk8s storage failed to enable"
 128                 sg ${KUBEGRP} -c "microk8s.status"
 129                 exit 1
 130             fi
 131             storage_status=`sg ${KUBEGRP} -c "microk8s.status -a storage"`
 132             if [[ $storage_status == "enabled" ]]; then
 133                 break
 134             fi
 135             sleep 1
 136         done
 137
 138         [ ! -v BOOTSTRAP_NEEDED ] && sg ${KUBEGRP} -c "microk8s.config" | juju add-k8s $K8S_CLOUD_NAME $ADD_K8S_OPTS
 139         [ -v BOOTSTRAP_NEEDED ] && sg ${KUBEGRP} -c \
 140             "juju bootstrap microk8s $CONTROLLER_NAME --config controller-service-type=loadbalancer --agent-version=$JUJU_AGENT_VERSION" \
 141             && K8S_CLOUD_NAME=microk8s
 142     fi
 143
 144     if [ -v LXD_CLOUD ]; then
 145         if [ ! -v LXD_CREDENTIALS ]; then
 146             echo "The installer needs the LXD server certificate if the LXD is external"
 147             exit 1
 148         fi
 149     else
 150         LXDENDPOINT=$DEFAULT_IP
 151         LXD_CLOUD=~/.osm/lxd-cloud.yaml
 152         LXD_CREDENTIALS=~/.osm/lxd-credentials.yaml
 153         # Apply sysctl production values for optimal performance
 154         sudo cp /usr/share/osm-devops/installers/60-lxd-production.conf /etc/sysctl.d/60-lxd-production.conf
 155         sudo sysctl --system
 156         # Install LXD snap
 157         sudo apt-get remove --purge -y liblxc1 lxc-common lxcfs lxd lxd-client
 158         sudo snap install lxd --channel $LXD_VERSION/stable
 159         # Configure LXD
 160         sudo usermod -a -G lxd `whoami`
 161         cat /usr/share/osm-devops/installers/lxd-preseed.conf | sed 's/^config: {}/config:\n  core.https_address: '$LXDENDPOINT':8443/' | sg lxd -c "lxd init --preseed"
 162         sg lxd -c "lxd waitready"
 163         DEFAULT_MTU=$(ip addr show $DEFAULT_IF | perl -ne 'if (/mtu\s(\d+)/) {print $1;}')
 164         sg lxd -c "lxc profile device set default eth0 mtu $DEFAULT_MTU"
 165         sg lxd -c "lxc network set lxdbr0 bridge.mtu $DEFAULT_MTU"
 166
 167         cat << EOF > $LXD_CLOUD
 168 clouds:
 169   lxd-cloud:
 170     type: lxd
 171     auth-types: [certificate]
 172     endpoint: "https://$LXDENDPOINT:8443"
 173     config:
 174       ssl-hostname-verification: false
 175 EOF
 176         openssl req -nodes -new -x509 -keyout ~/.osm/client.key -out ~/.osm/client.crt -days 365 -subj "/C=FR/ST=Nice/L=Nice/O=ETSI/OU=OSM/CN=osm.etsi.org"
 177         local server_cert=`cat /var/snap/lxd/common/lxd/server.crt | sed 's/^/        /'`
 178         local client_cert=`cat ~/.osm/client.crt | sed 's/^/        /'`
 179         local client_key=`cat ~/.osm/client.key | sed 's/^/        /'`
 180
 181         cat << EOF > $LXD_CREDENTIALS
 182 credentials:
 183   lxd-cloud:
 184     lxd-cloud:
 185       auth-type: certificate
 186       server-cert: |
 187 $server_cert
 188       client-cert: |
 189 $client_cert
 190       client-key: |
 191 $client_key
 192 EOF
 193         lxc config trust add local: ~/.osm/client.crt
 194     fi
 195
 196     juju add-cloud -c $CONTROLLER_NAME lxd-cloud $LXD_CLOUD --force
 197     juju add-credential -c $CONTROLLER_NAME lxd-cloud -f $LXD_CREDENTIALS
 198     sg lxd -c "lxd waitready"
 199     juju controller-config features=[k8s-operators]
 200 }
 201
 202 function wait_for_port(){
 203     SERVICE=$1
 204     INDEX=$2
 205     TIME_TO_WAIT=30
 206     start_time="$(date -u +%s)"
 207     while true
 208     do
 209         now="$(date -u +%s)"
 210         if [[ $(( now - start_time )) -gt $TIME_TO_WAIT ]];then
 211             echo "Failed to expose external ${SERVICE} interface port"
 212             exit 1
 213         fi
 214
 215         if [ $(sg ${KUBEGRP} -c "${KUBECTL} get ingresses.networking -n osm -o json | jq -r '.items[$INDEX].metadata.name'") == ${SERVICE} ] ; then
 216             break
 217         fi
 218         sleep 1
 219     done
 220 }
 221
 222 function deploy_charmed_osm(){
 223     if [ -v REGISTRY_INFO ] ; then
 224         registry_parts=(${REGISTRY_INFO//@/ })
 225         if [ ${#registry_parts[@]} -eq 1 ] ; then
 226             # No credentials supplied
 227             REGISTRY_USERNAME=""
 228             REGISTRY_PASSWORD=""
 229             REGISTRY_URL=${registry_parts[0]}
 230         else
 231             credentials=${registry_parts[0]}
 232             credential_parts=(${credentials//:/ })
 233             REGISTRY_USERNAME=${credential_parts[0]}
 234             REGISTRY_PASSWORD=${credential_parts[1]}
 235             REGISTRY_URL=${registry_parts[1]}
 236         fi
 237         # Ensure the URL ends with a /
 238         case $REGISTRY_URL in
 239             */) ;;
 240             *) REGISTRY_URL=${REGISTRY_URL}/
 241         esac
 242     fi
 243
 244     echo "Creating OSM model"
 245     if [ -v KUBECFG ]; then
 246         juju add-model $MODEL_NAME $K8S_CLOUD_NAME
 247     else
 248         sg ${KUBEGRP} -c "juju add-model $MODEL_NAME $K8S_CLOUD_NAME"
 249     fi
 250     echo "Deploying OSM with charms"
 251     images_overlay=""
 252     if [ -v REGISTRY_URL ]; then
 253        [ ! -v TAG ] && TAG='latest'
 254     fi
 255     [ -v TAG ] && generate_images_overlay && images_overlay="--overlay $IMAGES_OVERLAY_FILE"
 256
 257     if [ -v OVERLAY ]; then
 258         extra_overlay="--overlay $OVERLAY"
 259     fi
 260
 261     if [ -v BUNDLE ]; then
 262         juju deploy --trust --channel $CHARMHUB_CHANNEL -m $MODEL_NAME $BUNDLE --overlay ~/.osm/vca-overlay.yaml $images_overlay $extra_overlay
 263     else
 264         juju deploy --trust --channel $CHARMHUB_CHANNEL -m $MODEL_NAME $OSM_BUNDLE --overlay ~/.osm/vca-overlay.yaml $images_overlay $extra_overlay
 265     fi
 266
 267     if [ ! -v KUBECFG ]; then
 268         API_SERVER=${DEFAULT_IP}
 269     else
 270         API_SERVER=$(kubectl config view --minify | grep server | cut -f 2- -d ":" | tr -d " ")
 271         proto="$(echo $API_SERVER | grep :// | sed -e's,^\(.*://\).*,\1,g')"
 272         url="$(echo ${API_SERVER/$proto/})"
 273         user="$(echo $url | grep @ | cut -d@ -f1)"
 274         hostport="$(echo ${url/$user@/} | cut -d/ -f1)"
 275         API_SERVER="$(echo $hostport | sed -e 's,:.*,,g')"
 276     fi
 277     # Expose OSM services
 278     juju config -m $MODEL_NAME nbi site_url=https://nbi.${API_SERVER}.nip.io
 279     juju config -m $MODEL_NAME ng-ui site_url=https://ui.${API_SERVER}.nip.io
 280     juju config -m $MODEL_NAME grafana site_url=https://grafana.${API_SERVER}.nip.io
 281     juju config -m $MODEL_NAME prometheus site_url=https://prometheus.${API_SERVER}.nip.io
 282
 283     echo "Waiting for deployment to finish..."
 284     grafana_leader=`juju status -m $MODEL_NAME grafana | grep "*" | cut -d "*" -f 1`
 285     grafana_admin_password=`juju run -m $MODEL_NAME --unit $grafana_leader "echo \\$GF_SECURITY_ADMIN_PASSWORD"`
 286     juju config -m $MODEL_NAME mon grafana_password=$grafana_admin_password
 287     check_osm_deployed
 288     echo "OSM with charms deployed"
 289 }
 290
 291 function check_osm_deployed() {
 292     TIME_TO_WAIT=600
 293     start_time="$(date -u +%s)"
 294     total_service_count=14
 295     previous_count=0
 296     while true
 297     do
 298         service_count=$(juju status -m $MODEL_NAME | grep kubernetes | grep active | wc -l)
 299         echo "$service_count / $total_service_count services active"
 300         if [ $service_count -eq $total_service_count ]; then
 301             break
 302         fi
 303         if [ $service_count -ne $previous_count ]; then
 304             previous_count=$service_count
 305             start_time="$(date -u +%s)"
 306         fi
 307         now="$(date -u +%s)"
 308         if [[ $(( now - start_time )) -gt $TIME_TO_WAIT ]];then
 309             echo "Timed out waiting for OSM services to become ready"
 310             exit 1
 311         fi
 312         sleep 10
 313     done
 314 }
 315
 316 function create_overlay() {
 317     sudo snap install jq
 318     sudo snap install yq
 319     local HOME=/home/$USER
 320     local vca_user=$(cat $HOME/.local/share/juju/accounts.yaml | yq e .controllers.$CONTROLLER_NAME.user - )
 321     local vca_secret=$(cat $HOME/.local/share/juju/accounts.yaml | yq e .controllers.$CONTROLLER_NAME.password - )
 322     local vca_host=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.api-endpoints[0] - | cut -d ":" -f 1)
 323     local vca_port=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.api-endpoints[0] - | cut -d ":" -f 2)
 324     local vca_pubkey=\"$(cat $HOME/.local/share/juju/ssh/juju_id_rsa.pub)\"
 325     local vca_cloud="lxd-cloud"
 326     # Get the VCA Certificate
 327     local vca_cacert=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.ca-cert - | base64 | tr -d \\n)
 328
 329     # Calculate the default route of this machine
 330     local DEFAULT_IF=`ip route list match 0.0.0.0 | awk '{print $5}'`
 331
 332     # Generate a new overlay.yaml, overriding any existing one
 333     cat << EOF > /tmp/vca-overlay.yaml
 334 applications:
 335   lcm:
 336     options:
 337       vca_user: $vca_user
 338       vca_secret: $vca_secret
 339       vca_host: $vca_host
 340       vca_port: $vca_port
 341       vca_pubkey: $vca_pubkey
 342       vca_cacert: $vca_cacert
 343       vca_cloud: $vca_cloud
 344       vca_k8s_cloud: $K8S_CLOUD_NAME
 345   mon:
 346     options:
 347       vca_user: $vca_user
 348       vca_secret: $vca_secret
 349       vca_host: $vca_host
 350       vca_cacert: $vca_cacert
 351 EOF
 352     mv /tmp/vca-overlay.yaml ~/.osm/
 353     OSM_VCA_HOST=$vca_host
 354 }
 355
 356 function generate_images_overlay(){
 357     echo "applications:" > /tmp/images-overlay.yaml
 358
 359     charms_with_resources="nbi lcm mon pol ng-ui ro pla"
 360     for charm in $charms_with_resources; do
 361         cat << EOF > /tmp/${charm}_registry.yaml
 362 registrypath: ${REGISTRY_URL}opensourcemano/${charm}:$TAG
 363 EOF
 364         if [ ! -z "$REGISTRY_USERNAME" ] ; then
 365             echo username: $REGISTRY_USERNAME >> /tmp/${charm}_registry.yaml
 366             echo password: $REGISTRY_PASSWORD >> /tmp/${charm}_registry.yaml
 367         fi
 368
 369         cat << EOF >> /tmp/images-overlay.yaml
 370   ${charm}:
 371     resources:
 372       image: /tmp/${charm}_registry.yaml
 373
 374 EOF
 375     done
 376     ch_charms_with_resources="keystone"
 377     for charm in $ch_charms_with_resources; do
 378         cat << EOF > /tmp/${charm}_registry.yaml
 379 registrypath: ${REGISTRY_URL}opensourcemano/${charm}:$TAG
 380 EOF
 381         if [ ! -z "$REGISTRY_USERNAME" ] ; then
 382             echo username: $REGISTRY_USERNAME >> /tmp/${charm}_registry.yaml
 383             echo password: $REGISTRY_PASSWORD >> /tmp/${charm}_registry.yaml
 384         fi
 385
 386         cat << EOF >> /tmp/images-overlay.yaml
 387   ${charm}:
 388     resources:
 389       ${charm}-image: /tmp/${charm}_registry.yaml
 390
 391 EOF
 392     done
 393
 394     mv /tmp/images-overlay.yaml $IMAGES_OVERLAY_FILE
 395 }
 396
 397 function refresh_osmclient_snap() {
 398     osmclient_snap_install_refresh refresh
 399 }
 400
 401 function install_osm_client_snap() {
 402     osmclient_snap_install_refresh install
 403 }
 404
 405 function osmclient_snap_install_refresh() {
 406     channel_preference="stable candidate beta edge"
 407     for channel in $channel_preference; do
 408         echo "Trying to install osmclient from channel $OSMCLIENT_VERSION/$channel"
 409         sudo snap $1 osmclient --channel $OSMCLIENT_VERSION/$channel 2> /dev/null && echo osmclient snap installed && break
 410     done
 411 }
 412 function install_osmclient() {
 413     snap info osmclient | grep -E ^installed: && refresh_osmclient_snap || install_osm_client_snap
 414 }
 415
 416 function add_local_k8scluster() {
 417     osm --all-projects vim-create \
 418       --name _system-osm-vim \
 419       --account_type dummy \
 420       --auth_url http://dummy \
 421       --user osm --password osm --tenant osm \
 422       --description "dummy" \
 423       --config '{management_network_name: mgmt}'
 424     tmpfile=$(mktemp --tmpdir=${HOME})
 425     cp ${KUBECONFIG} ${tmpfile}
 426     osm --all-projects k8scluster-add \
 427       --creds ${tmpfile} \
 428       --vim _system-osm-vim \
 429       --k8s-nets '{"net1": null}' \
 430       --version '1.19' \
 431       --description "OSM Internal Cluster" \
 432       _system-osm-k8s
 433     rm -f ${tmpfile}
 434 }
 435
 436 function install_microstack() {
 437     sudo snap install microstack --classic --beta
 438     sudo microstack.init --auto
 439     wget https://cloud-images.ubuntu.com/releases/16.04/release/ubuntu-16.04-server-cloudimg-amd64-disk1.img -P ~/.osm/
 440     microstack.openstack image create \
 441     --public \
 442     --disk-format qcow2 \
 443     --container-format bare \
 444     --file ~/.osm/ubuntu-16.04-server-cloudimg-amd64-disk1.img \
 445     ubuntu1604
 446     ssh-keygen -t rsa -N "" -f ~/.ssh/microstack
 447     microstack.openstack keypair create --public-key ~/.ssh/microstack.pub microstack
 448     export OSM_HOSTNAME=`juju status -m $MODEL_NAME --format json | jq -rc '.applications."nbi".address'`
 449     osm vim-create --name microstack-site \
 450     --user admin \
 451     --password keystone \
 452     --auth_url http://10.20.20.1:5000/v3 \
 453     --tenant admin \
 454     --account_type openstack \
 455     --config='{security_groups: default,
 456         keypair: microstack,
 457         project_name: admin,
 458         user_domain_name: default,
 459         region_name: microstack,
 460         insecure: True,
 461         availability_zone: nova,
 462     version: 3}'
 463 }
 464
 465 DEFAULT_IF=`ip route list match 0.0.0.0 | awk '{print $5}'`
 466 DEFAULT_IP=`ip -o -4 a |grep ${DEFAULT_IF}|awk '{split($4,a,"/"); print a[1]}'`
 467
 468 check_arguments $@
 469 mkdir -p ~/.osm
 470 install_snaps
 471 bootstrap_k8s_lxd
 472 create_overlay
 473 if [ -v ONLY_VCA ]; then
 474     HOME=/home/$USER
 475     vca_user=$(cat $HOME/.local/share/juju/accounts.yaml | yq e .controllers.$CONTROLLER_NAME.user - )
 476     vca_secret=$(cat $HOME/.local/share/juju/accounts.yaml | yq e .controllers.$CONTROLLER_NAME.password - )
 477     vca_host=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.api-endpoints[0] - | cut -d ":" -f 1)
 478     vca_port=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.api-endpoints[0] - | cut -d ":" -f 2)
 479     vca_pubkey=\"$(cat $HOME/.local/share/juju/ssh/juju_id_rsa.pub)\"
 480     vca_cloud="lxd-cloud"
 481     vca_cacert=$(cat $HOME/.local/share/juju/controllers.yaml | yq e .controllers.$CONTROLLER_NAME.ca-cert - | base64 | tr -d \\n)
 482     hostname=`cat /etc/hostname`
 483
 484     echo "Use the following command to register the installed VCA to your OSM:"
 485     echo -e "  osm vca-add --endpoints $vca_host:$vca_port \\\n         --user $vca_user \\\n         --secret $vca_secret \\\n         --cacert $vca_cacert \\\n         --lxd-cloud lxd-cloud \\\n         --lxd-credentials lxd-cloud \\\n         --k8s-cloud microk8s \\\n         --k8s-credentials microk8s\\\n         $hostname-vca"
 486 else
 487     deploy_charmed_osm
 488     install_osmclient
 489     export OSM_HOSTNAME=$(juju config -m $MODEL_NAME nbi site_url | sed "s/http.*\?:\/\///"):443
 490     sleep 10
 491     add_local_k8scluster
 492     if [ -v MICROSTACK ]; then
 493         install_microstack
 494     fi
 495
 496     echo "Your installation is now complete, follow these steps for configuring the osmclient:"
 497     echo
 498     echo "1. Create the OSM_HOSTNAME environment variable with the NBI IP"
 499     echo
 500     echo "export OSM_HOSTNAME=$OSM_HOSTNAME"
 501     echo
 502     echo "2. Add the previous command to your .bashrc for other Shell sessions"
 503     echo
 504     echo "echo \"export OSM_HOSTNAME=$OSM_HOSTNAME\" >> ~/.bashrc"
 505     echo
 506     echo "DONE"
 507 fi
 508