Configure the Alfabet Web Application
From Alfabet 10 to Alfabet 11, the configuration language for the configuration files in the physical directory of the Alfabet Web Application has changed from XML to JSON. The alfabet.config file has been substituted by the alfasettings.json file. In the root directory of the Alfabet Web Application , appsettings.json contains the relevant settings while web.config is only a redirect to the .NET Core.
Example files for configuration files including NLog configuration for implementation of logging are available in the Example folder which is available in the AlfabetWebApplication , AlfabetAPIServer , and Programs directory. The folders contain all or the relevant subset of the following examples for different use cases:
-
OnPrem: For customers with on premise installations and Bizzdesign BV Technical Consultants to maintain customer installations. The folder contains sub-folders for various use cases:
- File: Including logging to file.
- FileCompressed: Including logging directly to ZIP files.
- WindowsEventLog: INcluding logging to the Windows event log.
- SAML: For logging to file when using SAML for user authentication.
- OAuth: For logging to file when using OAuth for user authentication.
- Demo: For partners and sales setting up an Alfabet instance for demonstration. NLog is pre-configured to write log messages about warnings and errors into a temporary folder.
- Cloud: For cloud installation via the Bizzdesign BV cloud team. Includes logging to Splunk.
- Container: For internal tests of upcoming container installations.
- Services: For internal tests of upcoming service-based installations.
- In the Windows® file explorer, navigate to the WebApplication subdirectory in your Alfabet installation folder.
- Add a new subfolder config.
- Open the subfolder Examples , copy the files from the relevant example folder and paste them in the subfolder config.
- Start the Alfabet Administrator from the Windows® Start Menu.
- Click the Alfabet Aliases node.
- In the toolbar of the table on the right, select Tools > Configure alfasettings.json.
- Click the three-dots button on the right of the Web Folder field and select the physical folder of the Alfabet Web Application. The alfasettings.config file in the config subfolder opens.
- Change the information in the following fields:
- "msfile": Specify the absolute path to the alfabetMS.xml configuration file located in the Programs subdirectory of the Alfabet Installation directory.
- "alias": Enter the name of the server alias configuration for the Alfabet Web Application.
- Optionally, change the additional settings in the file. Click for an overview of the settings which can be made in alfasettings.json.
- Save the file.
- Open the nlog-alfabet.config file in a text editor and configure logging.