sorna-manager 0.9.11

Sorna Manager

Package Structure

• sorna

• manager: Abstraction of agents and computation kernels

• gateway: RESTful API gateway based on aiohttp

Installation

Sorna Manager requires Python 3.6 or higher. We highly recommend to use pyenv for an isolated setup of custom Python versions that might be different from default installations managed by your OS or Linux distros.

$ pip install sorna-manager

For development:

We recommend to use virtual environments in Python. You may share a virtual environment with other Sorna projects.

$ git clone https://github.com/lablup/sorna-manager.git
$ python -m venv venv-sorna
$ source venv-sorna/bin/activate
$ pip install -U pip setuptools  # ensure latest versions!
$ pip install -r requirements-dev.txt

Running and Deployment

Prepare databases.

• An RDBMS (PostgreSQL)

• A Redis server

• Sorna Manager uses the following database IDs

  • 1: to track status and availability of kernel sessions

  • 2: to track status and availability of instances (agents)

  • 3: to track session IDs

  • These IDs are defined in sorna-common

Configuration

You need to specify configuration parameters using either CLI arguments or environment variables. The default values are for development settings so you should set most of them explicitly in production. For details about arguments and their equivalent environment variable names, run the server module with --help.

Running the API gateway server from a command line:

$ python -m sorna.gateway.server

Example supervisord config:

[program:sorna-manager]
stopsignal = TERM
stopasgroup = true
command = /home/sorna/run-manager.sh

TCP Port numbers to open

• 5001 (for legacy ZeroMQ-based interface)

• 8080 / 8443 (for local development)

• 80 / 443 (for HTTP/HTTPS API requests in production)