Part 0 - Getting started

To get started with the tutorial, you'll first need some data to perform your calculations on. We provide you an executable, which sets up this data. Currently, this is only available for Windows.

Requirements

To complete the exercises, you'll need:

  1. A user that belongs to the \RTDB-CalcUser group
  2. Another user that has permissions to create:
    • Variables
    • Equipment instances
    • ACL entries

The first user is the one you use when doing the exercises. The second user is used to run the setup program, this one needs to be a local account.

❗️

If you don't have access to an account with the necessary create permissions, you'll need to ask an administrator to run the setup program for you.

Running the setup program

To set up the example data for the exercises:

  1. Download the setup program.
  2. Unzip it.
  3. Open the command line.
  4. Navigate to the folder where you unzipped the program.
  5. Execute the following command:
CalcEngineTutorialSetup.exe -h <hostname> -u <username>
  • <hostname>: connection string to a History machine, for example wss://127.0.0.1/history
  • <username>: name of a user with create permissions, for example .\\AdminUser

The executable will ask you to type in the password for the user. After that, it will set up the data and exit. If everything was successful, you should see Setup successful printed on the console.


What’s Next

After setting up the data, you can move forward to the actual exercises.