Konsolmenu

Konsolmenuen er det, den virtuelle appliance (OVA og qcow2) viser på konsollen i hypervisoren. En installation med Docker har ingen konsolmenu. Menuen er på engelsk, så punkterne står her, som I ser dem.

Vælg et punkt ved at skrive tallet og trykke Enter. Er skærmen rodet, tegner Enter menuen igen.
Et ja/nej-spørgsmål kræver yes, y, j eller ja. Alt andet er nej, også Enter alene.
Øverst står appliancens version, VM-imagets version og adressen til webfladen. Står der “NO NETWORK ADDRESS”, har appliancen ingen adresse. Menuen tegnes igen af sig selv, når den får en.
Genstart, opdatering og geninstallation går i gang inden for et minut. Skærmen viser “working… mm:ss” og til sidst <Titel>: WORKED. eller <Titel>: FAILED (exit N).. Enter lader handlingen køre videre i baggrunden. Efter 15 minutter står der “Not finished after 15 minutes. Menu item 4 shows the log.”

1 Status, and how to reach the web interface

Viser:

netværksadresse og hostname;
styresystem, kerne, om automatiske sikkerhedsopdateringer er slået til, og hvor mange der venter;
om appliancen kører, er stoppet eller ikke er installeret endnu, og hvorfor;
ledig og brugt plads på datadisken;
om controlleren kører, og hvornår den sidst tjekkede ind. Den skal tjekke ind hvert minut;
controllerens seneste handling;
Appliance software version og VM image version;
adressen til webfladen og SHA-256-fingeraftrykket på appliancens certifikat.

Advarer browseren om certifikatet første gang, så sammenlign med fingeraftrykket her.

2 Test the connection to sslbrain Cloud

Tester cloud.sslbrain.com, acme.sslbrain.com og registry.sslbrain.com. Appliancen skal kunne nå alle tre.

Svar	Betyder
reachable (HTTP nnn)	Adressen svarer.
NAME DOES NOT RESOLVE	Appliancen kan ikke slå navnet op i DNS.
NO ANSWER	Som regel en firewall, der blokerer.

Portene står under Sikkerhed.

3 Configure the network

Sætter en statisk adresse på den virtuelle maskine. Skærmen spørger om:

IPv4-adressen med prefix, fx 192.168.1.50/24;
default gateway;
DNS-servere, kommasepareret;
hostname.

Cancel lader de nuværende indstillinger stå.

4 View logs

Bladr med piletasterne, og luk med q.

Punkt	Log
1 The appliance, last 200 lines	Appliancens egen log
2 The controller: updates, restarts, signature checks	Controllerens log: opdateringer, genstarter og signaturkontrol
3 First boot: image pull, verification, activation	Den første start: hentning, kontrol og aktivering af appliance-imaget
b Back	Tilbage til menuen

Fejler en opdatering, står årsagen i log 2. Se Når noget ikke virker.

5 Restart the appliance

Genstarter appliancen (containeren). Den virtuelle maskine kører videre. Webfladen er væk et øjeblik.

6 Update to the latest version

Gør det samme som Opdatér nu i webfladen. Den seneste signerede version hentes, og signaturen kontrolleres. Appliancen skal svare korrekt inden for 300 sekunder efter start. Fejler et trin, startes den version, der kørte før. Se Hold sslbrain opdateret.

7 Free disk space

Sletter Docker-images og build-cache, der ikke bruges, og viser ledig plads før og efter. Den kørende appliance røres ikke.

8 Reboot this machine

Genstarter hele den virtuelle maskine efter spørgsmålet “Reboot this machine now?”. Appliancen starter selv, når maskinen er oppe.

9 Danger zone

Punktet hedder Danger zone (root shell, support SSH, OS update, disk), og skærmen advarer: “This may break your installation, please backup first.” Tag en backup først: Gem en backup, og gendan fra den.

1 Open a root shell

Root-kontoen har ingen adgangskode. Root-shellen åbnes med en engangskode fra konsollen og et svar fra sslbrain Cloud.

Vælg 9 Danger zone, derefter 1 Open a root shell. Skærmen viser en kode, fx K7Q2-M9XD. Den gælder i 30 minutter og til én session.
Åbn Appliances i sslbrain Cloud, klik på appliancen, og vælg fanen Shell-adgang. Skriv koden, og klik på Hent svar.
Skriv svaret, fx 4H7M-Q2XD-9KTB, ved Answer i konsollen. Et rigtigt svar åbner én root-shell, og koden er brugt.

Licens	Hvem kan hente svaret
Free og Basic	FairSSL support med en supportsag. Send koden fra konsollen til support.
Professional og Enterprise	Kontoens Ejer og Administrator selv, og FairSSL support med en supportsag.

Licensen skal være gyldig. En licens, der venter på betaling, giver ikke kundens administratorer adgang. Supportsagen står i loggen og kan ses af kunden.

Fem forkerte svar i træk låser i 15 minutter. Derefter viser menuen en ny kode.
sslbrain Cloud logger, hvem der hentede svaret til hvilken kode og hvornår.
Appliancen melder til sslbrain Cloud, når en session åbnes, og når den lukkes. Optagelsen af sessionen sendes med lukningen. Går strømmen, eller stopper konsollen under en session, meldes lukningen med optagelsen, når konsollen starter igen. Er den komprimeret over 2 MiB, sendes slutningen. Ejer og Administrator ser sessionerne og henter optagelserne under Shell-adgang. Optagelsen ligger også på maskinen, se 3 View recorded shell sessions.
Kontoens Ejer og Administratorer med bekræftet e-mailadresse får en mail, hver gang en session faktisk åbnes. At hente et svar sender ingen mail.
Har appliancen ingen forbindelse til sslbrain Cloud, gemmer den hændelserne og sender dem, når forbindelsen er tilbage. Mailen om åbningen kommer da.
En appliance, der endnu ikke er registreret og forbundet med sslbrain Cloud, kan ikke vise en kode. Så kan FairSSL support hjælpe gennem midlertidig SSH.

2 Temporary SSH for support

Åbner SSH i 24 timer, så FairSSL support kan logge ind. Se Support og diagnostik.

3 View recorded shell sessions

Viser de seneste 10 optagelser fra root-shellen med alt, hvad der stod på skærmen. Optagelserne sendes også til sslbrain Cloud. SSH-sessioner optages ikke her.

4 Force an OS update now

Installerer opdateringer til styresystemet nu i stedet for ved den daglige kørsel. En fuld opgradering flytter også pakker, appliancen afhænger af, fx Docker. Skærmen siger, om maskinen skal genstartes. Ellers sker en nødvendig genstart kl. 03:00.

5 Claim new space from the virtual disk

Udvider partition, volume og filsystem til den virtuelle disks størrelse. Selve disken gøres større i hypervisoren.

Sluk den virtuelle maskine.
Gør den virtuelle disk større i hypervisoren.
Start maskinen, og vælg 9 Danger zone, derefter 5 Claim new space from the virtual disk.

6 Reinstall the appliance software (data kept)

Henter den version, der kører, igen, kontrollerer signaturen og opretter containeren på ny. Certifikater, indstillinger, konti og database bliver. Webfladen er væk i nogle minutter. Punktet er en af løsningerne, når en opdatering fejler. Se Når noget ikke virker.

0 Back to the main menu fører tilbage til hovedmenuen.