summaryrefslogtreecommitdiff
path: root/docs/linux-restarter.md
blob: 8ef84c45b4f7ef59f7d477c7322f3cd9de22581f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
## Introduction
This tutorial will walk you through creating a script to restart AzerothCore after a shutdown, restart, or crash when using a Linux server.

The easiest way to setup a restarter is by using our [integrated scripts or docker](how-to-restart-and-debug.md)

However, the following guy will show you how to create your own restarter from scratch.

## Creating The Scripts
#### Prerequisites
- Verify that your Linux server has screen and nano installed.

```sh
sudo apt-get update && sudo apt-get install screen nano
```

- Once you've installed screen and nano, continue on to the next step.

#### Script Creation
- Navigate to your server bin directory `~/azeroth-server/bin` and type `nano auth.sh`
- In the new nano screen, enter the following script:

```sh
#!/bin/sh
while :; do
./authserver
sleep 20
done
```

- Once entered, press Ctrl + O, hit Enter, and then Ctrl + X. That will save the new script and return you to the terminal. We've just created the Authserver restart script. Let's next create the Worldserver script.
- Type `nano world.sh`
- In the new nano screen, enter the following script:

```sh
while :; do
./worldserver
sleep 20
done
```

- Once entered, press Ctrl + O, hit Enter, and then Ctrl + X. That will save the new script and return you to the terminal. We've just created the Worldserver restart script. Let's next create a script that will launch both the Authserver and Worldserver restarter scripts.
- Type `nano restarter.sh`

```sh
#!/bin/bash
screen -AmdS auth ./auth.sh
screen -AmdS world ./world.sh
```

- Once entered, press Ctrl + O, hit Enter, and then Ctrl + X. Finally, let's create our server shutdown script.
- Type `nano shutdown.sh`

```sh
#!/bin/bash
screen -X -S "world" quit
screen -X -S "auth" quit
```

- Once entered, press Ctrl + O, hit Enter, and then Ctrl + X. Next, let's start our server.

## Server Management
#### Server Startup
- To start your server with the scripts, ensure you are in you server bin directory `~/azeroth-server/bin`.
- We will start the restart scripts by typing the following command `./restarter.sh`
- Side note: If you wish to start the server and see the worldserver console, use the following command `./restarter.sh; screen -r world`

#### Server Monitoring
- To access and view the Authserver or Worldserver consoles:
-- Authserver: `screen -r auth`
-- Worldserver: `screen -r world`
- When you want to exit the screen and return to your terminal, type Ctrl + A, followed by D.

#### Server Shutdown
- To terminate the restarter and shutdown your server, ensure you are in you server bin directory `~/azeroth-server/bin`.
- Type `./shutdown.sh` and the scripts will turn off and your server will terminate.