# Installation & Konfiguration



# Installation und Update

#### Installation

##### Setup herunterladen

<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">[AKTUELLE VERSION](https://dako-it.com/ghost/latest.php)</span></span>

<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">[TEST VERSION](https://dako-it.com/ghost/downloadTest/)</span></span>

<span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">[ÄLTERE VERSIONEN](https://dako-it.com/ghost/download/)</span></span>

##### Installationsschritte

Starten Sie die Installation mit der "SelectLine.ghost Setup xx.x.x.xxxxxx.exe". Der Ordner-Name wird für den Namen des "Dienstes" und der Bezeichnung des Browser-Tap übernommen.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 76.6667%; height: 504px;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-09/scaled-1680-/2R2image.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-09/2R2image.png)

</td></tr></tbody></table>

Aktivieren Sie den Punkt "Öffne SelectLine.ghost im Browser" und gehen auf "Fertigstellen".

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 76.9136%; height: 512px;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-09/scaled-1680-/9Erimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-09/9Erimage.png)

</td></tr></tbody></table>

Im geöffnetem Standard Browser können Sie mit der Anpassung der Einstellungen vom SelectLine.ghost beginnen.

#### Update

> Durch die Schnittstellen- Funktionen der SelectLine-API und der Shopify-API sowie die Wünsche der Anwender, wird die Anwendung ständig weiterentwickelt.  
> In der Fußzeile des Browser finden Sie die Version ihrer Installation. Die Version sollte immer der aktuell gültigen SelectLine Version entsprechen.
> 
> <table border="1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8681%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/puMimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/puMimage.png)
> 
> </td></tr></tbody></table>

Auf der Startseite des SelectLine.ghosts sehen Sie neben den News den Changelog und bekommen angezeigt, ob ein Update verfügbar ist.

Ab Version 23.1.6.240831  
Tastenkombination:  
strg + alt + u

Damit starten Sie ein Update vom Ghost. Dies wird vollständig automatisch im Hintergrund durchgeführt  
  
Bei älteren Versionen

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-09/scaled-1680-/sjcimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-09/sjcimage.png)

</td></tr></tbody></table>

Nach dem Herunterladen des Setups führen Sie die gleichen Schritte wir bei der Installation durch. Beachten Sie dabei, den selben Ordner für das Installationsverzeichnis zu wählen:

<table border="1" id="bkmrk--3" style="border-collapse: collapse; width: 47.7778%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-01/scaled-1680-/5YBimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-01/5YBimage.png)</td></tr></tbody></table>

Diesen Dialog können Sie bestätigen.  
  
Nach Abschluss des Updates prüfen Sie bitte, ob sich der Ghost über den Browser starten lässt. Ist dies erfolgreich, ist das Update abgeschlossen.

# SelectLine - Einstellungen

### Start der SelectLine-Einstellungen

Nach einer erfolgreichen Installation haben Sie mit dem Link über den Browser das Back End des FINN.ghost|Dienst aufgerufen.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/W8timage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/W8timage.png)

</td></tr></tbody></table>

**Über das Menü wechseln Sie auf SelectLine -&gt; Einstellungen**

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/Sx1image.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/Sx1image.png)

</td></tr></tbody></table>

  
Hier werden alle Anpassungen zur Integration in ihre Datenstruktur vorgenommen. Der Zugriff auf ihre Daten wird über die SL API (Bestandteil von SL Mobile) und die SL SQL Datenbank hergestellt.

### Konfigurationsbereiche

#### Datenbank

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/BcRimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/BcRimage.png)</td></tr></tbody></table>

An dieser Stelle wird die Verbindung zu der MS-SQL Datenbank der SelectLine hergestellt.

<table border="1" id="bkmrk-name-name-der-sql-da" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**Name**</td><td>Name der SQL Datenbank des gewünschten SL Mandant (Beispiel: SL\_MMandant)</td></tr><tr><td>**Host**</td><td>SQL Server Instanz  
(Beispiel: srv\_ghost\\sqlexpress)</td></tr><tr><td>**Nutzer &amp; Passwort**</td><td>An dieser Stelle wird ein Benutzer der SQL-Servers benötigt, der entsprechende Rechte auf die Tabellen der Datenbank besitzt. (Beispiel: sa)</td></tr></tbody></table>





#### API

<table border="1" id="bkmrk--5" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/2Q3image.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/2Q3image.png)</td></tr></tbody></table>

Hier erfolgt die Verbindung zu der SelectLine-API.

<table border="1" id="bkmrk-url-url-zum-aufruf-d" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**URL**</td><td>URL zum Aufruf der API. Nehmen Sie die URL zum SL-Mobile und ändern "slmobile" zu "slmobileApi". (Beispiel: https://localhost/slmobileApi)</td></tr><tr><td>**AppKey**</td><td>tragen Sie den AppKey "SelectLine.ghost" ein *(nicht erforderlich bei der SelectLine Shopify Anbindung).  
Diesen haben Sie beim Erwerb der API Schnittstelle von SelectLine vorab angegeben.  
Die kann auch in SelectLine unter Hilfe -&gt; Lizenzierung -&gt; AppKeys eingesehen werden.  
Sind hier Abweichungen, muss der aus Key aus SelectLine in den Ghost übernommenen werden.*</td></tr><tr><td>**Nutzer &amp; Passwort**</td><td>tragen Sie hier den in der SL-API-Konfiguration (SL Mobile) konfigurierten API-Benutzer ein</td></tr></tbody></table>



#### Lizenz

<table border="1" id="bkmrk--8" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/qnHimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/qnHimage.png)

</td></tr></tbody></table>

<span style="color: rgb(0, 0, 0);">Die Lizenz wird vom Fachhändler oder Dako-IT bereitgestellt. Sie steuert, welche Module des SelectLine.ghosts freigeschalten werden.</span>



#### FINN.ghost

<table border="1" id="bkmrk--10" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/8puimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/8puimage.png)

</td></tr></tbody></table>

<table border="1" id="bkmrk-lizenz%3A-wird-vom-fac" style="border-collapse: collapse; width: 100%; height: 309.344px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Port**</td><td style="height: 29.7969px;">Über diesen Port ist die Oberfläche des SelectLine.ghots aufzurufen. Planen Sie mehrere Ghosts zu betrieben, empfiehlt es sich, diesen Port anzupassen.</td></tr><tr style="height: 96.9844px;"><td style="height: 96.9844px;">**Bildformat**</td><td style="height: 96.9844px;"><span style="color: rgb(186, 55, 42);"><span style="color: rgb(0, 0, 0);">Hier legen Sie fest, in welchem Bildformat die Bilder aus der SelectLine an das angeschlossene Shopsystem übertragen werden. Dabei spielt es keine Rolle, in welchem Format die Bilder in SL gespeichert sind.  
Sie können aktuell zwischen png, jpg, webp und original wählen.</span></span></td></tr><tr style="height: 63.375px;"><td style="height: 63.375px;">**Nutzeranmeldung**</td><td style="height: 63.375px;"><span style="color: rgb(186, 55, 42);"><span style="color: rgb(0, 0, 0);">Bei Aktivierung ist eine Benutzeranmeldung erforderlich.  
Die Login Daten entsprechen den API Benutzern aus SL-Mobile.</span>  
</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**EU-Auslands-Kontogruppen (OSS-Verfahren)**</td><td style="height: 29.7969px;">An dieser Stelle kann das OSS-Verfahren konfiguriert werden. Sie können für jedes Land festlegen, welche Kontengruppe bei dem Import von Bestellungen für den Kunden verwendet werden soll. Hierbei wird das Land der Lieferadresse berücksichtigt.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Zertifikat**</td><td style="height: 29.7969px;">Damit das Zertifikat im Browser als sicher angezeigt wird, muss dieses Installiert werden. Siehe hierzu: [Zertifikat einrichten](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/zertifikat-einrichten)</td></tr></tbody></table>




#### E-Mail

<table border="1" id="bkmrk--14" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/D3Eimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/D3Eimage.png)</td></tr></tbody></table>

Die Konfiguration für den E-Mail Versand (SMTP) ist optional. Die E-Mail-Funktion dient dem Versand von Log Informationen.

<table border="1" id="bkmrk-host-smtp-server-por" style="border-collapse: collapse; width: 100%; height: 327.766px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Host**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">SMTP Server</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Port**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Port des Protokolls</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Verschlüsselte Verbindung**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">aktiviert Verschlüsselung</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Microsoft365**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">aktiviert die Verwendung eines Microsoft365 Account</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Nutzer**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Benutzername</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Passwort**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Kennwort</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Absender**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Absender Mail Adresse</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Absender Name**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Absender Anzeigename</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Empfänger**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Ziel Mailadresse</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Betreff**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Individueller Mail Betreff</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Intervall**</td><td style="height: 29.7969px;"><span style="color: rgb(0, 0, 0);">Zeit Intervall zum versenden von Mails (in Minuten)</span></td></tr></tbody></table>




### Weitere Module

Je nach erworbener Lizenz, werden weitere Module als Menü eingeblendet.

<table border="1" id="bkmrk--20" style="border-collapse: collapse; width: 39.6296%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/PEjimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/PEjimage.png)

</td></tr></tbody></table>

# Zertifikat einrichten

Das der Browser beim Zugriff auf den Ghost eine sichere Verbindung erkennt, muss ein Zertifikat eingerichtet werden.  
Dazu sind zwei Schritte erforderlich.  
  
**Voraussetzung:**  
Im Link zum Ghost muss der PC Name und nicht die IP enthalten sein.  
https://ihrghostserver:8084

##### **1. Zertifikat auf in der Ghost Installation hinterlegen**

SelecLine -&gt; Einstellung -&gt; FINN.ghost

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/dphimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/dphimage.png)

</td></tr></tbody></table>

Mit dem Button "ZERTIFIKAT DOWNLOAD" bitte die Datei cert.zip runterladen und entpacken.  
  
Die beiden Dateien (server.cert, server,key) in das folgende Verzeichnis ihrer Ghost-Installation verschieben.

C:\\DAKO\\FINN.ghost\\data\\ssl

Die Dateien im Ordner "ssl" können Sie überschreiben. Danach bitte unter "Dienste" den Ghost Dienst neu starten.

##### **2. Zertifikat am Client PC installieren**

Dazu laden Sie sich dieses mit dem Button "ROOT ZERTIFIKAT DOWNLOAD" herunter und installieren es, je nach verwendetem Browser. Die Schritte zur Einrichtung weichen je nach verwendetem Browser ab.

##### Firefox  


Firefox verwaltet die Zertifikate in den eigenen Einstellungen unter

[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/vFPimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/vFPimage.png)

Hier "Importieren" Sie bitte die heruntergeladenen Datei "RootCA.crt"

[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/q2pimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/q2pimage.png)

#####   
Chrome und andere  
  
Verwaltung über das Betriebssystem Windows.

Installieren Sie das Zertifikat mit einem Doppelklick auf die Datei "RootCA.crt".

[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-08/scaled-1680-/gaCimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-08/gaCimage.png)

in diesem Dialog wählen Sie bitte das aus und bestätigen alle weiteren Dialoge

<table border="1" id="bkmrk--7" style="border-collapse: collapse; width: 79.8765%; height: 310px;"><colgroup><col style="width: 50.0014%;"></col><col style="width: 50.0014%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-10/scaled-1680-/image.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-10/image.png)

</td><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-10/scaled-1680-/dsoimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-10/dsoimage.png)

</td></tr></tbody></table>

# Zertifikat erstellen (optional)

#### Root-Zertifikat erstellen

```bash
openssl req -x509 -nodes -new -sha256 -days 10000 -newkey rsa:2048 -keyout RootCA.key -out RootCA.pem -subj "/C=DE/CN=DAKO-Root-CA"
openssl x509 -outform pem -in RootCA.pem -out RootCA.crt
```

Das RootCA.crt muss dann am Rechner installiert werden werden. Siehe: [Zertifikat einrichten](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/zertifikat-einrichten)

#### Server-Zertifikat ausstellen

```bash
openssl req -new -nodes -newkey rsa:2048 -keyout server.key -out server.csr -subj "/C=DE/ST=Brandenburg/L=Spremberg/O=DAKO-IT/CN=XXXXXDOMAINNAMEXXXXX"
openssl x509 -req -sha256 -days 7000 -in server.csr -CA RootCA.pem -CAkey RootCA.key -CAcreateserial -extfile domains.ext -out server.cert
```

server.key und server.pem müssen im Ghost hinterlegt werden. Siehe: [Zertifikat einrichten](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/zertifikat-einrichten)

# Makros

In den Ghost Modulen finden Sie den Punkt Makro. Hier können in SL erstellte Makros eingetragen werden, um Daten selektiert vor bzw. nach der Übertragung zu bearbeiten.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-10/scaled-1680-/TlCimage.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-10/TlCimage.png)

</td></tr></tbody></table>

Tragen Sie im entsprechendem Feld den Dateinamen (nicht die Bezeichnung) den SL automatisch vergibt ein.

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://wiki.dako-it.com/uploads/images/gallery/2023-10/scaled-1680-/sp9image.png)](https://wiki.dako-it.com/uploads/images/gallery/2023-10/sp9image.png)

</td></tr></tbody></table>

Wenn Sie den Kurser im Feld haben, werden ihnen die erforderlichen "Parameter" des Makros angezeigt. Diese müssen gleichlautend vorhanden sein.