Stap 2: Gateway-installatie & configuratie
Nu uw gateway en apparaten in de SEW OrchestrationSuite zijn geconfigureerd, bestaat de volgende fase uit het installeren van de SDA Glue-service op de door u gekozen gatewayhardware. Dit installatieproces verschilt tussen Linux- en Windows-systemen, maar beide benaderingen volgen hetzelfde fundamentele principe: het downloaden en configureren van een service die continu op de achtergrond draait en klaar is om op verzoek beveiligde tunnels op te zetten.
Installatie
Het installatieproces bestaat uit twee hoofdfasen:
- Installeer SDA Glue en de afhankelijkheden op het doelsysteem.
- Configureer de service met unieke inloggegevens uit de SEW OrchestrationSuite, die een specifieke gateway authenticeren.
Zorg er voordat u met de installatie begint voor dat u beheerdersrechten hebt op uw doelsysteem. Het installatieproces vereist verhoogde rechten om de systeemservice te installeren. Voor Linux hebt u sudo-toegang nodig. Voor Windows moet u PowerShell als administrator uitvoeren.
Het installatieproces kan omgaan met proxyomgevingen, maar vereist aanvullende configuratiestappen die we in elke platformspecifieke sectie zullen toelichten.
Linux
Om SDA Glue te installeren op een Linux-systeem met directe internettoegang, voert u het volgende commando uit in een terminal:
curl -sSL 'https://api.eu1.sdaconsole.io/glue/v1/install.sh' | bash -
Dit commando gebruikt curl om het installatiescript veilig rechtstreeks op te halen van het API-endpoint van SEW en stuurt het via een pipe naar bash voor onmiddellijke uitvoering. De -sSL-vlaggen zorgen ervoor dat de overdracht stil verloopt, fouten worden getoond wanneer deze optreden en eventuele redirects veilig worden gevolgd.
Details over het Linux-installatieproces
De Linux-installatie maakt gebruik van een geautomatiseerd shellscript dat het complexe proces van het bouwen en configureren van de SDA Glue-service afhandelt. Dit script voert verschillende cruciale taken uit: het installeert de benodigde runtime-afhankelijkheden en buildtools, downloadt en compileert de SoftEther VPN Client uit de beveiligde repository van SEW en installeert SDA Glue als een systemd-service die automatisch met uw systeem wordt gestart.
De compilatiebenadering zorgt voor compatibiliteit met verschillende Linux-distributies en behoudt tegelijkertijd de veiligheid doordat er vanaf geverifieerde broncode wordt gebouwd. De systemd-service-integratie betekent dat uw gateway automatisch opnieuw start wanneer er problemen optreden en dat deze direct begint te werken zodra uw systeem opstart.
Als u het installatiescript liever bekijkt voordat u het uitvoert, kunt u het afzonderlijk ophalen door het gedeelte | bash - uit het commando te verwijderen of door https://api.eu1.sdaconsole.io/glue/v1/install.sh rechtstreeks in uw webbrowser te openen. Deze transparantie stelt u in staat om precies te begrijpen wat het installatieproces op uw systeem zal uitvoeren.
Linux met proxy
Wanneer uw Linux-systeem internettoegang nodig heeft via een proxyserver, moet u de juiste omgevingsvariabelen configureren voordat u het installatiescript uitvoert. Stel de omgevingsvariabelen http_proxy en https_proxy in binnen uw huidige bash-sessie:
export http_proxy=http://username:password@proxy.company.com:8080
export https_proxy=http://username:password@proxy.company.com:8080
curl -sSL 'https://api.eu1.sdaconsole.io/glue/v1/install.sh' | bash -
Vervang de proxy-URL door de gegevens van uw daadwerkelijke proxyserver, inclusief authenticatiegegevens indien uw netwerkconfiguratie dit vereist.
Docker
Docker biedt een alternatieve implementatiemethode die consistentie biedt op verschillende hostsystemen en vereenvoudigd beheer via containerisatie. De SDA Glue Docker-image is gebaseerd op Debian en bevat alle noodzakelijke afhankelijkheden vooraf geconfigureerd, waardoor handmatige compilatie of beheer van afhankelijkheden niet nodig is.
Om SDA Glue via Docker te implementeren, voert u het volgende commando uit met de vereiste netwerkrechten:
docker run -d \
--name glue \
--device=/dev/net/tun \
--cap-add=NET_ADMIN \
-v glue-data:/var/lib/sdaglue \
--restart always \
-p 8081:8080 \
public.ecr.aws/t9c5s2d1/sdaglue:latest
Dit commando maakt een persistente container met de naam "glue" die automatisch opnieuw start wanneer deze onverwacht stopt. De volume-mount behoudt de configuratie- en authenticatiegegevens van uw gateway tussen herstarts of updates van de container.
Het stuurt bovendien containerpoort 8080 door naar hostpoort 8081, waarop de Glue-webserver draait voor het instellen van de applicatie. U kunt deze vervolgens benaderen via http://localhost:8081/.
Wanneer u meerdere SDA Glue-containers op dezelfde host uitvoert, zorg er dan voor dat elke container unieke namen en volume-mounts gebruikt om conflicten te voorkomen:
docker run -d --name glue-factory -v factory-data:/var/lib/sdaglue [...]
Voor uitgebreide richtlijnen voor Docker-implementatie, inclusief geavanceerde netwerkconfiguraties, stappen voor probleemoplossing en best practices voor productie-implementatie, raadpleegt u de volledige documentatie:
Volledige implementatiedetails, configuratievoorbeelden en richtlijnen voor probleemoplossing.
Windows
Open PowerShell als administrator door in de Windows-zoekbalk naar "PowerShell" te zoeken, met de rechtermuisknop op het resultaat te klikken en "Als administrator uitvoeren" te selecteren. Zodra u een PowerShell-sessie met verhoogde rechten hebt, voert u het volgende commando uit:
iwr -Uri 'https://api.eu1.sdaconsole.io/glue/v1/install.ps1' -UseBasicParsing | iex
Dit PowerShell-commando gebruikt Invoke-WebRequest (afgekort als iwr) om het installatiescript op te halen en stuurt het via een pipe naar Invoke-Expression (afgekort als iex) voor onmiddellijke uitvoering. De parameter -UseBasicParsing zorgt voor compatibiliteit met verschillende Windows-versies en -configuraties.
Succesvolle installatie van SDA Glue met PowerShell
Details over het Windows-installatieproces
Het Windows-installatieproces gebruikt PowerShell om een installatiescript te downloaden en uit te voeren dat uw systeem configureert voor connectiviteit met SEW. Anders dan bij de Linux-benadering, waarbij software vanaf de bron wordt gecompileerd, downloadt het Windows-installatieprogramma vooraf gebouwde binaries van de OpenVPN Community Client en de SDA Glue-service, en registreert het SDA Glue vervolgens als een Windows-service.
De Windows-service-integratie zorgt ervoor dat SDA Glue automatisch met uw systeem start en automatisch opnieuw start wanneer er problemen optreden. Dit biedt dezelfde betrouwbaarheidsvoordelen als de systemd-benadering onder Linux, maar maakt gebruik van de native servicebeheerinfrastructuur van Windows.
Net als bij de Linux-benadering kunt u het installatiescript bekijken voordat u het uitvoert door het gedeelte | iex te verwijderen of door https://api.eu1.sdaconsole.io/glue/v1/install.ps1 rechtstreeks in uw webbrowser te openen.
Windows met proxy
Wanneer uw Windows-systeem achter een proxyserver werkt, vereist het installatieproces een aanpak in twee fasen. Eerst configureert u de proxy-instellingen en downloadt u het installatiescript. Vervolgens voert u het script uit met de juiste proxyconfiguratie.
Begin met het instellen van PowerShell-variabelen voor uw proxyconfiguratie:
# Configure your specific proxy details
$ProxyHost="proxy.company.com:8080"
$ProxyUser="your-username"
# Download the installation script through the proxy
iwr -Uri 'https://api.eu1.sdaconsole.io/glue/v1/install.ps1' -UseBasicParsing -OutFile .\glue-install.ps1 -Proxy http://$ProxyHost -ProxyCredential $ProxyUser
# Execute the script with proxy configuration
.\glue-install.ps1 -Proxy $ProxyHost -ProxyCredential $ProxyUser
Let op het belangrijke verschil in de opmaak van de proxy-URL: het commando Invoke-WebRequest vereist het volledige URL-schema (http://proxy.company.com:8080), terwijl het installatiescript alleen de hostnaam en poort verwacht (proxy.company.com:8080).
Zoals de logs onderaan aangeven, moeten we de proxyserver in SDA Glue configureren via de CLI
Authenticatie en aanmelding
Nadat u de SDA Glue-software succesvol hebt geïnstalleerd, moet u uw fysieke gateway authenticeren bij de SEW Cloud-services. Dit authenticatieproces maakt gebruik van unieke inloggegevens die door de SEW OrchestrationSuite voor uw specifieke gateway worden gegenereerd. Deze inloggegevens bestaan uit een korte gateway-identificatie en een eenmalig wachtwoord dat periodiek roteert voor extra veiligheid.
Commando's voor gateway-installatie uit de SEW OrchestrationSuite
Keer terug naar de SEW OrchestrationSuite en zoek het tweede commando in het installatiedialoogvenster van uw gateway. Dit commando ziet er ongeveer uit als de volgende voorbeelden:
Linux
sudo sdaglue login -e eu1 G1ABCD 123456
Docker
docker exec glue sdaglue login -e eu1 G1ABCD 123456
Windows
sdaglue.exe login -e eu1 G1ABCD 123456
De commandostructuur bevat de vlag -e eu1 die het Europese regio-endpoint aangeeft, gevolgd door de unieke identificatie van uw gateway (zoals G1ABCD) en het eenmalige wachtwoord (zoals 123456). Deze waarden zijn specifiek voor uw gateway en wijken af van de getoonde voorbeelden.
Het eenmalige wachtwoord wordt om veiligheidsredenen periodiek vernieuwd. Als u authenticatiefouten tegenkomt, keert u terug naar de SEW OrchestrationSuite om het actuele wachtwoord op te halen uit het installatiedialoogvenster van de gateway.
Servicestatus
Controleer na het voltooien van het installatie- en authenticatieproces of de SDA Glue-service correct op uw systeem draait.
Linux
Controleer de servicestatus met systemd-commando's:
sudo systemctl status sdaglue
Om live loguitvoer te monitoren en eventuele problemen op te lossen:
sudo journalctl -efu sdaglue -n 100
Docker
De servicelogs kunnen als volgt uit Docker-containers worden opgehaald:
docker logs -n 100 --follow glue # tracks the latest 100 logs from the service
Windows
U kunt de service verifiëren via de Windows-toepassing Services. Zoek in de Windows-zoekbalk naar "Services" en zoek "SDA Glue" in de servicelijst. De service moet worden weergegeven als "Wordt uitgevoerd" met opstarttype "Automatisch".
Actieve services visualiseren in Windows
Windows-services produceren gebeurtenislogboeken die toegankelijk zijn via de Logboeken (Event Viewer), onder Windows-logboeken → Toepassing. Gebruik de zoekbalk om de Event Viewer te openen.
SDA Glue-logs raadplegen in de Event Viewer
Configuratie
Met SDA Glue kunt u het gedrag ervan aanpassen zodat het optimaal functioneert binnen uw specifieke netwerkomgeving. Deze configuratieaanpassingen zorgen voor betrouwbare connectiviteit, ongeacht de unieke kenmerken van uw industriële netwerk, of u nu te maken hebt met proxyservers, firewallbeperkingen of verschillende communicatieprotocollen.
We gebruiken omgevingsvariabelen om de service aan te sturen. Configuratiewijzigingen vereisen een herstart van de service om van kracht te worden. Omgevingsvariabelen hanteren dezelfde naamgevingsconventie voor configuratieparameters, maar gebruiken het voorvoegsel GLUE en worden gescheiden door underscores:
log.level -> GLUE_LOG_LEVEL
webui.enabled -> GLUE_WEBUI_ENABLED
Huidige configuratieparameters bekijken:
# Linux & Windows
sdaglue config describe
# Docker
docker exec glue sdaglue config describe
Parameters instellen:
# Linux & Windows
sdaglue config set --log.level debug --webui.enabled true --webui.port 8080
# Docker
docker exec sdaglue config set --log.level debug --webui.enabled true --webui.port 8080
Parameters ophalen:
# Linux & Windows
sdaglue config list
# Docker
docker exec sdaglue config list
Service herstarten na wijzigingen:
# Linux & Windows
sdaglue service restart
# Docker
docker exec glue sdaglue service restart # or
docker restart glue
MQTT-transportprotocol
Een van de belangrijkste configuratiebeslissingen betreft de keuze hoe uw gateway communiceert met de SEW Cloud-services. SDA Glue ondersteunt twee transportprotocollen, elk ontworpen voor verschillende netwerkomgevingen:
| Transport | Protocol | Poort | Toepassing |
|---|---|---|---|
| MQTT | SSL / TCP | 443 | Standaardnetwerken met directe internettoegang |
| MQTT over WebSocket | WebSocket Secure (TCP) | 443 | Netwerken met transparante proxy's of SSL-inspectie |
Voor WebSocket-transport:
# Linux & Windows
sdaglue config set --iot.transport websocket
# Docker
docker exec glue sdaglue config set --iot.transport websocket
Voor standaard MQTT-transport:
# Linux & Windows
sdaglue config set --iot.transport mqtt
# Docker
docker exec glue sdaglue config set --iot.transport mqtt
Als de service al is aangemeld en verbonden, wordt het nieuwe transportprotocol pas van kracht na de volgende herstart van de service.
Wanneer WebSocket-transport gebruiken
Transparante proxy's: Sommige bedrijfsnetwerken gebruiken transparante proxy's die netwerkverkeer onderscheppen en analyseren. Deze proxy's kunnen standaard MQTT SSL-verbindingen verstoren, maar laten WebSocket-verbindingen doorgaans zonder problemen door.
Restrictieve firewalls: Netwerken met deep packet inspection of strikte protocolfiltering kunnen MQTT-verkeer blokkeren terwijl WebSocket-verbindingen wel worden toegestaan, omdat deze lijken op standaard webverkeer.
Beleid van bedrijfsnetwerken: Sommige organisaties hanteren beleid dat niet-HTTP-protocollen beperkt, waardoor WebSocket-transport de voorkeur verdient met het oog op naleving.
Proxyserver
Wanneer uw netwerk vereist dat al het internetverkeer via een specifieke proxyserver verloopt, moet SDA Glue met de proxygegevens worden geconfigureerd om verbindingen met de SEW Cloud-services tot stand te brengen. Dit komt met name vaak voor in bedrijfsomgevingen waar directe internettoegang om veiligheidsredenen is beperkt.
Proxyadressen volgen het standaardformaat: scheme://username:password@hostname:port
- Schema: Meestal
http://ofhttps:// - Gebruikersnaam/wachtwoord: Authenticatiegegevens (indien vereist door uw proxy)
- Hostnaam: Het adres van de proxyserver
- Poort: Het poortnummer van de proxyserver
U moet zowel de HTTP- als de HTTPS-proxy-instellingen configureren om volledige dekking van de communicatiebehoeften van SDA Glue te garanderen.
Als uw proxyserver geen authenticatie vereist, laat u eenvoudigweg de gebruikersnaam en het wachtwoord weg:
proxy_server="http://proxy.company.com:8080"
Linux
proxy_server="http://username:password@proxy.company.com:8080"
sdaglue config set --proxy.http=$proxy_server --proxy.https=$proxy_server
# Restart the service to apply changes
sdaglue service restart
Docker
proxy_server="http://username:password@proxy.company.com:8080"
docker exec glue sdaglue config set --proxy.http=$proxy_server --proxy.https=$proxy_server
# Restart the container to apply changes
docker restart glue
Windows
$ProxyServer="http://username:password@proxy.company.com:8080"
sdaglue.exe config set --proxy.http=$ProxyServer --proxy.https=$ProxyServer
# Restart the service to apply changes
sdaglue.exe service restart
Veelvoorkomende problemen
Bedrijfsnetwerk met transparante proxy
Probleem: De gateway maakt aanvankelijk verbinding, maar verbreekt deze regelmatig of vertoont instabiele connectiviteit.
Oplossing: Schakel over naar het WebSocket-transportprotocol.
Restrictieve firewallomgeving
Probleem: De gateway kan geen initiële verbinding met de SEW Cloud-services tot stand brengen.
Oplossing: Configureer WebSocket-transport en controleer of uitgaande HTTPS-verbindingen zijn toegestaan op poort 443.
Proxyserver met authenticatie
Probleem: De gateway kan geen verbinding maken via een bedrijfsproxy die authenticatie vereist.
Oplossing: Configureer beide proxy-instellingen met de juiste authenticatiegegevens en herstart de service.
Wanneer deze configuratieopties correct zijn ingesteld, past uw SDA Glue-service zich aan uw netwerkomgeving aan en behoudt deze een betrouwbare verbinding met de SEW Cloud-services, waardoor veilige toegang tot uw industriële apparaten mogelijk wordt.