6681c16a151e96d3f9586818f69cfa6c04504483
[vfc/nfvo/driver/vnfm/svnfm.git] / nokia / vnfmdriver / vfcadaptorservice / deployment / src / main / release / README.txt
1 Introduction:
2 =============
3     This document provides the required steps for installation
4     and configuration this service.
5
6 Installation steps:
7 ====================
8     Install following software:
9         - Java 1.8 or lattest
10         - MySql Server 5.7 or lattest.
11         - Apache Tomcat Server 8.0 or lattest
12
13     Set the following environment variables:
14         - JAVA_HOME: Set to JAVA JDK installed location
15         - CATALINIA_HOME: Set to Tomcat installed location
16         - CATALINIA_BASE: Set to the location, where this
17           service installer is unzipped, its optional
18         - PATH: Update it with the location of command 'mysql'
19
20     - In command console, cd to 'bin' directory under the location,
21       where this service installer is unzipped and
22       run ./init_db.sh <db user> <db password> <db server ip> <db port>
23         CAUTION: Existing vnfm_db will be cleaned before
24         initializing the schema, so please take a back-up of it
25         before executing it next time.
26
27 Configuration steps:
28 ====================
29     - Update the db credetials in 'application.properties' under webapps directory.
30     - Update the MSB address in 'application.properties' under webapps directory.
31     - Update the VNFM address in 'application.properties' under webapps directory.
32     - Update the Catalog address in 'application.properties' under webapps directory.
33     - Update the NSLCM address in 'application.properties' under webapps directory.
34     - Update the MSB address in $PATH/etc/conf/restclient.json
35     - Update the vnfmadapter service ip address in $PATH/etc/adapterInfo/vnfmadapterinfo.json
36
37
38 How to run?
39 ===========
40     - In command console, cd to 'bin' directory under the location,
41       where this service installer is unzipped and
42       run ./startup.sh
43           NOTE: It starts the tomcat at predefined http port. To change
44           default port, update the port in tomcat configuration file
45           'conf/server.xml'
46           - Verify that 'Tomcat started.' is reported on the console.
47     - Once service is started, please verify below details:
48         - from MSB service, verify that "nokia-vnfm-driver"  is reported from GET request on "/openoapi/microservices/v1/services"
49         - from this service, run one of the supported REST API mentioned in open-o NFVO wiki and verify that the
50           expected response is returned.
51 How to stop?
52 =============
53     - In command console, cd to 'bin' directory under the location,
54       where this service installer is unzipped and
55       run ./shutdown.sh
56
57 Update:
58 =========
59 The latest information are available through the OPEN-O release notes at
60 https://wiki.open-o.org/view/OPEN-O_Sun_Release_Notes