Εγκατάσταση του διακομιστή Edge Gateway¶

Σημείωση

Υπενθυμίζεται ότι η μετάβαση στον χρήστη root στους υπολογιστές Debian πρέπει να γίνεται με την ακόλουθη εντολή:

su -

Λήψη του ειδώλου και των απαραίτητων εργαλείων¶

Το κατοπτρικό αντίγραφο του CyberElements Cleanroom 4.6 και το κλειδί υπογραφής του αποθετηρίου της Systancia μπορούν να ληφθούν από αυτόν τον σύνδεσμο (απαιτείται η δημιουργία λογαριασμού πελάτη): Systancia Marketplace

Εκτός από το κατοπτρικό αντίγραφο και το κλειδί, για τη διαδικασία αναβάθμισης θα χρειαστούν εργαλεία τρίτων:

Ένα πρόγραμμα-πελάτης SSH (στα Windows, μπορείτε να χρησιμοποιήσετε το PuTTY)
Ένα πρόγραμμα-πελάτης SCP (στα Windows, μπορούν να χρησιμοποιηθούν τα εργαλεία WinSCP ή FileZilla)

Χρησιμοποιήστε το πρόγραμμα-πελάτη SSH για να συνδεθείτε απομακρυσμένα στον διακομιστή σας.

Χρησιμοποιήστε το πρόγραμμα-πελάτη SCP για να μεταφέρετε αρχεία στον απομακρυσμένο υπολογιστή σας.

Προετοιμασία για την εγκατάσταση¶

Διαμόρφωση του δικτύου¶

Συνιστάται ανεπιφύλακτα να ορίσετε μια στατική διεύθυνση δικτύου για τον διακομιστή Edge Gateway. Για να το κάνετε αυτό, πρέπει πρώτα να ανακτήσετε το όνομα της διασύνδεσης δικτύου του υπολογιστή σας και τη διεύθυνση MAC της. Εκτελέστε την ακόλουθη εντολή ως root:

ip -br link | grep -ve "^lo"

Η εντολή αυτή εμφανίζει το όνομα της διασύνδεσης δικτύου, την κατάστασή της, τη διεύθυνση MAC της και τις ρυθμίσεις της διασύνδεσης.

Παράδειγμα

Μετά την εκτέλεση της εντολής, εμφανίζεται η ακόλουθη έξοδος:

ens192           UP             00:50:56:a1:56:9f <BROADCAST,MULTICAST,UP,LOWER_UP>

Το όνομα της διασύνδεσης δικτύου είναι ens192 και η διεύθυνση MAC της είναι 00:50:56:a1:56:9f.

Αφού λάβετε το όνομα της διασύνδεσης δικτύου και τη διεύθυνση MAC, μπορείτε πλέον να επεξεργαστείτε τη διαμόρφωση δικτύου του υπολογιστή.
Επεξεργαστείτε το αρχείο /etc/network/interfaces για να το τροποποιήσετε σύμφωνα με το ακόλουθο πρότυπο:

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports INTERFACE_NAME
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw MAC_ADDRESS
    address IP_GW
    netmask NETMASK
    gateway NETWORK_GATEWAY
    dns-nameservers IP_DNS_1 IP_DNS_2
    dns-search DNS_SUFFIX

Όπου:

Το INTERFACE_NAME πρέπει να αντικατασταθεί από το όνομα της διασύνδεσης δικτύου που ανακτήσατε προηγουμένως.
Το MAC_ADDRESS πρέπει να αντικατασταθεί από τη διεύθυνση MAC που ανακτήσατε προηγουμένως.
Το IP_GW πρέπει να αντικατασταθεί από τη διεύθυνση IP του διακομιστή.
Το NETMASK πρέπει να αντικατασταθεί από τη μάσκα δικτύου που σχετίζεται με τη διεύθυνση IP.
Το NETWORK_GATEWAY πρέπει να αντικατασταθεί από την προεπιλεγμένη πύλη δικτύου.
Το IP_DNS πρέπει να αντικατασταθεί από τη διεύθυνση IP του διακομιστή DNS. Εάν πρέπει να διαμορφωθούν περισσότεροι διακομιστές (έως 3), διαχωρίστε τους με κενό διάστημα.
Το DNS_SUFFIX πρέπει να αντικατασταθεί από το επίθημα DNS που θα χρησιμοποιηθεί. Εάν δεν χρειάζεται να καταχωρίσετε επίθημα, διαγράψτε τη γραμμή.

Παράδειγμα

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto br0
iface br0 inet static
    bridge_ports ens192
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 2
    bridge_hw 00:50:56:a1:56:9f
    address 172.16.10.10
    netmask 255.255.255.0
    gateway 172.16.10.254
    dns-nameservers 172.16.11.2 172.16.11.3
    dns-search domain.local

Πριν από την εφαρμογή της διαμόρφωσης, απομένουν τρία ακόμη βήματα.

Το πρώτο είναι η εγκατάσταση των πακέτων resolvconf και bridge-utils, ώστε να μπορεί να εφαρμοστεί η διαμόρφωση DNS που καθορίστηκε στο προηγούμενο αρχείο και να μπορεί να χρησιμοποιηθεί η διασύνδεση br0:

apt install -y resolvconf bridge-utils

Το δεύτερο είναι ο έλεγχος της διαμόρφωσης του αρχείου /etc/hosts όσον αφορά την κύρια διεύθυνση IP του υπολογιστή (IP_GW).
Για να το κάνετε αυτό, επεξεργαστείτε το αρχείο /etc/hosts και ελέγξτε ότι η δεύτερη γραμμή έχει την ακόλουθη μορφή:

2	`IP_GW FQDN MACHINE_NAME`

Παράδειγμα

Εάν ο υπολογιστής ονομάζεται EDGE-GATEWAY χωρίς να ανήκει σε τομέα και η διεύθυνση IP του IP_GW είναι 172.16.10.10, το αρχείο θα συμπληρωνόταν ως εξής:

2	`172.16.10.10 EDGE-GATEWAY`

Εάν ο υπολογιστής ανήκει στον τομέα DOMAIN.LOCAL, το αρχείο θα συμπληρωνόταν ως εξής:

2	`172.16.10.10 EDGE-GATEWAY.DOMAIN.LOCAL EDGE-GATEWAY`

Προσοχή!

Μια εσφαλμένη διαμόρφωση του αρχείου ενδέχεται να προκαλέσει σφάλμα κατά την εγκατάσταση του πακέτου collectd.

Το μόνο που απομένει είναι η επανεκκίνηση του διακομιστή:

reboot

Διαμόρφωση του διαχειριστή πακέτων APT¶

Αποστείλετε τα αρχεία που λάβατε από το Systancia Marketplace στον κατάλογο /tmp/ του διακομιστή, χρησιμοποιώντας ένα πρόγραμμα-πελάτη SCP:

systancia.gpg
cleanroom-4.6.1-build33.1096.D12-full.tgz

Συνδεθείτε στον διακομιστή ως root και, στη συνέχεια, εκτελέστε τις ακόλουθες εντολές για να αποσυμπιέσετε το αποθετήριο της Systancia, να διαμορφώσετε τη χρήση του στο APT και να επαληθεύσετε την αυθεντικότητά του.

mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/
mkdir -p /opt/systancia/repository/
tar xvzf /tmp/cleanroom-4.6*.tgz -C /opt/systancia/repository/
echo "deb file:///opt/systancia/repository/ bookworm ipdiva" > /etc/apt/sources.list.d/systancia.list
apt update

Συνιστούμε ανεπιφύλακτα να απενεργοποιήσετε την εγκατάσταση μη απαραίτητων πακέτων κατά την εκτέλεση εντολών apt. Για να το κάνετε αυτό, εκτελέστε την ακόλουθη εντολή:

echo -e 'APT::Install-Recommends false;\nAPT::Install-Suggests false;' > /etc/apt/apt.conf.d/99norecommends

Εγκατάσταση του διακομιστή Edge Gateway του CyberElements Bastion¶

Εγκατάσταση βασικών στοιχείων¶

Ξεκινήστε την εγκατάσταση των στοιχείων με την ακόλουθη εντολή ως root:

apt install -y ipdiva-base

Μετά τη λήψη όλων των εξαρτήσεων, ανοίγει ένα παράθυρο που σας ζητά να επιλέξετε τον τύπο διακομιστή. Επιλέξτε gateway:

Τι πρέπει να κάνω σε περίπτωση σφάλματος;

Εάν υπάρχει σφάλμα στις πληροφορίες που καταχωρίσατε, συνεχίστε την εγκατάσταση του πακέτου ipdiva-base και, στη συνέχεια, χρησιμοποιήστε την ακόλουθη εντολή για να διαμορφώσετε ξανά τον διακομιστή:

1	`dpkg-reconfigure ipdiva-base`

Εγκατάσταση στοιχείων Edge Gateway¶

Στη συνέχεια, ξεκινήστε την εγκατάσταση των στοιχείων που αφορούν ειδικά το Edge Gateway με την ακόλουθη εντολή:

apt install -y ipdiva-safe-gateway ipdiva-gateway-setup

Τα στοιχεία του διακομιστή Edge Gateway έχουν πλέον εγκατασταθεί. Το μόνο που απομένει είναι η επανεκκίνηση του υπολογιστή, ώστε να μπορέσουν να αρχικοποιηθούν τα στοιχεία που μόλις εγκαταστάθηκαν:

reboot

Εγκατάσταση στοιχείων HTML5 Gateway¶

Χρησιμοποιήστε την ακόλουθη εντολή για να ξεκινήσετε την εγκατάσταση των στοιχείων του HTML5 Gateway στον διακομιστή Edge Gateway:

apt install -y ipdiva-html5gateway ipdiva-html5-webapp ipdiva-guacamole-server1

Χρησιμοποιήστε τις ακόλουθες γραμμές εντολών για να ενεργοποιήσετε και να διαμορφώσετε τις δυνατότητες μεταφοράς αρχείων και εικονικού εκτυπωτή:

apt install -y ghostscript
echo -e "printer=cyberelements HTML5 Printer\nprinterDriver=MS Publisher Imagesetter" > /etc/guacamole/printer-config
mkdir /home/systanciahtml5share

Διαμόρφωση¶

Διαμορφώσεις πριν από τη σύνδεση του στοιχείου HTML5 Gateway¶

Για να λειτουργούν οι εφαρμογές HTML5, πρέπει να διαμορφωθούν πρόσθετες ρυθμίσεις στον διακομιστή Mediation Controller. Συνδεθείτε στον διακομιστή Mediation Controller ως root.

Δημιουργήστε ή τροποποιήστε το αρχείο /etc/ipdiva/httpd/commonParameters.extra.conf για να προσθέσετε ένα τμήμα αντίστοιχο με το ακόλουθο:

<Location /URL_HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /URL_HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway GW_NAME|
        RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Όπου:

Το URL_HTML5 πρέπει να αντικατασταθεί με το περιεχόμενο του πεδίου URL του στοιχείου HTML5 Gateway που διαμορφώθηκε στην κονσόλα διαχείρισης κατά τη δημιουργία του διακριτικού σύζευξης.
Το GW_NAME πρέπει να αντικατασταθεί με το όνομα ενός Edge Gateway που βρίσκεται στον ίδιο διακομιστή με το HTML5 Gateway. Ο χαρακτήρας | στο τέλος της γραμμής πρέπει να διατηρηθεί.
Το ORGANIZATION_NAME πρέπει να αντικατασταθεί με το όνομα του οργανισμού στον οποίο συνδέεται το προηγούμενο Edge Gateway.

Παράδειγμα

Για μια πλατφόρμα με τις ακόλουθες ρυθμίσεις:

Όνομα οργανισμού: my-organization-name
Δήλωση του στοιχείου HTML5 Gateway στην κονσόλα διαχείρισης:
- Name: html5-gateway
- URL: HTML5
- Protocol: WebSocket
Ένας διακομιστής Edge Gateway διαθέτει:
- Μια υπηρεσία Edge Gateway με το όνομα edge-gateway
- Μια υπηρεσία HTML5 Gateway με το όνομα html5-gateway

Το αρχείο διαμόρφωσης /etc/ipdiva/httpd/commonParameters.extra.conf που δημιουργήθηκε θα ρυθμιστεί ως εξής:

<Location /HTML5/>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /HTML5/websocket-tunnel>
        Order allow,deny
        Allow from all
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-IPdiva-Gateway edge-gateway|
        RequestHeader set X-IPdiva-Orgname my-organization-name
        RequestHeader set X-IPdiva-Service 127.0.0.1:8080

        ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Πριν από την εφαρμογή των νέων ρυθμίσεων, πρέπει να ελέγξετε ότι η νέα διαμόρφωση δεν προκαλεί σφάλματα που εμποδίζουν τη λειτουργία του διακομιστή web Apache2.
Για να το κάνετε αυτό, εκτελέστε την ακόλουθη εντολή:

1	`apache2ctl configtest`

Εάν η απόκριση είναι Syntax OK, οι αλλαγές μπορούν να εφαρμοστούν με την παρακάτω εντολή. Διαφορετικά, ελέγξτε τη διαμόρφωσή σας στο αρχείο /etc/ipdiva/httpd/commonParameters.extra.conf.

1	`systemctl reload apache2`

Σύνδεση των στοιχείων Edge Gateway και HTML5 Gateway¶

Προσοχή!

Εάν χρησιμοποιείτε για το στοιχείο SSL Router πιστοποιητικά που έχουν εκδοθεί από αρχή έκδοσης πιστοποιητικών (CA) διαφορετική από αυτή της Systancia, πρέπει να προσθέσετε τη CA ρίζας στις αξιόπιστες CA του στοιχείου Edge Gateway: προσθέστε τη CA ρίζας του στοιχείου SSL Router στις αξιόπιστες CA για τη σύνδεση του στοιχείου Edge Gateway ή HTML5 Gateway.

Για να διαμορφώσετε τις παρουσίες Edge Gateway και HTML5 Gateway στον διακομιστή, ακολουθήστε τις πληροφορίες της παρακάτω τεκμηρίωσης: Σύζευξη του διακομιστή