InstallerConfiguration

Tom PIT Installer uses json file which contains instructions which guides installer when installing various components and plugins. Note that installer uses the same configuration file for fresh installation and upgrades. Below is a sample configuration file:

{
 "init": {
  "user": "admin",
  "password": "adminPassword",
  "storageProvider": "E8BC6674718241D0ADA31835BDA71E36"
 },
 "plugins": [
  {
   "default": [
    {
     "kind": "dataProvider",
     "location": "TomPIT.DataProviders.Sql",
     "type": "TomPIT.DataProviders.Sql.SqlDataProvider, TomPIT.DataProviders.Sql"
    },
    {
     "kind": "designer",
     "location": "TomPIT.Templates.Application.Design",
     "type": "TomPIT.Application.ApplicationTemplate, TomPIT.Application.Design"
    },
    {
     "kind": "template",
     "location": "TomPIT.Templates.Application",
     "type": "TomPIT.Application.Plugin, TomPIT.Application"
    }
    ]
   },
   {
    "runtime": [
    {
     "kind": "dataProvider",
     "location": "TomPIT.DataProviders.Sql",
     "type": "TomPIT.DataProviders.Sql.SqlDataProvider, TomPIT.DataProviders.Sql"
    },
    {
     "kind": "template",
     "location": "TomPIT.Templates.Application",
     "type": "TomPIT.Application.Plugin, TomPIT.Application"
    }
    ]
   }
 ],
 "db": {
  "connectionString": "data source=local;initial catalog=tompitSys; user id=***; password=***"
 },
 "sys": {
  "location": "c:\\inetpub\\wwwroot\\tompit\\sys",
  "url": "http://localhost/tompit/sys",
  "authenticationToken": "defaultAuthenticationToken",
  "name": "Default",
  "database": "TomPIT.SysDb.Sql.SqlProxy, TomPIT.SysDb.Sql",
  "authentication": {
   "jwToken": {
    "validIssuer": "tompit.net",
    "validAudience": "tompit.net",
    "issuerSigningKey": "7F4904FF3E1B4C758DE180D0F11779A3"
   }
  },
  "plugins": [
  {
   "kind": "storageProvider",
   "location": "TomPIT.StorageProviders.Sql",
   "type": "TomPIT.StorageProvider.Sql.SqlStorageProvider, TomPIT.StorageProvider.Sql"
  },
  {
   "kind": "sysDb",
   "location": "TomPIT.SysDb.Sql"
  }
  ]
 },
 "management": {
  "location": "c:\\inetpub\\wwwroot\\tompit\\management",
  "plugins": "default"
 },
 "dev": {
  "location": "c:\\inetpub\\wwwroot\\tompit\\dev",
  "plugins": "default"
 },
 "app": {
  "location": "c:\\inetpub\\wwwroot\\tompit\\app",
  "plugins": "runtime",
  "resourceGroups": [
   "Default"
  ]
 },
 "rest": {
  "location": "c:\\inetpub\\wwwroot\\tompit\\rest",
  "plugins": "runtime",
  "resourceGroups": [
   "Default"
  ]
 }
}

In the example above Tom PIT Installer will install (or upgrade) Sys server, a Management console, Development server, Application server and Rest server. It will also install Application Microservice template, with design time components on development and management server and runtime components on all installed servers.

Configuration

Configuration starts with the Json object. The following attributes are supported on the root:

• init
• plugins
• db
• sys
• management
• dev
• app
• rest
• iot
• bigData
• search
• worker
• cdn

Only the sys attribute is required, all other attributes depend on the installation type (fresh install or upgrade).

init attribute

init attribute is used only on fresh installation and can be removed once the first installation successfully completes. Its values are used after the System database is installed. Installer automatically creates user with Full control privileges, creates default Resource group and assigns its default Storage provider.

The following atributes are supported:

• user
• password
• storageProvider

user attribute

user attribute defines login name with which you'll be able to sign in. This attribute is required when installing the platform for the first time.

password attribute

password attribute defines the password for the user. This attribute is required as well when installing the platform for the first time.

storageProvider attribute

storageProvider attribute defines the default storage provider which will be used by default Resource group. Each Storage Provider has a unique id and you must set its value to this attribute. Default Storage provider is Sql Storage Provider but you can set a different storage provider, for example Azure Storage Provider.

You can change Storage provider in the Management console later but changing the Storage provider once Microservices are assigned will cause the configuration will be lost and you will have to reinstall all Microservices.

plugins attribute

plugins attribute is optional and serves only as a shortcut when defining servers. Each server