ইনস্টলেশন ও পরিচালনা নির্দেশিকা।

এই নির্দেশিকা সেইসব আইটি টিমের জন্য, যারা Amanova নিজস্ব সার্ভারে, নিজস্ব ক্লাউড অ্যাকাউন্টে অথবা বিচ্ছিন্ন (এয়ার-গ্যাপড) নেটওয়ার্কে ইনস্টল করছে। SMH Global Services পরিচালিত হোস্টেড সেবার জন্য এর কিছুই প্রয়োজন নেই।

1. কী কী ইনস্টল হয়

অংশ	এটি কী করে
অ্যাপ্লিকেশন	Amanova ওয়েব অ্যাপ্লিকেশন, কর্মীদের ওয়ার্কস্পেস, গ্রাহক পোর্টাল ও API
ওয়েব সার্ভার	ইনস্টলেশনের ভেতরে অ্যাপ্লিকেশন ও স্ট্যাটিক ফাইল পরিবেশন করে
ব্যাকগ্রাউন্ড ওয়ার্কার ও শিডিউলার	নথি যাচাই, স্টেটমেন্ট বিশ্লেষণ, আগাম সতর্কতা স্কোর, প্রতিবেদন ও অনুস্মারক
রিয়েল-টাইম সেবা	ব্রাউজারে তাৎক্ষণিক হালনাগাদ
MariaDB 11.8	ডেটাবেস, একটি অভ্যন্তরীণ নেটওয়ার্কে, বাইরে থেকে প্রবেশের কোনো পথ নেই
Redis	ক্যাশ ও জব কিউ
Caddy	সবকিছুর সামনে HTTPS, স্বয়ংক্রিয় বা আপনার নিজস্ব সার্টিফিকেটসহ
amanova.sh	অপারেশনস স্ক্রিপ্ট: ইনস্টল, ব্যাকআপ, রিস্টোর, আপগ্রেড, সাবস্ক্রিপশন, ব্যবহারের প্রতিবেদন

সবকিছু Docker Compose-এর অধীনে কনটেইনারে চলে। ডেটা থাকে Docker ভলিউমে; ব্যাকআপ লেখা হয় /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 বা সামঞ্জস্যপূর্ণ	একই
সফটওয়্যার	Compose প্লাগইনসহ Docker Engine 24 বা পরবর্তী সংস্করণ	একই

আপনার আরও প্রয়োজন হবে:

• ব্যবহারকারীরা টাইপ করবেন এমন একটি হোস্ট নেম, যেমন 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

স্ক্রিপ্টটি যা জানতে চায়:

1. ব্যবহারকারীরা যে ঠিকানা টাইপ করবেন (হোস্ট নেম);
2. ঋণদাতার নাম;
3. প্রধান দেশ (PK, BD, SA, AE, NG, KE, EG, GH, SN বা MZ);
4. প্রথম অ্যাডমিনিস্ট্রেটরের ইমেইল ঠিকানা।

এরপর এটি অ্যাপ্লিকেশন ইমেজ বিল্ড বা লোড করে, সেবাগুলো চালু করে, র‍্যান্ডম ডেটাবেস ও অ্যাডমিনিস্ট্রেটর পাসওয়ার্ড দিয়ে সাইট তৈরি করে (যা /opt/amanova/.env-এ রাখা হয় এবং কেবল root পড়তে পারে), তারপর ঠিকানা ও অ্যাডমিনিস্ট্রেটরের প্রথম পাসওয়ার্ড প্রদর্শন করে। প্রথম বিল্ডে 15 থেকে 25 মিনিট লাগে।

4. অফলাইন (এয়ার-গ্যাপড) ইনস্টলেশন

আপনার সংস্করণের ইমেজ আর্কাইভ amanova-2.1.0-images.tar.gz SMH Global-এর কাছে চেয়ে নিন। উভয় ফাইল সার্ভারে কপি করুন, তারপর:

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. প্রথম সাইন-ইনের পর

1. অ্যাডমিনিস্ট্রেটর হিসেবে https://<your host>/login-এ সাইন ইন করুন এবং পাসওয়ার্ড পরিবর্তন করুন।
2. Amanova Settings: ঋণদাতার নাম, ব্র্যান্ড, প্রধান দেশ, ভাষা, সহায়তার ফোন ও ইমেইল।
3. Country Pack: আপনার কমপ্লায়েন্স টিমের সঙ্গে পরিচয়পত্র, মোবাইল, ব্যুরো ও ঋণের নিয়মগুলো নিশ্চিত করুন।
4. Loan Product: আপনার পণ্য, সীমা, হার ও প্রয়োজনীয় নথি তৈরি করুন; অনলাইন পণ্যের জন্য Show on portal-এ টিক দিন।
5. Users: Loan Officer, Loan Underwriter, Loan Manager, Compliance Officer বা Auditor ভূমিকাসহ কর্মী যোগ করুন।
6. Amanova Compliance Settings: কর্মীদের জন্য টু-ফ্যাক্টর সাইন-ইন চালু করুন এবং স্ক্রিনিং, KYC ও অনুমোদনের গেট নির্ধারণ করুন।
7. আপনার সাবস্ক্রিপশন ফাইল ইনস্টল করুন (অনুচ্ছেদ 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, দুবাই · করাচি · রিয়াদ