CLI лавлагаа

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                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
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

Тэр `aihummer` коммандын мөрийн хэрэгсэл нь сервер дээр суулгасан програмаа удирддаг: энэ нь гарц (gateway)-ыг эхлүүлж, шинэчилдэг (суулгалт нь таны дансны порталын хувийн суулгалтын линкээр хийгддэг), гарцын systemd үйлчилгээг хянадаг, оношлогоо ажиллуулдаг, нөөцлөлтийг удирддаг, удирдлагын төвийн тохиргоог уншиж, бичиж, лицензүүдэд гарын үсэг зурдаг. Энэхүү хуудас нь бүх командын жагсаалтыг харуулдаг. ## Тушаалууд | Тушаал | Энэ юу хийдэг вэ | |---|---| | `up` / `install` | gateway systemd үйлчилгээг эхлүүлэх (`systemctl start`). Юу ч суулгадаггүй — суулгалт таны хувийн холбоосоос ороод ирэх суулгах скриптээр хийгддэг. | | `update [--check]` | Сүүлийн хувилбар руу шинэчлээрэй (гарын үсгийг баталгаажуул + бинар файлыг солих + дахин эхлүүлэх); `--check` зөвхөн шинэчлэлт байгаа эсэхийг мэдээлнэ. | | `restart` | Гэйтвейн үйлчилгээний үйлчилгээг дахин эхлүүлнэ (`systemctl restart`). | | `stop` | Гэйтвей үйлчилгээ зогсоо (`systemctl stop`). | | `logs [unit] [--no-follow]` | Нэг systemd нэгжийн журналыг дагах (`journalctl -u`); үүнийг анхдагчаар гарцын нэгж болгож тохируулна. `--no-follow` нь журналын сүүлийн хэсгийг хэвлээд гардаг; туггүйгээр команд дагасаар байдаг. | | `status` | Суулгацын тойм, үйлчилгээнүүдийн төлөв ба гарцын бэлэн байдал (`/readyz`). **Components** хэсэг нь сонголттой сайдкар нэгжүүдийн (хайлт, хөтөч, яриаг текст рүү, текстийг яриа руу, видео) төлөвийг мэдээлдэг; `systemctl` боломжгүй үед «суулгаагүй» гэхийн оронд төлөв тодорхойгүй байгааг үнэнчээр хэлдэг. | | `doctor` | Гурван дүгнэлттэй оношилгоо: бүгд хэвийн, сануулгатай ажиллаж байна (N), эсвэл асуудал илэрсэн. Node.js болон флотын бүртгэлийн материалын шалгалтууд нь алдаа биш, сануулга юм. | | `backup [dir]` | `pg_dump` PostgreSQL-н улсын тэгш газрын төлөвийг файлд гаргах; заавал заагаагүй бол анхдагч хавтасыг ашиглана. | | `restore <file>` | PostgreSQL-ийг үүсгэсэн дамп файлаас сэргээнэ `backup`. | | `uninstall [flags]` | Суулгалтыг устгах (доорх тугнуудыг үзнэ үү). Root эрх шаардлагатай — үүнийг ашиглан ажиллуулна уу `sudo`. | | `set-password` / `admin-password` | Орон нутгийн админ нууц үгийг тохируулах/үүсгэх (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Өгөгдлийн санд удирдлагын самбарын тохиргоог унших/бичих — ингэснээр CLI-ээс Settings-catalog-ийн товчлууруудыг тохируулдаг `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Лиценз удирдах: түлхүүр үүсгэх, гарын үсэг зурах, өгөгдсөн токеныг задлах ба баталгаажуулах. | | `loadtest` | Гэйтвей дээр ачааллын сорил хийх. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Плагин SDK: хүрээ үүсгэх, баталгаажуулах, түлхүүрүүд, багцлах, гарын үсэг зурах ба нийтлэх. | | `version` | Хувилбарыг хэвлэ. | | `help` | Тусламжийг үзүүлэх. | ### `uninstall` сүх | Түц | Нөлөө | |---|---| | `--purge` | Мөн мэдээллийг устгана уу (бүрэн устгах). | | `--yes` | Баталгаажуулах мессежийг алгасаарай. | | `--no-backup` | Устгахаас өмнө нөөцлөлт хийхгүй байх. | | `--backup-dir <dir>` | Сууц татахаас өмнөх нөөцлөлтийг энэ хавтас руу бичнэ үү. | ## Хэрхэн ашиглах жишээнүүд ### Суулгах ба ажиллуулах Суулгалт таны дансны портал дахь хувийн суулгалтын холбоосоор хийгддэг (харна уу [Суулгах](/mn/v1.0/getting-started/installation)); үүний дараа CLI эхэлж, үйлчилгээ шалгана: ```bash sudo aihummer up aihummer status ``` ### Шинэчлэх ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Үйлчилгээний хяналт ба тэмдэглэл Эдгээр командууд нь ганц gateway systemd нэгж дээр үйлчилдэг (`AIHUMMER_SERVICE`, анхдагч `aihummer-gateway`); `logs` ямар ч systemd нэгжийн нэрийг хүлээн авна. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Оношлогоо ```bash aihummer doctor ``` ### Нөөцөлж сэргээх `backup` үйлддэг `pg_dump` PostgreSQL улсын тэнхлэгийг файлд хадгалах; `restore` тэр хаягдал файлыг авдаг. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres нь үнэн болох эх сурвалж боловч таны `AIHUMMER_MASTER_KEY` мөн бөмбөлөг > директорыг тусад нь нөөцлөх ёстой — мастер түлхүүргүйгээр, кодлогдсон > нууцыг сэргээх боломжгүй. ### Админ нууц үг тохируулах Энэхүү команд хүлээн авдаг `[--login admin] [--password X]` мөн хэрэгцээ `AIHUMMER_DATABASE_URL` — ихэвчлэн авагдсан `gateway.env` суулгасан хэрэглэгчийн хувиар эсвэл дамжуулан ажиллуулагдах үед `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Хянах хавтгайгийн тохиргоо `settings` Өгөгдлийн санд Settings-catalog товчлууруудыг шууд уншиж, бичдэг — энэ нь веб удирдлагын UI (Management → Settings) засдаг нэг ижил сан юм. Ингээд CLI-аас каталогийн товчлууруудыг тохируулах боломжтой: `gateway.env` утгууд нь тэдэнд анхааралгүй орхигддог. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` зөвхөн хэрэглэгчид харагдах каталогийн түлхүүрүүдийг харуулна (систем болон дотоод түлхүүрүүд нуугдсан); бүх түлхүүрийг эх үүсвэрээр нь тэмдэглэнэ — `[db]` та тогтоосон утгуудын хувьд, `[unset]` энэ бол каталогийн анхдагчаар бусад тохиолдолд. ### Лицензүүд `license show` шаардадаг `<token>` маргаан ба `AIHUMMER_LICENSE_PUBKEY` өөрчлөгч: үүнийг тайлж, баталгаажуулна **өгөгдсөн** токен — энэ нь объектийн одоогийн лицензийг харуулдаггүй. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Ачааллын туршилт ```bash aihummer loadtest ``` ### Плагинууд ```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 ``` Бүтэн SDK болон портал («Миний залгаасууд») -аас нийтлэг каталогт нийтлэх талаар үзнэ үү [Плагин SDK](/mn/v1.0/marketplace/sdk) болон [Плагин нийтлэх](/mn/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` админ эрх шаардлагатай: ажиллуул `sudo aihummer uninstall`. Мөн > `sudo aihummer uninstall --purge --yes` мэдээллийг устгаж, үүнийг алгасна > баталгаажуулах сануулга — эхлээд батлагдсан нөөцлөлттэй эсэхээ шалгаарай. ## Орчин Өөрчлөгчид `aihummer` багаж өөрөө уншина: | Хувьсах | Зорилго | |---|---| | `AIHUMMER_SERVICE` | Гэйтвей системд нэгжийн нэр (анхдагч `aihummer-gateway`) — зорилт нь `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Шуурхай холболтын URL `status`/`doctor`/`loadtest` (анхдагч `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — шаардлагатай `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI-ийн гаралт болон тусламжийн хэл: `ru` (анхдагч) эсвэл `en`. | Ихэнх командуудад үндэс эрх (root) хэрэгтэй`systemctl`) — тэдгээрийг ажиллуул `sudo`. ## Дараа хаашаа явах вэ - Жишээний тохиргоог хий [Орчны хувьсагчид](/mn/v1.0/reference/env-vars). - Эгент нь ямар багаж хэрэгсэл ашиглах боломжтойг шийднэ үү: [Багаж хэрэгслийн каталог](/mn/v1.0/reference/tools-catalog).