Mwongozo wa usakinishaji na uendeshaji.

Mwongozo huu ni kwa timu za TEHAMA zinazosakinisha Amanova kwenye seva zao wenyewe, kwenye akaunti yao ya wingu au kwenye mtandao uliotengwa (air-gapped). Huduma iliyopangishwa inayoendeshwa na SMH Global Services haihitaji yoyote kati ya haya.

1. Kinachosakinishwa

Sehemu	Kazi yake
Programu	Programu ya wavuti ya Amanova, eneo la kazi la wafanyakazi, tovuti ya wateja na API
Seva ya wavuti	Hutoa programu na faili tuli ndani ya usakinishaji
Michakato ya nyuma na kipanga ratiba	Ukaguzi wa nyaraka, uchambuzi wa taarifa za benki, alama za tahadhari ya mapema, ripoti na vikumbusho
Huduma ya wakati halisi	Masasisho ya papo hapo kwenye kivinjari
MariaDB 11.8	Hifadhidata, kwenye mtandao wa ndani usio na njia kutoka nje
Redis	Kache na foleni za kazi
Caddy	HTTPS mbele ya kila kitu, ikiwa na vyeti vya kiotomatiki au vyako mwenyewe
amanova.sh	Skripti ya uendeshaji: usakinishaji, nakala rudufu, urejeshaji, uboreshaji, usajili, ripoti ya matumizi

Kila kitu huendeshwa ndani ya kontena chini ya Docker Compose. Data hukaa kwenye Docker volumes; nakala rudufu huandikwa kwenye /opt/amanova/backups.

2. Mahitaji

	Majaribio	Matumizi halisi
CPU	4 vCPU	8 vCPU
Kumbukumbu	8 GB	16 GB
Diski	60 GB SSD	200 GB SSD, pamoja na hifadhi ya nakala rudufu
Mfumo wa uendeshaji	Ubuntu 22.04 au 24.04, RHEL 9 au mfumo unaooana nao	Vivyo hivyo
Programu	Docker Engine 24 au toleo jipya zaidi pamoja na programu-jalizi ya Compose	Vivyo hivyo

Pia unahitaji:

• jina la seva (host name) ambalo watumiaji wataliandika, kwa mfano lending.bank.local, linaloelekeza kwenye seva;
• milango 80 na 443 iliyo wazi kwa watumiaji wako (mlango 80 huelekeza tu kwenye 443);
• kwa vyeti vya kiotomatiki kwenye intaneti, jina la seva lazima liwe la umma; kwenye mtandao wa ndani, tumia cheti chako mwenyewe (sehemu ya 6).

3. Usakinishaji wa kawaida (seva ina muunganisho wa intaneti)

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh install

Skripti huuliza:

1. anwani ambayo watumiaji wataiandika (host name);
2. jina la mkopeshaji;
3. nchi kuu (PK, BD, SA, AE, NG, KE, EG, GH, SN au MZ);
4. anwani ya barua pepe ya msimamizi wa kwanza.

Kisha hujenga au hupakia image ya programu, huanzisha huduma, huunda tovuti yenye manenosiri ya nasibu ya hifadhidata na ya msimamizi (yanayohifadhiwa kwenye /opt/amanova/.env, yanayoweza kusomwa na root pekee), na huchapisha anwani na nenosiri la kwanza la msimamizi. Ujenzi wa kwanza huchukua dakika 15 hadi 25.

4. Usakinishaji bila mtandao (air-gapped)

Omba kutoka SMH Global kifurushi cha image cha toleo lako, amanova-2.1.0-images.tar.gz. Nakili faili zote mbili kwenye seva, kisha:

sudo tar -xzf amanova-2.1.0-onprem.tar.gz -C /opt
sudo mv /opt/amanova-2.1.0-onprem /opt/amanova
cd /opt/amanova
sudo ./amanova.sh load-images /path/to/amanova-2.1.0-images.tar.gz
sudo ./amanova.sh install --offline

Hakuna kinachopakuliwa. Injini ya AI iliyojengwa ndani hufanya kazi bila muunganisho; ili kutumia modeli za AI, endesha seva ya modeli kwenye majengo yako (sehemu ya 10).

5. Baada ya kuingia kwa mara ya kwanza

1. Ingia kupitia https://<your host>/login kama msimamizi na ubadilishe nenosiri.
2. Amanova Settings: jina la mkopeshaji, chapa, nchi kuu, lugha, simu na barua pepe ya usaidizi.
3. Country Pack: thibitisha kanuni za vitambulisho, nambari za simu, ofisi ya taarifa za mikopo na mikopo pamoja na timu yako ya uzingatiaji wa sheria.
4. Loan Product: unda bidhaa zako, vikomo, viwango na nyaraka zinazohitajika; weka alama kwenye Show on portal kwa bidhaa za mtandaoni.
5. Users: ongeza wafanyakazi wenye majukumu ya Loan Officer, Loan Underwriter, Loan Manager, Compliance Officer au Auditor.
6. Amanova Compliance Settings: washa kuingia kwa hatua mbili kwa wafanyakazi, na uweke vizuizi vya uchunguzi, KYC na idhini.
7. Sakinisha faili lako la usajili (sehemu ya 9).

6. Cheti cha TLS

• Jina la seva la umma: Caddy hupata na kufanya upya cheti kiotomatiki.
• Jina la seva la ndani: weka cheti chako na ufunguo wake kwenye /opt/amanova/certs/ kama site.crt na site.key, kisha endesha sudo ./amanova.sh cert. Tumia mnyororo kamili wa vyeti katika site.crt.

7. Nakala rudufu na urejeshaji

sudo ./amanova.sh backup              # database and files, with a SHA-256 checksum
sudo ./amanova.sh backups             # list backups
sudo ./amanova.sh restore <folder>    # verifies the checksum, then restores

Nakala rudufu huchukuliwa kila usiku saa 02:00 na nakala 14 za mwisho huhifadhiwa (BACKUP_KEEP katika .env). Nakili /opt/amanova/backups kwenye hifadhi tofauti; ufunguo wa usimbaji wa hifadhidata uko katika .env na lazima uhifadhiwe nakala kando na kulindwa vizuri.

8. Uboreshaji wa matoleo

sudo tar -xzf amanova-2.2.0-onprem.tar.gz -C /tmp
sudo /tmp/amanova-2.2.0-onprem/amanova.sh upgrade /opt/amanova

Uboreshaji huchukua nakala rudufu kwanza, hubadilisha faili za programu (.env yako, vyeti, usajili na nakala rudufu huhifadhiwa), hujenga upya au hupakia image mpya, huhamisha hifadhidata na kuanzisha upya. Mifumo isiyounganishwa na mtandao hupakia kwanza kifurushi kipya cha image. Usakinishaji ulionakiliwa kutoka hazina ya SMH Global unaweza kuendesha sudo ./amanova.sh update ili kuvuta na kutumia toleo jipya zaidi.

9. Faili la usajili na ripoti ya matumizi

Faili la usajili hutiwa saini na SMH Global na hukaguliwa bila mtandao kwa kutumia ufunguo wa umma unaokuja na bidhaa; hakuna kinachowasiliana na seva zetu. Hurekodi mwenye leseni, watumiaji wa wafanyakazi, kiwango cha jalada, moduli, nchi, muda wa mkataba na tarehe ya mwisho ya usaidizi.

sudo ./amanova.sh subscription /path/to/subscription.json   # install or replace
sudo ./amanova.sh subscription                              # show status
sudo ./amanova.sh usage-report                              # writes usage-report-<date>.json with a checksum

Wasimamizi pia huona usajili, matumizi na tarehe ya kuisha chini ya Amanova Subscription ndani ya programu. Kipindi cha usajili au cha usaidizi kinapoisha, au matumizi yanapozidi kiasi kilichosajiliwa, wasimamizi huona ilani; utoaji wa mikopo, usimamizi wa mikopo na ukusanyaji wa madeni huendelea kufanya kazi. Tuma kwa SMH Global ripoti ya matumizi kila robo mwaka, au unapoombwa.

10. Chaguo za AI

Chini ya Amanova Settings → Market & AI:

Mtoa huduma	Data inakwenda wapi
Iliyojengwa ndani	Haiendi popote: kanuni na takwimu ndani ya usakinishaji wako
Kwenye majengo yako	Seva yako mwenyewe ya modeli yenye API inayooana na OpenAI (kwa mfano vLLM au Ollama), inayowekwa kwa URL yake
Anthropic Claude au wingu linalooana na OpenAI	Mtoa huduma unayemuidhinisha, kwa ufunguo wako wa API, unaohifadhiwa ukiwa umesimbwa

Kila matokeo ya AI hurekodiwa pamoja na data iliyotumika na mtu aliyeyakubali au kuyakataa. Hakuna kinachoamuliwa na AI peke yake.

11. Maelezo ya usalama kwa ajili ya mapitio ya usalama wa taarifa

• Kontena huendesha programu kama mtumiaji asiye root; hifadhidata na Redis hazina milango iliyo wazi kwa nje.
• HTTPS pekee, TLS 1.2 na 1.3; HTTP huelekezwa kwenye HTTPS.
• Manenosiri huhifadhiwa kama hashi; siri kama vile funguo za API husimbwa kwa ufunguo wa tovuti ulio katika .env.
• Kuingia kwa hatua mbili kwa wafanyakazi, sera ya manenosiri, kufungiwa baada ya majaribio yaliyoshindwa na muda wa kuisha kwa kipindi cha kuingia vinaweza kusanidiwa.
• Nyaraka za wateja ni faili za faragha, zinazotolewa tu kwa watumiaji walioingia ambao wameruhusiwa kuziona.
• Kila hati huhifadhi historia ya matoleo; matokeo ya AI hurekodiwa pamoja na aliyeyapitia.

12. Usakinishaji bila kontena

Pale ambapo kontena haziruhusiwi, Amanova husakinishwa kwa mpangilio wa kawaida wa uendeshaji wa jukwaa (Python, Node.js, MariaDB, Redis, NGINX na Supervisor) kwa kutumia bench. Omba kutoka SMH Global mwongozo wa systemd/bench kwa mfumo wako wa uendeshaji.

13. Utatuzi wa matatizo

Dalili	Kagua
Tovuti haifunguki	sudo ./amanova.sh status na sudo ./amanova.sh logs web
Hitilafu za cheti	Jina la seva (host name) linaelekeza kwenye seva; milango 80 na 443 iko wazi; au sakinisha cheti chako mwenyewe
Ukaguzi wa nyuma unaenda polepole	sudo ./amanova.sh logs worker; ongeza kumbukumbu au CPU
Urejeshaji umekataliwa	Checksum ya nakala rudufu hailingani; nakili nakala rudufu tena

14. Marejeleo ya amri

Amri	Kazi yake
install [--offline]	Usakinishaji wa kwanza
status	Huduma, toleo, usajili na matumizi ya diski
start, stop, restart	Dhibiti huduma zote
logs [service]	Fuatilia kumbukumbu za mfumo (app, web, worker, scheduler, db, proxy)
backup, backups, restore <folder>	Nakala rudufu zenye checksum
upgrade <folder> / update	Boresha kutoka kifurushi kipya, au vuta toleo jipya zaidi kutoka kwenye hazina
load-images <archive>	Pakia image kwa usakinishaji au uboreshaji bila mtandao
cert	Tumia cheti chako mwenyewe kutoka certs/
subscription [file]	Sakinisha au onyesha usajili
usage-report	Andika ripoti ya matumizi kwa ajili ya SMH Global
admin-password	Weka nenosiri jipya la msimamizi
version	Onyesha toleo lililosakinishwa

Usaidizi: support@amanova.app · SMH Global Services, Dubai · Karachi · Riyadh