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

# RDS servers

Il-modulu **RDS servers** idaħħal f’Bastion is-servers Windows Remote Desktop Services li se jospitaw applikazzjonijiet ippubblikati jew desktops remoti. Minn dan l-iskrin, l-amministratur jista’ jiskopri servers minn direttorju, idaħħalhom, jiskjera jew ineħħi l-aġent Bastion fuqhom u joħloq bl-ingrossa applikazzjonijiet li jimmiraw lejn dawk is-servers.

L-applikazzjonijiet li jesponu dawk is-servers lill-utenti huma ddikjarati fil-modulu [Applications](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/Applications/), u jsiru disponibbli permezz ta’ [access contract](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AccessContracts/).

> **Prerekwiżit: id-dominju jrid jippermetti l-ġestjoni tas-servers RDS**
>
> Jidhru f’dan l-iskrin biss id-dominji tal-awtentikazzjoni **LDAP / Active Directory** li għandhom l-għażla **Allow RDS server management** immarkata — hija din l-għażla li tagħmel dominju eliġibbli, u tiġi mmarkata fil-modulu [Authentication domain](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AuthenticationDomain/). Tipi oħra ta’ dominju (direttorju lokali, SAML, anonimu) qatt ma jiġu elenkati, tkun xi tkun il-konfigurazzjoni tagħhom.

---

## Lista tas-servers

L-iskrin prinċipali juri l-lista paġinata tas-servers RDS li diġà ġew iskritti.

### Filtri u tfittxija

| Element | Deskrizzjoni |
|---|---|
| **Domain** | Lista drop-down tad-dominji LDAP eliġibbli. Entrata sintetika **All** tiżdied fil-quċċata biex turi s-servers kollha, ikun x’ikun id-dominju. |
| **Qasam ta’ tfittxija** | Jiffiltra skont parti mit-test fuq is-servers elenkati. It-tfittxija tiskatta 700 ms wara l-aħħar tasta, jew immedjatament b’`Enter`. Il-buttuna tat-tbattil (salib) tbattal it-tfittxija. |
| **Paġinazzjoni** | Selettur tad-daqs tal-paġna (`15`, `25` jew `50`). |
| **Kolonni tal-grilja** | **Name**, **Host**, **LDAP domain**. |

Il-grilja tappoġġja s-selezzjoni multipla. Jintwera messaġġ ta’ stat vojt sakemm ma jiġi rritornat l-ebda server.

### Azzjonijiet tal-istrixxa tal-għodod

Il-buttuni tal-istrixxa tal-għodod huma kuntestwali: dawk li jaġixxu fuq servers eżistenti jibqgħu diżattivati sakemm tintgħażel tal-inqas ringiela waħda.

| Azzjoni | Disponibbiltà | Effett |
|---|---|---|
| **+** — ħjiel **Register RDS servers** | Dejjem disponibbli | Tiftaħ it-tieqa tal-iskrizzjoni bi tliet tabs (ara l-kapitolu [Iskrivi server wieħed jew aktar](#register-one-or-several-servers)). |
| **×** (ħassar) | Selezzjoni ≥ 1 | Tiftaħ it-tieqa tal-konferma (ara l-kapitolu [Ħassar server](#delete-a-server)). |
| **Deploy Agent** | Selezzjoni ≥ 1 | Tiftaħ il-formola biex tiskjera l-aġent Bastion fuq is-servers magħżula (ara l-kapitolu [Deploy Agent (azzjoni diretta)](#deploy-agent-direct-action)). |
| **Remove Agent** | Selezzjoni ≥ 1 | Tiftaħ il-formola biex tiddiżinstalla l-aġent Bastion mis-servers magħżula (ara l-kapitolu [Tneħħija tal-aġent](#agent-removal)). |
| **New applications** | Selezzjoni ≥ 1 | Tiftaħ il-formola tal-ħolqien bl-ingrossa ta’ applikazzjoni, ripetuta għal kull server magħżul (ara l-kapitolu [Ħolqien bl-ingrossa tal-applikazzjonijiet](#bulk-application-creation)). |

---

## Iskrivi server wieħed jew aktar

Il-buttuna **+** tiftaħ tieqa modali bi **tliet tabs**. It-tab **Server registration** hija dejjem attiva. Iż-żewġ l-oħra jsiru attivi biss jekk l-għażla ta’ tal-inqas server wieħed tagħmilhom rilevanti.

**Server registration**

> It-tab turi żewġ pannelli ħdejn xulxin. Fuq ix-xellug, l-iskoperta tas-servers disponibbli fid-direttorju; fuq il-lemin, il-lista tas-servers magħżula għal din l-iskrizzjoni.
>
> | Element | Deskrizzjoni |
> |---|---|
> | **Domain** | Id-dominju LDAP fil-mira. Jillimita l-lista tax-xellug għas-servers ta’ dak id-dominju. |
> | **Qasam ta’ tfittxija** | Filtru skont parti mit-test. Jiskatta wara 1200 ms ta’ inattività jew b’`Enter`. |
> | **Lista tax-xellug** | Servers RDS skoperti fid-dominju (isem, dominju, DNS). Is-servers diġà iskritti jiġu esklużi awtomatikament. Fil-qiegħ hemm disponibbli l-buttuni **Select all** u **Refresh**. |
> | **Lista tal-lemin** | Is-servers magħżula għal din l-iskrizzjoni. It-tkaxkir mil-lista tax-xellug iżid servers; kull karta tista’ titneħħa individwalment bis-salib tal-għeluq tagħha. |
> | **Għaddad** | Juri n-numru ta’ servers magħżula meta mqabbel mal-massimu possibbli, fil-forma ***n* / 200 RDS servers**. |
>
> Għal kull server miżjud fuq il-lemin, jiġu offruti żewġ kaxxi ta’ selezzjoni:
>
> | Kaxxa ta’ selezzjoni | Effett |
> |---|---|
> | **Deploy an agent** | Jimmarka dan is-server għall-iskjerament tal-aġent Bastion fl-istess operazzjoni. Jattiva t-tab **Agent deployment**. |
> | **Create applications** | Timmarka dan is-server għall-ħolqien tal-applikazzjonijiet iddefiniti fit-tab **New applications**. Tattiva dik it-tab. |
>
> Żewġ buttuni, **Deploy an agent** u **Create applications**, imqiegħda fuq il-karti, jagħżlu jew ineħħu l-għażla tal-kaxxa korrispondenti fuq **kull** server magħżul f’daqqa.
>
> > **Limitu tas-selezzjoni**
> >
> > L-ogħla numru ta’ servers li jistgħu jiġu pproċessati f’operazzjoni waħda ta’ skrizzjoni huwa **200 server**. Kull tentattiv biex jiżdiedu servers lil hinn minn dak il-limitu jiġi rrifjutat b’messaġġ ta’ twissija.
>
> > **Dominji li ma jistgħux jintlaħqu**
> >
> > Jekk wieħed mid-dominji kkonsultati ma jwieġibx, messaġġ ta’ żball jelenka d-dominji li fallew u n-numru ta’ tentattivi magħmula (`Error` għal falliment immedjat, `5 retries` wara ħames tentattivi). Is-servers tad-dominji li jistgħu jintlaħqu xorta jintwerew.

**Agent deployment**

> It-tab hija attiva biss jekk tal-inqas server wieħed fil-lista tal-lemin ikollu l-kaxxa ta’ selezzjoni **Agent deployment** magħżula. L-oqsma kollha huma obbligatorji.
>
> | Qasam | Deskrizzjoni |
> |---|---|
> | **Target Server** | Is-server li fuqu jiġi installat l-aġent. **Moħbi u diżattivat fil-modalità multi-server**: il-mira mbagħad tiġi kkalkulata mis-servers magħżula. |
> | **Target drive** | L-ittra tad-drajv li fuqu għandu jiġi installat l-aġent. |
> | **Target directory** | Il-mogħdija tal-installazzjoni tal-aġent fuq is-server. Il-karattri `"` u `'` jiġu rrifjutati waqt id-dħul. |
> | **Gateway** | Komponent Edge Gateway ta’ Bastion li jmexxi l-iskjerament. |
> | **Domain** | Id-dominju tal-awtentikazzjoni tal-kont tal-installazzjoni. |
> | **Username** | Kont li għandu d-dritt jinstalla softwer fuq is-server fil-mira. |
> | **Password** | Il-password tal-kont tal-installazzjoni (moħbija). |

**New applications**

> It-tab hija attiva biss jekk tal-inqas server wieħed fil-lista tal-lemin ikollu l-kaxxa ta’ selezzjoni **New applications** magħżula.
>
> It-tab turi grilja ta’ **mudelli ta’ applikazzjoni** li għandhom jinħolqu fuq kull server magħżul. Tliet azzjonijiet:
>
> | Buttuna | Effett |
> |---|---|
> | **+** — ħjiel **New application template** | Tiftaħ il-formola taż-żieda ta’ applikazzjoni fil-modalità raggruppata. Jiġu offruti biss it-tipi ta’ servizz **RDP** u **HTML5 RDP**. |
> | **Edit** | Attiva meta tkun magħżula eżattament ringiela waħda. |
> | **×** | Tneħħi l-mudelli magħżula. |
>
> Kolonni tal-grilja:
>
> | Kolonna | Kontenut |
> |---|---|
> | **Name** | Isem il-mudell, preċedut mill-ikona tat-tip ta’ servizz. |
> | **Recording** | Indikatur viżiv tal-għażla tar-reġistrazzjoni tal-vidjo. |
> | **SSO / Remote application / Working directory** | Sommarju tal-modalità SSO magħżula (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), tal-alias fakultattiv, tal-isem tal-applikazzjoni remota (RemoteApp) u tal-folder tat-tnedija. |
>
> L-ismijiet tal-mudelli jridu jkunu **uniċi** fil-lista: duplikat jiġi rrifjutat b’twissija.
>
> > **Isem varjabbli għall-mudell**
> >
> > Biex tiġġenera isem differenti għal kull server, uża l-karattri `{` u `}` fil-qasam **Name** tal-mudell. Mingħajr il-parentesi graffa, l-isem tas-server jiżdied fl-aħħar tal-isem tal-mudell. Bil-parentesi graffa, jissostitwixxi `{}`.
> >
> > - Mudell `Application RDP` applikat għas-server `srv1` → `Application RDP srv1`
> > - Mudell `Application {} RDP` applikat għas-server `srv1` → `Application srv1 RDP`

### Validazzjoni u rapport

Il-buttuna **Validate** tiġi attivata biss jekk:

- tal-inqas server wieħed ikun fil-lista tal-lemin,
- it-tab **Agent deployment** tkun valida (meta meħtieġa),
- it-tab **New applications** ikun fiha tal-inqas mudell wieħed (meta meħtieġa).

Meta tibgħat il-formola, tinfetaħ tieqa ta’ **rapport**, b’tab waħda għal kull operazzjoni (skrizzjoni, skjerament tal-aġent, ħolqien tal-applikazzjonijiet). Kull ringiela tirċievi status hekk kif timxi ’l quddiem: *għaddej*, *suċċess*, *żball ġeneriku*, *permess miċħud*, *aġent diġà preżenti* jew *status mhux magħruf (l-ebda tweġiba)*. Il-buttuna **Close** tiġi attivata biss ladarba l-operazzjonijiet kollha jkunu spiċċaw.

> **Segwiment tal-installazzjoni tal-aġent**
>
> L-installazzjoni tal-aġent hija asinkronika, għalhekk ir-rapport jikkonsulta s-server kull 5 sekondi biex jaġġorna l-istatus sakemm ix-xogħol ikun immarkat `INPROGRESS`.

---

## Deploy Agent (azzjoni diretta)

Il-buttuna **Deploy Agent** fl-istrixxa tal-għodod tiftaħ direttament il-formola tal-iskjerament, mimlija minn qabel bis-servers magħżula fil-lista prinċipali — il-qasam **Target Server** imbagħad ikun fih l-ismijiet tagħhom, separati b’virgoli.

L-oqsma huma dawk tat-tab **Agent deployment** fil-kapitolu [Iskrivi server wieħed jew aktar](#register-one-or-several-servers), b’differenza waħda: hawn **Target Server** huwa viżibbli u jista’ jiġi editjat, għax il-modalità multi-server ma tapplikax. L-oqsma kollha huma obbligatorji.

Meta tibgħat il-formola, il-grilja prinċipali tiġi msakkra waqt l-operazzjoni u konsultazzjoni perjodika (kull 5 sekondi) taġġorna l-istatus tal-installazzjoni sakemm titlesta.

---

## Tneħħija tal-aġent

Il-buttuna **Remove Agent** fl-istrixxa tal-għodod tiftaħ il-formola tad-diżinstallazzjoni tal-aġent għas-servers magħżula.

| Qasam | Deskrizzjoni |
|---|---|
| **Target Server** | Is-servers ikkonċernati, mimlija minn qabel u separati b’virgoli. |
| **Gateway** | Komponent Edge Gateway ta’ Bastion użat biex imexxi d-diżinstallazzjoni. |
| **Domain** | Id-dominju tal-awtentikazzjoni tal-kont tal-amministrazzjoni. |
| **Username** | Kont li għandu d-dritt jiddiżinstalla l-aġent fuq is-server. |
| **Password** | Il-password tal-kont (moħbija). |

L-oqsma kollha huma obbligatorji.

---

## Ħassar server

Il-buttuna **×** fl-istrixxa tal-għodod tiftaħ tieqa ta’ konferma. It-test introduttiv jadatta ruħu għas-selezzjoni (server wieħed jew diversi servers).

Jiġu offruti żewġ għażliet indipendenti:

| Għażla | Effett |
|---|---|
| **Delete Bastion agents** | Jekk immarkat, il-proċedura tad-diżinstallazzjoni titħaddem fuq is-servers ikkonċernati fil-mument tat-tħassir. It-tieqa tad-diżinstallazzjoni (kapitolu [Tneħħija tal-aġent](#agent-removal)) imbagħad tinfetaħ wara biex tiġbor il-parametri tal-aċċess. |
| **Delete related applications** | Jekk magħżula, l-applikazzjonijiet li jimmiraw lejn dawn is-servers jitħassru fl-istess ħin. |

Meta tibgħat il-formola, tieqa ta’ rapport tagħti sommarju tar-riżultat ta’ kull operazzjoni.

> **Tħassir mingħajr tneħħija tal-aġent**
>
> Jekk il-kaxxa ta’ selezzjoni tad-diżinstallazzjoni mhijiex immarkata, l-entrata tas-server titneħħa minn Bastion iżda l-aġent jibqa’ installat fuq il-kompjuter. Ikollu jiġi diżinstallat manwalment jew permezz ta’ operazzjoni ġdida **Remove Agent**.

---

## Ħolqien bl-ingrossa tal-applikazzjonijiet

Il-buttuna **New applications** fl-istrixxa tal-għodod tiftaħ il-formola taż-żieda ta’ applikazzjonijiet raggruppati, mingħajr pass preliminari ta’ skrizzjoni. Il-formola hija dik tal-modulu **Applications**, limitata għat-tipi ta’ servizz **RDP** u **HTML5 RDP**.

Meta tibgħat il-formola, l-applikazzjoni tinħoloq fuq kull server magħżul fil-lista prinċipali, billi jiġi applikat il-mekkaniżmu tal-ismijiet varjabbli deskritt fil-kapitolu [Iskrivi server wieħed jew aktar](#register-one-or-several-servers) (l-użu ta’ `{}` biex jiddaħħal l-isem tas-server). It-tieqa tar-rapport turi r-riżultat ringiela b’ringiela.
