CLI-viite

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # yhdyskäytäväyksikön loki (oletus; seuraa)
aihummer logs --no-follow     # tulosta lokin loppu ja poistu
aihummer logs aihummer-stt    # toisen systemd-yksikön loki
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Se `aihummer` Komentorivityökalu hallinnoi isäntäkohtaisia asennuksia: se käynnistää ja päivittää portin (asennus itsessään tehdään henkilökohtaisen asennuslinkin kautta tilisi portaalista), ohjaa portin systemd-palvelua, suorittaa diagnostiikkaa, käsittelee varmuuskopioita, lukee ja kirjoittaa ohjaustason asetuksia sekä allekirjoittaa lisenssejä. Tämä sivu luettelee kaikki komennot. ## Komennot | Komento | Mitä se tekee | |---|---| | `up` / `install` | Käynnistä gateway systemd -palvelu (`systemctl start`). Se ei asenna mitään — asennuksen suorittaa asennusskripti henkilökohtaisesta linkistäsi. | | `update [--check]` | Päivitä uusimpaan julkaisuun (tarkista allekirjoitus + vaihda binääri + käynnistä uudelleen); `--check` ilmoittaa vain, onko päivitys saatavilla. | | `restart` | Käynnistä uudelleen porttipalvelu (`systemctl restart`). | | `stop` | Pysäytä yhdyskäytäväpalvelu (`systemctl stop`). | | `logs [unit] [--no-follow]` | Seuraa yhden systemd-yksikön lokia (`journalctl -u`); oletuksena yhdyskäytäväyksikköön. `--no-follow` tulostaa lokin lopun ja poistuu; ilman sitä komento jatkaa seuraamista. | | `status` | Asennuksen yleiskatsaus, palvelujen tila ja yhdyskäytävän valmius (`/readyz`). **Komponentit**-osio raportoi valinnaisten sivuvaunuyksiköiden tilan (haku, selain, puheesta tekstiksi, tekstistä puheeksi, video); kun `systemctl` ei ole käytettävissä, se sanoo rehellisesti tilan olevan tuntematon eikä väitä "ei asennettu". | | `doctor` | Diagnostiikka kolmella tuomiolla: kaikki kunnossa, käynnissä varoituksin (N) tai ongelmia löytyi. Node.js:n ja laivastorekisteröintimateriaalin tarkistukset ovat varoituksia, eivät virheitä. | | `backup [dir]` | `pg_dump` PostgreSQL-tilataso tiedostoon; oletushakemistoa käytetään, kun sitä ei ole määritetty. | | `restore <file>` | Palauta PostgreSQL dump-tiedostosta, jonka on tuottanut `backup`. | | `uninstall [flags]` | Poista asennus (katso alla olevat liput). Vaatii root-oikeudet — suorita se `sudo`. | | `set-password` / `admin-password` | Aseta/luo paikallisen järjestelmänvalvojan salasana (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Luku-/kirjoitusohjaimen asetukset tietokannassa — näin Settings-katalogin säätimet määritetään CLI:stä sen sijaan, että `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Hallitse lisenssejä: luo avain, allekirjoita, dekoodaa ja varmista annettu tunniste. | | `loadtest` | Suorita kuormitustesti porttikäyttöliittymää vastaan. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Laajennus-SDK: rakenna, validoi, avaimet, pakkaa, allekirjoita ja julkaise. | | `version` | Tulosta versio. | | `help` | Näytä ohjeet. | ### `uninstall` liput | Lippu | Vaikutus | |---|---| | `--purge` | Poista myös tiedot (täydellinen poisto). | | `--yes` | Ohita vahvistuskehote. | | `--no-backup` | Älä ota varmuuskopiota ennen poistoa. | | `--backup-dir <dir>` | Kirjoita esiasennuksen poiston varmuuskopio tähän hakemistoon. | ## Käyttöesimerkkejä ### Asenna ja käynnistä Asennus tapahtuu henkilökohtaisen asennuslinkin kautta tilisi portaalista (katso [Asennus](/fi/v1.0/getting-started/installation)); sen jälkeen CLI käynnistyy ja tarkistaa palvelun: ```bash sudo aihummer up aihummer status ``` ### Päivittää ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Palvelun hallinta ja lokit Komennot vaikuttavat yksittäiseen gateway-järjestelmäyksikköön (`AIHUMMER_SERVICE`, oletus `aihummer-gateway`); `logs` hyväksyy minkä tahansa systemd-yksikön nimen. ```bash sudo aihummer restart aihummer logs # yhdyskäytäväyksikön loki (oletus; seuraa) aihummer logs --no-follow # tulosta lokin loppu ja poistu aihummer logs aihummer-stt # toisen systemd-yksikön loki sudo aihummer stop ``` ### Diagnostiikka ```bash aihummer doctor ``` ### Varmuuskopiointi ja palauttaminen `backup` juoksee `pg_dump` PostgreSQL-tilan tasosta tiedostoon; `restore` ottaa sen lähtötiedoston. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres on totuuden lähde, mutta sinun `AIHUMMER_MASTER_KEY` ja läikkä > hakemisto on varmuuskopioitava erikseen — ilman pääavainta, salattuna > salaisuuksia ei voida palauttaa. ### Aseta ylläpitäjän salasana Komentoa hyväksytään `[--login admin] [--password X]` ja tarpeet `AIHUMMER_DATABASE_URL` — yleensä poimittu jostakin `gateway.env` kun suoritetaan asennuskäyttäjänä tai kautta `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Ohjaustason asetukset `settings` lukee ja kirjoittaa Asetukset-luettelon säätimiä suoraan tietokantaan — samaan tietokantaan, jota verkko-hallinta-UI (Hallinta → Asetukset) muokkaa. Näin luettelon säätimet määritetään CLI:stä: `gateway.env` arvot jätetään heille huomiotta. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` näyttää vain käyttäjälle näkyvät luettelon avaimet (järjestelmä- ja sisäiset avaimet on piilotettu); jokainen avain on merkitty sen lähteellä — `[db]` asetuksiasi varten, `[unset]` muuten katalogin oletusarvolla. ### Lisenssit `license show` vaatii `<token>` väittely ja se `AIHUMMER_LICENSE_PUBKEY` muuttuja: se purkaa ja tarkistaa **annettu** token — se ei näytä instanssin nykyistä lisenssiä. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Kuormitustesti ```bash aihummer loadtest ``` ### Laajennukset ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` Täydellistä SDK:ta varten ja julkaisemista varten jaettuun luetteloon portaalista («Omat lisäosat»), katso [Liitännäisen SDK](/fi/v1.0/marketplace/sdk) ja [Laajennuksen julkaiseminen](/fi/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` vaatii root-oikeudet: suorita `sudo aihummer uninstall`. Ja > `sudo aihummer uninstall --purge --yes` poistaa tiedot ja ohittaa > vahvistuskehotus — varmista ensin, että sinulla on varmennettu varmuuskopio. ## Ympäristö Muuttujat `aihummer` työkalu itse lukee: | Muuttuja | Tarkoitus | |---|---| | `AIHUMMER_SERVICE` | Yhdyskäytäväjärjestelmän yksikön nimi (oletus `aihummer-gateway`) — kohde `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Väylän URL-osoite `status`/`doctor`/`loadtest` (oletus `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — vaaditaan `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI-tulosteen ja ohjeen kieli: `ru` (oletus) tai `en`. | Useimmat komennot tarvitsevat rootin (`systemctl`) — aja niitä kanssa `sudo`. ## Minne seuraavaksi - Määritä instanssi: [Ympäristömuuttujat](/fi/v1.0/reference/env-vars). - Päätä, mitä työkaluja agentti voi käyttää: [Työkaluluettelo](/fi/v1.0/reference/tools-catalog).