You are viewing the documentation for a prerelease version.

Default configuration installation

The UtilityTool has the possibility to install default configuration and specific data regarding the environment of a customer. Otherwise the database will be empty.

The subordinated directories are different kind of configuration objects for the system.

The configuration is located in the following path:

📒 UtilityTool
  📂 DefaultConfiguration
    📂 CertificateAuthority (1)
    📂 CertificateTemplate (2)
    📂 DirectoryService (3)
    📂 Organization (4)
    📂 Report (5)
    📂 Role (6)
    📂 System (7)
    📂 Task (8)
    📂 Text (9)
    📂 TokenTemplate (10)
    📂 User (11)
    📂 UserGroup (12)
    📂 UserGroupRestriction (13)
1 If this directory is available, the UtilityTool will set information of a certificate authority (CA) as configuration into the database.
2 If this directory is available, the UtilityTool will set information of certificate templates as configuration into the database (usually certificate templates for Authentication and Signature).
3 If this directory is available, the UtilityTool will set information of directory service as configuration into the database (usually the local instance of Active Directory).
4 If this directory is available, the UtilityTool will set information of the organization as configuration into the database.
5 If this directory is available, the UtilityTool will create pre-defined reports as templates against the database.
6 If this directory is available, the UtilityTool will create pre-defined roles against the database.
7 If this directory is available, the UtilityTool will set generic settings and configuration of the system against the database.
8 If this directory is available, the UtilityTool will set the task types and task configuration against the database.
9 If this directory is available, the UtilityTool will set the generic texts of the system of different languages against the database.
10 If this directory is available, the UtilityTool will set the default token templates against the database (usually Standard, Limited, Virtual and File).
11 If this directory is available, the UtilityTool will set a default user into the database (usually the SuperAdmin user for system setup). If the user is available, a one-time-password will be generated (see "Receive one time password credential" information below).
12 If this directory is available, the UtilityTool will set default user groups into the database.
13 If this directory is available, the UtilityTool will set default restrictions between the user groups against the database.

Install default configuration

If the /UtilityTool/DefaultConfiguration/ is available, the UtilityTool will install the default configuration when install/upgrade the database. The UtilityTool can also install the default configuration separately:

  • Open the UtilityTool console.

  • Select ServerManager.

  • Select Set default configuration.

The default configuration can also be installed using the Windows command prompt:

Pointsharp.NiS.UtilityTool.exe -setdefaultconfig

Receive one-time-password

If default configuration is installed, included a default user, a one-time-password has been generated. Receive the OTP using UtilityTool through Windows command prompt:

Pointsharp.NiS.UtilityTool.exe -getotp

Set pointer to customized signing certificate information

The portal requires a signing certificate used for audit logs of the system. The signing certificate is customized and owed by the customer. The portal need the thumbprint of this signing certificate for creation of signatures.

  • Open the UtilityTool console.

  • Select ServerManager.

  • Select Set audit log certificate thumbprint.

  • Set the thumbprint of the certificate thumbprint.

The signing certificate thumbprint set using the Windows command prompt:

Pointsharp.NiS.UtilityTool.exe -setauditlogcert thumbprint=ABCD1234

The UtilityTool will now set the thumbprint into the XML system configuration SystemConfiguration/Components/Component/AuditLog/SigningCertificateHash