JDK Installation Guide
JDK Installation Guide
This guide provides a comprehensive walkthrough of installing the Java Development Kit (JDK) on a server environment, focusing on configurations commonly used with MediaWiki. A properly installed JDK is crucial for various server-side operations, including running Java-based extensions, processing certain data formats, and ensuring compatibility with specific server applications. This guide assumes you have basic server administration knowledge, including access to a command-line interface.
Prerequisites
Before beginning, ensure you have the following:
- A server with a supported operating system (e.g., Linux, Windows Server).
- Root or administrator privileges on the server.
- An internet connection to download the JDK.
- Understanding of your server's operating system package manager (e.g., `apt`, `yum`, `dnf`).
- **`java -version` command not found:** Ensure that the `JAVA_HOME` environment variable is set correctly and that `%JAVA_HOME%\bin` or `$JAVA_HOME/bin` is in your `Path`.
- **Incorrect JDK version:** Verify that you have installed the correct JDK version for your needs and that the `JAVA_HOME` variable points to the correct installation.
- **Permissions issues:** Ensure that the user account running the application has the necessary permissions to access the JDK installation directory. Consider using a dedicated system user for running Java applications.
- **Conflicts with other Java installations:** If you have multiple Java versions installed, ensure that the correct version is being used by setting the `JAVA_HOME` variable appropriately. You can use tools like `update-alternatives` on Debian/Ubuntu to manage multiple Java installations. See also Java Virtual Machine.
- Oracle Java Documentation
- Adoptium Temurin
- MediaWiki Extension Development
- Server Security
- Performance Tuning
- Telegram: @powervps Servers at a discounted price
Choosing a JDK Version
The choice of JDK version depends on the requirements of your MediaWiki installation and any associated extensions. Generally, using a Long-Term Support (LTS) version is recommended for stability. As of late 2023, the most common LTS versions are JDK 8, JDK 11, JDK 17, and JDK 21. Check the compatibility matrix for your specific MediaWiki version and extensions to determine the appropriate JDK.
Recommended JDK Versions
| JDK Version | Support Status | Recommended Use Cases |
|---|---|---|
| JDK 8 | LTS (Limited Support) | Older MediaWiki installations, legacy extensions. |
| JDK 11 | LTS (Full Support) | Commonly used for stable MediaWiki environments. |
| JDK 17 | LTS (Full Support) | Newer installations, improved performance, modern features. |
| JDK 21 | LTS (Early Access) | Cutting-edge installations, testing new features. |
Installation Methods
There are several ways to install the JDK. The method you choose depends on your operating system and preferences.
Linux (Debian/Ubuntu)
The following steps install OpenJDK 17 using `apt`:
1. Update the package index: `sudo apt update` 2. Install the JDK: `sudo apt install openjdk-17-jdk` 3. Verify the installation: `java -version`
Linux (Red Hat/CentOS/Fedora)
The following steps install OpenJDK 17 using `yum` or `dnf`:
1. Update the package index: `sudo yum update` or `sudo dnf update` 2. Install the JDK: `sudo yum install java-17-openjdk-devel` or `sudo dnf install java-17-openjdk-devel` 3. Verify the installation: `java -version`
Windows Server
1. Download the JDK installer from the Oracle website or an OpenJDK distribution like Adoptium. 2. Run the installer and follow the on-screen instructions. 3. Set the `JAVA_HOME` environment variable to the JDK installation directory (e.g., `C:\Program Files\Java\jdk-17.0.2`). 4. Add `%JAVA_HOME%\bin` to the `Path` environment variable. 5. Verify the installation: Open a new command prompt and run `java -version`.
Configuring Environment Variables
Setting the `JAVA_HOME` environment variable is crucial for many applications to locate the JDK.
Setting JAVA_HOME (Linux)
Add the following line to your `.bashrc` or `.zshrc` file (replace `/usr/lib/jvm/java-17-openjdk-amd64` with the actual JDK installation path):
```bash export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH ```
Then, source the file: `source ~/.bashrc` or `source ~/.zshrc`
Setting JAVA_HOME (Windows)
1. Search for "environment variables" in the Start menu. 2. Click "Edit the system environment variables". 3. Click "Environment Variables...". 4. Under "System variables", click "New...". 5. Variable name: `JAVA_HOME` 6. Variable value: `C:\Program Files\Java\jdk-17.0.2` (or your JDK installation path) 7. Edit the `Path` variable and add `%JAVA_HOME%\bin`.
Verifying the Installation
After installation, verify that the JDK is correctly installed and configured.
Verification Steps
| Command | Expected Output |
|---|---|
| `java -version` | Displays the JDK version information. |
| `javac -version` | Displays the Java compiler version information. |
| `echo $JAVA_HOME` (Linux/macOS) | Displays the path to the JDK installation directory. |
| `echo %JAVA_HOME%` (Windows) | Displays the path to the JDK installation directory. |
Troubleshooting
Further Resources
Intel-Based Server Configurations
| Configuration | Specifications | Benchmark |
|---|---|---|
| Core i7-6700K/7700 Server | 64 GB DDR4, NVMe SSD 2 x 512 GB | CPU Benchmark: 8046 |
| Core i7-8700 Server | 64 GB DDR4, NVMe SSD 2x1 TB | CPU Benchmark: 13124 |
| Core i9-9900K Server | 128 GB DDR4, NVMe SSD 2 x 1 TB | CPU Benchmark: 49969 |
| Core i9-13900 Server (64GB) | 64 GB RAM, 2x2 TB NVMe SSD | |
| Core i9-13900 Server (128GB) | 128 GB RAM, 2x2 TB NVMe SSD | |
| Core i5-13500 Server (64GB) | 64 GB RAM, 2x500 GB NVMe SSD | |
| Core i5-13500 Server (128GB) | 128 GB RAM, 2x500 GB NVMe SSD | |
| Core i5-13500 Workstation | 64 GB DDR5 RAM, 2 NVMe SSD, NVIDIA RTX 4000 |
AMD-Based Server Configurations
| Configuration | Specifications | Benchmark |
|---|---|---|
| Ryzen 5 3600 Server | 64 GB RAM, 2x480 GB NVMe | CPU Benchmark: 17849 |
| Ryzen 7 7700 Server | 64 GB DDR5 RAM, 2x1 TB NVMe | CPU Benchmark: 35224 |
| Ryzen 9 5950X Server | 128 GB RAM, 2x4 TB NVMe | CPU Benchmark: 46045 |
| Ryzen 9 7950X Server | 128 GB DDR5 ECC, 2x2 TB NVMe | CPU Benchmark: 63561 |
| EPYC 7502P Server (128GB/1TB) | 128 GB RAM, 1 TB NVMe | CPU Benchmark: 48021 |
| EPYC 7502P Server (128GB/2TB) | 128 GB RAM, 2 TB NVMe | CPU Benchmark: 48021 |
| EPYC 7502P Server (128GB/4TB) | 128 GB RAM, 2x2 TB NVMe | CPU Benchmark: 48021 |
| EPYC 7502P Server (256GB/1TB) | 256 GB RAM, 1 TB NVMe | CPU Benchmark: 48021 |
| EPYC 7502P Server (256GB/4TB) | 256 GB RAM, 2x2 TB NVMe | CPU Benchmark: 48021 |
| EPYC 9454P Server | 256 GB RAM, 2x2 TB NVMe |
Order Your Dedicated Server
Configure and order your ideal server configurationNeed Assistance?
⚠️ *Note: All benchmark scores are approximate and may vary based on configuration. Server availability subject to stock.* ⚠️