Configurator/IniFiles

Description

This setting allows UMS backend to run multiple UMS installation (customers) from the same backend server.

Options for this setting can be found under Settings -> IniFiles

A file will be generate under the UMS installation folder containing these settings. They are not stored in a database.

The file is called IniFiles.json and the contents of the file looks like this.

{
 "IniFiles": [
   {
     "Name": "Customer1",
     "FileName": "UserManagement - Customer1.ini",
     "Description": "Customer1 DB",
     "WebSiteName": "Customer 1"
   },
   {
     "Name": "Customer2",
     "FileName": "UserManagement - Customer2.ini",
     "Description": "Customer2 DB",
     "WebSiteName": "Customer 2"
   }
 ],
 "Concurrency": [
   {
     "ProgramName": "GetSkemaBrikker",
     "MaxConcurrency": 4
   },
   {
     "ProgramName": "GetStudents",
     "MaxConcurrency": 3
   },
   {
     "ProgramName": "SMS Server",
     "MaxConcurrency": 2
   }
 ]
}

Settings

Databases / Customers

This section is used to specify the Ini files used to run the programs with. These files must be in the usermanagement installation folder.

Name

This is an abbreviated name for the ini file. This can only contain [a-zA-Z0-9].

This is used for two things:

• When running the programs from the commandline with the parameter "/IniFilesName:Customer1". Change Customer1 to the name you want to use.
• It will generate new log files with the prefix "GetStudents Customer1.log" for each row name. This will allow you to see the log file just you would when this is not used.

Filename

The filename of the ini file to use for this setting.

Web site name

This is the web site name from IIS manager. See picture marked with yellow arrow.

This is needed when running multiple frontends on the same installation.

You create multiple sites that points to the same installation folder where UMS Web is installed.

Description

Enter a description. This is not used for anything.

Concurrency for each program

This controls how many instances are running at a time. This is for each program.

If the program is not specified the default is 10.

For service the default is all is running.

Program name

The name of the *.exe file from the UMS installation folder.

For UMS Services this is still the *.exe file name.

You can enter some reserved Keywords:

• Programs
  • All backend programs that are not services
• Services
  • All backend services
• *
  • All backend programs and services

The order in which the program or service decides the concurrency is:

1. Specified with the program name
2. Programs or Services keyword
3. *

Max concurrency

Specify how many should be activated at the same time.

Change setting

Name

Choose the setting you want to change to.

You will see the setting has been change in the here. Marked with yellow.

How to create a new Ini file for a database

Enter the information under the "Databases / Customers" section.

Then change to this setting under Settings -> IniFiles -> Change Setting. This will cause UMS to say that the file does not exist and ask you to fill out the SQL connection information.

How to run/install on IIS

You install UMS Academic web into a web site.

Then you create new websites that points into the same physical folder. This website name is used in the IniFiles.json under the tag "Web site name" as described in under Configurator/IniFiles#Web site name

Remember to copy IniFiles.json into the bin folder along with the ini files specified in the json file.