/pega-infinity-sma

System Management Application for Pega Infinity based on Pega API

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

PISMA - Pega Infinity SMA (System Management Application)

CodeFactor Django CI

System Management Application for multiple Pega Infinity nodes based on Pega API

Currently application in its early alpha stage. In the future it will cover all Pega API system management capabilities

Available features:

  • Requestor management: interrupt and stop
  • Agent management: start, stop and restart

Instalation

git clone https://github.com/mishankov/pega-infinity-sma.git
cd pega-infinity-sma
scripts/init.sh

Then follow instructions to create super user

For Windows use init.bat

Get up and running

To run SMA do

scripts/runserver.sh

and then go to http://0.0.0.0:8888/ in your browser

For Windows use runserver.bat

Add new node

To add new node:

  1. Go to http://0.0.0.0:8888/admin
  2. Log in with your super user account
  3. Under PISMA application go to "Pega nodes" and click "Add Pega node" button
  4. Fill the form: displayed name, url in format http://{host}:{port}, select production level and enter login and password to access Pega API on your node
  5. Click "Save"

Then you can access you node on home page http://0.0.0.0:8888/

Node access permissions

To access node with not super user you should add permission with name Can access {PegaNode.name} to this user or to one of his groups

Settings

All project wide settings should be done through environment variables

Common settings

  • PISMA_PEGAAPI_TIMEOUT - timeout for PegaAPI services. Default is 5
  • PISMA_DJANGO_DEBUG - debug mode for Django. Default is False
  • PISMA_DJANGO_SECRET_KEY - Django secret key. Default is SECRET_KEY. You must change it, if you use PISMA with production environments
  • PISMA_DJANGO_SELF_SERVE_STATIC_FILES - use WhiteNoise to serve static files. Default is True

Server settings

  • PISMA_HOST - host to run application server. Default is ::
  • PISMA_PORT - port to run application server. Default is 8888

Database settings

  • PISMA_DJANGO_SQL_ENGINE - SQL engine for Django. Default is django.db.backends.sqlite3. django.db.backends.postgresql also supported
  • PISMA_DATABASE_URL - URL to connect to database in format {database vendor}://{login}:{password}@{host}:{port}/{databse name}. Required if PISMA_DJANGO_SQL_ENGINE is not set to django.db.backends.sqlite3. Default is empty string

Logging level settings

  • PISMA_DJANGO_ROOT_LOGGING_LEVEL - root logging level setting. Default is ERROR. Sends logs to logs/errors.log and console
  • PISMA_DJANGO_PISMA_LOGGING_LEVEL - PISMA logging level setting. Default is INFO. Sends logs to logs/pisma.log and console
  • PISMA_DJANGO_CONSOLE_LOGGING_LEVEL - console logging level setting. Default is WARNING. Doesn't print messages with logging level lower then its
  • PISMA_DJANGO_FILE_LOGGING_LEVEL - logs/pisma.log logging level setting. Default is INFO. Doesn't print messages with logging level lower then its

Docker

You can use Docker to deploy Pega Infinity SMA

docker-compose.yml

You need to create docker-compose.yml in the project root directory. There are a couple examples of content for docker-compose.yml file in docker-compose-examples/ directory:

  • docker-compose-sqlite.yml - creates container with PISMA and SQLite as your database. Great for small projects and development environment
  • docker-compose-with-postgresql.yml - creates two containers: one with PISMA and one with PostgreSQL. Connects PISMA to this PostgreSQL database
  • docker-compose-external-database.yml - if you already have a database that you want to use this option is for you

Deployment

After you created docker-compose.yml you can run scripts/init_docker.sh to deploy Pega Infinity SMA

Technologies