> Source: https://docs.cyberelements.io/bastion/4.6/el/Installation/Standalone/FromScratch/InstallEdgeGateway/

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

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

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

Το κατοπτρικό αντίγραφο του CyberElements Cleanroom 4.6 και το κλειδί υπογραφής του αποθετηρίου της Systancia μπορούν να ληφθούν από αυτόν τον σύνδεσμο (απαιτείται η δημιουργία λογαριασμού πελάτη): [Systancia Marketplace](https://www.systancia.com/my-systancia/marketplace/systancia-cleanroom/telechargements-cleanroom/)

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

- Ένα πρόγραμμα-πελάτης SSH (στα Windows, μπορείτε να χρησιμοποιήσετε το [PuTTY](https://putty.org/))
- Ένα πρόγραμμα-πελάτης SCP (στα Windows, μπορούν να χρησιμοποιηθούν τα εργαλεία [WinSCP](https://winscp.net/eng/index.php) ή [FileZilla](https://filezilla-project.org/))

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

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

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

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

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

```
1
```

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

> **Παράδειγμα**
>
> Μετά την εκτέλεση της εντολής, εμφανίζεται η ακόλουθη έξοδος:
>
> ```
> 1
> ```
>
> Το όνομα της διασύνδεσης δικτύου είναι `ens192` και η διεύθυνση MAC της είναι `00:50:56:a1:56:9f`.

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

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
```

Όπου:

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

> **Παράδειγμα**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> ```

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

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

```
1
```

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

```
2
```

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

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

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

```
1
```

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

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

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

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

```
1
2
3
4
5
```

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

```
1
```

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

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

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

```
1
```

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

![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/InstallCLRScratchStandalone-Gateway.png)

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

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

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

```
1
```

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

```
1
```

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

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

```
1
```

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

```
1
2
3
```

## Διαμόρφωση

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

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

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

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
```

Όπου:

- Το `URL_HTML5` πρέπει να αντικατασταθεί με το περιεχόμενο του πεδίου `URL` του στοιχείου HTML5 Gateway που διαμορφώθηκε στην κονσόλα διαχείρισης κατά τη [δημιουργία του διακριτικού σύζευξης](https://docs.cyberelements.io/bastion/4.6/el/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).
- Το `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` που δημιουργήθηκε θα ρυθμιστεί ως εξής:
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```

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

```
1
```

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

```
1
```

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

> **Προσοχή!**
>
> Εάν χρησιμοποιείτε για το στοιχείο SSL Router πιστοποιητικά που έχουν εκδοθεί από αρχή έκδοσης πιστοποιητικών (CA) διαφορετική από αυτή της Systancia, πρέπει να προσθέσετε τη CA ρίζας στις αξιόπιστες CA του στοιχείου Edge Gateway: [προσθέστε τη CA ρίζας του στοιχείου SSL Router στις αξιόπιστες CA για τη σύνδεση του στοιχείου Edge Gateway ή HTML5 Gateway](https://docs.cyberelements.io/bastion/4.6/el/Usage/Configuration/EdgeGateway/AddANewTrustedCertificationAuthority/#global-addition-to-debian).

Για να διαμορφώσετε τις παρουσίες Edge Gateway και HTML5 Gateway στον διακομιστή, ακολουθήστε τις πληροφορίες της παρακάτω τεκμηρίωσης: [Σύζευξη του διακομιστή](https://docs.cyberelements.io/bastion/4.6/el/Usage/Configuration/EdgeGateway/ConnectAnEdgeGatewayWithPairingToken/)
