ম্যানুয়াল: মিডিয়াউইকি ইনস্টল করা
এই পৃষ্ঠাটি মিডিয়াউইকি ম্যানুয়ালি ইনস্টল করার জন্য প্রয়োজনীয় ধাপগুলি তুলে ধরে। ইনস্টলেশনের পরে, অতিরিক্ত কনফিগারেশন সম্পর্কিত তথ্য ম্যানুয়াল:সিস্টেম অ্যাডমিনিস্ট্রেশন#কনফিগারেশন-এ পাওয়া যাবে।
মিডিয়াউইকি ইনস্টল করতে ওয়েব হোস্টিং সম্পর্কে প্রাথমিক ধারণা প্রয়োজন। অ্যাপাচি, পিএইচপি, এবং মাইএসকিউএল/মারিয়া ডিবি সম্পর্কে অভিজ্ঞতা থাকলে প্রক্রিয়াটি আরও সহজ হবে। মিডিয়াউইকি ইনস্টলেশন সম্পর্কে যেকোনো প্রশ্ন থাকলে Project: Support desk-এ জিজ্ঞাসা করুন অথবা যোগাযোগ-এ উল্লিখিত অন্যান্য জায়গাগুলিতে দেখুন।
নিচের পরিশিষ্ট অংশে ম্যানুয়াল ইনস্টলেশনের বিকল্প এবং বিভিন্ন সিস্টেম কনফিগারেশনের জন্য নির্দিষ্ট ইনস্টলেশন নোট দেওয়া হয়েছে।
মিডিয়াউইকির একটি দ্রুত স্থানীয় সার্ভার সেটআপের জন্য Local development quickstart-এ দেখুন।
ইনস্টলেশনের প্রয়োজনীয়তা
আপনার সিস্টেম ইনস্টলেশনের প্রয়োজনীয়তা পূরণ করে কিনা তা যাচাই করুন।
আপনার ইনস্টল করতে ইচ্ছুক মিডিয়াউইকির সংস্করণের Release notes পরীক্ষা করাও নিশ্চিত করুন।
মিডিয়াউইকি সফটওয়্যার ডাউনলোড করুন
অফিশিয়াল ডাউনলোড পৃষ্ঠা থেকে মিডিয়াউইকির টার ফাইল ডাউনলোড করুন।
যদি আপনি মিডিয়াউইকি একটি প্রোডাকশন পরিবেশে ব্যবহার করেন, তবে রিলিজ ম্যানেজার দৃঢ়ভাবে সুপারিশ করেছেন যে শুধুমাত্র সংস্করণের জীবনচক্র এবং তাদের সমাপ্তি-এ তালিকাভুক্ত "স্থিতিশীল সংস্করণ", "উত্তরাধিকার সংস্করণ" বা "দীর্ঘমেয়াদী সহায়তা সংস্করণ" প্রোডাকশন পরিবেশে ব্যবহার করা উচিত। পুরোনো সংস্করণে গুরুতর সুরক্ষা দুর্বলতা এবং অন্যান্য বড় ত্রুটি থাকতে পারে, যার মধ্যে ডেটা ক্ষতি এবং/অথবা দুর্নীতির হুমকি রয়েছে। বর্তমান স্থিতিশীল সংস্করণ হল MediaWiki 1.42.3।
মিডিয়াউইকি সফটওয়্যার এক্সট্র্যাক্ট করুন
ডাউনলোড করা ফাইলটি .zip বা .tar.gz ফাইল ফরম্যাটে থাকে।
ব্যবহারের আগে এটি আনকমপ্রেস করতে হবে।
ফাইলটি লোকাল মেশিনে আনকমপ্রেস করা যেতে পারে (এরপর FTP-এর মাধ্যমে সার্ভারে আপলোড করা হবে) অথবা সরাসরি সার্ভারে আনকমপ্রেস করা যেতে পারে।
উইন্ডোজে, আনকমপ্রেস করার জন্য সাধারণত 7-Zip (বিনামূল্যে), WinZip, WinRAR বা IZArc (বিনামূল্যে) সফটওয়্যার ব্যবহৃত হয়।
লিনাক্স এবং ম্যাকওএস-এ, ফাইলটি আনকমপ্রেস করতে নিচের কমান্ডটি ব্যবহার করতে পারেন:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder> ফাইলের অনুমতি সুরক্ষিত করার বিষয়ে আরও তথ্যের জন্য, দেখুন Manual:Security#File permissions।
আপনার ওয়েব সার্ভারে ফাইল আপলোড করুন
যদি আপনি এখনও আপনার ওয়েব সার্ভারে (অথবা আপনার ওয়েব সার্ভার সফটওয়্যার যদি আপনার localhost-এ স্থানীয়ভাবে চালানো হয়, তবে সেখান থেকে কপি করেননি) ফাইল আপলোড না করে থাকেন, তবে এখন করুন।
আপনার ওয়েব সার্ভারের ওয়েব ডিরেক্টরিতে ফাইল আপলোড করুন, যা করতে পারেন:
- আনজিপ করা ফোল্ডার সরাসরি কপি করে অথবা
- একটি FTP ক্লায়েন্ট ব্যবহার করে, যেমন FileZilla (Windows, macOS এবং Linux) অথবা Cyberduck (Windows এবং macOS)।
- অথবা আপনার হোস্টিং পরিষেবা দ্বারা সরবরাহিত সফটওয়্যার, যেমন cPanel File Manager ব্যবহার করে।
যদি আপনার আপলোড টুলে "ফাইলের নাম ছোট হাতের অক্ষরে রূপান্তর করুন" অপশন থাকে, তবে এটি নিষ্ক্রিয় করুন যাতে আপলোড প্রক্রিয়ার সময় ফাইলের নাম অপ্রত্যাশিতভাবে পরিবর্তিত না হয়।
যদি আপনি Apache HTTPD ওয়েব সার্ভার ব্যবহার করেন, তবে সঠিক ডিরেক্টরি httpd.conf ফাইলে DocumentRoot নির্দেশনায় উল্লেখ করা থাকে।
ডিফল্টভাবে, এটি /var/www/ অথবা <apache-folder>/htdocs।
Apache সার্ভার সেটিংস এবং ডিরেক্টরির ফাইল httpd.conf-এর সঠিক অবস্থান আপনার অপারেটিং সিস্টেমের উপর নির্ভর করে।
Debian এবং Ubuntu-তে, Apache সার্ভারের সেটিংস এবং ডিরেক্টরির ফাইল /etc/apache2/apache2.conf।
Red Hat এবং Fedora-তে, ফাইলটি /etc/httpd/conf/httpd.conf।
আপলোড করা ফোল্ডারটির নাম আপনার পছন্দমতো নামকরণ করুন, কারণ এটি URL-এ কেমন দেখাবে তা নির্ধারণ করবে।
For example, if you rename the folder to wiki, the URL will reflect this as example.com/wiki.
If your web server is running as http://localhost for example, renaming the directory to /w/ would mean you would access your wiki at http://localhost/w/index.php.
/wiki/ yet if you want to set up Short URLs after running the initial configuration script.
Set up the database
The MediaWiki initial configuration script requires a database name and a database username to store the wiki’s content.
If you already have a database server and know the password for the root (administrator) user, you can skip directly to the Run the installation script section.
If you do not know the root user’s password, for instance if you are using a hosted server, you will need to create a new database before proceeding to the MediaWiki installation script.
MariaDB/MySQL are the recommended databases. While PostgreSQL and SQLite are supported, they offer limited compatibility and should only be used only if necessary. If you're unsure which database to choose, use MariaDB.
Once the database setup is complete, proceed to the Run the installation script below.
SQLite
No additional setup is required for SQLite if the pdo-sqlite module for PHP is installed on the system.
On the SQLite installation page, select a database name (any name is acceptable) and an SQLite database directory. The installer will attempt to use a directory outside the document root and create it if necessary. If this directory is web-readable or insecure, it should be manually changed to prevent unauthorized access.
MariaDB/MySQL
- A control panel provided by your hosting service, such as phpMyAdmin.
- SSH access to your host, where you can enter the commands below into a MySQL prompt. Refer to your hosting provider’s documentation. Alternatively, you can request that your hosting provider create the database and user for you.
The following commands will create a database named my_wiki, a user named wikiuser, and assign permissions for the user on that database.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Only if your database is not running on the same server as your web server, you need to give the appropriate web server hostname (mediawiki.example.com in the example below):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
 সতর্কীকরণ | MySQL/MariaDB logs all queries in a history file. It will include the database password for the user account. If this concerns you, delete and disable the .mysql_history file after running these queries by following the MySQL documentation. |
PostgreSQL
If you are using PostgreSQL, you will need to either have a database and user created for you, or supply the name of a PostgreSQL user with "superuser" privileges to the configuration form.
Often, this is the database user named postgres.
The following commands on a Linux command-line, as the postgres user, create a database user named wikiuser, and a database named my_wiki owned by the user named wikiuser.
createuser -S -D -R -P -E wikiuser (then enter the database password)
createdb -O wikiuser my_wiki
or as superuser (default postgres) execute the following commands at the database prompt:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Beware of the list of known issues when running MediaWiki with PostgreSQL.
Run the installation script
Next, complete the installation of MediaWiki by going to the URL of your MediaWiki installation in your web browser: Follow the instructions in Manual:Config script.
Further configuration
- Manual:System administration#Configuration - Additional configuration
- নির্দেশনা:প্রশাসক - Wiki administration
Keep up to date!
Once installed, make sure you stay up to date with releases, and keep your server secure!
Appendices
Alternatives to manual installation
Manual installation is often the preferred method because it gives the user more control and insight into how their wiki is installed, making troubleshooting and maintenance easier. Automated processes, packages, bundles, and services all come with their own idiosyncrasies.
Instead of manually installing MediaWiki, alternative options might be easier:
- pre-integrated software appliances
- hosting services with 1-click installation, or wiki farms
- software bundles
- Hosting services which provide automatical installation of applications such as MediaWiki may offer outdated versions or have other issues. If you encounter problems, it does not mean that you cannot install MediaWiki. It means that you should install MediaWiki manually.
See also the comparison of distribution options.
System-specific instructions
The pages listed on Manual:OS specific help give more detailed installation instructions aimed at specific systems.
However, by and large these per-system docs are less maintained and might not always be up to date. First consult মিডিয়াউইকি ইনস্টল করা (this page) before looking at per-system installation documentation.
Running multiple wikis