> For the complete documentation index, see [llms.txt](https://knjiga.edostava.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knjiga.edostava.me/prirucnik/solucije/trustpoint/instalacija.md).

# Instalacija

Instalacija TrustPointa pomoću Ansible automatizacije

Nove verzije TrustPointa instaliraju se, konfigurišu i nadograđuju pomoću Ansible automatizacije. Isti postupak podržava **Rocky Linux 9** i **Red Hat Enterprise Linux 9**, kao i **SINGLE** i **SPLIT** topologije.

{% hint style="info" %}
Za pristup TrustPoint automatizaciji, paketskom repozitorijumu i odgovarajućoj licenci obratite se TrustPoint podršci.
{% endhint %}

### Preduslovi

Prije početka pripremite:

* jedan server za SINGLE ili dva servera za SPLIT topologiju;
* instaliran Rocky Linux 9 ili Red Hat Enterprise Linux 9;
* administratorski SSH pristup serverima;
* DNS zapise i TLS sertifikate za TrustPoint i SSO adrese;
* pristupne podatke za TrustPoint paketski repozitorijum;
* odvojenu lokaciju za backup, preporučeno NFS spremište;
* računar sa instaliranim Gitom i `ansible-core` verzije 2.14 ili novije.

### 1. Pripremite konfiguraciju

Preuzmite TrustPoint Ansible paket, otvorite njegov root direktorijum i pripremite lokalnu Ansible konfiguraciju:

```bash
cp ansible.cfg.example ansible.cfg
ansible-galaxy collection install -r requirements.yml
```

Zatim izaberite željenu topologiju:

{% tabs %}
{% tab title="SINGLE" %}
TrustPoint aplikacija i SSO servis instaliraju se na jednom serveru.

```bash
cp inventory/single-example.yml inventory/moj-sajt.yml
```

{% endtab %}

{% tab title="SPLIT" %}
TrustPoint aplikacija i SSO servis instaliraju se na odvojenim serverima.

```bash
cp inventory/split-example.yml inventory/moj-sajt.yml
```

{% endtab %}
{% endtabs %}

U fajlu `inventory/moj-sajt.yml` unesite podatke označene sa `PRILAGODITI`. Obavezno provjerite:

* naziv sajta i izabranu distribuciju;
* ciljnu TrustPoint i Keycloak verziju;
* adrese servera i SSH korisnika;
* DNS imena i TLS konfiguraciju;
* backup lokaciju;
* opcione SMTP i licencne postavke.

Tajne čuvajte u šifrovanom Ansible Vault fajlu:

```bash
mkdir -p inventory/group_vars/all
ansible-vault create inventory/group_vars/all/vault.yml
```

Minimalni sadržaj Vaulta je:

```yaml
vault_tp_repo_username: "<repo-korisnik>"
vault_tp_repo_password: "<repo-lozinka>"
vault_tp_restic_password: "<jaka-restic-lozinka>"
```

{% hint style="warning" %}
Lozinke, privatne ključeve i druge tajne nemojte čuvati kao običan tekst u inventoryju ili Git repozitorijumu.
{% endhint %}

### 2. Provjerite okruženje

Pokrenite assessment ciljnog okruženja:

```bash
ansible-playbook -i inventory/moj-sajt.yml playbooks/assess.yml
```

Pregledajte završni verdict u izvještaju koji je kreiran u direktorijumu `reports/<ime-sajta>/`. Prije implementacije otklonite sve nalaze označene kao `BLOCK`.

### 3. Instalirajte ili nadogradite TrustPoint

Kada assessment potvrdi da je okruženje spremno, pokrenite:

```bash
ansible-playbook -i inventory/moj-sajt.yml playbooks/implement.yml
```

Automatizacija će uskladiti servere sa konfiguracijom iz inventoryja, uključujući instalaciju ili nadogradnju komponenti, sistemsku konfiguraciju, SELinux pravila, firewall, TLS, backup i podržane TrustPoint servise.

Ista komanda može se ponovo pokrenuti nakon promjene konfiguracije. Ansible će primijeniti samo potrebne izmjene kako bi sistem doveo u definisano stanje.

### Nakon instalacije

Po završetku:

1. otvorite TrustPoint i SSO adrese definisane u inventoryju;
2. preuzmite generisane inicijalne pristupne podatke iz direktorijuma `exports/<ime-sajta>/` i sačuvajte ih na sigurnom mjestu;
3. napravite prvi backup:

```bash
ansible-playbook -i inventory/moj-sajt.yml playbooks/backup-run.yml
```

{% hint style="success" %}
TrustPoint je instaliran kada se `implement.yml` završi bez greške, servisi su dostupni, a završne funkcionalne provjere prođu uspješno.
{% endhint %}

### Podrška

Za planiranje produkcione implementacije, migracije, Disaster Recovery okruženja ili eksternalizaciju operativnih poslova kontaktirajte TrustPoint podršku.
