Welcome to the Getting Started, this is what you will achieve by follow the next steps:
Setup the environment.
Deploy Saga.
Run Saga.
Check it's working!.
Prerequisites
Elasticsearch 6.4.1 or above.
Java 11 or above.
Note
This guide assumes you already have a stable Saga release such as 1.0 or above.
Step 1: Setup the environment
Check Java 11 is installed on your machine by running on terminal (or system console):
$> java -version
Unpackage Saga in your preferred location. This is our recommended setup but you can pretty much handle the paths as you wish. This guide will refer to Saga's working directory as {SAGA_HOME}.
Saga uses Elasticsearch (6.4.1 or above) and you can get it here.
Deploy Elasticsearch (ES) under {SAGA_HOME} in something like {SAGA_HOME}/Elasticsearch-6.4.1.
Run ES by executing the binary on {SAGA_HOME}/Elasticsearch-6.4.1/bin.
Saga can run on an empty ES instance, you'd need to add new tags and resources.
Step 2: Deploy Saga
Once you have Saga in {SAGA_HOME} validate the following:
There is a {SAGA_HOME}/lib folder containing the following JARs:
Check the basic configuration on {SAGA_HOME}/config/config.json:
"airPort": 8080 → this is the port used by the server.
"ipAdress": "0.0.0.0" → this IP/mask is used to restrict inbound connections, open to all connections by default.
"logger" → each logger level config per handler.
"provider" → data Resources, mainly used to specify location of resource files like dictionaries and ES configuration
New filesystem providers can be added to group different resource files.
ES configuration includes the "port" to connect to, this is by default 9200, you may change it to fit your environment.
"solutions" → bundle solution schema, it values may be change to have multiple servers with different "solutions" or to switch from one to another.
A solution work as a domain. By default the "saga" solution creates ES indexes using the pattern "saga-<index>" and only loads indexes with the same patter. So you could have multiple solutions on a ES server. To switch between solution you'd need to shut down the server, change the "indexName" value and restart the server.
If you have some valid "models" you'd like to include on the server:
Create a {SAGA-HOME}/nt-models folder for "name trainers" and copy the model there.
Create a {SAGA-HOME}/ct-models folder for "classification trainers" and copy the model there.
To add datasets:
Create a {SAGA-HOME}/datasets folder.
Each dataset must be placed on each own folder, this folder name will be the one displayed for "test runs".
Each data document in the dataset must be compliant with Saga's data file JSON format.
Each folder must contain a ".metadata" file with information about the dataset and how to read it. You can check the dataset format here.
Step 3: Run Saga
To run Saga:
Check Elasticsearch is running.
Use the bundled startup script on {SAGA_HOME} (either startup.bat for Windows or startup.sh for Linux).
If you didn't change the default port on the configuration, you should be able to access Saga at http://localhost:8080/. If not check your configuration for the right port.
Panel
On this page:
Table of Contents
Related pages
Content by Label
showLabels
false
spaces
saga12new
showSpace
false
sort
title
type
page
cql
label = "documentation-space-sample" and type = "page" and space = "saga12new"