Install new municipalitiy

This document is going to describe the necessary steps to install a new municipality in OS2 Valghalla. This is mainly targeted to people working with the system and will describe all the steps to setup a new municipality in an already existing environment.

Database

Create a new database in the correct environment. If using the Valghalla.Tools run the command updateSingle -d “Databasename”. (For more information, read the system documentation about tools) If not using Valghalla.Tools run all the migrations on the selected database by running dotnet ef database update command with the correct connection string.

Create a new login on the server specific for that municipality. Then create a user with the same name inside of the newly created database. The user should have the roles reader and writer access. Save the password.

When the database is created go to the secrets,json file. This is a JSON-string that contains all the connections that OS2 Valghalla is using. Open that file in Notepad++ and format it to JSON-format. The add a new municipality by creating a new object inside of the array. Do this with caution, if there is something wrong with the format when uploading the new version this will affect all municipalities. The new object should look like the picture below.

../_images/secrets.png

DatabaseConnectionString should contain the credentials for the database user that was recently created.

  • ExternalDomain is the address to the external application.

  • InternalDomain is the address to the internal application.

  • Name is the name of the municipality and is shown in the application.

DNS

Go to the chosen DNS provider and add the specific DNS records for the new municipality.

Authentication

Use the Valghalla.Tools to insert certificate into the database.

Configuration

  • AppConfiguration.Cvr: The municipalitys CVR code.

  • AppConfiguration.Komkod: The municipalitys Komkod

  • AppConfiguration.SMSSender: Sender name when sending out text messages from the system.

  • AppConfiguration.MailAddress: Sender address that the system is sending mails from.

  • AppConfiguration.MailSender: Sender alias that the system use to send mails.

  • ExternalAuthConfiguration.Authority: The EntityID from the authentication setup

  • ExternalAuthConfiguration.Issuer: The EntityID from the authentication setup

  • ExternalAuthConfiguration.SigningCertificatePassword: The password for the certificate used in the external authentication.

  • InternalAuthConfiguration.Authority: The EntityID from the authentication setup

  • InternalAuthConfiguration.Issuer: The EntityID from the authentication setup

  • InternalAuthConfiguration.SigningCertificatePassword: The password for the certificate used in the internal authentication.

First time signing in

There is nothing that is needed to do in OS2 Valghalla for the first time user signing in as the identity portal is saying which user/users that can access the system.

Styling

To change to logo of each municipality go to Administration -> Web -> Contact information an upload a svg file. This file will then be used as a the logo for the external application.