Platform:Drupal/Drupal migration - Revision history

Mngr: Created page with "== Heritage Project: Drupal 11 Migration Blueprint (AlmaLinux 10.1) == === 1. Infrastructure Architecture === * '''Web Server:''' AlmaLinux 10.1 (Hyper-V VM) - Apache 2.4 / PHP 8.3 * '''Database Server:''' AlmaLinux 10.1 (Hyper-V VM) - MariaDB 10.11+ * '''Proxy:''' IIS ARR (Windows Server) - SSL Offloading & Reverse Proxy === 2. Installation Sequence (Web Server) === On the Web VM, execute the following to establish the "Secure Core": # '''Install Composer:''' #*
2026-05-14T17:24:31Z

Created page with "== Heritage Project: Drupal 11 Migration Blueprint (AlmaLinux 10.1) == === 1. Infrastructure Architecture === * '''Web Server:''' AlmaLinux 10.1 (Hyper-V VM) - Apache 2.4 / PHP 8.3 * '''Database Server:''' AlmaLinux 10.1 (Hyper-V VM) - MariaDB 10.11+ * '''Proxy:''' IIS ARR (Windows Server) - SSL Offloading & Reverse Proxy === 2. Installation Sequence (Web Server) === On the Web VM, execute the following to establish the "Secure Core": # '''Install Composer:''' #* <cod..."

New page
== Heritage Project: Drupal 11 Migration Blueprint (AlmaLinux 10.1) ==

=== 1. Infrastructure Architecture ===
* '''Web Server:''' AlmaLinux 10.1 (Hyper-V VM) - Apache 2.4 / PHP 8.3
* '''Database Server:''' AlmaLinux 10.1 (Hyper-V VM) - MariaDB 10.11+
* '''Proxy:''' IIS ARR (Windows Server) - SSL Offloading & Reverse Proxy

=== 2. Installation Sequence (Web Server) ===
On the Web VM, execute the following to establish the "Secure Core":

# '''Install Composer:'''
#* <code>php -r "copy('https://getcomposer.org', 'composer-setup.php');"</code>
#* <code>php composer-setup.php --install-dir=/usr/local/bin --filename=composer</code>
# '''Scaffold Drupal 11:'''
#* <code>cd /var/www</code>
#* <code>composer create-project drupal/recommended-project drupal</code>
#* ''Note: DocumentRoot must point to /var/www/drupal/web''

=== 3. Twin-Server Database Handshake ===
On the '''MariaDB VM''', grant remote access to the Web VM IP:
<syntaxhighlight lang="sql">
CREATE DATABASE drupal_heritage_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'drupal_admin'@'192.168.x.WEB_IP' IDENTIFIED BY 'PASSWORD';
GRANT ALL PRIVILEGES ON drupal_heritage_db.* TO 'drupal_admin'@'192.168.x.WEB_IP';
FLUSH PRIVILEGES;
</syntaxhighlight>

On the '''Web VM''', allow network connection via SELinux:
* <code>setsebool -P httpd_can_network_connect_db 1</code>

=== 4. Essential Module Stack ("The Pro Suite") ===
Install via Composer to ensure 10-year maintainability:
{| class="wikitable"
! Module !! Purpose !! Note

|-
| [[https://www.drupal.org|Admin Toolbar]] || Enhanced Navigation || DNN-style dropdown menus.
|-

| [[https://www.drupal.org|Gin Theme]] || Admin UI / Dark Mode || Essential for senior eye comfort.
|-

| [[https://www.drupal.org|ECA]] || Business Logic Engine || Visual workflow (replaces Cargo/Hooks).
|-

| [[https://www.drupal.org|Dashboards]] || User Landing Pages || Masking ICT complexity for historians.
|-

| [[https://www.drupal.org|Pathauto]] || Automatic Aliasing || Automatic URL generation from Unique IDs.
|}

=== 5. Rapid Data Model Import Workflow ===
To bridge the '''DBML''' model from VS Code to Drupal:
# '''Export DBML to YAML''' via VS Code.
# '''Translate to Drupal Config:''' Map entities to Node Types and relationships to Entity References.
# '''Sync Directory:''' Place YAML files in <code>/var/www/drupal/config/sync</code>.
# '''Import:''' <code>./vendor/bin/drush config:import</code>

=== 6. Survival & Maintenance Checklist ===
* '''Updates:''' <code>composer update</code> (Code) + <code>drush updb</code> (Database).
* '''Documentation:''' All custom Content Types and ECA Workflows must be mirrored in this MediaWiki.
* '''Backups:''' Snapshots of both Hyper-V VMs + MariaDB SQL dumps.