Připojení k jiné databázi

Tato příručka vás provede přesměrováním stávající instance Team assistant na jiný databázový server Microsoft SQL Server. Upravíte soubor prostředí Docker Compose, spustíte upgrade schématu a restartujete služby z nabídky tas-manager.

Předpoklady

Než připojíte novou databázi, dodržte tato pravidla — jejich ignorování může poškodit data:

  1. Verze Team assistant musí být novější než verze schématu stávající databáze, nebo musí být schéma databáze prázdné. Starší Team assistant nesmí být nikdy připojen k novějšímu schématu.
  2. K dané databázi smí být připojena pouze jedna instance Team assistant. Připojení druhé instance ke stejné databázi ji poškodí.
  3. Pokud je nová databáze klonem jiného prostředí, zakažte crony Team assistant před připojením nové instance, aby se klonované naplánované úlohy nespustily. Spusťte proti databázi tento SQL příkaz:
    UPDATE CRONS SET CRON_STATUS='N'
  4. Pokud je verze Team assistant novější než nově připojená databáze, je nutné migraci schématu databáze spustit ručně (krok 5 níže).
Ignorování těchto pravidel — zejména připojení starší verze k novějšímu schématu nebo připojení druhé instance ke stejné databázi — může nevratně poškodit data.

Postup

1. Otevřete systémový shell

V hlavní nabídce přejděte na:

Správa → Systém → [!] Otevřít systémový shell (pouze pro zkušené uživatele)

Potvrďte varovné okno. Nyní jste na příkazovém řádku shellu. Soubor prostředí Docker Compose, který budete upravovat, je $TAS_COMPOSE_PATH/.env (výchozí ~/tas-compose/.env).

2. Otevřete soubor prostředí v editoru nano

Otevřete soubor v textovém editoru nano:

nano "$TAS_COMPOSE_PATH/.env"

Práce v editoru nano:

  • Pohybujte se šipkami a přímo pište pro úpravy.
  • Uložení: stiskněte Ctrl+O, poté Enter pro potvrzení názvu souboru.
  • Ukončení: stiskněte Ctrl+X.
  • Ukončení bez uložení: stiskněte Ctrl+X, poté N na dotaz, zda uložit.

3. Přidejte nebo upravte proměnné databáze

Nastavte následující povinné proměnné. Pokud proměnná v souboru již existuje, upravte její hodnotu na místě; jinak ji přidejte na nový řádek.

Proměnná

Účel

Příklad

TAS_DB_VENDOR

Databázový engine (SQL Server)

mssql

TAS_DB_HOSTNAME

Hostname nebo IP databázového serveru

sql.example.local

TAS_DB_PORT

Port TCP

1433

TAS_DB_NAME

Název databáze

TAS

TAS_DB_SCHEMA

Název schématu

tas

TAS_DB_USERNAME

Přihlašovací uživatel

tas_app

TAS_DB_PASSWORD

Přihlašovací heslo

your-password

Níže uvedené proměnné jsou volitelné — nastavte je pouze tehdy, když je cílový server vyžaduje. Přesné hodnoty konzultujte se svým správcem databáze nebo v poznámkách k vydání Team assistant.

Proměnná

Účel

TAS_DB_ENCRYPTION

Povolení šifrování TLS pro připojení

TAS_DB_ENCRYPTION_IGNORE_CERTIFICATE

Důvěřovat certifikátu serveru (např. self-signed)

TAS_DB_ENCRYPTION_METHOD

Metoda šifrování TLS

TAS_DB_NTLM_AUTH_ENABLED

Povolení ověřování Windows/NTLM

TAS_DB_NTLM_AUTH_DOMAIN

Doména ověřování NTLM

TAS_DB_MAX_POOL_CONNECTION

Maximální velikost fondu připojení

TAS_DB_MAX_ROWS

Maximální počet řádků vrácených na dotaz

TAS_DB_REQUEST_TIMEOUT

Časový limit požadavku dotazu

Neodstraňujte nesouvisející klíče, které spravuje tas-manager (například TAS_FRONTEND_IMAGE, TAS_BACKEND_IMAGE, TAS_COMPOSE_DB_BACKUP_PATH).

4. Uložte a vraťte se do nabídky

Uložte soubor (Ctrl+O, Enter) a ukončete nano (Ctrl+X). Poté zadejte exit pro opuštění systémového shellu a návrat do nabídky tas-manager.

5. Spusťte upgrade schématu databáze

V hlavní nabídce přejděte na:

Správa → Team assistant → Spustit upgrade schématu databáze

Potvrďte dotaz a počkejte na dokončení.

Spuštění se doporučuje pokaždé, abyste měli jistotu, že schéma odpovídá nasazené verzi Team assistant. Přeskočit jej lze pouze tehdy, když je schéma cílové databáze již na přesně stejné verzi jako Team assistant — jeho spuštění je v takovém případě neškodné.

6. Restartujte služby Team assistant

V hlavní nabídce přejděte na:

Správa → Team assistant → Spravovat služby → Restartovat Team assistant

Tím se restartují tas-frontend, tas-backend a tas-backend-cron. Použijte místo toho Restartovat všechny služby, chcete-li restartovat celou sadu.

Restart se doporučuje pokaždé, aby se nové nastavení databáze projevilo; striktně vzato je zbytečný pouze tehdy, když už bylo schéma aktuální a služby byly po změně souboru .env již restartovány. V případě pochybností restartujte.

Řešení potíží

Databáze nedostupná / connection refused

Ověřte TAS_DB_HOSTNAME a TAS_DB_PORT. Zkontrolujte, že je databázový server ze shellu dostupný (síťová trasa, firewall) a že SQL Server přijímá připojení TCP na daném portu.

Přihlášení selhalo / nesprávné přihlašovací údaje

Znovu zkontrolujte TAS_DB_USERNAME, TAS_DB_PASSWORD a TAS_DB_NAME. Ověřte, že přihlášení na cílovém serveru existuje a má práva k databázi a schématu TAS_DB_SCHEMA.

Chyby TLS / certifikátu

Nastavte TAS_DB_ENCRYPTION tak, aby odpovídalo požadavku serveru. Pro self-signed nebo nedůvěryhodný certifikát nastavte TAS_DB_ENCRYPTION_IGNORE_CERTIFICATE.

Neshoda verze schématu / migrace odmítá běžet

Toto je pravidlo 1: verze Team assistant musí být novější než schéma, nebo musí být schéma prázdné. Ověřte verze a spusťte upgrade schématu (krok 5).

Klonovaná databáze stále spouští naplánované úlohy

Toto je pravidlo 3: před spuštěním instance spusťte proti databázi UPDATE CRONS SET CRON_STATUS='N'.

Podrobnosti najdete ve výstupu spouštění zobrazeném přes Spravovat služby a v protokolech kontejnerů. Podrobné pokyny k diagnostice — kontrola stavu služeb, čtení protokolů a testování připojení k databázi — viz článek Diagnostika stavu služeb Team assistant.

Frantisek Brych Updated by Frantisek Brych

Diagnostika služeb

Contact

Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)