Contrail: Server Manager Lite Overview

Server Manager Lite Overview

Server Manager Lite is a new interface to Server Manager. Except for reimage, rest of the functionality is same as Server Manager.

SM-lite is developed with the intent of replacing fab provisioning. SM-lite use cases are -

• Faster deployment of contrail provisioning for POC
• CI Sanity using SM provisioning
• Contrail provisioning for daily builds to perform sanity
• Developers to do faster implementation of contrail provisioning in local environment

User can choose any server/node to install SM Lite. There are multiple options to run SM Lite as given below.

• a single node (or VM) to provision contrail, then user might install SM Lite on the same node and perform contrail provisioning.
• a seperate node (or VM) to install SM Lite, and provision contrail with the rest of nodes.
• choose a node (or VM) which might have contrail roles to install SM Lite (typically config node)

testbed.py will be used to specify servers and associated contrail roles.

SM installer

Use regular contrail-server-manager-installer debian package. Example package is contrail-server-manager-installer_2.22~juno_all.deb

dpkg –i <contrail-server-manager-installer_2.22~juno_all.deb>

SM-Lite install/provision

Help: /opt/contrail/contrail_server_manager/provision.sh -h
-h --help
-c|--contrail-package <pkg>
-t|--testbed <testbed.py>
-cid|--cluster-id <cluster-id>
-ni|--no-install-sm-lite

-ni option is used in case of reprovision of existing cluster, or create a new cluser, or upgrade an existing cluster with different version.

/opt/contrail/contrail_server_manager/provision.sh -t <testbed.py> –c <contrail-install-packages_2.22~juno_all.deb> –cid <mycluster>

provision.sh tool tasks are -

1. Install sm-lite (includes sm client, sm webui, sm monitoring/inventory)
2. Prepare testbed.py specified cluster for contrail provision
3. Convert testbed.py details into server manager objects
4. Issue contrail provision using server-manager client cli

Server Manager client

Server Manager client can be installed in couple of ways, a) via .deb b) via .tgz Installation brings in default sm-client-config.ini file, which has server manager ip address to communicate. Server Manager client includes an additional wrapper tool to privision via testbed.py.

/opt/contrail/server_manager/client/provision.sh -h
-h --help
-c|--contrail-package <pkg>
-t|--testbed <testbed.py>
-cid|--cluster-id <cluster-id>

Server Manager client also supports in .tgz, where user untar the client utility and use provision.sh tool to provision testbed.py specified cluster.

Puppet logs

Contrail provisioning puppet logs can be accessed at
http:<sm_lite_ip>:9001/logs or target server's /var/log/syslog would give puppet logs.

Server Manager WebUI

Both SM or SMLite WebUI would use 9080 (http_port) and 9143(https_port). If user issues http::9080, it will be redirected to 9143. It is the same behavior as contrail WebUI, except the ports are changed. SM Webui port/s can be changed at /etc/contrail/config.global.sm.js and restart supervisor-webui-sm service to take it effect.

User can carry rest of the functions using server manager webui for further tasks.