Erste Schritte: Installationsvoraussetzungen

• Bevor Sie beginnen, stellen Sie sicher, dass Microsoft SQL Server Management Studio bereits auf dem Computer installiert ist, auf dem Sie das PLC-CFX Gateway installieren und die Gateway-Datenbank erstellen werden.
  
  

  Hinweis:

  Einzelheiten zu Microsoft SQL Server Management Studio (SSMS) finden Sie unter diesem Link: https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver16.

Die Installationsdateien des Gateways auf den Zielcomputer kopieren

1. Erstellen Sie auf dem Gateway-Zielcomputer den folgenden Ordner:
   
   C:\Program Files (x86)\Aegis\PLCGateway\
   
   
2. Kopieren Sie den Inhalt des Ordners "PLC-CFX Gateway Installation" in den Ordner "PLCGateway" auf dem Zielcomputer.

Installation des .NET 6-Hosting-Pakets

• Laden Sie das .NET 6-Hostingpaket herunter und installieren Sie es. Es enthält die .NET-Laufzeit und IIS-Unterstützung und befindet sich hier (unter der Überschrift ASP.NET Core Runtime 6.0.xx):
  
  https://dotnet.microsoft.com/en-us/download/dotnet/6.0.

Erstellung und Konfiguration der SQL-Datenbank

1. Öffnen Sie Microsoft SQL Server Management Studio (SSMS). 

2. Erstellen Sie eine neue SQL-Datenbank und geben Sie ihr einen Namen, zum Beispiel PLC-CFX Gateway.
3. Erstellen Sie einen neuen Benutzer namens AegisSQL.

Erstellen von ASP.NET-Core-Diensten

1. Starten Sie Windows PowerShell ISE (wählen Sie Als Administrator ausführen). 
   
   

   Hinweis:

   Weitere Informationen über Windows Powershell ISE finden Sie unter https://learn.microsoft.com/en-us/powershell/.

2. Bearbeiten Sie das folgende Skript, indem Sie die entsprechenden Details für die folgende Linie eingeben: $userName = "[ComputerNameOderDomain]\[UserName]"
   
   

   • Wichtig

     Jede nummerierte Zeile im folgenden Skript sollte als einzelne Codezeile eingegeben werden.

   
   

   1 $exeFolder = "C:\Program Files (x86)\Aegis\PLCGateway\" 2 $exePath = "C:\Program Files (x86)\Aegis\PLCGateway\Aegis.CFX.Gateway.Web.Server.exe" 3 $Benutzername = "[ComputerNameOderDomain]\[Benutzername]" 4 $serviceName = "Aegis PLC Gateway Dienst" 5 $serviceDesc = "IIoT-Dienst zur Verbindung von SPSen mit CFX-fähigen Systemen" 6 $acl = Get-Acl $exeFolder 7 $aclRuleArgs = $Benutzername, "Lesen,Schreiben,LesenUndAusführen", "Keine", "Zulassen" 8 $accessRule = New-Object System.Security.AccessControl.FileSystemAccessRule($aclRuleArgs) 9 $acl.SetAccessRule($accessRule) 10 $acl | Set-Acl $exeFolder 11 New-Service -Name $serviceName -BinaryPathName ($exePath + " --contentRoot " + $exePath) -Credential $userName -Description $serviceDesc -DisplayName $serviceName -StartupType Automatisch

   
   
   

3. Speichern Sie Ihre Änderungen.

4. Führen Sie das Powershell-Skript aus und der Aegis PLC Gateway Service wird erstellt.
   
   

   Hinweis:

   Wenn Sie eine Fehlermeldung sehen, die besagt, dass die Skripte nicht ausgeführt werden können, verwenden Sie den Befehl Set-ExecutionPolicy, um die Richtlinie so anzupassen, dass Skripte zugelassen werden, zum Beispiel:
   
   Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

Erstellung der Datenbankkonfiguration

1. Laden Sie das Hosting-Bundle der neuesten Version von .NET 6 ASP.NET Core Runtime herunter und installieren Sie es.
2. Erstellen Sie ein neues lokales oder Domänen-Benutzerkonto mit lokalen Administratorrechten auf dem Zielrechner (oder verwenden Sie ein vorhandenes FactoryLogix-Dienstkonto).
3. Erstellen Sie den Dienst ‘CreateASPNETCoreServices’.
4. Klicken Sie mit der rechten Maustaste auf PLCGateway\AegisCFXGateway.pfx und wählen Sie dann Install PFX. 
5. Wählen Sie Lokaler Rechner.
6. Wählen Sie Kennwort GatewayAdmin123* verwenden.
7. Wählen Sie "Place Certificate in the Following Store...", wählen Sie "Trusted Root Certification Authorities", und beenden Sie den Assistenten.
8. Bearbeiten Sie die Datei appsetttings.json im PLCGateway-Ordner (siehe das folgende Thema).
9. Legen Sie die Datenbankverbindungszeichenfolge und die PLCCFXGateway-Serverdetails fest.
10. Gehen Sie zu services.msc, um das Fenster Dienste zu öffnen.
11. Klicken Sie mit der rechten Maustaste auf den Aegis PLC Gateway Service und wählen Sie Start, um den Dienst zu starten.
12. Öffnen Sie einen Browser und navigieren Sie zu https://localhost:5251.
13. Melden Sie sich mit den folgenden Anmeldedaten an:
    
    ID: admin
    Kennwort: GatewayAdmin123*

Konfiguration der Datei appsetting.json

1. Öffnen Sie die Datei appsettings.json, die sich im Installationsordner des PLC-CFX Gateway befindet.

2. Ersetzen Sie die fettgedruckten Elemente in eckigen Klammern [ ] wie unten gezeigt:
   
   

   {   /* Die folgenden Identitätseinstellungen müssen konfiguriert werden bevor das Projekt erfolgreich ausgeführt werden kann. Für weitere Informationen siehe https://aka.ms/dotnet-template-ms-identity-platform */   "IdentityServer": {     "Key": {       "Typ": "Datei",       "FilePath": "AegisCFXGateway.pfx",       "Kennwort": "GatewayAdmin123*"     },     "Clients": {       "Aegis.CFX.Gateway.Web.Client": {         "Profil": "IdentityServerSPA"       }     }   },   "ConnectionStrings": {     "DefaultConnection": "Server=[DB Server];Database=[DB Name];MultipleActiveResultSets=True;User Id=[Username];Password=[Password];",   },   "Logging": {     "LogLevel": {       "Default": "Trace",       "Microsoft": "Warning",       "Microsoft.Hosting.Lifetime": "Information"     }   },   "AllowedHosts": "*",   "Kestrel": {     "Endpunkte": {       "Http": {         "Url": "http://[PLCCFXGatewayServer]:5250"       },       "HttpsInlineCertFile": {         "Url": "https://[PLCCFXGatewayServer]:5251",         "Zertifikat": {           "Pfad": "AegisCFXGateway.pfx",           "Kennwort": "GatewayAdmin123*"         }       },     }   },   "PagingData": {     "PageSize": 25   } }

   
   
   

3. Speichern Sie Ihre Änderungen.