SkySpark Installation Guide

Published on 04 Mar 2021 by Emma Eynon

SkySpark Installation Guide

Walkthrough Steps - Configure SkySpark

  1. Install Java tick
  2. Obtain/Download SkySpark install tick
  3. Install SkySpark files. tick
  4. Configure SkySpark.

    Run the setup.bat file found from the skyspark-3.x.x/bin/ directory (manually or by using command prompt).

This will run a script which asks a couple of questions and configures SkySpark accordingly.


a. Answer Y (for yes) to configure/create the required directories

Setup
  var dir:     C:\Temp\skyspark-3.0.25\var [exists]
  host db:     C:\Temp\skyspark-3.0.25\var\host\folio.trio [missing]
  user db:     C:\Temp\skyspark-3.0.25\var\user\db
  http config: [missing]
  su user:     [missing]
  license:     [missing]

Run setup for above dir? (y/n)>

b. Answer Y to accept the End User License Agreement

Do you accept the End User License Agreement found at:
https://skyfoundry.com/file/125/EULA.pdf
Accept? (y/n)>

c. Create your own SkySpark login

This is the all-important Super User (su) account which will allow the highest level of access to the SkySpark platform.

su username>
su password>
su password (confirm)>

Note: These details can be changed later. Any username / password may be entered.

If setting up a local installation for personal development only, simple credentials such as the following are fine:

username: su
password: password

(Needless to say these login credentials are important and should be remembered!)

d. Specify a HTTP Port

(Typically this is 8080)

http port [8080]>

This configures which HTTP port the webserver will run on and affects the URL used to access SkySpark from a browser. The default port of 8080 is fine for most purposes.

Choosing a port

Selecting port 8080 means you will access SkySpark on a URL of http://localhost:8080/ Note how the port number comes after the :colon.

Note: Historically, port 8080 has been the port of choice for development web servers. Production web servers have always run on port 80 (see HTTP 0.9), so 8080 was an easily typed, natural progression, and step up from 80 - as 81 and other port numbers were already taken by other communication standards.

e. Choose whether to manually or automatically update the license

Update license from cloud? (y/n)>

Choosing yes initiates licence auto-updates from the SkyFoundry server should a change be detected. See SkySpark Licensing for details. Licences are typically only updated anually when maintence is due, so for local development use, any option is fine.

f. Answer Y to complete the setup

Apply setup options? (y/n)>

Are you sure!? Last chance!

Success!

The last thing we should see is an overview of settings applied to the SkySpark installation.

Commit: host @http {httpPort:8080, sysMod}
Commit: db @su {person, userAuth:{salt:xxxx-xxxx, c:10000, scheme:scram, hash:SHA-256}, created:2020-02-22T22:22:22.222+01:00 London, tz:London, userRole:su, user, username:su, dis:su}

License update: no license file installed

Success!

Made a mistake?

If you need to start over, just run the script (skyspark.bat) file again!

3 items