Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Parameter
    summaryPort of the Saga server
    default8080
    nameapiPort
    typeinteger
  • Parameter
    summaryIp address the server will be listening for request
    default0.0.0.0
    nameipAddresshost

Security 

Manages the security configuration regarding encrypted communication and authentication

...

  • Parameter
    summaryLocations for external libraries, the locations can be either folder paths or paths directly to the jars files
    namelibraryJars
    typestring array
  • Parameter
    summaryIndicates the class name of the external REST handler to use. If the class is in a non-standard package path, the whole path needs to be specified
    namerestHandlers
    typestring array
     (server only)
  • Parameter
    summaryIndicates the class name of the external UI handler to use. If the class is in a non-standard package path, the whole path needs to be specified
    nameuiHandlers
    typestring array
     (server only)
  • Parameter
    summaryIndicates the class name of the external Model to use. If the class is in a non-standard package path, the whole path needs to be specified
    namemodels
    typestring array
     (server only)

...

  • Parameter
    summaryConfiguration for the GTP3 proxy
    namegpt3
    • Parameter
      summarySecret key for the OpenAI API
      namekey
    • Parameter
      summaryHost for the OpenAI API
      nameopenAIHost
    • Parameter
      summaryOpenAI API version to use.
      nameopenAIAPIVersion

Providers & Resources

  • Parameter
    summaryProvider configurations
    nameproviders
    typejson
    • Parameter
      summaryProvider name
      namename
    • Parameter
      summaryType of provider, the type is the name segment of the class name (e.g. TheName is the type for TheNameProvider class)
      nametype

      Info

      As explained in the Resources page, a resource provides access to a specific set of resources from a particular storage technology.  In order for the Saga to use these providers, we need to specify them in the config file under the providers field.  The declaration of each Resource Provider depends of the resource per se; the details of each one can be find here.

  • Parameter
    summaryTag manager configuration
    nametagManager
    typejson
    • Parameter
      summaryName of the resource to use for the tags. The value should be form by "<provider_name>:<source_name>"
      defaultsaga-provider:saga_tags
      nameresource
  • Parameter
    summaryPipeline manager configuration
    namepipelineManager
    typejson
    • Parameter
      summaryName of the resource to use for the pipelines. The value should be form by "<provider_name>:<source_name>"
      defaultsaga-provider:saga_pipelines
      nameresource
  • Parameter
    summaryConnections for the server user interface (one at the moment ¯\_(ツ)_/¯ ). Use to manage the patterns, tags, and pretty much every single stored element in elasticsearch
    namesolutions
    typejson
     (server only)
    • Parameter
      summaryElasticsearch configuration
      nameelasticSearch
      typejson
      ParametersummaryProtocol to use for the connectiondefault
      • http
        nameschema
        Parameter
        summaryList of hostnames and ports to connect to
        namehostnamesAndPortsnodeUrls
        typestring array
      • Parameter
        summaryThis will be the prefix for all the indexes created for this Saga solution. Prefix must not contain _ (underscore) character.
        defaultsaga
        nameindexName
      • Parameter
        summaryElasticsearch username
        nameuser
        Parameter
        This will enable authentication.
        defaultnone
        nameauthentication
        summaryPath to the file holding the password
        namepassword
      • Parameter
        summaryTimeout in seconds for all the connections use by the user interface
        default30
        nametimeout
        typeinteger
      • Parameter
        summaryTime in seconds to wait before a retry of a failed connection
        default5
        namedelay
      • Parameter
        summaryNumber of times to retry a failed connection
        default3
        nameretries
        typeinteger
        Parameter
        summarySets the maximum of elements to fetch with each request. The default is -1 indicating no limit is set
        default-1
        namemaxResults
        typeinteger


Connecting Saga to an Elasticsearch on HTTPS

...

Code Block
languagejs
themeRDark
{
  "config": {
    "apiPort": 8080,
    "ipAddresshost": "0.0.0.0",
    "security": {
      "enable": false,
      "encryptionKey": "SDFW$%GW$S%S#",
      "encryptionKeyFile": "./bin/saga.ek",
      "users": [{
        "username": "admin",
        "password": "password",
        "roles": "admin"
      }]
    },
    "libraryJars": [
      "./lib"
    ],
    "tagManager": {
      "resource": "saga-provider:saga_tags"
    },
    "pipelineManager": {
      "resource": "saga-provider:saga_pipelines"
    },
    "datasetFolder": "./datasets",
    "ssl": {
      "enable": false,
      "keyStore": "./bin/saga.jks",
      "keyStorePassword": "encrypted:NxepNROIgJ27pYpmKEw30llscPA8zCUpbQW676E7H8Nwo9DMABKQsIYF3fcSxQGG"
    },
    "exportSettings" : {
      "maxSize" : 40,
      "batchSize" : 5000
    },
    "restHandlers": [],
    "models": [],
    "uiHandlers": [],
    "gpt3": {
      "key": "encrypted:7E7nI0+ofh//r1bFvTQCnY7DQlG6Kh4aA1TQlh44/NoxR0DDzHaeZdBXqYAguEXc"
    },
    "providers": [
      {
        "name": "filesystem-provider",
        "type": "FileSystem",
        "baseDir": "./config"
      },
      {
        "name": "saga-provider",
        "type": "Elastic",
        "schemenodeUrls": ["http://localhost:9200"],
        "hostnametimestamp": "localhostupdatedAt",
        "portauthentication": 9200,
        "timestamp": "updatedAt"none",
        "exclude": [
          "updatedAt",
          "createdAt"
        ]
      }
    ],
    "solutions": [
      {
        "display": "Saga",
        "elasticSearch": {
          "schemenodeUrls": ["http://localhost:9200"],
          "hostnamesAndPortsindexName": ["server1:9210", "server2:9220"]"saga",
          "indexNameauthentication": "saganone",
          "timeout": 30,
          "delay": 5,
          "retries": 3
        }
      }
    ]
  }
}