> Source: https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/RDSServers/

# RDS servers

**RDS servers** moodul registreerib Bastion platvormis Windows Remote Desktop Services serverid, mis majutavad avaldatud rakendusi või kaugtöölaudu. Sellelt kuvalt saab administraator kataloogist servereid avastada, need registreerida, neile Bastion agendi juurutada või sealt eemaldada ning luua hulgi nendele serveritele suunatud rakendusi.

Rakendused, mis neid servereid kasutajatele avaldavad, deklareeritakse moodulis [Applications](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/Applications/) ja tehakse kättesaadavaks [access contract](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AccessContracts/) lepingu kaudu.

> **Eeltingimus: domeen peab lubama RDS-serverite haldamist**
>
> Sellel kuval kuvatakse ainult **LDAP / Active Directory** autentimisdomeenid, millel on märgitud suvand **Allow RDS server management** — just see suvand muudab domeeni sobivaks ja see märgitakse moodulis [Authentication domain](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AuthenticationDomain/). Muid domeenitüüpe (kohalik kataloog, SAML, anonüümne) ei loetleta kunagi, olenemata nende konfiguratsioonist.

---

## Serverite loend

Põhikuval kuvatakse juba registreeritud RDS-serverite lehekülgedeks jaotatud loend.

### Filtrid ja otsing

| Element | Kirjeldus |
|---|---|
| **Domain** | Sobivate LDAP-domeenide ripploend. Ülaossa lisatakse sünteetiline kirje **All**, mis näitab kõiki servereid olenemata domeenist. |
| **Otsinguväli** | Filtreerib loendis olevaid servereid alamstringi järgi. Otsing käivitub 700 ms pärast viimast klahvivajutust või kohe klahviga `Enter`. Tühjendusnupp (rist) lähtestab otsingu. |
| **Pagination** | Lehekülje suuruse valija (`15`, `25` või `50`). |
| **Tabeli veerud** | **Name**, **Host**, **LDAP domain**. |

Tabel toetab mitmikvalikut. Kuni ühtegi serverit ei tagastata, kuvatakse tühja oleku teade.

### Tööriistariba toimingud

Tööriistariba nupud on kontekstipõhised: olemasolevatele serveritele toimivad nupud jäävad välja lülitatuks, kuni on valitud vähemalt üks rida.

| Toiming | Saadavus | Mõju |
|---|---|---|
| **+** — kohtspikker **Register RDS servers** | Alati saadaval | Avab kolme vahekaardiga registreerimisakna (vt peatükki [Ühe või mitme serveri registreerimine](#register-one-or-several-servers)). |
| **×** (Kustuta) | Valik ≥ 1 | Avab kinnitusakna (vt peatükki [Serveri kustutamine](#delete-a-server)). |
| **Deploy Agent** | Valik ≥ 1 | Avab vormi Bastion agendi juurutamiseks valitud serveritesse (vt peatükki [Deploy Agent (otsetoiming)](#deploy-agent-direct-action)). |
| **Remove Agent** | Valik ≥ 1 | Avab vormi Bastion agendi desinstallimiseks valitud serveritest (vt peatükki [Agendi eemaldamine](#agent-removal)). |
| **New applications** | Valik ≥ 1 | Avab rakenduse hulgiloomise vormi, mida korratakse iga valitud serveri jaoks (vt peatükki [Rakenduste hulgiloomine](#bulk-application-creation)). |

---

## Ühe või mitme serveri registreerimine

Nupp **+** avab **kolme vahekaardiga** modaalakna. Vahekaart **Server registration** on alati aktiivne. Ülejäänud kaks muutuvad aktiivseks ainult siis, kui vähemalt ühe serveri valik muudab need asjakohaseks.

**Server registration**

> Vahekaardil on kaks kõrvuti paani. Vasakul kataloogis saadaolevate serverite tuvastamine; paremal selle registreerimise jaoks valitud serverite loend.
>
> | Element | Kirjeldus |
> |---|---|
> | **Domain** | Siht-LDAP-domeen. Piirab vasakpoolse loendi selle domeeni serveritega. |
> | **Otsinguväli** | Alamstringi filter. Käivitub pärast 1200 ms tegevusetust või klahviga `Enter`. |
> | **Vasakpoolne loend** | Domeenis tuvastatud RDS-serverid (nimi, domeen, DNS). Juba registreeritud serverid jäetakse automaatselt välja. Allosas on saadaval nupud **Select all** ja **Refresh**. |
> | **Parempoolne loend** | Selle registreerimise jaoks valitud serverid. Vasakpoolsest loendist pukseerimine lisab servereid; iga paani saab eraldi eemaldada selle sulgemisristiga. |
> | **Loendur** | Näitab valitud serverite arvu lubatud maksimumi suhtes kujul ***n* / 200 RDS servers**. |
>
> Iga paremale lisatud serveri jaoks pakutakse kahte märkeruutu:
>
> | Märkeruut | Mõju |
> |---|---|
> | **Deploy an agent** | Märgib selle serveri samas toimingus Bastion agendi juurutamiseks. Aktiveerib vahekaardi **Agent deployment**. |
> | **Create applications** | Märgib selle serveri vahekaardil **New applications** määratletud rakenduste loomiseks. Aktiveerib selle vahekaardi. |
>
> Paanide kohal asuvad kaks nuppu, **Deploy an agent** ja **Create applications**, märgivad või tühjendavad vastava märkeruudu **kõigis** valitud serverites korraga.
>
> > **Valiku piirang**
> >
> > Ühes registreerimistoimingus saab töödelda kuni **200 serverit**. Iga katse lisada servereid üle selle piiri lükatakse hoiatusteatega tagasi.
>
> > **Kättesaamatud domeenid**
> >
> > Kui mõni päritud domeenidest ei vasta, loetleb tõrketeade nurjunud domeenid ja tehtud katsete arvu (`Error` kohese nurjumise korral, `5 retries` pärast viit katset). Kättesaadavate domeenide serverid kuvatakse siiski.

**Agent deployment**

> Vahekaart on aktiivne ainult siis, kui vähemalt ühel parempoolse loendi serveril on märkeruut **Agent deployment** märgitud. Kõik väljad on kohustuslikud.
>
> | Väli | Kirjeldus |
> |---|---|
> | **Target Server** | Server, kuhu agent paigaldatakse. **Mitme serveri režiimis peidetud ja välja lülitatud**: siht arvutatakse siis valitud serverite põhjal. |
> | **Target drive** | Draivi täht, kuhu agent installitakse. |
> | **Target directory** | Agendi installitee serveris. Märgid `"` ja `'` lükatakse sisestamisel tagasi. |
> | **Gateway** | Juurutamist juhtiv Bastion Edge Gateway server. |
> | **Domain** | Installikonto autentimisdomeen. |
> | **Username** | Konto, millel on lubatud sihtserverisse tarkvara installida. |
> | **Password** | Installikonto parool (maskitud). |

**New applications**

> Vahekaart on aktiivne ainult siis, kui vähemalt ühel parempoolse loendi serveril on märkeruut **New applications** märgitud.
>
> Vahekaardil kuvatakse tabel **rakendusmallidega**, mis luuakse igasse valitud serverisse. Kolm toimingut:
>
> | Nupp | Toime |
> |---|---|
> | **+** — kohtspikker **New application template** | Avab rakenduse lisamisvormi rühmarežiimis. Pakutakse ainult teenusetüüpe **RDP** ja **HTML5 RDP**. |
> | **Edit** | Aktiivne, kui on valitud täpselt üks rida. |
> | **×** | Eemaldab valitud mallid. |
>
> Tabeli veerud:
>
> | Veerg | Sisu |
> |---|---|
> | **Name** | Malli nimi, mille ees on teenusetüübi ikoon. |
> | **Recording** | Videosalvestamise suvandi visuaalne tähis. |
> | **SSO / Remote application / Working directory** | Kokkuvõte valitud SSO-režiimist (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), valikulisest aliasest, kaugrakenduse nimest (RemoteApp) ja käivituskaustast. |
>
> Mallide nimed peavad loendis olema **kordumatud**: duplikaat lükatakse hoiatusega tagasi.
>
> > **Malli nime muutujastamine**
> >
> > Iga serveri jaoks erineva nime genereerimiseks kasutage malli väljal **Name** märke `{` ja `}`. Ilma looksulgudeta lisatakse serveri nimi malli nime lõppu. Looksulgudega asendab see märgid `{}`.
> >
> > - Mall `Application RDP`, rakendatuna serverile `srv1` → `Application RDP srv1`
> > - Mall `Application {} RDP`, rakendatuna serverile `srv1` → `Application srv1 RDP`

### Kinnitamine ja aruanne

Nupp **Validate** muutub aktiivseks ainult siis, kui:

- parempoolses loendis on vähemalt üks server,
- vahekaart **Agent deployment** on kehtiv (kui see on nõutud),
- vahekaart **New applications** sisaldab vähemalt üht malli (kui see on nõutud).

Esitamisel avaneb **aruande** aken, kus on iga toimingu jaoks oma vahekaart (registreerimine, agendi juurutamine, rakenduste loomine). Iga rida saab edenedes oleku: *käimas*, *õnnestus*, *üldine tõrge*, *luba puudub*, *agent on juba olemas* või *tundmatu olek (vastus puudub)*. Nupp **Close** muutub aktiivseks alles siis, kui kõik toimingud on lõpule jõudnud.

> **Agendi installimise jälgimine**
>
> Agendi installimine on asünkroonne, seega küsitleb aruanne serverit iga 5 sekundi järel, et olekut värskendada, kuni töö on märgitud olekuga `INPROGRESS`.

---

## Deploy Agent (otsetoiming)

Tööriistariba nupp **Deploy Agent** avab juurutamisvormi otse, eeltäidetuna põhiloendis valitud serveritega — väli **Target Server** sisaldab siis nende nimesid komadega eraldatult.

Väljad on samad mis peatüki [Ühe või mitme serveri registreerimine](#register-one-or-several-servers) vahekaardil **Agent deployment**, ühe erinevusega: **Target Server** on siin nähtav ja redigeeritav, sest mitme serveri režiim ei kehti. Kõik väljad on kohustuslikud.

Esitamisel lukustatakse põhitabel toimingu ajaks ning perioodiline päring (iga 5 sekundi järel) värskendab installimise olekut kuni lõpuni.

---

## Agendi eemaldamine

Tööriistariba nupp **Remove Agent** avab valitud serverite jaoks agendi desinstallimise vormi.

| Väli | Kirjeldus |
|---|---|
| **Target Server** | Asjaomased serverid, eeltäidetud ja komadega eraldatud. |
| **Gateway** | Desinstallimise juhtimiseks kasutatav Bastion Edge Gateway server. |
| **Domain** | Administraatorikonto autentimisdomeen. |
| **Username** | Konto, millel on lubatud serverist agent desinstallida. |
| **Password** | Konto parool (maskitud). |

Kõik väljad on kohustuslikud.

---

## Serveri kustutamine

Tööriistariba nupp **×** avab kinnitusakna. Sissejuhatav tekst kohandub valikuga (üks server või mitu serverit).

Pakutakse kahte teineteisest sõltumatut suvandit:

| Suvand | Mõju |
|---|---|
| **Delete Bastion agents** | Kui see on märgitud, käivitatakse kustutamise ajal asjaomastes serverites desinstallimisprotseduur. Seejärel avatakse järgmisena desinstallimisaken (peatükk [Agendi eemaldamine](#agent-removal)), et koguda juurdepääsuparameetrid. |
| **Delete related applications** | Kui see on märgitud, kustutatakse samal ajal ka neid servereid sihtivad rakendused. |

Esitamisel kuvab aruandeaken iga toimingu tulemuse kokkuvõtte.

> **Kustutamine ilma agenti eemaldamata**
>
> Kui desinstallimise märkeruut pole märgitud, eemaldatakse serveri kirje Bastion platvormist, kuid agent jääb arvutisse installituks. See tuleb desinstallida käsitsi või uue toiminguga **Remove Agent**.

---

## Rakenduste hulgiloomine

Tööriistariba nupp **New applications** avab rakenduste rühmalisamise vormi ilma eelneva registreerimisetapita. See on mooduli **Applications** vorm, mis on piiratud teenusetüüpidega **RDP** ja **HTML5 RDP**.

Esitamisel luuakse rakendus igasse põhiloendis valitud serverisse, rakendades peatükis [Ühe või mitme serveri registreerimine](#register-one-or-several-servers) kirjeldatud nime muutujastamise mehhanismi (`{}` kasutamine serveri nime lisamiseks). Aruandeaken näitab tulemust rida-realt.
