pa/eqemu-server
2
0
Fork 0
mirror of https://github.com/EQEmu/Server.git synced 2026-04-13 15:02:25 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Updated Development Server Setup (markdown)

Chris Miles 2018-07-07 00:38:28 -05:00
parent 94b772268b
commit 3a5d13c837
1 changed files with 42 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
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 * 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** * **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 * 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 * In Linux - the base installer uses /home/eqemu/ - so let's use that directory as our base
``` ```text
mkdir eqemu_test mkdir eqemu_test
cd eqemu_test cd eqemu_test
``` ```
### Using eqemu_server.pl #### 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
* 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 * 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 * 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] 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] This will install a fresh PEQ Database, with all server assets
[New Server] You will need to supply database credentials to get started... [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 [New Server] Success! We have a database connection
[Input] Specify a NEW database name that PEQ will be installed to: peq_new [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 * 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: * 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 * 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 * Once complete, you will see installation summary info presented to you
```
[New Server] New server folder install complete ```text
[New Server] Below is your installation info: [New Server] New server folder install complete
[Install] Installation complete... [New Server] Below is your installation info:
[Install] Server Info (Save somewhere if needed): [Install] Installation complete...
- mysql_eqemu_db_name peq_new [Install] Server Info (Save somewhere if needed):
- mysql_eqemu_user eqemu - mysql_eqemu_db_name peq_new
- mysql_eqemu_password eqemu - mysql_eqemu_user eqemu
[Install] Linux Utility Scripts: - mysql_eqemu_password eqemu
- server_start.sh Starts EQEmu server (Quiet) with 30 dynamic zones, UCS & Queryserv, dynamic zones [Install] Linux Utility Scripts:
- server_start_dev.sh Starts EQEmu server with 10 dynamic zones, UCS & Queryserv, dynamic zones all verbose - server_start.sh Starts EQEmu server (Quiet) with 30 dynamic zones, UCS & Queryserv, dynamic zones
- server_stop.sh Stops EQEmu Server (No warning) - server_start_dev.sh Starts EQEmu server with 10 dynamic zones, UCS & Queryserv, dynamic zones all verbose
- server_status.sh Prints the status of the EQEmu Server processes - server_stop.sh Stops EQEmu Server (No warning)
[Configure] eqemu_config.json Edit to change server settings and name - 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 * 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 root@debian:/home/eqemu/eqemu_test# ./server_start.sh
[Status] Loading items... [Status] Loading items...
[Status] Loading factions... [Status] Loading factions...
@ -83,6 +91,8 @@ root@debian:/home/eqemu/eqemu_test# ./server_status.sh
Akka's Linux Server Launcher Akka's Linux Server Launcher
World: UP Zones: (30/30) UCS: UP Queryserv: UP World: UP Zones: (30/30) UCS: UP Queryserv: UP
``` ```
That's it! That's it!
Your new server parition should be ready for you to use and manipulate however you need Your new server parition should be ready for you to use and manipulate however you need