installers/install_osm.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 REPOSITORY_BASE=https://osm-download.etsi.org/repository/osm/debian
  16 RELEASE=ReleaseTHIRTEEN
  17 REPOSITORY=stable
  18 DOCKER_TAG=13
  19 DEVOPS_PATH=/usr/share/osm-devops
  20
  21 function usage(){
  22     echo -e "usage: $0 [OPTIONS]"
  23     echo -e "Install OSM from binaries or source code (by default, from binaries)"
  24     echo -e "  OPTIONS"
  25     echo -e "     -h / --help:    print this help"
  26     echo -e "     -y:             do not prompt for confirmation, assumes yes"
  27     echo -e "     -r <repo>:      use specified repository name for osm packages"
  28     echo -e "     -R <release>:   use specified release for osm binaries (deb packages, lxd images, ...)"
  29     echo -e "     -u <repo base>: use specified repository url for osm packages"
  30     echo -e "     -k <repo key>:  use specified repository public key url"
  31     echo -e "     -b <refspec>:   install OSM from source code using a specific branch (master, v2.0, ...) or tag"
  32     echo -e "                     -b master          (main dev branch)"
  33     echo -e "                     -b v2.0            (v2.0 branch)"
  34     echo -e "                     -b tags/v1.1.0     (a specific tag)"
  35     echo -e "                     ..."
  36     echo -e "     -a <apt proxy url>: use this apt proxy url when downloading apt packages (air-gapped installation)"
  37     echo -e "     -s <stack name> or <namespace>  user defined stack name when installed using swarm or namespace when installed using k8s, default is osm"
  38     echo -e "     -H <VCA host>   use specific juju host controller IP"
  39     echo -e "     -S <VCA secret> use VCA/juju secret key"
  40     echo -e "     -P <VCA pubkey> use VCA/juju public key file"
  41     echo -e "     -A <VCA apiproxy> use VCA/juju API proxy"
  42     echo -e "     --pla:          install the PLA module for placement support"
  43     echo -e "     --ng-sa:        install Airflow and Pushgateway to get VNF and NS status (experimental)"
  44     echo -e "     -m <MODULE>:    install OSM but only rebuild or pull the specified docker images (NG-UI, NBI, LCM, RO, MON, POL, PLA, KAFKA, MONGO, PROMETHEUS, PROMETHEUS-CADVISOR, KEYSTONE-DB, NONE)"
  45     echo -e "     -o <ADDON>:     ONLY (un)installs one of the addons (k8s_monitor)"
  46     echo -e "     -O <openrc file path/cloud name>: Install OSM to an OpenStack infrastructure. <openrc file/cloud name> is required. If a <cloud name> is used, the clouds.yaml file should be under ~/.config/openstack/ or /etc/openstack/"
  47     echo -e "     -N <openstack public network name/ID>: Public network name required to setup OSM to OpenStack"
  48     echo -e "     -f <path to SSH public key>: Public SSH key to use to deploy OSM to OpenStack"
  49     echo -e "     -F <path to cloud-init file>: Cloud-Init userdata file to deploy OSM to OpenStack"
  50     echo -e "     -D <devops path> use local devops installation path"
  51     echo -e "     -w <work dir>   Location to store runtime installation"
  52     echo -e "     -t <docker tag> specify osm docker tag (default is latest)"
  53     echo -e "     -l:             LXD cloud yaml file"
  54     echo -e "     -L:             LXD credentials yaml file"
  55     echo -e "     -K:             Specifies the name of the controller to use - The controller must be already bootstrapped"
  56     echo -e "     -d <docker registry URL> use docker registry URL instead of dockerhub"
  57     echo -e "     -p <docker proxy URL> set docker proxy URL as part of docker CE configuration"
  58     echo -e "     -T <docker tag> specify docker tag for the modules specified with option -m"
  59     echo -e "     --debug:        debug mode"
  60     echo -e "     --nocachelxdimages:  do not cache local lxd images, do not create cronjob for that cache (will save installation time, might affect instantiation time)"
  61     echo -e "     --cachelxdimages:  cache local lxd images, create cronjob for that cache (will make installation longer)"
  62     echo -e "     --nolxd:        do not install and configure LXD, allowing unattended installations (assumes LXD is already installed and confifured)"
  63     echo -e "     --nodocker:     do not install docker, do not initialize a swarm (assumes docker is already installed and a swarm has been initialized)"
  64     echo -e "     --nojuju:       do not juju, assumes already installed"
  65     echo -e "     --nodockerbuild:do not build docker images (use existing locally cached images)"
  66     echo -e "     --nohostports:  do not expose docker ports to host (useful for creating multiple instances of osm on the same host)"
  67     echo -e "     --nohostclient: do not install the osmclient"
  68     echo -e "     --uninstall:    uninstall OSM: remove the containers and delete NAT rules"
  69     echo -e "     --source:       install OSM from source code using the latest stable tag"
  70     echo -e "     --develop:      (deprecated, use '-b master') install OSM from source code using the master branch"
  71     echo -e "     --pullimages:   pull/run osm images from docker.io/opensourcemano"
  72     echo -e "     --k8s_monitor:  install the OSM kubernetes monitoring with prometheus and grafana"
  73     echo -e "     --volume:       create a VM volume when installing to OpenStack"
  74     echo -e "     --showopts:     print chosen options and exit (only for debugging)"
  75     echo -e "     --charmed:                   Deploy and operate OSM with Charms on k8s"
  76     echo -e "     [--bundle <bundle path>]:    Specify with which bundle to deploy OSM with charms (--charmed option)"
  77     echo -e "     [--k8s <kubeconfig path>]:   Specify with which kubernetes to deploy OSM with charms (--charmed option)"
  78     echo -e "     [--vca <name>]:              Specifies the name of the controller to use - The controller must be already bootstrapped (--charmed option)"
  79     echo -e "     [--small-profile]:           Do not install and configure LXD which aims to use only K8s Clouds (--charmed option)"
  80     echo -e "     [--lxd <yaml path>]:         Takes a YAML file as a parameter with the LXD Cloud information (--charmed option)"
  81     echo -e "     [--lxd-cred <yaml path>]:    Takes a YAML file as a parameter with the LXD Credentials information (--charmed option)"
  82     echo -e "     [--microstack]:              Installs microstack as a vim. (--charmed option)"
  83     echo -e "     [--overlay]:                 Add an overlay to override some defaults of the default bundle (--charmed option)"
  84     echo -e "     [--ha]:                      Installs High Availability bundle. (--charmed option)"
  85     echo -e "     [--tag]:                     Docker image tag. (--charmed option)"
  86     echo -e "     [--registry]:                Docker registry with optional credentials as user:pass@hostname:port (--charmed option)"
  87 }
  88
  89 add_repo() {
  90   REPO_CHECK="^$1"
  91   grep "${REPO_CHECK/\[arch=amd64\]/\\[arch=amd64\\]}" /etc/apt/sources.list > /dev/null 2>&1
  92   if [ $? -ne 0 ]
  93   then
  94     need_packages_lw="software-properties-common apt-transport-https"
  95     echo -e "Checking required packages to add ETSI OSM debian repo: $need_packages_lw"
  96     dpkg -l $need_packages_lw &>/dev/null \
  97       || ! echo -e "One or several required packages are not installed. Updating apt cache requires root privileges." \
  98       || sudo apt-get -qy update \
  99       || ! echo "failed to run apt-get update" \
 100       || exit 1
 101     dpkg -l $need_packages_lw &>/dev/null \
 102       || ! echo -e "Installing $need_packages_lw requires root privileges." \
 103       || sudo apt-get install -y $need_packages_lw \
 104       || ! echo "failed to install $need_packages_lw" \
 105       || exit 1
 106     wget -q -O OSM-ETSI-Release-key.gpg "$REPOSITORY_BASE/$RELEASE/OSM%20ETSI%20Release%20Key.gpg"
 107     sudo APT_KEY_DONT_WARN_ON_DANGEROUS_USAGE=1 apt-key add OSM-ETSI-Release-key.gpg \
 108       || ! echo -e "Could not add GPG key $REPOSITORY_BASE/$RELEASE/OSM%20ETSI%20Release%20Key.gpg" \
 109       || exit 1
 110     sudo DEBIAN_FRONTEND=noninteractive add-apt-repository -y "$1"
 111     sudo DEBIAN_FRONTEND=noninteractive apt-get -y update
 112     return 0
 113   fi
 114
 115   return 1
 116 }
 117
 118 clean_old_repo() {
 119 dpkg -s 'osm-devops' &> /dev/null
 120 if [ $? -eq 0 ]; then
 121   # Clean the previous repos that might exist
 122   sudo sed -i "/osm-download.etsi.org/d" /etc/apt/sources.list
 123 fi
 124 }
 125
 126 function configure_apt_proxy() {
 127     [ -z "${DEBUG_INSTALL}" ] || DEBUG beginning of function
 128     OSM_APT_PROXY=$1
 129     OSM_APT_PROXY_FILE="/etc/apt/apt.conf.d/osm-apt"
 130     echo "Configuring apt proxy in file ${OSM_APT_PROXY_FILE}"
 131     if [ ! -f ${OSM_APT_PROXY_FILE} ]; then
 132         sudo bash -c "cat <<EOF > ${OSM_APT_PROXY}
 133 Acquire::http { Proxy \"${OSM_APT_PROXY}\"; }
 134 EOF"
 135     else
 136         sudo sed -i "s|Proxy.*|Proxy \"${OSM_APT_PROXY}\"; }|" ${OSM_APT_PROXY_FILE}
 137     fi
 138     sudo apt-get -y update || FATAL "Configured apt proxy, but couldn't run 'apt-get update'. Check ${OSM_APT_PROXY_FILE}"
 139     [ -z "${DEBUG_INSTALL}" ] || DEBUG end of function
 140 }
 141
 142 while getopts ":a:b:r:n:k:u:R:D:o:O:m:N:H:S:s:t:U:P:A:l:L:K:d:p:T:f:F:-: hy" o; do
 143     case "${o}" in
 144         D)
 145             DEVOPS_PATH="${OPTARG}"
 146             ;;
 147         r)
 148             REPOSITORY="${OPTARG}"
 149             ;;
 150         R)
 151             RELEASE="${OPTARG}"
 152             ;;
 153         u)
 154             REPOSITORY_BASE="${OPTARG}"
 155             ;;
 156         t)
 157             DOCKER_TAG="${OPTARG}"
 158             ;;
 159         -)
 160             [ "${OPTARG}" == "help" ] && usage && exit 0
 161             ;;
 162         :)
 163             echo "Option -$OPTARG requires an argument" >&2
 164             usage && exit 1
 165             ;;
 166         \?)
 167             echo -e "Invalid option: '-$OPTARG'\n" >&2
 168             usage && exit 1
 169             ;;
 170         h)
 171             usage && exit 0
 172             ;;
 173         *)
 174             ;;
 175     esac
 176 done
 177
 178 clean_old_repo
 179 add_repo "deb [arch=amd64] $REPOSITORY_BASE/$RELEASE $REPOSITORY devops"
 180 sudo DEBIAN_FRONTEND=noninteractive apt-get -qy update
 181 sudo DEBIAN_FRONTEND=noninteractive apt-get -y install osm-devops
 182 $DEVOPS_PATH/installers/full_install_osm.sh -R $RELEASE -r $REPOSITORY -u $REPOSITORY_BASE -D $DEVOPS_PATH -t $DOCKER_TAG "$@"