summaryrefslogtreecommitdiffstats
path: root/docs/cookbook.rst
blob: df2e437a7d4a056641c93e0ac25235d58b2f8804 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. Copyright 2017 Huawei Technologies Co., Ltd.

.. _cli_cookbook:

Cook-book
=========

To Run OCLIP on local docker machine
---------------------------------------

1. Login to docker repository::

    docker login -u docker -p docker nexus3.onap.org:10001

2. Pull cli docker image and run locally::

    docker run -d --name oclip -e CLI_MODE=daemon -p 8080:9090 -p 8080:80 nexus3.onap.org:10001/onap/cli:2.0-STAGING-latest

Access the CLI console
~~~~~~~~~~~~~~~~~~~~~~

1. Web command console::

    http://localhost:9090

2. Linux console::

    docker exec -it oclip oclip

How to run OCLIP on ubuntu server
---------------------------------

1. Download install script::

    wget -O ~/oclip-install.sh https://gerrit.onap.org/r/gitweb?p=cli.git;a=blob_plain;f=deployment/zip/installer/install-latest.sh;h=71488dae78a3ecbb27711c95475b4568883f799f;hb=refs/heads/master

2. Set execution mode and run installer::

    cd ~

    chmod +x oclip-install.sh

    ./oclip-install.sh

3. verify the installation, by running::

    oclip --version

    NOTE: Make sure OPEN_CLI_HOME is set to /opt/oclip, type

    echo $OPEN_CLI_HOME

Setup profile
-------------

1. Run oclip console::

    oclip

2. Create a profile::

    profile <name>

3. Add basic parameters in to profile::

    set <service-name>:<parameter-name>

    Example: To set the host url for service AAI in ONAP, type 'set AAI:host-url=https://192.168.17.35:30233'

4. For ONAP beijing version, OCLIP provides default profile named onap-beijing. To use this profile, type::

    profile onap-beijing

    set aai:host-url=<AAI service URL>

    set msb:host-url=<MSB service URL>

    set sdc:host-url=<SDC service URL>

    set so:host-url=<SO service URL>

    NOTE: This step is not applicable for other products, so it could be skipped.

4. Exit console::

    exit

Use the existing profile
------------------------

1. In console mode, type::

    profile <profile-name>


2. In scripting mode, type::

    oclip -c <profile-name> <command name>

    Example: To list the VNF cloud registered in the ONAP, type 'oclip -c onap-beijing cloud-list'.


How to configure OCLIP to use for given product version
-------------------------------------------------------

In console mode
~~~~~~~~~~~~~~~

1. Identify the available and current product version, type::

    version

    It will report as below:

    CLI version       : 2.0.0 [2018-03-21 11:04 UTC]
    Available products: [open-cli, onap-beijing, onap-amsterdam, sample-helloworld]
    Enabled product   : open-cli

2. To enable a product say onap-beijing, type::

    use onap-beijing

3. List available commands, type::

    help

In scripting mode
~~~~~~~~~~~~~~~~~

1. Identify the available and current product version, type::

    oclip --version

    It will report as below:

    CLI version       : 2.0.0 [2018-03-21 11:04 UTC]
    Available products: [open-cli, onap-beijing, onap-amsterdam, sample-helloworld]
    Enabled product   : open-cli

2. To enable a product say onap-beijing, set environment variable OPEN_CLI_PRODUCT_IN_USE::

    export OPEN_CLI_PRODUCT_IN_USE=onap-beijing

3. List available commands, type::

    oclip --help