Updated Development Server Setup (markdown)

Chris Miles 2018-07-07 00:38:28 -05:00
parent 94b772268b
commit 3a5d13c837

@ -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
That's it!
Your new server parition should be ready for you to use and manipulate however you need