Instalacija poslužitelja Edge Gateway¶
Napomena
Podsjetnik: prebacivanje na root na računalima sa sustavom Debian mora se izvršiti sljedećom naredbom:
1 | |
Preuzimanje zrcala i potrebnih alata¶
Zrcalo za CyberElements Cleanroom 4.6 i ključ za potpis repozitorija tvrtke Systancia mogu se preuzeti s ove poveznice (potrebno je stvoriti račun klijenta): Systancia Marketplace
Uz zrcalo i ključ, za postupak nadogradnje bit će potrebni alati trećih strana:
- SSH klijent (u sustavu Windows možete upotrijebiti PuTTY)
- SCP klijent (u sustavu Windows možete upotrijebiti alate WinSCP ili FileZilla)
Upotrijebite SSH klijent za udaljeno povezivanje sa svojim poslužiteljem.
Upotrijebite SCP klijent za prijenos datoteka na udaljeno računalo.
Priprema za instalaciju¶
Konfiguracija mreže¶
Izričito se preporučuje definirati statičku mrežnu adresu za poslužitelj Edge Gateway. Da biste to učinili, najprije morate dohvatiti naziv mrežnog sučelja svojeg računala i njegovu MAC adresu. Pokrenite sljedeću naredbu kao root:
1 | |
Ova naredba prikazuje naziv mrežnog sučelja, njegovo stanje, njegovu MAC adresu i postavke sučelja.
Primjer
Nakon izvršavanja naredbe prikazuje se sljedeći izlaz:
1 | |
Naziv mrežnog sučelja je ens192, a njegova je MAC adresa 00:50:56:a1:56:9f.
Kada ste dobili naziv mrežnog sučelja i MAC adresu, sada možete urediti mrežnu konfiguraciju računala.
Uredite datoteku /etc/network/interfaces i izmijenite je prema sljedećem predlošku:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | |
Pri čemu:
INTERFACE_NAMEtreba zamijeniti nazivom prethodno dohvaćenog mrežnog sučelja.MAC_ADDRESStreba zamijeniti prethodno dohvaćenom MAC adresom.IP_GWtreba zamijeniti IP adresom poslužitelja.NETMASKtreba zamijeniti mrežnom maskom pridruženom IP adresi.NETWORK_GATEWAYtreba zamijeniti zadanim mrežnim pristupnikom.IP_DNStreba zamijeniti IP adresom DNS poslužitelja. Ako treba konfigurirati nekoliko poslužitelja (najviše 3), odvojite ih razmakom.DNS_SUFFIXtreba zamijeniti DNS sufiksom koji će se upotrebljavati. Ako sufiks nije potrebno unijeti, izbrišite redak.
Primjer
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | |
Prije primjene konfiguracije treba dovršiti još tri koraka.
Prvi je instalacija paketa resolvconf i bridge-utils kako bi se mogla primijeniti DNS konfiguracija navedena u prethodnoj datoteci i kako bi se moglo upotrebljavati sučelje br0:
1 | |
Drugi je provjera konfiguracije datoteke /etc/hosts u pogledu primarne IP adrese računala (IP_GW).
Da biste to učinili, uredite datoteku /etc/hosts i provjerite je li drugi redak u sljedećem obliku:
2 | |
Primjer
Ako je naziv računala EDGE-GATEWAY, računalo ne pripada domeni, a njegova je IP adresa IP_GW jednaka 172.16.10.10, datoteka bi se ispunila na sljedeći način:
2 | |
Ako računalo pripada domeni DOMAIN.LOCAL, datoteka bi se ispunila na sljedeći način:
2 | |
Pozor!
Neispravna konfiguracija datoteke može uzrokovati pogrešku pri instalaciji paketa collectd.
Preostaje samo ponovno pokrenuti poslužitelj:
1 | |
Konfiguriranje upravitelja paketa APT¶
Prenesite datoteke preuzete sa servisa Systancia Marketplace u direktorij /tmp/ na poslužitelju pomoću SCP klijenta:
systancia.gpgcleanroom-4.6.1-build33.1096.D12-full.tgz
Prijavite se na poslužitelj kao root, a zatim pokrenite sljedeće naredbe da biste raspakirali repozitorij tvrtke Systancia, konfigurirali njegovu upotrebu u alatu APT i provjerili njegovu autentičnost.
1 2 3 4 5 | |
Izričito preporučujemo da onemogućite instalaciju nepotrebnih paketa pri pokretanju naredbi apt. Da biste to učinili, pokrenite sljedeću naredbu:
1 | |
Instalacija poslužitelja Edge Gateway za CyberElements Bastion¶
Instalacija osnovnih komponenti¶
Pokrenite instalaciju komponenti sljedećom naredbom kao root:
1 | |
Nakon preuzimanja svih zavisnosti otvorit će se prozor u kojem se od vas traži da odaberete vrstu poslužitelja. Odaberite gateway:
Što učiniti u slučaju pogreške?
Ako postoji pogreška u podacima koje ste unijeli, nastavite instalaciju paketa ipdiva-base, a zatim upotrijebite sljedeću naredbu za ponovno konfiguriranje poslužitelja:
1 | |
Instalacija komponenti Edge Gateway¶
Zatim pokrenite instalaciju komponenti specifičnih za poslužitelj Edge Gateway sljedećom naredbom:
1 | |
Komponente poslužitelja Edge Gateway sada su instalirane. Preostaje samo ponovno pokrenuti računalo kako bi se novoinstalirane komponente mogle inicijalizirati:
1 | |
Instalacija komponenti HTML5 Gateway¶
Upotrijebite sljedeću naredbu da biste pokrenuli instalaciju komponenti HTML5 Gateway na poslužitelju Edge Gateway:
1 | |
Upotrijebite sljedeće naredbene retke da biste omogućili i konfigurirali značajke prijenosa datoteka i virtualnog pisača:
1 2 3 | |
Postavke specifične za rad proizvoda CyberElements Bastion¶
Nakon primjene mrežnih postavki još morate povezati instance komponenti Edge Gateway i HTML5 Gateway s poslužiteljima Mediation Controller.
U tu svrhu prve instance komponenti Edge Gateway i HTML5 Gateway povezat će se s poslužiteljem Mediation Controller MASTER, a druge instance s poslužiteljem Mediation Controller SLAVE.
Pozor!
Ako se instalacija komponente Edge Gateway ne nalazi unutar mreže LAN i stoga adrese RIP_MED_SSL_MASTER i RIP_MED_SSL_SLAVE nisu dostupne (čak ni uz NAT).
U tom slučaju trebate konfigurirati samo prvu instancu komponenti Edge Gateway i HTML5 Gateway, koja će biti postavljena za povezivanje s VIP_MED_SSL.
U tom se kontekstu može upotrijebiti virtualni uređaj Standalone. Virtualni uređaj Cluster unaprijed je konfiguriran s dvjema instancama, dok je njegov ekvivalent Standalone unaprijed konfiguriran s jednom instancom.
Prije nastavka sa sljedećim uputama provjerite imate li sljedeće stavke:
- Certifikat za instance komponenti Edge Gateway i HTML5 Gateway koje treba povezati
- Certifikat za uslugu snimanja
- SSH klijent (u sustavu Windows možete upotrijebiti PuTTY)
- SCP klijent (u sustavu Windows možete upotrijebiti alate WinSCP ili FileZilla)
Prenesite certifikate u direktorij /tmp/ na računalu.
Stvaranje instanci za povezivanje s poslužiteljem Mediation Controller SLAVE¶
Pokrenite sljedeće naredbe kao root kako biste deklarirali novu instancu komponenti Edge Gateway i HTML5 Gateway koja će se koristiti za povezivanje s poslužiteljem Mediation Controller SLAVE:
1 2 | |
Povezivanje poslužitelja Edge Gateway¶
Kopirajte datoteku certifikata komponente Edge Gateway u direktorije /etc/ipdiva/gateway/ssl/ i /etc/ipdiva/gateway-slave/ssl/. To možete učiniti tako da kao root pokrenete naredbe slične sljedećima (zamijenite <CERT_NAME> nazivom certifikata za komponentu Edge Gateway):
1 2 | |
Konfigurirajte instance komponente Edge Gateway kako bi se mogle povezati s poslužiteljima Mediation Controller.
Konfiguracije se razlikuju ovisno o poslužitelju Mediation Controller s kojim se treba povezati. Izvršite obje konfiguracije:
Uredite datoteku /etc/ipdiva/gateway/gateway.xml i ispunite je pomoću sljedećih podataka (nekoliko je odjeljaka izostavljeno i označeno s […]):
1 2 3 4 5 6 7 8 9 10 | |
Zamijenite sljedeće elemente:
_FILL_ME_WITH_SERVER_ADDRESS_:: treba zamijeniti adresomRIP_MED_SSL_MASTER, znakom:i priključkom za osluškivanje komponente SSL Router, koji je obično postavljen na443keyfile.pem: treba zamijeniti nazivom datoteke certifikataPASSWORD: treba zamijeniti lozinkom certifikata
Primjer
Uzimajući u obzir sljedeće podatke:
RIP_MED_SSL_MASTERjednako je:10.0.10.11- Priključak za osluškivanje komponente SSL Router:
443 - Naziv datoteke certifikata:
edge-gateway.p12 - Lozinka certifikata:
Str0ngP@ssw0rd
Datoteka /etc/ipdiva/gateway/gateway.xml konfigurirala bi se na sljedeći način:
1 2 3 4 5 6 7 8 9 10 | |
Potpuna datoteka
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | |
Na kraju pokrenite instancu komponente Edge Gateway da biste učitali nove postavke i povezali je s poslužiteljem Mediation Controller MASTER:
1 | |
Uredite datoteku /etc/ipdiva/gateway-slave/gateway.xml i dovršite je pomoću sljedećih podataka (nekoliko je odjeljaka izostavljeno i označeno s […]):
1 2 3 4 5 6 7 8 9 10 11 12 | |
Zamijenite sljedeće elemente:
@SERVER@: treba zamijeniti adresomRIP_MED_SSL_SLAVE@SERVERPORT@: treba zamijeniti priključkom za osluškivanje komponente SSL Router, obično postavljenim na443keyfile.pem: treba zamijeniti nazivom datoteke certifikataPASSWORD: treba zamijeniti lozinkom certifikata@RPC_PORT@: treba zamijeniti dostupnim TCP priključkom na računalu; obično se upotrebljava priključak9081
Primjer
Uzimajući u obzir sljedeće podatke:
RIP_MED_SSL_SLAVEjednako je:10.0.10.13- Priključak za osluškivanje komponente SSL Router:
443 - Naziv datoteke certifikata:
edge-gateway.p12 - Lozinka certifikata:
Str0ngP@ssw0rd - Dostupan RPC priključak:
9081
Datoteka /etc/ipdiva/gateway-slave/gateway.xml konfigurirala bi se na sljedeći način:
1 2 3 4 5 6 7 8 9 10 11 12 | |
Potpuna datoteka
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | |
Na kraju pokrenite instancu komponente Edge Gateway da biste učitali nove postavke i povezali je s poslužiteljem Mediation Controller SLAVE:
1 | |
Konfiguracija usluge snimanja¶
Premjestite certifikat za uslugu snimanja u direktorij /etc/ipdiva/careserver/ naredbom sličnom ovoj (zamijenite <CERT_NAME> nazivom predviđenog certifikata):
1 | |
Zatim konfigurirajte uslugu izmjenom sljedeće datoteke: /etc/ipdiva/careserver/careserver.xml. Konfiguracija datoteke trebala bi izgledati otprilike ovako (u sljedećem su isječku izostavljeni mnogi retci datoteke, označeni s […]):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | |
Unesite sljedeće promjene:
- Promijenite IP adresu za osluškivanje usluge snimanja u
0.0.0.0(osluškuje na svim dostupnim IP adresama) - Zamijenite
recording_service.p12nazivom certifikata za uslugu snimanja - Zamijenite
PASSWORDlozinkom certifikata usluge snimanja - Dodajte redak
<element>http://127.0.0.1:9081</element>
Primjer
Uzimajući u obzir sljedeće podatke:
- Naziv datoteke certifikata:
fqdn.edge-gateway.local.p12 - Lozinka certifikata:
Str0ngP@ssw0rd
Datoteka /etc/ipdiva/careserver/careserver.xml konfigurirala bi se na sljedeći način:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | |
Potpuna datoteka
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | |
Potvrdite nove postavke ponovnim pokretanjem usluge snimanja:
1 | |
Povezivanje instanci HTML5 Gateway¶
Ako je potrebno konfigurirati instancu HTML5 Gateway, pokrenite sljedeću naredbu na poslužitelju Edge Gateway kao root kako biste omogućili automatsko pokretanje instance:
1 | |
Kopirajte datoteku certifikata komponente HTML5 Gateway u direktorije /etc/ipdiva/html5gateway/ssl/ i /etc/ipdiva/html5gateway-slave/ssl/. To možete učiniti tako da kao root pokrenete naredbe slične sljedećima (zamijenite <CERT_NAME> nazivom certifikata za komponentu HTML5 Gateway):
1 2 | |
Konfigurirajte instance komponente HTML5 Gateway kako bi se mogle povezati s poslužiteljima Mediation Controller.
Konfiguracije se razlikuju ovisno o poslužitelju Mediation Controller s kojim se treba povezati. Izvršite obje konfiguracije:
Uredite datoteku /etc/ipdiva/html5gateway/html5gateway.xml i dovršite je pomoću sljedećih podataka (nekoliko je odjeljaka izostavljeno i označeno s […]):
1 2 3 4 5 6 7 8 9 10 | |
Zamijenite sljedeće elemente:
_FILL_ME_WITH_SERVER_ADDRESS_:: treba zamijeniti adresomRIP_MED_SSL_MASTER, znakom:i priključkom za osluškivanje komponente SSL Router, koji je obično postavljen na443keyfile.pem: treba zamijeniti nazivom datoteke certifikataPASSWORD: treba zamijeniti lozinkom certifikata
Primjer
Uzimajući u obzir sljedeće podatke:
RIP_MED_SSL_MASTERjednako je:10.0.10.11- Priključak za osluškivanje komponente SSL Router:
443 - Naziv datoteke certifikata:
html5-gateway.p12 - Lozinka certifikata:
Str0ngP@ssw0rd
Datoteka /etc/ipdiva/html5gateway/html5gateway.xml konfigurirala bi se na sljedeći način:
1 2 3 4 5 6 7 8 9 10 | |
Potpuna datoteka
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | |
Na kraju ponovno pokrenite instancu komponente HTML5 Gateway da biste učitali nove postavke i povezali je s poslužiteljem Mediation Controller MASTER:
1 | |
Uredite datoteku /etc/ipdiva/html5gateway-slave/html5gateway.xml i dovršite je pomoću sljedećih podataka (nekoliko je odjeljaka izostavljeno i označeno s […]):
1 2 3 4 5 6 7 8 9 10 11 12 | |
Zamijenite sljedeće elemente:
@SERVER@: treba zamijeniti adresomRIP_MED_SSL_SLAVE@SERVERPORT@: treba zamijeniti priključkom za osluškivanje komponente SSL Router, obično postavljenim na443keyfile.pem: treba zamijeniti nazivom datoteke certifikataPASSWORD: treba zamijeniti lozinkom certifikata@RPC_PORT@: treba zamijeniti dostupnim TCP priključkom na računalu; obično se upotrebljava priključak9089
Primjer
Uzimajući u obzir sljedeće podatke:
RIP_MED_SSL_SLAVEjednako je:10.0.10.13- Priključak za osluškivanje komponente SSL Router:
443 - Naziv datoteke certifikata:
html5-gateway.p12 - Lozinka certifikata:
Str0ngP@ssw0rd - Dostupan RPC priključak:
9089
Datoteka /etc/ipdiva/html5gateway-slave/html5gateway.xml konfigurirala bi se na sljedeći način:
1 2 3 4 5 6 7 8 9 10 11 12 | |
Potpuna datoteka
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | |
Na kraju ponovno pokrenite instancu komponente HTML5 Gateway da biste učitali nove postavke i povezali je s poslužiteljem Mediation Controller SLAVE:
1 | |
Konfiguracije prije povezivanja instanci HTML5 Gateway¶
Da bi aplikacije HTML5 radile, potrebno je konfigurirati dodatne postavke na poslužiteljima Mediation Controller. Prijavite se na poslužitelje Mediation Controller MASTER i SLAVE kao root.
Stvorite ili uredite datoteku /etc/ipdiva/httpd/commonParameters.extra.conf kako biste za komponentu HTML5 Gateway dodali odjeljak ekvivalentan sljedećem:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Pri čemu:
URL_HTML5treba zamijeniti sadržajem poljaURLza komponentu HTML5 Gateway konfiguriranu u administratorskoj konzoli tijekom deklariranja komponente HTML5 Gateway (za klaster to su običnoHTML5-1iHTML5-2).GW_NAMEtreba zamijeniti nazivom komponente Edge Gateway koja se nalazi na istom poslužitelju kao i komponenta HTML5 Gateway. Znak | na kraju retka mora se zadržati.ORGANIZATION_NAMEtreba zamijeniti nazivom organizacije s kojom se povezuje prethodna komponenta Edge Gateway.
Primjer
Za platformu sa sljedećim postavkama:
- Naziv organizacije:
my-organization-name - Deklaracija prve komponente HTML5 Gateway u administratorskoj konzoli:
- Name:
html5-gateway-1 - URL:
HTML5-1 - Protocol:
WebSocket
- Name:
- Deklaracija druge komponente HTML5 Gateway u administratorskoj konzoli:
- Name:
html5-gateway-2 - URL:
HTML5-2 - Protocol:
WebSocket
- Name:
- Poslužitelj Edge Gateway prve komponente HTML5 Gateway ima:
- Uslugu Edge Gateway pod nazivom
edge-gateway-1 - Uslugu HTML5 Gateway pod nazivom
html5-gateway-1
- Uslugu Edge Gateway pod nazivom
- Poslužitelj Edge Gateway druge komponente HTML5 Gateway ima:
- Uslugu Edge Gateway pod nazivom
edge-gateway-2 - Uslugu HTML5 Gateway pod nazivom
html5-gateway-2
- Uslugu Edge Gateway pod nazivom
Stvorena konfiguracijska datoteka /etc/ipdiva/httpd/commonParameters.extra.conf bit će postavljena na sljedeći način:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | |
Prije primjene novih postavki morate provjeriti da nova konfiguracija ne uzrokuje blokirajuće pogreške za web-poslužitelj Apache2.
Da biste to učinili, pokrenite sljedeću naredbu:
1 | |
Ako je odgovor Syntax OK, promjene se mogu primijeniti naredbom u nastavku. U suprotnom provjerite svoju konfiguraciju u datoteci /etc/ipdiva/httpd/commonParameters.extra.conf.
1 | |
Konfiguriranje NTP poslužitelja vremena¶
Preporučuje se postaviti poslužitelj vremena kako bi sat sustava bio ažuran. Potrebni koraci opisani su na stranici konfiguracije NTP-a.
