From c7cbd5376f00cf2e5e060075a2a7666e6318fd29 Mon Sep 17 00:00:00 2001 From: lizi Date: Wed, 11 Oct 2017 15:28:54 +0800 Subject: Add the installation detail of esr. Change-Id: Ib1533a6faf77f2dd56f33ea62f2fd71811f09346 Issue-ID: AAI-427 Signed-off-by: lizi --- docs/platform/installation.rst | 87 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 86 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/platform/installation.rst b/docs/platform/installation.rst index 93a658c..d936567 100644 --- a/docs/platform/installation.rst +++ b/docs/platform/installation.rst @@ -3,4 +3,89 @@ Installation ------------ -- `ESR setup `_. + +Install docker +^^^^^^^^^^^^^^^^^^^^^^^ + +sudo apt-add-repository 'deb https://apt.dockerproject.org/repo ubuntu-xenial main' + +sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D + +sudo apt-get update + +apt-cache policy docker-engine + +sudo apt-get install -y docker-engine + +docker ps + +Run esr-server docker +^^^^^^^^^^^^^^^^^^^^^^^ + +Login the ONAP docker registry first: sudo docker login -u docker -p docker nexus3.onap.org:10001 + +sudo docker run -p 9518:9518 -d --net=host --name esr-server -e MSB_ADDR=${MSB_SERVER_IP}:80 nexus3.onap.org:10001/onap/aai/esr-server + +Run esr-gui docker +^^^^^^^^^^^^^^^^^^^^^^^ + +sudo docker run -p 8080:9519 -d --net=host --name esr-gui nexus3.onap.org:10001/onap/aai/esr-gui + +Check status of ESR +^^^^^^^^^^^^^^^^^^^^^^^ + +Test whether esr-server is runing: + +GET http://ESR_SERVICE_IP:9518/api/aai-esr-server/v1/test + +The returned status should be 200. + +Visit ESR portal: + +http://ESR_SERVER_IP:9519/esr-gui/extsys/vnfm/vnfmView.html + +http://ESR_SERVER_IP:9519/esr-gui/extsys/sdncontroller/sdncView.html + +http://ESR_SERVER_IP:9519/esr-gui/extsys/vim/vimView.html + +http://ESR_SERVER_IP:9519/esr-gui/extsys/ems/emsView.html + +A&AI register to MSB +^^^^^^^^^^^^^^^^^^^^^^^ + +NOTE: The way bellow is register to MSB by hand, it is a temporary method. Later it will be registered automatic by MSB. + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "aai-cloudInfrastructure", "version": "v11", "url": "/aai/v11/cloud-infrastructure","protocol": "REST", "enable_ssl":"true", "visualRange":"1", "nodes": [ {"ip": "A&AI_SERVER_IP","port": "8443"}]}' "http://MSB_SERVER_IP:10081/api/microservices/v1/services" + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "aai-externalSystem", "version": "v11", "url": "/aai/v11/external-system","protocol": "REST", "enable_ssl":"true", "visualRange":"1", "nodes": [ {"ip": "A&AI_SERVER_IP","port": "8443"}]}' "http://MSB_SERVER_IP:10081/api/microservices/v1/services" + +MultiCloud register to MSB +^^^^^^^^^^^^^^^^^^^^^^^ + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "multicloud", "version": "v0", "url": "/api/multicloud/v0","protocol": "REST", "nodes": [ {"ip": "'$MultiCloud_IP'","port": "9001"}]}' "http://$MSB_SERVER_IP:10081/api/microservices/v1/services" + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "multicloud-vio", "version": "v0", "url": "/api/multicloud-vio/v0","protocol": "REST", "nodes": [ {"ip": "'$MultiCloud_IP'","port": "9004"}]}' "http://$MSB_SERVER_IP:10081/api/microservices/v1/services" + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "multicloud-ocata", "version": "v0", "url": "/api/multicloud-ocata/v0","protocol": "REST", "nodes": [ {"ip": "'$MultiCloud_IP'","port": "9006"}]}' "http://$MSB_SERVER_IP:10081/api/microservices/v1/services" + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "multicloud-titanium_cloud", "version": "v0", "url": "/api/multicloud-titanium_cloud/v0","protocol": "REST", "nodes": [ {"ip": "'$MultiCloud_IP'","port": "9005"}]}' "http://$MSB_SERVER_IP:10081/api/microservices/v1/services" + +ESR register to MSB +^^^^^^^^^^^^^^^^^^^^^^^ + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "aai-esr-server", "version": "v1", "url": "/api/aai-esr-server/v1","protocol": "REST", "visualRange":"1", "nodes": [ {"ip": "ESR_SERVER_IP","port": "9518"}]}' "http://MSB_SERVER_IP:10081/api/microservices/v1/services" + +curl -X POST -H "Content-Type: application/json" -d '{"serviceName": "aai-esr-gui", "url": "/esr-gui","protocol": "UI", "visualRange":"1", "path":"/iui/aai-esr-gui", "nodes": [ {"ip": "ESR_SERVER_IP","port": "9519"}]}' "http://MSB_SERVER_IP:10081/api/microservices/v1/services" + +ESR usage +^^^^^^^^^^^^^^^^^^^^^^^ + +Visit ESR portal to manage the external systems. + +http://MSB_SERVER_IP:80/iui/aai-esr-gui/extsys/vnfm/vnfmView.html + +http://MSB_SERVER_IP:80/iui/aai-esr-gui/extsys/sdncontroller/sdncView.html + +http://MSB_SERVER_IP:80/iui/aai-esr-gui/extsys/vim/vimView.html + +http://MSB_SERVER_IP:80/iui/aai-esr-gui/extsys/ems/emsView.html \ No newline at end of file -- cgit 1.2.3-korg