Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

width100%

...

width40%

...

bgColor#ECECEC

...


German

...

width60%

...

width40%

...

...

MSI installieren

German

MSI installieren


Section


Column
width40%

Image Added


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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




SmartNotesServerService.exe.config anpassen


Section


Column
width40%

Image Modified


Column
width60%

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. 



Section


Column
width40%

Image Modified


Column
width60%

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;




Section


Column
width40%

Image Modified


Column
width60%

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

Speichern Sie danach die Konfigurationsdatei.



Section


Column
width40%

Image Modified


Column
width60%

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.




SMO installieren


Section


Column
width40%

Image Modified


Column
width60%

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


Note

Die Dateien werden (leider ohne besondere Kennung) in 32 und 64 Bit angeboten. Wählen Sie bitte immer die größere Datei. 64 ist ja größer als 32 (wink) 

Es muss zuerst die SQLSysClrTypes.msi installiert werden, danach die SharedManagementObjects.msi.

Die SMO sind zwingend in der Version 2012 zu installieren und sind unabhängig von den SMO auf dem Datenbankserver






Section


Column
width40%

Image Modified


Column
width60%


Note
titleVersion < 2.8.1.195?

Sollten Sie eine ältere Version als die 2.8.1.195 installiert haben, so benötigen Sie noch die SMO2008.

Kontaktieren Sie uns bitte, falls Sie diese nicht vorliegen haben. 





Lizenz einspielen


Section


Column
width40%



Column
width60%

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).




ActiveDirectory Synchronisation


Section


Column
width40%

Image Modified


Column
width60%

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.

Note

Kerberos ist im Hosting (Cloud) nicht möglich und bezieht sich hier auf OnPremise Installationen.




Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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. 



Panel
titleActiveDirectory Synchronisation Client


Section


Column
width40%

Image Modified


Column
width60%

Client:

Es gibt keine spezielle Konfiguration für die Client-Konfigurationsdatei, also konfigurieren Sie den Client einfach so, wie es in den folgenden Kapiteln beschrieben wird.

Danach starten Sie den Client und melden sich mit dem Administrationskonto an. Klicken Sie direkt im Dialog "Verfügbare Dokumente", der auf den Anmeldedialog folgt, auf die Konfigurationsschaltfläche.



Section


Column
width40%

Image Modified


Column
width60%

Wählen Sie im Konfigurationsdialog die Registerkarte "Allgemeine Einstellungen" und klicken Sie auf die Schaltfläche [Systemeinstellungen öffnen].



Section


Column
width40%

Image Modified


Column
width60%

Fügen Sie im folgenden Dialog eine neue Konfigurationseigenschaft enableActiveDirectoryAuthentication mit dem Wert 1 hinzu:


Schließen Sie das Fenster, speichern Sie die Änderungen im Konfigurationsdialog und schließen Sie den Client.

Bitte starten Sie danach den SmartNotes-Dienst neu, um die Änderungen zu aktivieren.




Panel
titleActiveDirectory Searcher


Section


Column
width40%

Image Modified


Column
width60%

Seit SmartNotes Version 2.9 ist der Active Directory Searcher Teil des SmartNotes Servers. Mit dieser Anwendung können Sie den korrekten Zugriff auf Ihre AD Konfiguration testen.

Starten Sie dazu bitte die ActiveDirectorySearcher.exe im SmartNotes Server Verzeichnis. Im nun geöffneten Fenster können Sie Ihre AD Einstellungen eintragen. Dabei können Sie auch nur Teile des AD Trees eintragen, um eine größere Menge angezeigt zu bekommen. Sie erhalten dann alle AD Gruppen. Klicken Sie bitte doppelt auf eine Gruppe, um die User zu laden. Diese finden Sie dann im unteren Teil des Fensters. Sie finden Hier auch immer den vollständigen Tree, welchen Sie dann auch in der AD Konfiguration in SmartNotes eintragen können. 





SmartNotes-Serverdienst starten


Section


Column
width40%



Column
width60%

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.





Portfreigabe Firewall


Section


Column
width40%

Image Modified


Column
width60%

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

Note

Sollten Sie statt der Windows-Firewall eine Alternative nutzen, dann ist der Port entsprechend dort freizuschalten. Wenn Sie gar keine Firewall zwischen Client- und Serveranwendung nutzen, dann kann dieser Schritt übersprungen werden.





Optional - Parametrierung des MSI-Pakets


Section


Column
width40%

Image Modified


Column
width60%

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:



Section


Column
width40%

Image Modified


Column
width60%

Runtime configuration parameters:



Section


Column
width40%



Column
width60%

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\

...

Column
width33%

<< Zurück zu - Leere Datenbank mit Inhalt füllen --

Column
width34%

Zurück zur Übersicht - SmartNotes --

Column
width33%

Weiter mit -- Installation und Anpassung der Client-Anwendung >>

...

width60%

...

width100%

...

width40%
Panel
bgColor#ECECEC

<< Installation and Update SmartNotes

...

Column
width33%

<< Back to - Filling the empty database with content --

Column
width34%

Back to overview - SmartNotes --

...

width33%

...

"




English

install MSI


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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




Customise SmartNotesServerService.exe.config


Section


Column
width40%

Image Modified


Column
width60%

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. 



Section


Column
width40%

Image Modified


Column
width60%

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;




Section


Column
width40%

Image Modified


Column
width60%

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

Then save the configuration file.



Section


Column
width40%

Image Modified


Column
width60%

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.




Install SMO


Section


Column
width40%

Image Modified


Column
width60%

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


Note

The files are offered (unfortunately without special identification) in 32 and 64 bit. Please always choose the larger file. 64 is larger than 32  (wink) 

The SQLSysClrTypes.msi must be installed first, then the SharedManagementObjects.msi.

The SMOs must be installed in version 2012 and are independent of the SMOs on the database server.






Section


Column
width40%

Image Modified


Column
width60%


Note
titleVersion < 2.8.1.195?

If you have installed an older version than 2.8.1.195, you still need SMO2008.

Please contact us if you do not have this version. 





Import licence


Section


Column
width40%



Column
width60%

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).



Anchor
ActiveDirectory synchronisation
ActiveDirectory synchronisation

ActiveDirectory synchronisation


Section


Column
width40%

Image Modified


Column
width60%

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.

Note

Kerberos is not possible in hosting (cloud) and refers here to on-premise installations.




Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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. 



Panel
titleActiveDirectory Synchronisation Client


Section


Column
width40%

Image Modified


Column
width60%

Client:

There is no special configuration for the client configuration file, so simply configure the client as described in the following chapters.

Then start the client and log in with the administration account. Click the configuration button directly in the "Available documents" dialogue that follows the login dialogue.



Section


Column
width40%

Image Modified


Column
width60%

In the configuration dialogue, select the "General Settings" tab and click on the [Open System Settings] button.



Section


Column
width40%

Image Modified


Column
width60%

In the following dialogue, add a new configuration property enableActiveDirectoryAuthentication with the value 1:

Close the window, save the changes in the configuration dialogue and close the client.

Please restart the SmartNotes service afterwards to activate the changes.




Panel
titleActiveDirectory Searcher


Section


Column
width40%

Image Modified


Column
width60%

Since SmartNotes version 2.9 the Active Directory Searcher is part of the SmartNotes Server. With this application you can test the correct access to your AD configuration.

Please start the ActiveDirectorySearcher.exe in the SmartNotes Server directory. In the opened window you can enter your AD settings. You can also enter only parts of the AD tree to get a larger set displayed. You will then get all AD groups. Please double click on a group to load the users. You will find them in the lower part of the window. You will always find the complete tree here, which you can then also enter in the AD configuration in SmartNotes. 





Start SmartNotes server service


Section


Column
width40%



Column
width60%

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.





Port Enabling Firewall


Section


Column
width40%

Image Modified


Column
width60%

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.

Note

If you use an alternative instead of the Windows firewall, the port must be enabled there accordingly. If you do not use a firewall between client and server application, this step can be skipped.





Optional - Parameterisation of the MSI package


Section


Column
width40%

Image Modified


Column
width60%

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:



Section


Column
width40%

Image Modified


Column
width60%

Runtime configuration parameters:



Section


Column
width40%



Column
width60%

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\"

...