Instalação do OpenSource OSM ☁️

OSM Release: 8.0 e 9.0

OSM

Requisitos mínimos de hardware

• 2 processadores
• 8 Gb de RAM
• 60 Gb disco

Sistema Operacional

• Ubuntu18.04 (64-bit variant required)

Passo a Passo para instalação

Serão citadas as instações da versão 8 com docker e versão 9 com kubernetes

Versão 8 com docker por padrão

1. Sugiro criar na instalaçao do Ubuntu o usuário chamado mano.

2. Execute os comandos abaixo

sudo groupadd docker
sudo usermod -aG docker mano
newgrp docker
su - mano

3. Para instalar o OSM

wget https://osm-download.etsi.org/ftp/osm-8.0-eight/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh 2>&1 | tee osm_install_log.txt

Obs.: Caso deseje instalar como módulo de placement, será necessário adicinoar o parametro --pla depois do install_osm.sh

4. Verificar se todos os containers subiram e estão em estado de running, e verificar as portas utilizadas

docker stack ps osm |grep -i running
docker service ls

5. A qualquer tempo, é possível fazer re deploy

docker stack rm osm && sleep 60
docker stack deploy -c /etc/osm/docker/docker-compose.yaml osm

6. Para verificar os logs

docker service logs osm_lcm     # exibe logs de todos os containers (inclusive os "dead") associados ao osm_lcm.
docker logs $(docker ps -aqf "name=osm_lcm" -n 1)  # exibe os logs do último container osm_lcm

7. --
8. --
9. --
10. --

Versão 9 com kubernetes por padrão

1. Sugiro criar na instalaçao do Ubuntu o usuário chamado mano.

2. Desativar serviço

sudo systemctl stop ufw

3. Para instalar o OSM e monitoramento do kubernetes cluster

wget https://osm-download.etsi.org/ftp/osm-9.0-nine/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh 2>&1 | tee osm_install_log.txt

Obs.: Caso queira instalar uma versão com docker, execute o comando:

./install_osm.sh -c swarm 2>&1 | tee osm_install_log.txt.

Obs.: Caso queira instalar uma versão com docker e pla, execute o comando:

./install_osm.sh -c swarm --pla 2>&1 | tee osm_install_log.txt.

4. Ao ser questionado sobre prosseguir com a instalação, digite "Y".

5. Será solicitado a senha do sudo para o usuário mano.

6. Depois de tudo instalado, digite no browser: http://endereco_ip

7. Execute o comando abaixo e observe se o status é "RUNNING"

kubectl get all -n osm

8. Para verificar o log por container

kubectl logs -n osm deployments/lcm           # for LCM
kubectl logs -n osm deployments/light-ui      # for LW-UI
kubectl logs -n osm deployments/mon           # for MON
kubectl logs -n osm deployments/nbi           # for NBI
kubectl logs -n osm deployments/pol           # for POL
kubectl logs -n osm deployments/ro            # for RO
kubectl logs -n osm deployments/keystone      # for Keystone
kubectl logs -n osm statefulset/kafka         # for Kafka
kubectl logs -n osm statefulset/mongo         # for Mongo
kubectl logs -n osm statefulset/mysql         # for Mysql
kubectl logs -n osm statefulset/prometheus    # for Prometheus
kubectl logs -n osm statefulset/zookeeper     # for Zookeeper

9. Para verificar as portas relacinadas a aplicacoes do OSM e aplicacoes correlatas

kubectl get pods -A -o wide

Comum às versões 8 e 9

10. Digite usuário e senha admin opara acessar a interface web http://endereco_ip

11. Para acessar o Grafana (dashboards) e Prometheus (coletor de dados do VIM)

• Grafana (http://endereco_ip:3000)
• Prometheus (http://endereco_ip:9091)

12. para adicionar um VIM OpenStack, neste caso, o Victoria

osm vim-create --name openstack1 --user admin --password keystoneadmin --auth_url http://endereco_ip:5000/v3 --tenant admin --account_type openstack --config='{security_groups: sg_admin, keypair: }'

Obs.: No exemplo acima foi criado um security group denominado sg_admin, para evitar utilizar o default. Neste grupo foi permitido acesso ssh e entrada e saída de pacotes icmp.

13. Ao acessar o grafana pela primeira vez, utilize a senha default: usuario: admin senha: admin Obs.: Ao ser questionado para renomear a senha, clique em Skip.

14. Ao acessar a interface do prometheus, será possível visualizar as métricas que começam com o nome osm_.

15. Adiconando VNF e NS (compatível apenas com versão 8) O OSM cria as instancias e parametros de rede no VIM baseado em arquivos descriptors, que estão no formato YAML. No exemplo abaixo iremos adicionar uma NS, que compõe dois tipos de instancias, ligado por redes privadas. Uma instancia possui o haproxy e outra um webserver, ambos em Ubuntu. A memoria e cpu das instancias com apache são monitoradas, e quando chegar nos limites pré-estabelecidos no descriptor, novas instâncias serão criadas ou excluídas.

https://github.com/laudelinojr/install-osm/raw/main/webserver_vimmetric_autoscale_nsd.tar.gz https://github.com/laudelinojr/install-osm/raw/main/webserver_vimmetric_autoscale_vnfd.tar.gz

15.1) Obs.: As imagens haproxy_ubuntu e apache_ubuntu precisam estar importadas no OpenStack. Elas podem ser baixadas do link. https://osm-download.etsi.org/ftp/osm-4.0-four/4th-hackfest/images/

Seguem os comandos para inserir estas imagens no openstack:

  source admin-openrc.sh (é necessário baixar prreviamente o arquivo na interface do OpenStack)
  openstack  image  create  --file="./haproxy_ubuntu.qcow2" --container-format=bare  --disk-format=qcow2  haproxy_ubuntu
  openstack  image  create  --file="./apache_ubuntu.qcow2" --container-format=bare  --disk-format=qcow2  apache_ubuntu

16. Importando NS

osm vnfd-create webserver_vimmetric_autoscale_nsd.gz
osm vnfd-list

17. Importando VNF

osm nsd-create webserver_vimmetric_autoscale_vnfd.tar.gz
osm nsd-list

18. Instanciando

osm ns-create --nsd_name webserver_vimmetric_autoscale_vnf --ns_name teste1 --vim_account openstack1
osm ns-list

Obs.: Observe que o vim_account foi definido no passo 13 e o nsd_name no passo 18.

19. Entre no openstack e observe que as instancias e respectivas redes foram criadas.

20. Testando AutoScaling

20.1) No security group sg_admin, crie uma regra para permitir o trafego tcp para a porta 32700.

20.2) execute no browser o ip da rede externa concebido à instancia haproxy para acessar a interface web: http://endereco_ip:32700 Digite usuário "osm" e senha "osm2018"

20.3) Acesse o haproxy via ssh utilizando o usuário "ubuntu" e senha "osm2018".

20.4) Caso queira acessar algum apache, pode ser feito acesso via console com o usuário "ubuntu" e senha "osm2018"

20.5) Em uma máquina com linux instale o seguinte utilitário para efetuar testes no haproxy

sudo apt install apache2-utils ab -n 5000000 -c 2 http://[load-balancer-ip]/test.php Este comando irá stressar a CPU para 100% e ativar o scale-out no POL

21. Deletando instancia NS

osm ns-delete <ns-instance-name>
osm ns-list

22. Deletando VNF e NS pakage osm webserver_vimmetric_autoscale_nsd osm nsd-list osm vnfd-delete webserver_vimmetric_autoscale_vnfd osm vnfd-list

23. Exemplos de descritores https://osm-download.etsi.org/ftp/Packages/examples/

24. Árvore de parametro VNFD http://osm-download.etsi.org/repository/osm/debian/ReleaseEIGHT/docs/osm-im/osm_im_trees/vnfd.html

25. Métricas VIM https://osm.etsi.org/docs/user-guide/05-osm-usage.html#vim-metrics

26. Fonte Descriptor autoscaling https://osm.etsi.org/docs/user-guide/05-osm-usage.html#scaling-descriptor

Teste mysql -h localhost -u mano -p

senha manopw

testes yes > /dev/null &

para varios vims

osm ns-create --ns_name teste_vims --nsd_name hackfest2-ns --vim_account openstack1 --config '{vnf: [ {member-vnf-index: "1", vim_account: openstack1}, {member-vnf-index: "2", vim_account: openstack2} ], vld: [ {name: mgmtnet, vim-network-name: {openstack1: provider-net, openstack2: provider-net} } ], wim_account: False }'

para pla

osm ns-create --ns_name teste_vims2 --nsd_name hackfest2-ns --vim_account openstack1 --config '{vnf: [ {member-vnf-index: "1", vim_account: openstack1}, {member-vnf-index: "2", vim_account: openstack2} ], vld: [ {name: mgmtnet, vim-network-name: {openstack1: provider-net, openstack2: provider-net} } ], wim_account: False, placement-engine: PLA }'

Pazer uso do recurso de placement osm ns-create --nsd_name hackfest1-ns --ns_name test1 --vim_account openstack1 --config '{placement-engine: PLA}' docker logs $(docker ps -aqf "name=osm_pla" -n 1) docker logs $(docker ps -aqf "name=osm_lcm" -n 1)