انسٹالیشن اور آپریشنز گائیڈ۔
ان آئی ٹی ٹیموں کے لیے جو Amanova کو اپنے سرورز پر، اپنے کلاؤڈ میں یا الگ تھلگ نیٹ ورک پر انسٹال کر رہی ہیں۔
یہ گائیڈ ان آئی ٹی ٹیموں کے لیے ہے جو Amanova کو اپنے سرورز پر، اپنے کلاؤڈ اکاؤنٹ میں یا الگ تھلگ (ایئر گیپڈ) نیٹ ورک پر انسٹال کر رہی ہیں۔ SMH Global Services کی چلائی جانے والی ہوسٹڈ سروس کے لیے ان میں سے کسی چیز کی ضرورت نہیں۔
1. کیا انسٹال ہوتا ہے
| جزو | کیا کرتا ہے |
|---|---|
| ایپلیکیشن | Amanova ویب ایپلیکیشن، عملے کی ورک اسپیس، صارف پورٹل اور APIs |
| ویب سرور | انسٹالیشن کے اندر ایپلیکیشن اور اسٹیٹک فائلیں فراہم کرتا ہے |
| بیک گراؤنڈ ورکرز اور شیڈولر | دستاویزات کی جانچ، اسٹیٹمنٹ کا تجزیہ، ابتدائی انتباہ کے اسکور، رپورٹس اور یاد دہانیاں |
| ریئل ٹائم سروس | براؤزر میں فوری اپ ڈیٹس |
| MariaDB 11.8 | ڈیٹا بیس، ایک اندرونی نیٹ ورک پر جس تک باہر سے کوئی راستہ نہیں |
| Redis | کیش اور جاب قطاریں |
| Caddy | ہر چیز کے آگے HTTPS، خودکار یا آپ کے اپنے سرٹیفکیٹس کے ساتھ |
amanova.sh |
آپریشنز اسکرپٹ: انسٹالیشن، بیک اپ، ریسٹور، اپ گریڈ، سبسکرپشن، استعمال کی رپورٹ |
سب کچھ Docker Compose کے تحت کنٹینرز میں چلتا ہے۔ ڈیٹا Docker volumes میں رہتا ہے؛ بیک اپس /opt/amanova/backups میں لکھے جاتے ہیں۔
2. ضروریات
| پائلٹ | پروڈکشن | |
|---|---|---|
| CPU | 4 vCPU | 8 vCPU |
| میموری | 8 GB | 16 GB |
| ڈسک | 60 GB SSD | 200 GB SSD، اور بیک اپ کے لیے اسٹوریج |
| آپریٹنگ سسٹم | Ubuntu 22.04 یا 24.04، RHEL 9 یا اس سے مطابقت رکھنے والا | وہی |
| سافٹ ویئر | Docker Engine 24 یا اس سے نیا ورژن، Compose پلگ اِن کے ساتھ | وہی |
آپ کو یہ بھی درکار ہے:
- ایک ہوسٹ نیم جو یوزرز ٹائپ کریں گے، مثلاً
lending.bank.local، جو سرور کی طرف اشارہ کرتا ہو؛ - پورٹس 80 اور 443 آپ کے یوزرز کے لیے کھلی ہوں (پورٹ 80 صرف 443 کی طرف ری ڈائریکٹ کرتی ہے)؛
- انٹرنیٹ پر خودکار سرٹیفکیٹس کے لیے ہوسٹ نیم کا پبلک ہونا ضروری ہے؛ اندرونی نیٹ ورک پر اپنا سرٹیفکیٹ استعمال کریں (سیکشن 6)۔
3. معیاری انسٹالیشن (سرور کو انٹرنیٹ تک رسائی حاصل ہو)
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
اسکرپٹ یہ معلومات مانگتا ہے:
- وہ ایڈریس جو یوزرز ٹائپ کریں گے (ہوسٹ نیم)؛
- قرض دہندہ کا نام؛
- بنیادی ملک (
PK،BD،SA،AE،NG،KE،EG،GH،SNیاMZ)؛ - پہلے ایڈمنسٹریٹر کا ای میل ایڈریس۔
پھر یہ ایپلیکیشن امیج بناتا یا لوڈ کرتا ہے، سروسز شروع کرتا ہے، ڈیٹا بیس اور ایڈمنسٹریٹر کے رینڈم پاس ورڈز کے ساتھ سائٹ بناتا ہے (جو /opt/amanova/.env میں محفوظ ہوتے ہیں اور صرف root انہیں پڑھ سکتا ہے)، اور ایڈریس اور ایڈمنسٹریٹر کا پہلا پاس ورڈ دکھاتا ہے۔ پہلی بلڈ میں 15 سے 25 منٹ لگتے ہیں۔
4. آف لائن (ایئر گیپڈ) انسٹالیشن
SMH Global سے اپنے ورژن کا امیج آرکائیو، amanova-2.1.0-images.tar.gz، طلب کریں۔ دونوں فائلیں سرور پر کاپی کریں، پھر:
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
کچھ بھی ڈاؤن لوڈ نہیں ہوتا۔ بلٹ اِن اے آئی انجن کنکشن کے بغیر کام کرتا ہے؛ اے آئی ماڈلز استعمال کرنے کے لیے آن پریمیسز ماڈل سرور چلائیں (سیکشن 10)۔
5. پہلے سائن اِن کے بعد
https://<your host>/loginپر ایڈمنسٹریٹر کے طور پر سائن اِن کریں اور پاس ورڈ تبدیل کریں۔- Amanova Settings: قرض دہندہ کا نام، برانڈ، بنیادی ملک، زبانیں، سپورٹ فون اور ای میل۔
- Country Pack: اپنی کمپلائنس ٹیم کے ساتھ شناختی کارڈ، موبائل نمبر، بیورو اور قرض کے قواعد کی تصدیق کریں۔
- Loan Product: اپنی مصنوعات، حدود، شرحیں اور مطلوبہ دستاویزات بنائیں؛ آن لائن مصنوعات کے لیے Show on portal پر نشان لگائیں۔
- Users: عملے کو Loan Officer، Loan Underwriter، Loan Manager، Compliance Officer یا Auditor کے کرداروں کے ساتھ شامل کریں۔
- Amanova Compliance Settings: عملے کے لیے ٹو فیکٹر سائن اِن فعال کریں، اور اسکریننگ، KYC اور منظوری کے گیٹس مقرر کریں۔
- اپنی سبسکرپشن فائل انسٹال کریں (سیکشن 9)۔
6. TLS سرٹیفکیٹ
- پبلک ہوسٹ نیم: Caddy خود بخود سرٹیفکیٹ حاصل کرتا اور اس کی تجدید کرتا ہے۔
- اندرونی ہوسٹ نیم: اپنا سرٹیفکیٹ اور کی
/opt/amanova/certs/میںsite.crtاورsite.keyکے نام سے رکھیں، پھرsudo ./amanova.sh certچلائیں۔site.crtمیں مکمل چین استعمال کریں۔
7. بیک اپ اور ریسٹور
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
ہر رات 02:00 بجے بیک اپ چلتا ہے اور آخری 14 بیک اپس محفوظ رکھے جاتے ہیں (.env میں BACKUP_KEEP)۔ /opt/amanova/backups کو الگ اسٹوریج پر کاپی کریں؛ ڈیٹا بیس کی انکرپشن کلید .env میں ہے، اس کا الگ سے بیک اپ لینا اور اسے محفوظ رکھنا لازمی ہے۔
8. اپ گریڈز
sudo tar -xzf amanova-2.2.0-onprem.tar.gz -C /tmp
sudo /tmp/amanova-2.2.0-onprem/amanova.sh upgrade /opt/amanova
اپ گریڈ پہلے بیک اپ لیتا ہے، ایپلیکیشن فائلیں تبدیل کرتا ہے (آپ کی .env، سرٹیفکیٹس، سبسکرپشن اور بیک اپس برقرار رہتے ہیں)، نیا امیج دوبارہ بناتا یا لوڈ کرتا ہے، ڈیٹا بیس کو مائیگریٹ کرتا ہے اور ری اسٹارٹ کرتا ہے۔ ایئر گیپڈ سائٹس پہلے نیا امیج آرکائیو لوڈ کرتی ہیں۔ SMH Global کی ریپوزٹری سے کلون کی گئی انسٹالیشنز تازہ ترین ریلیز حاصل کر کے لاگو کرنے کے لیے sudo ./amanova.sh update چلا سکتی ہیں۔
9. سبسکرپشن فائل اور استعمال کی رپورٹ
سبسکرپشن فائل پر SMH Global کے دستخط ہوتے ہیں اور اس کی جانچ پروڈکٹ کے ساتھ فراہم کردہ پبلک کی کے ذریعے آف لائن کی جاتی ہے؛ کوئی چیز ہمارے سرور سے رابطہ نہیں کرتی۔ اس میں لائسنس یافتہ ادارہ، اسٹاف یوزرز، پورٹ فولیو بینڈ، ماڈیولز، ممالک، مدت اور سپورٹ کے اختتام کی تاریخ درج ہوتی ہے۔
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
ایڈمنسٹریٹرز ایپلیکیشن میں Amanova Subscription کے تحت سبسکرپشن، استعمال اور میعاد ختم ہونے کی تاریخ بھی دیکھ سکتے ہیں۔ جب سبسکرپشن یا سپورٹ کی مدت ختم ہو جائے، یا استعمال سبسکرائب کی گئی مقدار سے بڑھ جائے، تو ایڈمنسٹریٹرز کو ایک نوٹس دکھائی دیتا ہے؛ قرض دہی، سروسنگ اور وصولی کا کام جاری رہتا ہے۔ ہر سہ ماہی، یا طلب کیے جانے پر، SMH Global کو استعمال کی رپورٹ بھیجیں۔
10. اے آئی کے آپشنز
Amanova Settings → Market & AI کے تحت:
| فراہم کنندہ | ڈیٹا کہاں جاتا ہے |
|---|---|
| بلٹ اِن | کہیں نہیں: آپ کی انسٹالیشن کے اندر قواعد اور شماریات |
| آن پریمیسز | OpenAI سے مطابقت رکھنے والی API کے ساتھ آپ کا اپنا ماڈل سرور (مثلاً vLLM یا Ollama)، جو اس کے URL کے ذریعے ترتیب دیا جاتا ہے |
| Anthropic Claude یا OpenAI سے مطابقت رکھنے والا کلاؤڈ | آپ کا منظور کردہ فراہم کنندہ، آپ کی API کی کے ساتھ، جو انکرپٹڈ صورت میں محفوظ ہوتی ہے |
اے آئی کا ہر نتیجہ اس کے ان پٹس اور اسے قبول یا رد کرنے والے فرد کے ساتھ لاگ ہوتا ہے۔ کوئی فیصلہ اکیلا اے آئی نہیں کرتا۔
11. انفارمیشن سکیورٹی جائزے کے لیے سکیورٹی نوٹس
- کنٹینرز ایپلیکیشن کو نان روٹ یوزر کے طور پر چلاتے ہیں؛ ڈیٹا بیس اور Redis کی کوئی پورٹ باہر کے لیے کھلی نہیں۔
- صرف HTTPS، TLS 1.2 اور 1.3؛ HTTP خود بخود HTTPS کی طرف ری ڈائریکٹ ہوتا ہے۔
- پاس ورڈز ہیش کیے جاتے ہیں؛ API کیز جیسی خفیہ معلومات
.envمیں موجود سائٹ کی کلید سے انکرپٹ کی جاتی ہیں۔ - عملے کے لیے ٹو فیکٹر سائن اِن، پاس ورڈ پالیسی، ناکام کوششوں کے بعد لاک آؤٹ اور سیشن کی میعاد قابلِ ترتیب ہیں۔
- صارفین کی دستاویزات نجی فائلیں ہیں، جو صرف ان سائن اِن یوزرز کو دکھائی جاتی ہیں جنہیں انہیں دیکھنے کی اجازت ہو۔
- ہر دستاویز کی ورژن ہسٹری محفوظ رہتی ہے؛ اے آئی کے نتائج ان کا جائزہ لینے والے کے ساتھ لاگ ہوتے ہیں۔
12. کنٹینرز کے بغیر انسٹالیشن
جہاں کنٹینرز کی اجازت نہ ہو، وہاں Amanova پلیٹ فارم کے معیاری پروڈکشن سیٹ اپ (Python، Node.js، MariaDB، Redis، NGINX اور Supervisor) کے ساتھ bench کے ذریعے انسٹال ہوتا ہے۔ اپنے آپریٹنگ سسٹم کے لیے systemd/bench گائیڈ SMH Global سے طلب کریں۔
13. مسائل کا حل
| علامت | کیا جانچیں |
|---|---|
| سائٹ نہیں کھلتی | sudo ./amanova.sh status اور sudo ./amanova.sh logs web |
| سرٹیفکیٹ کی خرابیاں | ہوسٹ نیم سرور کی طرف ریزولو ہوتا ہو؛ پورٹس 80 اور 443 کھلی ہوں؛ یا اپنا سرٹیفکیٹ انسٹال کریں |
| بیک گراؤنڈ جانچ میں سستی | sudo ./amanova.sh logs worker؛ میموری یا CPU بڑھائیں |
| ریسٹور مسترد | بیک اپ کا چیک سم میل نہیں کھاتا؛ بیک اپ دوبارہ کاپی کریں |
14. کمانڈز کا حوالہ
| کمانڈ | کیا کرتا ہے |
|---|---|
install [--offline] |
پہلی انسٹالیشن |
status |
سروسز، ورژن، سبسکرپشن اور ڈسک کا استعمال |
start، stop، restart |
تمام سروسز کو کنٹرول کریں |
logs [service] |
لاگز دیکھیں (app، web، worker، scheduler، db، proxy) |
backup، backups، restore <folder> |
چیک سمز کے ساتھ بیک اپس |
upgrade <folder> / update |
نئے پیکج سے اپ گریڈ کریں، یا ریپوزٹری سے تازہ ترین ورژن حاصل کریں |
load-images <archive> |
آف لائن انسٹالیشن یا اپ گریڈ کے لیے امیجز لوڈ کریں |
cert |
certs/ سے اپنا سرٹیفکیٹ استعمال کریں |
subscription [file] |
سبسکرپشن انسٹال کریں یا دکھائیں |
usage-report |
SMH Global کے لیے استعمال کی رپورٹ تیار کریں |
admin-password |
ایڈمنسٹریٹر کے لیے نیا پاس ورڈ مقرر کریں |
version |
انسٹال شدہ ورژن دکھائیں |
سپورٹ: support@amanova.app · SMH Global Services، دبئی · کراچی · ریاض