Page Comparison

Aus dem Installationspaket installieren Sie nun die Serveranwendung mit Hilfe der MSI-Datei.

Der Pfad für das vorgeschlagene Installationsverzeichnis kann bei Bedarf geändert werden. 

Die Bestätigung der Installation können Sie mit "Finish" beenden.

Im nächsten Schritt muss die Konfigurationsdatei angepasst werden, da diese nur mit Standardwerten geliefert wird.  Öffnen Sie dazu die SmartNotesServerService.exe.config im Installationsverzeichnis der Anwendung mit einem Editor Ihrer Wahl. 

In dieser Konfigurationsdatei müssen zwei Stellen angepasst werden;

• <ConnectionStrings></ConnectionStrings>
  • Data Source: IP des SQL Servers, muss ggf. mit Instanzname angegeben werden
  • Initial Catalog: Datenbankname

Wenn die Datenbankberechtigungen über einen SQL-Benutzer realisiert wurden (siehe Kapitel Berechtigung für die Datenbank festlegen, Punkt 2), dann muss das entsprechend in der Konfiguration berücksichtigt werden.  Diese muss im ConnectionStrings-Abschnitt wie folgt geändert werden:

• Integrated Security=SSPI;
  • Dieser Eintrag muss entfernt werden und durch folgende ersetzt werden:
    • User Id = YourUserName ;Password = YourPassword;

Passen Sie nun noch im Bereich <appSettings> die Serveradress und ggf. den ServerPort an.

Speichern Sie danach die Konfigurationsdatei.

Wenn die Datenbankberechtigungen über einen AD-Benutzer realisiert wurden (siehe Berechtigung für die Datenbank festlegen), dann muss dieser noch im SmartNotes-Dienst hinterlegt werden. Öffnen Sie dazu die Windows-Dienste und suchen Sie den Dienst SmartNotesServer. Diesen klicken Sie mit rechter Maustaste an und wählen Eigenschaften. Danach auf den Tab Anmelden.

Dort geben Sie den AD-Benutzer mit dem zugehörigen Passwort an und schließen den Dialog mit OK.

Bevor der SmartNotes-Dienst gestartet wird, muss noch zusätzliche Software heruntergeladen und installiert werden. Dabei handelt es sich um die Microsoft SQL Server 2012 Shared Management Objects x64 und die CLR-Objekte der Version 2012 entsprechen (Version11.0.0.0).

Link zum Herunterladen: 

https://www.microsoft.com/en-us/download/details.aspx?id=56041

• SharedManagementObjects.msi
• SQLSysClrTypes.msi

Im nächsten Schritt muss die Lizenz eingespielt werden.  Folgen Sie der Anleitung Lizenzdatei einspielen. (Wenn Sie die Taste <strg> beim Aufruf gedrückt halten, dann öffnet sich die Seite in einem neuen Fenster).

Um die ActiveDirectory-Synchronisation in SmartNotes zu aktivieren, müssen die folgenden Einstellungen konfiguriert werden:

In der Konfigurationsdatei SmartNotesServerService.exe.Config -> aktivieren (unkommentiert) Sie die Sektion "ActiveDirectoryConnectionSettings" an zwei Stellen: in der Deklarationssektion <configSections>, und in der Sektion "ActiveDirectoryConnectionSettings" am Ende der Datei.

Mehrere ActiveDirectory-Einträge können im Abschnitt "ActiveDirectoryConnectionSettings" konfiguriert werden. SmartNotes kann aus diesen Einträgen Informationen über AD-Gruppen und Benutzer abfragen.

In der Regel reicht ein Konfigurationseintrag aus.  Mehr wird nur im Falle einer AD-Forest-Konfiguration benötigt. Ein Konfigurationseintrag enthält die folgenden Attribute:

• Entry - ActiveDirectory Organization Unit-Eintrag, bei dem die Gruppen und Benutzer von SmartNotes abgefragt werden können
  UserName - Teil der Benutzerdaten für den Fall, dass die Kommunikation mit ActiveDirectory mit Identitätswechsel erfolgt. Dies ist ein seltener Fall. Wenn sich Ihr Server in der Domäne befindet, lassen Sie die Anmeldedaten leer.
  Password - Teil der Passwort-Zugangsdaten. Das Passwort sollte verschlüsselt werden. Bitte rufen Sie das SmartNotes.PasswordEncrypter-Tool aus dem gleichen Ordner mit Ihrem Passwort anstelle von mypassword SmartNotes.PasswordEncrypter -p:mypassword auf.

Domain-Controller - Über den Eintrag Controller="" LdapConnection="True" können Domains angesprochen werden, die außerhalb der Domain des SmartNotes Servers liegen. Fügen Sie dazu bitte den entsprechenden Domain Controller im Eintrag Controller="" ein. Beachten Sie bitte, dass hier auch ein Username und Passwort gepflegt werden muss. 

Nach Abschluss der ersten fünf Schritte können Sie den SmartNotes Dienst starten, falls Sie dies beim Einspielen der Lizenz noch nicht getan haben. Rufen Sie dazu bitte im Installationsverzeichnis die SmartNotesServer.exe auf. Drücken Sie auf Start Service.

Damit sichdie Client-Anwendung auch auf den Server verbinden kann, muss der verwendete Port in der Windows-Firewall auf dem Anwendungsserver freigeschaltet werden.

Neben dem Standardsatz von MSI-Installationsparametern (die von Microsoft zur Verfügung gestellt werden und hier eingesehen werden können) bietet "SmartNotesServerSetup" einen zusätzlichen Satz von Parametern, die es ermöglichen, die Installation an Ihre Bedürfnisse anzupassen. Die folgende Tabelle listet zusätzliche Parameter auf, die verfügbar sind:

Runtime configuration parameters:

Beispiele:

Durchführen einer SmartNotesServer-Installation unter der IP-Adresse 10.1.1.10:6666 mit aktiviertem SSO:

SmartNotesServerSetup.msi ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True"

Durchführen einer stillen SmartNotesServer-Installation auf der IP-Adresse 10.1.1.10:6666 mit aktiviertem SSO, Datenquelle, Datenbank und MSSQL-Sicherheitssatz:

SmartNotesServerSetup.msi /q ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True" Datasource=".\SQLEXPRESS" INITIALCATALOG="smartnotes" USERID="DBUser" USERPASSWORD="sn"ENCRYPTCONNECTIONSTRING="True"

Durchführen einer stillen SmartNotesServer-Installation auf IP-Adresse 10.1.1.10:6666 mit aktiviertem SSO, Datenquelle, Datenbank und MSSQL-Sicherheitssatz, benutzerdefinierten Import- und Lizenzschlüssel-Ordnern und Erstellen eines Installationsprotokolls:

SmartNotesServerSetup.msi /l* snInstallation.log /q ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True" Datasource=".\SQLEXPRESS" INITIALCATALOG="smartnotes" USERID="DBUser"USERPASSWORD="sn" ENCRYPTCONNECTIONSTRING="True" IMPORTASSEMBLYFOLDER="c:\sn\snImport\" LICENSEKEYFOLDER="c:\sn\snKey\"

From the installation package, now install the server application using the MSI file.

The path for the suggested installation directory can be changed if necessary. 

You can finish the confirmation of the installation with "Finish".

In the next step, the configuration file must be adapted, as it is only supplied with default values.  To do this, open the SmartNotesServerService.exe.config in the installation directory of the application with an editor of your choice. 

Two places in this configuration file need to be adjusted:

• <ConnectionStrings></ConnectionStrings>
  • Data Source: IP of the SQL server, must be specified with instance name if necessary.
  • Initial Catalog: Database name

If the database authorisations have been realised via an SQL user (see chapter Defining authorisation for the database, point 2), then this must be taken into account accordingly in the configuration.  This must be changed in the ConnectionStrings section as follows:

• Integrated Security=SSPI;
  • This entry must be removed and replaced with the following:
    • User Id = YourUserName ;Password = YourPassword;

Now adjust the server address and, if necessary, the server port in the <appSettings> area.

Then save the configuration file.

There you enter the AD user with the corresponding password and close the dialogue with OK.

If the database authorisations have been realised via an AD user (see Set authorisation for the database), then this must still be stored in the SmartNotes service. To do this, open the Windows services and find the SmartNotesServer service. Click on it with the right mouse button and select Properties. Then click on the Log On tab.

Enter the AD user with the corresponding password and close the dialogue with OK.

Before the SmartNotes service is started, additional software must be downloaded and installed. This is the Microsoft SQL Server 2012 Shared Management Objects x64 and the CLR objects corresponding to the 2012 version (version11.0.0.0).

Link to download: 

https://www.microsoft.com/en-us/download/details.aspx?id=56041

• SharedManagementObjects.msi
• SQLSysClrTypes.msi

The next step is to import the licence.  Follow the instructions for importing the licence file. (If you hold down the <strg> key when calling up the page, it opens in a new window).

To enable ActiveDirectory synchronization in SmartNotes, the following settings must be configured:

In the configuration file SmartNotesServerService.exe.Config -> activate (uncommented) the section "ActiveDirectoryConnectionSettings" in two places: in the declaration section <configSections>, and in the section "ActiveDirectoryConnectionSettings" at the end of the file.

Multiple ActiveDirectory entries can be configured in the ActiveDirectoryConnectionSettings section. SmartNotes can retrieve information about AD groups and users from these entries.

Usually one configuration entry is sufficient.  More is only needed in case of an AD-Forest configuration. A configuration entry contains the following attributes:

• Entry - ActiveDirectory Organisation Unit entry where the groups and users can be queried by SmartNotes.
  UserName - part of the user data in case the communication with ActiveDirectory is done with identity change. This is a rare case. If your server is in the domain, leave the credentials blank.
  Password - Part of the password credentials. The password should be encrypted. Please call the SmartNotes.PasswordEncrypter tool from the same folder with your password instead of mypassword SmartNotes.PasswordEncrypter -p:mypassword.

Domain controller - Via the entry Controller="" LdapConnection="True" you can access domains that are outside the domain of the SmartNotes server. For this purpose, please add the corresponding domain controller in the entry Controller="". Please note that a username and password must also be maintained here. 

After completing the first five steps, you can start the SmartNotes service if you have not already done so when installing the licence. To do this, please call up SmartNotesServer.exe in the installation directory. Press Start Service.

In order for the client application to also connect to the server, the port used must be enabled in the Windows firewall on the application server.

In addition to the standard set of MSI installation parameters (which are provided by Microsoft and can be viewed here), "SmartNotesServerSetup" provides an additional set of parameters that allow you to customise the installation to your needs. The following table lists additional parameters that are available:

Runtime configuration parameters:

Beispiele:

Performing a SmartNotesServer installation at the IP address 10.1.1.10:6666 with activates SSO:

SmartNotesServerSetup.msi ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True"

Perform a silent SmartNotesServer installation on IP address 10.1.1.10:6666 with SSO, data source, database and MSSQL security set enabled:

SmartNotesServerSetup.msi /q ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True" Datasource=".\SQLEXPRESS" INITIALCATALOG="smartnotes" USERID="DBUser" USERPASSWORD="sn"ENCRYPTCONNECTIONSTRING="True"

Perform a silent SmartNotesServer installation on IP address 10.1.1.10:6666 with SSO enabled, data source, database and MSSQL security set, custom import and licence key folders and create an installation log:

SmartNotesServerSetup.msi /l* snInstallation.log /q ServerAddress="10.1.1.10" ServerPort="6666" useSingleSignOn="True" Datasource=".\SQLEXPRESS" INITIALCATALOG="smartnotes" USERID="DBUser"USERPASSWORD="sn" ENCRYPTCONNECTIONSTRING="True" IMPORTASSEMBLYFOLDER="c:\sn\snImport\" LICENSEKEYFOLDER="c:\sn\snKey\"