moon-manager 0.9.1

No project description provided

# moon_manager

## Installation

`bash python -m pip install moon_manager sudo moon_manager_setup ` If you want a development version:

`bash ARTIFACTORY=https://artifactory-iva.si.francetelecom.fr/artifactory/api/pypi/python-virt-orange-product-devops/simple sudo python -m pip install --pre moon_manager -i $ARTIFACTORY ` Use it at your own risk, this is an unstable version.

If you want to be in development mode, and get the code, you can do the following steps:

`bash git clone [e-mail]:moon/moon_utilities.git cd moon_utilities sudo pip install -r requirements.txt sudo pip install -e . cd .. git clone [e-mail]:moon/moon_manager.git cd moon_manager sudo pip install -e . `

## Configuration

A configuration file should be located in /etc/moon/moon.yaml, review it and update it to fit your needs. You may need to change the following attributes:

• debug: true to false

• database: url: either sqlite or mysql

• pwd_file: put this file in a secured directory, this file contains the users and passwords of all the system

• openstack: url: the URL of the Keystone server (if used)

## Initialization

To initialize the database, use:

`bash moon_manager db `

You need to add a new user (for example admin):

`bash moon_manager users add admin [-p admin_password] ` If the password is not given, you will be prompt for one.

## Web server execution

For a development server, use:

`bash hug -m moon_manager.server `

For a production server:

If you use Information plugins, you must start the daemon (experimental):

`bash moon_manager start_daemon `

Then, start the server and connect to the CLI with the /etc/moon/moonrc file:

`bash moon_manager start_manager . /etc/moon/moonrc admin admin # Check if the service is up and running moon_manager status --human `

## Connect to API

• With a web browser

  1. go to http://127.0.0.1:8000/auth

  2. insert login and password (admin/admin for example)

  3. with “RestClient”, “Postman” or an other Web API client add the “x-api-key” in headers with the key given by the previous step.

• With a console

  1. execute a basic auth to http://127.0.0.1:8000/auth

  2. use the received token to connect to API

Example with httpie:

`bash sudo python -m pip install httpie http -a admin:admin 127.0.0.1:8000/auth # copy the Token in TOKEN http 127.0.0.1:8000/subjects "x-api-key:$TOKEN" `

## Connect to HTML UI You need to have serve installed on your server. To install it:

` sudo apt install npm sudo npm install -g serve `

Then, configure the dashboard part of the /etc/moon/moon.yaml file like this:

` dashboard: root: <path to dist dir of moon gui> pid_filename: <file to store the pid in, eg. /tmp/moon_web_ui.pid> port: 8080 `

and:

`bash moon_manager start_gui `

Open your web browser and go to: http://127.0.0.1:8080/

The port can be changed in the conf file.