Oracle APEX কিভাবে Install করবেন — সম্পূর্ণ Step by Step গাইড

আগের পোস্টে আমরা দেখেছিলাম Oracle APEX দিয়ে কীভাবে শুরু করবেন, সেখানে Oracle Cloud Free Tier ব্যবহার করে সহজভাবে শুরু করার কথা বলেছিলাম। কিন্তু অনেকেই চান নিজের PC বা অফিসের Server-এ সরাসরি Oracle APEX ইনস্টল করে কাজ করতে — বিশেষ করে যখন ক্লায়েন্টের নিজস্ব সার্ভারে ডিপ্লয় করতে হয়। আজকে সেই প্রক্রিয়াটা ধাপে ধাপে দেখাবো, যেভাবে আমি নিজে প্রথমবার করেছিলাম।

শুরুর আগে যা জানা দরকার

Oracle APEX একা চলে না — এর পেছনে তিনটা জিনিস লাগে:

1. Oracle Database (XE - Express Edition, ফ্রি ভার্সন যথেষ্ট শেখার জন্য)
2. Oracle APEX software (ডাটাবেসের ভেতরে ইনস্টল হয়)
3. ORDS (Oracle REST Data Services) — এটা APEX-কে ব্রাউজারে দেখানোর জন্য ওয়েব সার্ভার হিসেবে কাজ করে

এই তিনটা ধাপে ধাপে বসাতে হবে। প্রথমবার করার সময় আমার কাছেও এই তিন নম্বর (ORDS) সবচেয়ে বেশি ঝামেলা মনে হয়েছিল, তাই সেই অংশে একটু বেশি মনোযোগ দিয়ে লিখছি।

ধাপ ১: Oracle Database XE ইনস্টল করা

1. Oracle-এর অফিসিয়াল সাইট থেকে Oracle Database XE ডাউনলোড করুন (Windows বা Linux ভার্সন, যেটা আপনার সার্ভারে প্রযোজ্য)
2. ইনস্টলার চালান, ডিফল্ট সেটিংসই বেশিরভাগ ক্ষেত্রে ঠিক আছে
3. ইনস্টলেশনের সময় একটা SYS/SYSTEM পাসওয়ার্ড সেট করতে বলবে — এটা ভালোভাবে মনে রাখুন বা লিখে রাখুন, পরের প্রতিটা ধাপে এটা লাগবে
4. ইনস্টল শেষ হলে Database স্বয়ংক্রিয়ভাবে চালু হয়ে যাবে (Windows-এ Service হিসেবে চলে)

আমার পরামর্শ: ইনস্টলেশনের সময় পোর্ট নম্বরগুলো (Database Listener Port: সাধারণত 1521, EM Express Port: 5500) নোট করে রাখুন — পরে কোনো সমস্যা হলে এগুলো কাজে লাগে।

ধাপ ২: Oracle APEX ডাউনলোড ও ইনস্টল করা

1. Oracle APEX-এর অফিসিয়াল ডাউনলোড পেজ থেকে সর্বশেষ ভার্সন ডাউনলোড করুন (zip ফাইল)
2. Zip ফাইলটা একটা ফোল্ডারে Extract করুন (যেমন C:\apex বা /opt/apex)
3. Command Prompt/Terminal খুলে SQL*Plus দিয়ে Database-এ কানেক্ট করুন:

sqlplus / as sysdba

APEX ইনস্টল স্ক্রিপ্ট চালান (Extract করা ফোল্ডারের ভেতর থেকে):

@apexins.sql SYSAUX SYSAUX TEMP /i/

এই কমান্ডটা একটু সময় নেয় (১৫-৩০ মিনিট পর্যন্ত লাগতে পারে), ধৈর্য ধরে অপেক্ষা করুন। স্ক্রিনে অনেক লেখা স্ক্রল হতে থাকবে, এটা স্বাভাবিক।

ইনস্টল শেষ হলে APEX Admin ইউজারের পাসওয়ার্ড সেট করুন:

@apxchpwd.sql

ধাপ ৩: ORDS সেটআপ করা (এখানেই বেশিরভাগ মানুষ আটকে যায়)

ORDS হলো সেই সেতু যেটা আপনার ব্রাউজার আর Database-এর মাঝে কাজ করে। প্রথমবার এই ধাপে আমি নিজে ORDS Configuration Error-এ পড়েছিলাম, তাই এখানে একটু সতর্ক থাকুন।

1. Oracle-এর সাইট থেকে ORDS ডাউনলোড করুন, একটা ফোল্ডারে Extract করুন
2. Command Prompt/Terminal-এ সেই ফোল্ডারে গিয়ে চালান:

ords install

এটা আপনাকে ধাপে ধাপে কিছু প্রশ্ন জিজ্ঞেস করবে:

• Database connection type (সাধারণত "Basic" সিলেক্ট করুন)
• Database hostname (লোকাল হলে localhost)
• Database port (ডিফল্ট 1521)
• Database service name (XE-এর জন্য সাধারণত XEPDB1)
• SYS পাসওয়ার্ড (ধাপ ১-এ যেটা সেট করেছিলেন)

প্রশ্নগুলোর উত্তর ঠিকভাবে দিলে ORDS নিজে থেকেই কনফিগার হয়ে যাবে এবং শেষে একটা local server চালু করার অপশন দেবে। সার্ভার চালু করতে:

ords serve

এটা চালু থাকা অবস্থায় ব্রাউজারে গিয়ে এই লিংকে যান:

http://localhost:8080/ords

এখানে APEX Workspace Login পেজ দেখতে পাবেন — এর মানে ইনস্টলেশন সফল হয়েছে।

আমি যে এররগুলোতে পড়েছিলাম

ORDS Configuration Error

আমার ক্ষেত্রে এটা হয়েছিল কারণ Database Service Name ভুল দিয়েছিলাম (XE দিয়েছিলাম, কিন্তু আসলে XEPDB1 দরকার ছিল — Oracle XE-তে Pluggable Database আলাদা নাম রাখে)। lsnrctl status কমান্ড দিয়ে চেক করলে Database-এর আসল Service Name দেখা যায়।

ORA-12154 (TNS could not resolve)

এটা হয় যখন tnsnames.ora ফাইলে ভুল এন্ট্রি থাকে বা Listener চালু না থাকে। lsnrctl start দিয়ে Listener চালু আছে কিনা আগে নিশ্চিত করুন।

পোর্ট আগে থেকে ব্যবহৃত (Port already in use)

যদি 8080 পোর্টে আগে থেকে অন্য কোনো প্রোগ্রাম চলে, তাহলে ORDS চালু হবে না। নিচের কমান্ড দিয়ে আলাদা পোর্টে চালানো যায়:

ords serve --port 8181

Windows Server-এ চালিয়েই রাখতে চাইলে

প্রতিবার ম্যানুয়ালি ords serve চালানো বিরক্তিকর। প্রোডাকশন সার্ভারে এটাকে Windows Service হিসেবে ইনস্টল করে রাখা ভালো, যাতে সার্ভার রিস্টার্ট হলেও ORDS নিজে থেকে চালু হয়ে যায়। এই বিষয়ে বিস্তারিত ভবিষ্যতের একটা পোস্টে লিখব।

মনে রাখবেন: SYS/SYSTEM পাসওয়ার্ড এবং ORDS কনফিগারেশনের তথ্য কখনো পাবলিক কোনো জায়গায় (যেমন GitHub-এর পাবলিক রিপোজিটরিতে) শেয়ার করবেন না। প্রোডাকশন সার্ভারে শক্তিশালী পাসওয়ার্ড ব্যবহার করুন।

শেষ কথা

প্রথমবার Oracle APEX ইনস্টল করা একটু ধৈর্যের কাজ, কারণ তিনটা আলাদা জিনিস (Database, APEX, ORDS) ঠিকভাবে একসাথে কাজ করাতে হয়। কিন্তু একবার সফলভাবে বসে গেলে, এরপর থেকে যতগুলো প্রজেক্ট দরকার সবগুলোর জন্য একই Database ব্যবহার করা যায়। আমার পরামর্শ — প্রথমে Cloud Free Tier দিয়ে প্র্যাকটিস করে APEX-এর সাথে পরিচিত হয়ে নিন, তারপর যখন নিজের সার্ভারে ডিপ্লয় করার দরকার পড়বে, তখন এই গাইড অনুসরণ করুন।

কোনো ধাপে আটকে গেলে কমেন্টে জানান, এরর মেসেজসহ লিখলে সাহায্য করতে সুবিধা হবে।