From 725686d1cd77f3f4382ec03f7c2185c4e9179378 Mon Sep 17 00:00:00 2001 From: Sarjuuk Date: Wed, 8 Apr 2026 14:43:30 +0200 Subject: [PATCH] Setup/Help * be more clear that connecting to auth and characters db is conditional * updated some lost references to renamed databases and config options --- README.md | 4 ++-- includes/components/profiler.class.php | 2 +- setup/tools/clisetup/dbconfig.us.php | 12 +++++++++--- setup/tools/clisetup/setup.us.php | 2 ++ setup/tools/clisetup/update.us.php | 9 +++++++-- 5 files changed, 21 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 110ff55e..e182aced 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,7 @@ audio processing may require [lame](https://sourceforge.net/projects/lame/files/ `git clone git@github.com:Sarjuuk/MPQExtractor.git MPQExtractor` #### 2. Prepare the database -Ensure that the account you are going to use has **full** access on the database AoWoW is going to occupy and ideally only **read** access on the world database you are going to reference. +Ensure that the account you are going to use has **full** access on the database AoWoW is going to occupy and ideally only **read** access on the world and optionally auth and characters databases you are going to reference. Import files 01 - 03 from `setup/sql/` in order into the AoWoW database `mysql --default-character-set=utf8 -p {your-db-here} < setup/sql/01-db_structure.sql`, etc. **Optional**: If you are using MySQL ≥ 8.4.0 and want to support fulltext search for locale zhCN, additionally import `setup/sql/04-db_optional_mysql_only.sql`. Enables this in settings after AoWoW has been set up. @@ -104,7 +104,7 @@ When you've created your admin account you are done. ## Troubleshooting Q: The Page appears white, without any styles. -A: The static content is not being displayed. You are either using SSL and AoWoW is unable to detect it or STATIC_HOST is not defined properly. Either way this can be fixed via config `php aowow --siteconfig` +A: The static content is not being displayed. You are either using SSL and AoWoW is unable to detect it or STATIC_HOST is not defined properly. Either way this can be fixed via config `php aowow --configure` Q: Fatal error: Can't inherit abstract function \ (previously declared abstract in \) in \ A: You are using multiple cache optimization modules for php that are in conflict with each other. (Zend OPcache, XCache, ..) Disable all but one. diff --git a/includes/components/profiler.class.php b/includes/components/profiler.class.php index 9dc17fea..e3c4d452 100644 --- a/includes/components/profiler.class.php +++ b/includes/components/profiler.class.php @@ -257,7 +257,7 @@ class Profiler { self::getRealms(); - // sort depends on encountered order in `logon`.`realmlist`. Is that a problem? + // sort depends on encountered order in `auth`.`realmlist`. Is that a problem? return array_unique(array_column(self::$realms, 'region')); } diff --git a/setup/tools/clisetup/dbconfig.us.php b/setup/tools/clisetup/dbconfig.us.php index 35557c61..e2120989 100644 --- a/setup/tools/clisetup/dbconfig.us.php +++ b/setup/tools/clisetup/dbconfig.us.php @@ -85,7 +85,7 @@ CLISetup::registerUtility(new class extends UtilityScript { CLI::write(); if (!DB::isConnectable(DB_AUTH) || !$this->test()) - CLI::write('[db] auth server not yet set up.', CLI::LOG_ERROR); + CLI::write('[db] auth db not yet set up.', CLI::LOG_ERROR); else if ($realms = DB::Auth()->selectAssoc('SELECT `id` AS "0", `name` AS "1", `icon` AS "2", `timezone` AS "3", `allowedSecurityLevel` AS "4" FROM realmlist')) { $tbl = [['Realm Id', 'Name', 'Type', 'Region', 'GMLevel', 'Status']]; @@ -309,15 +309,21 @@ CLISetup::registerUtility(new class extends UtilityScript $buff[] = $dbInfo['prefix'] ? 'pre.: '.$dbInfo['prefix'] : ''; $buff[] = $note; } + else if ($idx == DB_AUTH) + $buff[] = CLI::bold(''); else - $buff[] = CLI::bold(''); + $buff[] = CLI::bold(''); return $buff; } public function writeCLIHelp() : bool { - CLI::write(' Remember to use the correct Realm Id from '.CLI::bold('`logon`.`realmlist`').' when connecting to your characters DB.', -1, false); + CLI::write(' Connecting to '.CLI::bold('`auth`').' is optional and only required when using the character profiler tool or using the game accounts for login.', -1, false); + CLI::write(); + CLI::write(' Connecting to '.CLI::bold('`characters`').' is optional and only required when using the character profiler tool.', -1, false); + CLI::write(' Remember to use the correct Realm Id from '.CLI::bold('`auth`.`realmlist`').' when connecting to your characters DB.', -1, false); + CLI::write(); CLI::write(' To remove a db entry edit it and leave all fields empty.', -1, false); CLI::write(); CLI::write(); diff --git a/setup/tools/clisetup/setup.us.php b/setup/tools/clisetup/setup.us.php index 60c312e2..5b8c4762 100644 --- a/setup/tools/clisetup/setup.us.php +++ b/setup/tools/clisetup/setup.us.php @@ -170,8 +170,10 @@ CLISetup::registerUtility(new class extends UtilityScript CLI::write(' usage: php aowow --setup [--locales: --datasrc:] [--step=]', -1, false); CLI::write(); CLI::write(' Initially essential connection information are set up and basic connectivity tests run afterwards.', -1, false); + CLI::write(); CLI::write(' In the main stage dbc and world data is compiled into the database and required sound, image and data files are generated.', -1, false); CLI::write(' This should not require further input and will take about 15-20 minutes, plus 10 minutes per additional locale.', -1, false); + CLI::write(); CLI::write(' Lastly pending updates are applied and you are prompted to create an administrator account.', -1, false); if (($startStep = $this->getSavedStartStep()) !== 0) diff --git a/setup/tools/clisetup/update.us.php b/setup/tools/clisetup/update.us.php index 7f4fd99f..9b4cc185 100644 --- a/setup/tools/clisetup/update.us.php +++ b/setup/tools/clisetup/update.us.php @@ -111,8 +111,13 @@ CLISetup::registerUtility(new class extends UtilityScript CLI::write(); CLI::write(' Checks /setup/sql/updates for new *.sql files and applies them. If required by an applied update, the --sql and --build command are triggered afterwards.', -1, false); CLI::write(' Use this after fetching the latest rev. from Github.', -1, false); - CLI::write(); - CLI::write(' Last Update: '.date(Util::$dateFormatInternal, $this->date).' (Part #'.$this->part.')', -1, false); + + if ($this->date) + { + CLI::write(); + CLI::write(' Last Update: '.date(Util::$dateFormatInternal, $this->date).' (Part #'.$this->part.')', -1, false); + } + CLI::write(); CLI::write();