Updated Development Server Setup (markdown)

Chris Miles
2018-07-07 00:38:28 -05:00
parent 94b772268b
commit 3a5d13c837
+40 -30
@@ -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