...

...

Bevor Sie beginnen:

Voraussetzung für die Installation des primedocs-Servers ist eine Microsoft SQL Server Datenbank zum Speichern der Daten. Falls Sie keinen vorhandenen Datenbankserver verwenden können, können Sie eine SQL Express-Installation durchführen wie hier beschrieben. Die korrekte Konfiguration des SQL-Benutzers für primedocs ist hier beschrieben.

Installation

Im Installationspaket ist ein PowerShell-Skript "Install.ps1" enthalten, das die Installation vornimmt. Das Skript muss als Administrator ausgeführt werden, da unter anderem fehlende Windows Features aktiviert werden.

Before you start:

Prerequisite for the installation of the primedocs server is a Microsoft SQL Server database to store the data. If you cannot use an existing database server, you can perform a SQL Express installation as described here. The correct configuration of the SQL user for primedocs is described here.

...

Installation

The installation package contains a PowerShell script "Install.ps1" that performs the installation. The script must be run as administrator because, among other things, missing Windows features are activated.

Execution Policy

Um das Skript zu starten, muss die Execution Policy auf Unrestricted gesetzt seinTo run the script, the execution policy must be set to Unrestricted:

Set-ExecutionPolicy Unrestricted

Wenn Sie die Execution Policy nur temporär für die Installation anpassen möchten, kann diese wie folgt gesetzt werdenIf you want to adjust the execution policy only temporarily for the installation, it can be set as follows:

Set-ExecutionPolicy Unrestricted -Scope Process

Die folgende Frage muss mit y für The following question must be answered with y for "Yes" beantwortet werden:

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): y

Skript ausführen

...

Run script

The installation zip file must be unpacked beforehand.

In der Datei the "Install_Customization.ps1" können Anpassungen vorgenommen werden, falls es sich nicht um eine Standardinstallation handelt. Die entsprechenden Einstellungsmöglichkeiten sind in der Datei beschrieben.Beim Aufruf von file, adjustments can be made if it is not a standard installation. The corresponding setting options are described in the file.

When calling "Install.ps1" können Argumente mitgegeben werden. Diese sind in der Datei in einem grossen Kommentar beschrieben (unter , arguments can be given. These are described in the file in a large comment (in "Usages").

Standardaufruf (hierfür muss zuvor ins Installationsverzeichnis navigiert werden, z. B. mit Default call (for this you must first navigate to the installation directory, e.g. with cd "C:\temp\primedocs_Install_Package"):

.\Install.ps1 `
    -HostUrl "https://primedocs.local" `
    -DbConnectionString "Data Source=...;Initial Catalog=primedocs_Prod;User ID=...;Password=...;MultipleActiveResultSets=True" `
    -OperationDbConnectionString "Data Source=...;Initial Catalog=primedocs_Prod_Operation;User ID=...;Password=...;MultipleActiveResultSets=True"

Weitere Aufrufmöglichkeiten sind Further call options are described in "Install.ps1" unter in "Usages" beschrieben, so ze. B. die Angabe eines Service Accounts, falls kein SQL-Benutzer genutzt werden soll.Die beiden Datenbanken vom obigen Beispiel g. the specification of a service account, if no SQL user is to be used.

The two databases from the above example ("primedocs_Prod" und and "primedocs_Prod_Operation") können entweder als leere Datenbanken bereits existieren. Ansonsten werden sie automatisch durch die primedocs-Serverapplikationen angelegt (Bedingungen siehe SQL-Server-Rollen / -Berechtigungencan either already exist as empty databases. Otherwise they will be created automatically by the primedocs server applications (for conditions see SQL server roles / permissions).

Standardmässig fragt das Skript den Benutzer nach Informationen und Bestätigungen. Falls dies nicht gewünscht ist, kann als Argument -Force $true mitgegeben werden.

Skript-Ablauf

1. Benötigte Windows Features überprüfen

...

By default, the script asks the user for information and confirmations. If this is not desired, -Force $true can be supplied as an argument.

...

Script procedure

1. Check required Windows features

The first step is to verify that all required Windows features (including the Internet Information Service (IIS) mit with http://ASP.NET) installiert sind und ob das Hosting Bundle für are installed and that the hosting bundle for .NET 6 -Applikationen installiert istapplications is installed.

2. "primedocs" -Website im IIS

Im nächsten Schritt wird überprüft, ob bereits eine "primedocs"-Website mit den Application Pools im IIS registriert ist. Ist das der Fall, wird zum nächsten Schritt gegangen.

Falls die Website nicht gefunden wird, werden Sie gefragt, ob diese angelegt werden soll, mit der Angabe des Installationspfades und des Port. Die Standardeinstellungen werden in der Ausgabe angezeigt. Das Skript legt zudem folgende Application Pools im IIS anwebsite in IIS

The next step is to verify whether a "primedocs" website is already registered with its application pools in IIS. If this is the case, it will continue with the next step.

If the website is not found, you will be asked if it should be created, with the installation path and port specified. The default settings are displayed in the output. The script also creates the following application pools in IIS:

• primedocs-Managed:
  Ist für die Responsible for the .NET Framework-basierten Serverapplikationen zuständig.based server applications

• primedocs-Unmanaged-[...]:
  Für alle Serverapplikationen wird ein eigener Application Pool angelegt, wie z. B. For all server applications, a separate application pool is created, such as primedocs-Unmanaged-AddressService für den for the "AddressService" oder or primedocs-Unmanaged-HealthMonitor für den for the "HealthMonitor".

3. "primedocs" -WebapplikationenIn diesem Schritt werden die eigentlichen Webapplikationen in der web applications

In this step the actual web applications are put in the "primedocs" -Website hinterlegt. Falls die Anwendungen bereits installiert sind, werden Sie gefragt, ob eine Aktualisierung stattfinden soll. Im Fall einer Aktualisierung handelt es sich um ein Server-Update, weswegen wir die Kontaktaufnahme mit unserem Support empfehlenwebsite. If the applications are already installed, you will be asked if an update should take place. In case of an update, we recommend contacting our support.

4. "primedocs JobHost" -Scheduled Task

Im letzten Schritt erfolgt eine Abfrage, ob der "primedocs-JobHost" als "Scheduled Task" eingerichtet werden soll. Der primedocs-JobHost ist ein Konsolenprogramm, das z. B. Benutzerdaten im Hintergrund in einem bestimmten Intervall aktualisiert. Er sollte daher installiert werden.

Abschluss der Server-Installation

Nach der Installation sollten sowohl der IIS als auch die Webapplikationen und der Scheduled Task installiert seinscheduled task

In the last step you are asked, whether the "primedocs JobHost" should be set up as a "scheduled task". The primedocs JobHost is a console program that updates user data in the background at a certain interval, for example. Therefore, it should be installed.

Completing the server installation

After the installation, both the IIS and the web applications and the scheduled task should be installed.

Service Account

Die Standardinstallation geht von der Nutzung eines SQL-Benutzers aus. Es ist jedoch auch möglich, die primedocs-Serverapplikationen unter einem Service Account zu betreiben.

Stellen Sie hierfür folgende Konfiguration sicher:

...

Der Service Account kann sich mit dem SQL Server bzw. mit der zukünftigen Datenbank verbinden.

...

...

Service Account

The default installation assumes the use of an SQL user. However, it is also possible to run the primedocs server applications using a service account. For this, ensure the following configuration:

1. The service account can connect to the SQL Server or to the future database.

2. The service account is a member of the https://docs.microsoft.com/en-us/iis/get-started/planning-for-security/understanding-built-in-user-and-group-accounts-in-iis#understanding-the-new-iis_iusrs-group .
   This step is done automatically by the installation script if a security account is specified when calling it via arguments (see "Usages" in "Install.ps1" -Datei) und die entsprechende Abfrage bestätigt wird.Für die IIS_IUSRS-Gruppe muss in der Local Security Policy file) and the corresponding query is confirmed..

3. For the IIS_IUSRS group, Log on as batch und and Impersonate a client after authentication hinterlegt sein (dies entspricht einer Standard-IIS-Installation must be stored in the Local Security Policy (this corresponds to a standard IIS installation).
   Administrative Tools → Local Security Policy → Local Policies → User Rights Assignment

4. Der Service Account hat Ändern-Rechte auf dem primedocs-Applikations- und Logverzeichnis (in der Standardinstallation ist das derselbe Ordner).
   Dieser Schritt wird für das Applikationsverzeichnis vom Installationsskript automatisch erledigt, wenn beim Aufruf über die Argumente ein Security Account angegeben wird (siehe The service account has modification rights on the primedocs application and log directory (in the default installation this is the same folder).
   This step is automatically taken care of for the application directory by the installation script if a security account is specified when called via the arguments (see "Usages" in "Install.ps1" -Datei) und die entsprechende Abfrage für die Ändern-Rechte bestätigt wird.Der Service Account muss im IIS als Benutzer in allen primedocs-Application Pools hinterlegt werdenfile) and the corresponding prompt for change rights is confirmed.

5. The service account must be stored in IIS as a user in all primedocs application pools.
   IIS → Application Pools → Advanced Settings → Identity → Custom account
   Dieser Schritt wird vom Installationsskript automatisch erledigt, wenn beim Aufruf über die Argumente ein Security Account angegeben wird (siehe This step is done automatically by the installation script if a security account is specified when called via the arguments (see "Usages" in "Install.ps1" -Dateifile).Der Service Account muss als ausführender Benutzer im "PrimeDocs.JobHost"-Task hinterlegt werden

6. The service account must be stored as executing user in the "primedocs.JobHost" task.
   Task Scheduler → Task Scheduler Library → PrimeDocsprimedocs.JobHost → Properties
   Dieser Schritt wird vom Installationsskript automatisch erledigt, wenn beim Aufruf über die Argumente ein Security Account angegeben wird (siehe This step is done automatically by the installation script if a security account is specified in the call via the arguments (see "Usages" in "Install.ps1" -Dateifile).

7. Im The service account is used in SQL-ConnectionString wird der Service Account verwendet (bei der Installation als Argument übergeben oder (passed as argument during installation or customize it in "primedocs.config"-Datei anpassenfile)
   Dieser Schritt wird vom Installationsskript automatisch erledigt, wenn beim Aufruf über die Argumente der korrekte ConnectionString angegeben wird (siehe .
   This step is done automatically by the installation script if the correct ConnectionString is specified in the call via the arguments (see "Usages" in "Install.ps1" -Dateifile).