From 3a5d13c8370926d978ef472092a7285437d43daf Mon Sep 17 00:00:00 2001 From: Chris Miles Date: Sat, 7 Jul 2018 00:38:28 -0500 Subject: [PATCH] Updated Development Server Setup (markdown) --- Development-Server-Setup.md | 74 +++++++++++++++++++++---------------- 1 file changed, 42 insertions(+), 32 deletions(-) diff --git a/Development-Server-Setup.md b/Development-Server-Setup.md index d424fe9..79684bc 100644 --- a/Development-Server-Setup.md +++ b/Development-Server-Setup.md @@ -1,31 +1,36 @@ +# Dev Server Folders + * As a developer - you may find the necessity to build a clean server/folder with the latest PEQ database without messing up an existing folder - today this is easy to do and applies for either Linux or Windows * **This assumes you have Perl / MySQL and the rest of the environment already installed** -### Creating a New Folder +#### Creating a New Folder * First, create your server folder that you wish use, the examples are going to be used with Linux, but the command line is almost identical for Windows - * In Linux - the base installer uses /home/eqemu/ - so let's use that directory as our base -``` +```text mkdir eqemu_test cd eqemu_test ``` -### Using eqemu_server.pl - -* Now that we are in our server folder, we can either copy the eqemu_server.pl from another server folder, or we can pull down a fresh copy from Github +#### Using eqemu\_server.pl +* Now that we are in our server folder, we can either copy the eqemu\_server.pl from another server folder, or we can pull down a fresh copy from Github * You can use curl, wget or manually create the file -> curl -O https://raw.githubusercontent.com/EQEmu/Server/master/utils/scripts/eqemu_server.pl eqemu_server.pl && chmod 755 eqemu_server.pl && ./eqemu_server.pl new_server -> wget --no-check-certificate --cache=no https://raw.githubusercontent.com/EQEmu/Server/master/utils/scripts/eqemu_server.pl -O eqemu_server.pl && chmod 755 eqemu_server.pl && ./eqemu_server.pl new_server +```bash +curl -O https://raw.githubusercontent.com/EQEmu/Server/master/utils/scripts/eqemu_server.pl eqemu_server.pl && chmod 755 eqemu_server.pl && ./eqemu_server.pl new_server +``` -### Setting Environment Parameters +```bash +wget --no-check-certificate --cache=no https://raw.githubusercontent.com/EQEmu/Server/master/utils/scripts/eqemu_server.pl -O eqemu_server.pl && chmod 755 eqemu_server.pl && ./eqemu_server.pl new_server +``` + +#### Setting Environment Parameters * The script will prompt for a few questions, this is to ask for a valid MySQL user/password so the script can install a new environment properly, it is also going to ask for your new database name so it can associate the new folder with that database -``` +```text [New Server] For a new server folder install, we assume Perl and MySQL are configured [New Server] This will install a fresh PEQ Database, with all server assets [New Server] You will need to supply database credentials to get started... @@ -35,36 +40,39 @@ cd eqemu_test [New Server] Success! We have a database connection [Input] Specify a NEW database name that PEQ will be installed to: peq_new ``` + * Note: If you do not supply valid MySQL credentials - the command will halt and not continue. Make sure to also use a simple database name to prevent issues -### Waiting for Installation +#### Waiting for Installation * Next, this is going to kick off installer routines - and build the source in the following directory: - * **/home/eqemu/eqemu_test**_source/Server/build + * **/home/eqemu/eqemu\_test**\_source/Server/build * When this is done compiling, the folder you created will by symlinked to this custom build directory * Once complete, you will see installation summary info presented to you -``` -[New Server] New server folder install complete -[New Server] Below is your installation info: -[Install] Installation complete... -[Install] Server Info (Save somewhere if needed): - - mysql_eqemu_db_name peq_new - - mysql_eqemu_user eqemu - - mysql_eqemu_password eqemu -[Install] Linux Utility Scripts: - - server_start.sh Starts EQEmu server (Quiet) with 30 dynamic zones, UCS & Queryserv, dynamic zones - - server_start_dev.sh Starts EQEmu server with 10 dynamic zones, UCS & Queryserv, dynamic zones all verbose - - server_stop.sh Stops EQEmu Server (No warning) - - server_status.sh Prints the status of the EQEmu Server processes -[Configure] eqemu_config.json Edit to change server settings and name -``` + + ```text + [New Server] New server folder install complete + [New Server] Below is your installation info: + [Install] Installation complete... + [Install] Server Info (Save somewhere if needed): + - mysql_eqemu_db_name peq_new + - mysql_eqemu_user eqemu + - mysql_eqemu_password eqemu + [Install] Linux Utility Scripts: + - server_start.sh Starts EQEmu server (Quiet) with 30 dynamic zones, UCS & Queryserv, dynamic zones + - server_start_dev.sh Starts EQEmu server with 10 dynamic zones, UCS & Queryserv, dynamic zones all verbose + - server_stop.sh Stops EQEmu Server (No warning) + - server_status.sh Prints the status of the EQEmu Server processes + [Configure] eqemu_config.json Edit to change server settings and name + ``` + * Type **exit** out of the menu and return back to the prompt -### Server Start Test +#### Server Start Test - * If necessary, return back to your original folder and start your respective start script whether you are in Windows or Linux, in Linux we will use ./server_start.sh +* If necessary, return back to your original folder and start your respective start script whether you are in Windows or Linux, in Linux we will use ./server\_start.sh -``` +```text root@debian:/home/eqemu/eqemu_test# ./server_start.sh [Status] Loading items... [Status] Loading factions... @@ -83,6 +91,8 @@ root@debian:/home/eqemu/eqemu_test# ./server_status.sh Akka's Linux Server Launcher World: UP Zones: (30/30) UCS: UP Queryserv: UP ``` -That's it! -Your new server parition should be ready for you to use and manipulate however you need \ No newline at end of file +That's it! + +Your new server parition should be ready for you to use and manipulate however you need +