A3 architecture
Intro
The A3 architecture is one of the possible Assothink architectures.
It is an extension / rewriting of the previous (less powerfull) versions of Alex and Assothink (2 names for the same project), developped from 2009.
It was developed from 2013 and it is still under development in 2015 ...
The A3 architecture divides the Assothink work in a trilogy of main working layers, plus 3 complementary side parts.
Part | Technology | Function |
---|---|---|
Engine Layer |
Linux, C project name : engine (main: engine.c) |
implemented (goal: computation speed, sizing efficiency) |
Transmission Layer |
Linux, Java project name : alexLib (main: central.java) |
Transmission of information between engine layer and presentation layer; engine launching (goal: network efficiency) |
Presentation Layer |
Linux, Java, JavaFX project Name : alexFX (main: alexFX.java) |
User interface, working as a client to the central process. Access to passive jelly. Access to active jelly and engines. (goal: user friendliness, visibility on data and process) |
Resource Builder |
Linux, Java project name : alexRB (main: builder.java) |
Construction of passive jelly database. Organized in numerous steps. (goal: data coherence, data availability) |
Java Utilities |
Linux, java, javaFX project names: mslib,
techLib, structureLib, drawFXLib |
Generic tools for advanced java application development. Usable not only with Assothink. (goal: ease of development and deployment) |
Bash Scripts |
Linux, bash main bash scripts: a |
terminal-based front-end utilities to launch, monitor, test, debug... all other parts (goal: convenience) |
Engine layer (engine project) notes
This layer implements the Assothink Excitation Propagation Model (EPM), or Assothink active Jelly, or Assothink brain.
The program is a C program: engine.c.
Only concepts, links, signals (only the active jelly).
Load concept and links data from the transmission layer.
Runs autonomously, saving state .
A brain uses a brain slot: a host/port combination.
Many brains may run at the same time in a network, and even on a single machine.
Interaction
The engine layer interacts mainly with the transmission layer.
It is also controlled through the bash scripts components.
Suggested hardware
- standard PC
- mainly accessible through network (remote shells)
- with Linux OS
- with strong processor (fast) and gigabit ethernet!
- 4 Gb RAM, USB port, small HD, simple graphic controller
- compact
- without (no need) CD/DVD, advanced graphic, monitor, keyboard, mouse...
The EPM engine machine setup is standardized, simple, fast,
Transmission & central layer (AlexLib project) notes
The transmission layer works as a visible daemon (a daemon with a visible front-end).
Its main class is central.java.
The transmission layer is a java program, launched from the a script.
Interaction
This layer has two sides.
Interacting with its presentation layer clients, it
- delivers (begin of user session) the whole data set describing the passive jelly
- continuously delivers information produced by the engines
- receives orders from clients, and transmits them to engines
Interacting with the engine layer, it
- creates, kills and controls engine processes
- delivers orders defined by clients
- receives state information from the engines, propagates them to all subscribing clients
Functions
The central controller (launched as a central on the centralHost machine) is able to:
- read, analyse, display (or distribute) state data generated by the EPM engine
- send orders to the EPM engine
- visualize active engine and active front-ends
The central controller is alwas the first and mandatory component of all the processes.
Orders
The orders transmitted to the EPM are:
- Wake Up (launch a new instance of EPM engine)
- Halt (the EPM engine process is terminated)
- Stop (the EPM engine is stopped: it continues to run, but does not perform any cycle)
- Resume (the EPM engine resumes: it performs repeated cycles until new orders are sent)
- Clear EPM memory (all excitation values are set to 0)
- N cycle (the EPM engine performs N cycles, then it is stopped)
- Set one-shot excitation for some nodes
- Set permanent excitation for some nodes
- Modify EPM parameters
- Modify permeabilities of specified EPM links
Suggested hardware
Roughly the same as the computing layer.
More server oriented: more disk and network efficiency, less CPU needs, high availablity.
Presentation layer (AlexFX project) notes
This is a javaFX front-end client applic running
- as stand-alone application
- within browsers
Many clients (presentation layer) may run and interact with the transmission layer simultaneously.
The presentation layer client allows
- to list all running engines to select any of them
- to display the state of the selected EPM engine
- to send to the selected EPM engine all orders listed above.
Suggested hardware
No specific hardware needed.
A standard PC with browser having good web access and good visualization hardware.
- The screen resolution should by high (at least 1500x1000 points).
- The graphic card should have average or high performance.
- The preferred browsers are google chrome (chromium) and firefox.
- The web access should be fast (>20Kbit/sec for download) and the network throughput should be high.
- OS? Linux, Windows, Android and MacOS OK.
Resource Builder (AlexRB project) notes
The resource building part of Alex is a set of batch programs running sequentially.
They are described in details here.
Lauching Alex triple level components: what's running where?
We assume here that 'MMU' is both the dataHost and the centralHost. This may be checked with the a info comman (see Bash Scripts notes)
A typical Alex system includes data located in /server.Alex/ (assuming MMU is the dataHost machine).
A typical running set includes:
a ceds (unique script running on MMU, mainly reporting the creation of central process, engine process, and client process)- central (unique server program running on MMU)
- one or many engines (runing on several hosts)
- one or many UI clients (running on several hosts)
The active process may be listes using a ps or a psa. They are also visible in the UI interface.
The list of hosts likely to run the processes, known as hostSet is defined in java source mscp.alex.msg.hostSet .
Here is a typical output of a info
>> a info General working context information HOST MMM ARCH i686 centralHost MMU dataHost MMU srcHost MMM hostSet MMM MMQ MMU MMW jnb /home/pge/javaNB4projects alexBase /server.Alex JAVA_HOME /usr/lib/jvm/java-8-oracle Unix Linux MMM 3.13.0-43-generic i686 GNU/Linux Ubuntu Ubuntu 14.04.1 LTS gcc gcc version 4.8.2 (Ubuntu 4.8.2-19ubuntu1) java Java(TM) SE Runtime Environment (build 1.8.0_25-b17) Java HotSpot(TM) Server VM (build 25.25-b02, mixed mode) uptime 15:55:45 up 29 days, 4:32, 6 users, load average: 0.54, 0.49, 0.64 alexBase=/server.Alex alexEn3=/server.Alex/en3 alexLac=/server.Alex/lac alexPk=/server.Alex/pkDir alexResource=/server.Alex/resources alexTrace=/server.Alex/trace
Java utility libraries notes
The java utility libraries are used
- by the transmission layer
- by the presentation layer
- by the resource builder
and generally speaking by all java programs included in the Assothink project (and possibly by other programs).
Project-library mslib
General purpose libraries, complementing the standard java packages.
Project-library techLib
Specialized technical tools.
- byting: byte encoding/decoding of various simple data types
- clock: nanosecond-level time measurement
- pack: data compression
- rounding: creation of rounded data for grafs
- sort: sorting utilities
- tObs & tSerie: time series
- topSort: partial sorting
- wordDistance: distance between langage words
Project-library structureLib
Advanced structures based mainly on Java collections, mainly matrix and indexing tools.
Project-library drawFXLib
JavaFX animation library, plus various javaFX utilities.
There is also a set of simple graphic programs used to test drawFXLib, located in the afxXXX projects.
Bash Scripts notes
The a script covers various maintenance and convenience functions.
It is located in ~/Scripts/a .
It uses function and settings defined in ~/Scripts/bashrc and ~/Scripts/bashrcAlex .
It covers very different functions, as visible in its help display.
Alex Main host is MMU Local host is MMM Usage: a central (launch FX Central; only on MMU) Usage: a check (central prereq; check ssh capabilities; only on MMU) Usage: a fx (javafx front end) Usage: a gcc (compile engine) Usage: a gcc <args> (compile engine, then execute with args) Usage: a engi <args> (run engine with args) Usage: a r view (view RB results) Usage: a r 3a 3b 3c (for instance - forced) Usage: a r 4a-4z (for instance - forced) Usage: a r all : all forced Usage: a r need : all needed Usage: a r cnt : cnt pk records Usage: a r clr : clear all pk files Usage: a r step : step list Usage: a r stepp : step list with header Usage: a r steppp : step list with header and comments Usage: a r trace : summary of trace files Usage: a r fileSeq : file construction sequence Usage: a r file <fn> : info on file <fn> Usage: a r stepInfo <step> : info on step <step> Usage: a r ckdbl : check possible double lines Usage: a r -t ... : generic option: terminal tracing Usage: a r -f ... : generic option: file tracing Usage: a r -v|-vv|-vvv ... : generic option: verbosity Usage: a r help|-help|h|-h Usage: (a r works on a makefile in the src directory) Usage: a run <class> <arg> (run java process class mscp.<class> with args) Usage: a runfx <class> <arg> (run javafx process class mscp.<class> with args) Usage: a ljr <class> (list java runnable class(es)) Usage: a ps (involved processes on this host) Usage: a psa(ll) (involved processes on all hosts) Usage: a f(ollow) (tail -f central stdout) Usage: a e(rror) (tail -f central stderr) Usage: a ex(plore) (terminal passive jelly explorer) Usage: a engp(erf) (engine performance, host comparison) Usage: a engl(abspeed) (engine speed lab) Usage: a pk(ack) (pk files interface) Usage: a ba(ckup) (create a backup of critical source files) Usage: a info (general working context info) Usage: a wiki (open Alex wiki) Usage: a he(lp) (this help)