JLupin Control Center core

Requirements

To run JCC core at least Java SE 8 is required and set JAVA_HOME variable.

Installation

Windows

Unpack downloaded zip into installation directory (ex. C:\Program Files\JLupinControlCenter\core). Then go to directory platform\start and execute start.cmd file.

Linux

Unpack downloaded zip into installation directory (ex. /opt/JLupinControlCenter/core). Then go to directory platform/start and execute start.sh file.

Configuration

Console is configured through YAML configuration file. It is located under conf directory. (ex. /opt/JLupinControlCenterSE/console/conf/settings.yml).

cloudName: jlupin # Name of the cloud.
startingContext: /jlupin/zone/default # Default starting context.
verboseMode: true # Default verbose mode setting. When verbose mod is enabled all live logs (ex. when application is starting) are printed to terminal.
echoMode: false # Default setting for 'echo' feature (displaying typed command just after execution).
interactiveMode: true # Default setting for 'interactive'. When interactive is enabled console is asking user for confirmation when paramteres are not typed implicitly.
workingDirectory: control-center # Realtive to platform directory - working directory for JCC (all other directories are relative to this one)
role:
  directory: role # Directory for dumping and loading roles.
script:
  directory: script # Directory for dumping and loading scripts.
deploy:
  strategies:
    directory: deploy/strategies # Directory with deploy strategies.
temp:
  directory: temp # Temp directory for JCC data.
repository:
  remote:
    connectionTimeout: 60000 # Connection tiemout for remote repositories
    readTimeout:       60000 # Read timeout for remote repositories
ssl:
  client:
    certificate: configuration/ssl/client/clientX509Certificate.crt # Client certificate file.
    privateKey:  configuration/ssl/client/clientPrivateKey.pk # Cient private key file.
  server:
    certificate: configuration/ssl/server/serverX509Certificate.crt # Server certificate file.
dataPrinter:
  display: plain_text # Default setting for 'display' (data result format).
  printHeaders: true # Default setting for 'header'.
  separator: ',' # Seperator used by CSV display type.
events:
  defaultListSize: 10 # Default list size for 'event list' command.
  shortDescriptionMaxSize: 50 # Max length of description in short form for 'event list' command.
node:
  isSSL:             true    # Setting if SSL is used for connection with nodes
  transmissionPort:  9096    # Default transmission port for new nodes.
  connectionTimeout: 1000    # Connection timeout for executing commands on nodes.
  readTimeout:       300000  # Read timeout for executing commands on nodes.
externalNode:
  jlrmcPort:         9090    # Default JLRMC port for new external node.
  queuePort:         9095    # Default queue port for new external node.
  transmissionPort:  9096    # Default transmission port for new external node.
  informationPort:   9097    # Default information port for new external node.
  connectionTimeout: 1000    # Connection timeout for executing commands on external nodes.
  readTimeout:       300000  # Read timeout for executing commands on nodes.
security:
  minPasswordLength:    4   # Minimal password length for all users.
  minLowercaseLetters:  0   # Minimal lowercased letters in password.
  minUppercaseLetters:  0   # Miniaml uppercased letters in password.
  minDigits:            0   # Minimal digits in password.
  minSpecialCharacters: 0   # Minimal special characters in password. Special characters list is shown below, under configuration file.

Special characters list

! " # $ % &  ( ) * +  - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~

JLupin Control Center client

Requirements

To run JCC client at least Java SE 8 is required and set JAVA_HOME variable.

Installation

Windows

Unpack downloaded zip into installation directory (ex. C:\Program Files\JLupinControlCenter\client). Then go to My Computer > Properties > Advanced > Environment Variables > Path and change your PATH variable. At the end of string add path to bin directory (ex. C:\Program Files\JLupinControlCenter\client\bin). Now through Windows CMD you should be able to run console command.

Linux

Unpack downloaded zip into installation directory (ex. /opt/JLupinControlCenter/client). Then create symlinks: ln -s /opt/JLupinControlCenter/client/bin/console.sh /usr/local/sbin/console. Now you should be able to run console command.

Configuration

Console is configured through YAML configuration file. It is located under conf directory. (ex. /opt/JLupinControlCenterSE/console/conf/settings.yml).

logging:
  configuration: configuration/log4j2.xml # Path to conguration file for logs.
node:
  address:           127.0.0.1 # Addres of JCC core
  jlrmcPort:         9090      # JLRMC port of JCC core
  queuePort:         9095      # Queue port of JCC core
  transmissionPort:  9096      # Transmission port of JCC core
  informationPort:   9097      # Information port of JCC core
  connectionTimeout: 1000      # Connection timoeut for communication with JCC core.
  readTimeout:       300000    # Read timeout for communication with JCC core.

Running

console - Runs interactive console to manage your microservices.

console [username] [password] [CMD...] - Runs non interactive console to manage your microservices.

To run console just type console in your terminal. Then console should start and you should see request to enter your username (default user is user_admin). Then enter password (default one for user_admin is also user_admin). You should logged in. The first operation you should do is to change user_admin password. To do so type in passwd and change your password. Now you are ready to start using JLupin Control Center! Create new users and start managing your microservices!