Clustering servers in Atlas is a bit of a daunting task for beginners, so I've written a guide on how to do it that should hopefully make it a bit easier.
-
Create a map the same size as the number of servers you have available, if you have 2 services 1x2 map would be needed, 4 services 2x2 map and so on. The map creation is done within the devs map tool here https://github.com/GrapeshotGames/ServerGridEditor
-
CTRL + left-click on the map you have created within the map editor tool (somewhere on the water, you need to do this for each square)
-
Ensure the IP, Port, GamePort and SeamlessDataPort are all correct. Everything else doesn’t matter (keep additional command line parameters clear) You can find what these should be by looking at your main server's current ServerGrid.json file under ShooterGame folder on their server. It will look something like this
"servers": [
{
"gridX": 0,
"gridY": 0,
"MachineIdTag": "",
"ip": "95.154.229.132",
"name": "servernamehere",
"port": 32005,
"gamePort": 32001,
"seamlessDataPort": 32015,
-
Atlas ID can be found in your current ServerGrid.json file next to "WorldAtlasId": "208108208108208108208108", (In this example it's 208108208108208108208108208108)
-
Click edit at the bottom of the box in the map editor when you have finished inputting the name, IP, ports and Atlas ID
-
Click export then click local export (these files will go to the map editors export folder no matter where you told it to save, so be aware of that)
-
Upload the JPG files to your ShooterGame\ServerGrid folder (remove the old ones first)
-
Open the Servergrid.json file in the configuration files section of the game panel and paste in everything from the newly generated ServerGrid.json file in the export folder of the map editor
-
Run the wipe database button on your main server (If you haven't chosen a main server by now, pick one, it should be the same one you did step 7 & 8 for)
Note: The configuration files in your game panel ServerGrid.json CANNOT be used with the configuration editor, if you do, you will wipe your map, you must use text editor from now on
-
Contact support and ask them to switch your cluster servers (everything other than your main server) to an "Additional Server" provide IP's and ports of the servers in question, so there is no confusion
- The same ServerGrid.json contents can be copied from the main server to all the others (all the additional servers connect to the main server's redis database)
-
Upload the JPG files from the map editor export folder to all additional servers.
-
On each additional server create a new custom command line, name it whichever square of the server it is (i.e. 0-1 or 1-3 etc) tick X, Y and Alt Directory, For X enter the first number in the server co-ords, for Y enter the second i.e. X=0, Y=1 (you can find the co-ords on the map editor, e.g. In a 2x2 map top left square is x=0 y=0, bottom right would be x=1 y=1) do not tick server name
-
After the config files have been copied, the command lines changed and the files uploaded to ServerGrid start up the main server, wait for 5 minutes then start up the others 1 by 1
Troubleshooting
- Some servers are stuck around 350MB RAM.
This problem occurs if there's a problem with that server's database connection. To fix:
Stop the effected servers
Copy and paste the entire contents of the ServerGrid.ServerOnly.json file on the master, into the ServerGrid.ServerOnly.json file on the server/s that have the problem
This problem occurs if you've already created a player on another server and are joining a different server. To fix:
Join the server your character is located on.
- Shut down one server, and tried to join another, but I can't.
This happens when you've created a player, or your player is located, on the server that's been shut down, to fix:
Turn the server that you shut down back on again, and move your character to another server.
If you no longer have that server, you will have to wipe your database and start over. This will delete all players, there is no currently known way to remove your character data from the database without a full wipe. To wipe the database; stop all servers and stop the click the "Wipe Redis Database" button on your master server.
Looking for a game server host known for brilliant 24/7 customer support and quality hardware?
Try a Pingperfect Atlas server today! https://pingperfect.com/gameservers/atlas-game-server-hosting-rental.php
