License	License The Apache Software License, Version 2.0
Categories	Categories CLI User Interface
GroupId	GroupId org.openbaton
ArtifactId	ArtifactId cli
Last Version	Last Version 5.2.1
Release Date	Release Date Apr 27, 2018
Type	Type zip
Description	Description Open Baton SDK Openbaton libraries for integrating with the NFV Orchestrator NBI
Project URL	Project URL http://openbaton.github.io
Source Code Management	Source Code Management https://github.com/openbaton/openbaton-client

Filename	Size
cli-5.2.1.pom
cli-5.2.1.zip	3 MB
cli-5.2.1-sources.jar	14 KB
cli-5.2.1-javadoc.jar	61 KB
Browse

Group / Artifact	Type	Version
org.openbaton : sdk	jar	5.2.1
org.slf4j : slf4j-log4j12	jar	1.7.12
org.apache.commons : commons-lang3	jar	3.0
jline : jline	jar	2.12.1

Open Baton Client

Open Baton Client contains the Open Baton SDK and the Open Baton command-line interface. The SDK provides methods to access the RESTful NFVO API. The command-line interface enables you to use the OpenBaton SDK via the command-line.

Project Structure

The project contains the two modules cli and sdk.

How to install the Open Baton Client

Git clone this project. Navigate into the root directory of the project and execute ./gradlew build.

How to use the command-line interface

Documentation

Set the required environment variables

Navigate into the project's root directory and execute source nfvo.properties. A dialog appears and will ask you for some properties.

Openbaton command-line usage

run a command: openbaton.sh command-name [arg-1] [arg-2] [arg-3]
show the configuration: openbaton.sh -c
activate debug mode: openbaton.sh -d command-name [arg-1] [arg-2] [arg-3]
print help: openbaton.sh -h
print help for a command: openbaton.sh command-name help
list the available commands: openbaton.sh -l

For help on a specific openbaton command, enter:

 $ openbaton.sh COMMAND help

Vim Instance Subcommands

create

Create the object of type Vim Instance

 $ openbaton.sh VimInstance-create file.json

delete
- Delete the object of type Vim Instance passing the id
```
 $ openbaton.sh VimInstance-delete id-vim-instance
```
update
- Update the object of type Vim nstance passing the new object and the id of the old object
```
 $ openbaton.sh VimInstance-update file.json id-vim-instance
```
findAll
- Find all the objects of type Vim Instance
```
 $ openbaton.sh VimInstance-findAll
```
findById
- Find the object of type Vim Instance through the id
```
 $ openbaton.sh VimInstance-findById id-vim-instance
```

Network Service Descriptor Subcommands

create

Create the object of type Network Service Descriptor

 $ openbaton.sh NetworkServiceDescriptor-create file.json

delete

Delete the object of type Network Service Descriptor passing the id

 $ openbaton.sh NetworkServiceDescriptor-delete id-network-service-descriptor

findAll
- Find all the objects of type Network Service Descriptor
```
 $ openbaton.sh NetworkServiceDescriptor-findAll
```

findById

Find the object of type Network Service Descriptor through the id

 $ openbaton.sh NetworkServiceDescriptor-findById id-network-service-descriptor

createVNFDependency

Create the Virtual Network Function Descriptor dependency for a Network Service Descriptor with a specific id

 $ openbaton.sh NetworkServiceDescriptor-createVNFDependency id-network-service-descriptor file.json

The file should look similar to this:

{"parameters":["theParameter"], "version":1, 
"source":{"id":"950811b6-ebb6-4a17-bf4e-ab61974acbc8"}, 
"target": {"id":"9873ad54-2963-424d-ab5d-39403a5dd544"}
}

The ids belong to the particular VirtualNettworkFunctionDescriptor.

deleteVNFDependency
- Delete the Virtual Network Function Descriptor dependency of a Network Service Descriptor with specific id
```
 $ openbaton.sh NetworkServiceDescriptor-deleteVNFDependency id-network-service-descriptor id-vnfdependency
```
getVNFDependencies
- Get all the Virtual Network Function Descriptor Dependency of a Network Service Descriptor with specific id
```
 $ openbaton.sh NetworkServiceDescriptor-getVNFDependencies id-network-service-descriptor
```
getVNFDependency
- Get the VirtualNetwork Function Descriptor dependency with specific id of a Network Service Descriptor with specific id
```
 $ openbaton.sh NetworkServiceDescriptor-getVNFDependency id-network-service-descriptor id-vnfdependency
```

getVirtualNetworkFunctionDescriptors

Find all the objects of type VirtualNetworkFunctionDescriptor

 $ openbaton.sh NetworkServiceDescriptor-getVirtualNetworkFunctionDescriptors id-network-service-descriptor

getVirtualNetworkFunctionDescriptor

Find the object of type VirtualNetworkFunctionDescriptor through the id

 $ openbaton.sh NetworkServiceDescriptor-getVirtualNetworkFunctionDescriptor id-network-service-descriptor id-vnfd

Virtual Network Function Descriptor Subcommands

create
- Create the object of type Virtual Network Function Descriptor
```
 $ openbaton.sh VirtualNetworkFunctionDescriptor-create file.json
```

delete

Delete the object of type Virtual Network Function Descriptor passing the id

 $ openbaton.sh VirtualNetworkFunctionDescriptor-delete id-virtual-network-function-descriptor

findAll
- Find all the objects of type Virtual Network Function Descriptor
```
 $ openbaton.sh VirtualNetworkFunctionDescriptor-findAll
```

findById

Find the object of type Virtual Network Function Descriptor through the id

 $ openbaton.sh VirtualNetworkFunctionDescriptor-findById id-virtual-network-function-descriptor

Network Service Record Subcommands

create

Create a Network Service Record from a Network Service Descriptor stored in the orchestrator

 $ openbaton.sh NetworkServiceRecord-create id-network-service-descriptor vim-map-file keypair-file configurations-file

The three arguments after the NSD id can be used to specify the VIM on which a VDU should be deployed, the keypairs that shall be used to deploy the NSR and configuration parameters for the VNFRs.
If you want to specify the VIM to use for a particular VDU you can pass a file containing a map like this:

 {"vdu1Name":["vim1","vim2","vim3"], "vdu2Name":["vim1"]}

In this case the VDU named vdu2Name would be deployed on vim1 and the VDU named vdu1Name randomly on one of the VIMs vim1, vim2 or vim3.

The second command argument specifies a file containing a list that describes which keypairs shall be used to deploy the NSR. Here is an example:

 ["key1", "key2", "key3"]

The last command argument specifies a file containing a map of VNFR names and configuration parameters. Here is an example:

{
  "configurations":{ 
    "vnfrName1":{"name":"conf1","configurationParameters":[{"confKey":"key1", "value":"value1", "description":"description1"}]}, 
    "vnfrName2":{"name":"conf2","configurationParameters":[{"confKey":"key1", "value":"value1", "description":"description1"}]} 
  }
}

Of course you do not have to specify VIMs, keys and configurations. If you do not want to specify them just put empty objects into the files i.e. {} and [].

delete

Delete the object of type Network Service Record passing the id

 $ openbaton.sh NetworkServiceRecord-delete id-network-service-record

update

Update the Network Service Record

 $ openbaton.sh NetworkServiceRecord-update file.json id-network-service-record

findAll
- Find all the objects of type Network Service Record
```
 $ openbaton.sh NetworkServiceRecord-findAll 
```

findById

Find the object of type Network Service Record through the id

 $ openbaton.sh NetworkServiceRecord-findById id-network-service-record

getVirtualNetworkFunctionRecords
- Get all the Virtual Network Function Records of Network Service Record with specific id
```
 $ openbaton.sh NetworkServiceRecord-getVirtualNetworkFunctionRecords id-network-service-record
```
getVirtualNetworkFunctionRecord
- Get the Virtual Network Function Record with specific id of Network Service Record with specific id
```
 $ openbaton.sh NetworkServiceRecord-getVirtualNetworkFunctionRecord id-network-service-record id-vnfr
```
deleteVirtualNetworkFunctionRecord
- Delete the Virtual Network Function Record of NetworkS ervice Record with specific id
```
   $ openbaton.sh NetworkServiceRecord-deleteVirtualNetworkFunctionRecord id-network-service-record id-vnfr
```
createVNFDependency
- Create a VirtualNetworkFunctionRecord Dependency of a NetworkServiceRecord with specific id
```
 $ openbaton.sh NetworkServiceRecord-createVNFDependency id-network-service-record file.json
```
deleteVNFDependency
- Delete the VirtualNetworkFunctionRecord Dependency of a NetworkServiceRecord with specific id
```
 $ openbaton.sh NetworkServiceRecord-deleteVNFDependency id-network-service-record id-vnfdependency
```
getVNFDependencies
- Get all the VirtualNetworkFunctionRecord Dependencies of a NetworkServiceRecord with specific id
```
 $ openbaton.sh NetworkServiceRecord-getVNFDependencies id-network-service-record
```
getVNFDependency
- Get the VirtualNetworkFunctionRecord Dependency of a NetworkServiceRecord with specific id
```
 $ openbaton.sh NetworkServiceRecord-getVNFDependency id-network-service-record id-vnfdependency
```
createVNFCInstance
Add a VNFCInstance to a VNF by performing a SCALE_OUT operation on the VNF

$ openbaton.sh NetworkServiceRecord-createVNFCInstance id-network-service-record id-virtual-network-function-record vnfcomponent-file.json vim-list-file.json

createVNFCInstance
Add a VNFCInstance to a specific VDU by performing a SCALE_OUT operation on the VNF

$ openbaton.sh NetworkServiceRecord-createVNFCInstance id-network-service-record id-virtual-network-function-record id-vdu vnfcomponent-file.json vim-list-file.json

deleteVNFCInstance
Perform a SCALE_IN operation on a Virtual Network Function by deleting a VNFCInstance from the Virtual Network Function Record

$ openbaton.sh NetworkServiceRecord-deleteVNFCInstance id-network-service-record id-virtual-network-function-record

startVNFCInstance
Start a VNFCInstance specified by it's id

$ openbaton.sh NetworkServiceRecord-startVNFCInstance id-nsr id-vnfr id-vdu id-vnfcinstance

stopVNFCInstance
Stop a VNFCInstance specified by it's id

$ openbaton.sh NetworkServiceRecord-stopVNFCInstance id-nsr id-vnfr id-vdu id-vnfcinstance

User Subcommands

create
Create a new User

$ openbaton.sh User-create file.json

delete
Delete a user passing his id

$ openbaton.sh User-delete user-id

update
Update a User

$ openbaton.sh User-update file.json user-id

findAll
Find all Users

$ openbaton.sh User-findAll

findByName
Find a User by his username

$ openbaton.sh User-findByName username

changePassword
Change the password of the current user

$ openbaton.sh User-changePassword oldPassword newPassword

Remember to source nfvo.properties afterwards and set the new password if you want to continue working as this User.

Project Subcommands

create
Create a new Project

$ openbaton.sh Project-create file.json

delete
Delete a Project passing its id

$ openbaton.sh Project-delete id-project

update
Delete a Project passing its id

$ openbaton.sh Project-delete id-project

findAll
Find all Projects

$ openbaton.sh Project-findAll

findById
Find a Project by passing its id

$ openbaton.sh Project-findById id-project

Key Subcommands

generateKey
Generate a new Key in the NFVO

$ openbaton.sh Key-generateKey keyname

You will get back the private key.

importKey
Import a Key into the NFVO

$ openbaton.sh Key-importKey keyname publicKey

delete
Delete a Key passing its id

$ openbaton.sh Key-delete id-key

findAll
Find all Keys

$ openbaton.sh Key-findAll

findById
Find a Key by passing its id

$ openbaton.sh Key-findById id-key

Event Subcommands

create
- Create the object of type Event
```
$ openbaton.sh Event-create file.json
```
delete
- Delete the object of type Event passing the id
```
$ openbaton.sh Event-delete id-event
```
findAll
- Find all the objects of type Event
```
$ openbaton.sh Event-findAll
```
findById
- Find the object of type Event through the id
```
 $ openbaton.sh Event-findById id-event
```

Configuration Subcommands

create

Create the object of type Configuration

 $ openbaton.sh Configuration-create file.json

delete
- Delete the object of type Configuration passing the id
```
 $ openbaton.sh Configuration-delete id-configuration
```
findAll
- Find all the objects of type Configuration
```
 $ openbaton.sh Configuration-findAll
```
findById
- Find the object of type Configuration through the id
```
 $ openbaton.sh Configuration-findById id-configuration
```

Image Subcommands

create
- Create the object of type Image
```
 $ openbaton.sh Image-create file.json
```
delete
- Delete the object of type Image passing the id
```
 $ openbaton.sh Image-delete id-image
```
findAll
- Find all the objects of type Image
```
 $ openbaton.sh Image-findAll
```
findById
- Find the object of type Image through the id
```
 $ openbaton.sh Image-findById id-image 
```

VirtualLink Subcommands

create

Create the object of type VirtualLink

 $ openbaton.sh VirtualLink-create file.json

delete
- Delete the object of type VirtualLink passing the id
```
 $ openbaton.sh VirtualLink-delete id-virtual-link 
```
update
- Update the object of type VirtualLink passing the new object and the id of the old object
```
 $ openbaton.sh VirtualLink-update file.json id-virtual-link
```
findAll
- Find all the objects of type VirtualLink
```
 $ openbaton.sh VirtualLink-findAll
```
findById
- Find the object of type VirtualLink through the id
```
 $ openbaton.sh VirtualLink-findById id-virtual-link
```

VNFPackage Subcommands

create
- Create a VNFPackage by uploading a tar file to the NFVO
```
 $ openbaton.sh VNFPackage-upload file.tar 
```
delete
- Delete the object of type VNFPackage passing the id
```
 $ openbaton.sh VNFPackage-delete id-vnfPackage 
```
update
- Update the object of type VNFPackage passing the new object and the id of the old object
```
 $ openbaton.sh VNFPackage-update file.json id-vnfPackage
```
findAll
- Find all the objects of type VNFPackage
```
 $ openbaton.sh VNFPackage-findAll
```
findById
- Find the object of type VNFPackage through the id
```
 $ openbaton.sh VNFPackage-findById id-vnfPackage
```

Issue tracker

Issues and bug reports should be posted to the GitHub Issue Tracker of this project

What is Open Baton?

Open Baton is an open source project providing a comprehensive implementation of the ETSI Management and Orchestration (MANO) specification and the TOSCA Standard.

Open Baton provides multiple mechanisms for interoperating with different VNFM vendor solutions. It has a modular architecture which can be easily extended for supporting additional use cases.

It integrates with OpenStack as standard de-facto VIM implementation, and provides a driver mechanism for supporting additional VIM types. It supports Network Service management either using the provided Generic VNFM and Juju VNFM, or integrating additional specific VNFMs. It provides several mechanisms (REST or PUB/SUB) for interoperating with external VNFMs.

It can be combined with additional components (Monitoring, Fault Management, Autoscaling, and Network Slicing Engine) for building a unique MANO comprehensive solution.

Source Code and documentation

The Source Code of the other Open Baton projects can be found here and the documentation can be found here .

News and Website

Check the Open Baton Website Follow us on Twitter @openbaton.

Licensing and distribution

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Support

The Open Baton project provides community support through the Open Baton Public Mailing List and through StackOverflow using the tags openbaton.

Version
5.2.1 Apr 27, 2018
3.2.0 Feb 8, 2017
3.0.0 Oct 31, 2016
3.0.0-RC1 Oct 26, 2016
2.2.0 Sep 26, 2016

Open Baton SDK

License

Categories

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Source Code Management

Download cli

Dependencies

compile (4)

Project Modules

Open Baton Client

Project Structure

How to install the Open Baton Client

How to use the command-line interface

Documentation

Set the required environment variables

Openbaton command-line usage

For help on a specific openbaton command, enter:

Vim Instance Subcommands

Network Service Descriptor Subcommands

Virtual Network Function Descriptor Subcommands

Network Service Record Subcommands

User Subcommands

Project Subcommands

Key Subcommands

Event Subcommands

Configuration Subcommands

Image Subcommands

VirtualLink Subcommands

VNFPackage Subcommands

Issue tracker

What is Open Baton?

Source Code and documentation

News and Website

Licensing and distribution

Support

Supported by

Open Baton

Versions