Generic selectors
Exact matches only
Search in title
Search in content
Search in project

Debugging Tips

It is very common for users to have issues starting or connecting to their atavism servers due to the complex nature of the server and all the different setups it can be running on. This page contains tips on how to resolve the issues you are having. If you are still having trouble getting your server running or connecting to it please post on the forum.

General Server Debugging Tips

Server Commands

Checking the Status of the Server

You can check the status of the server to verify it is running by typing:

./world.sh -v -C status

Each server process should produce the message: RUNNING. If a process says: NOT RUNNING you will want to check the logs for that process.

Stopping the Server

The server can be stopped by typing:

./world.sh -v -C stop

Or if you are running Cygwin you can close the window to stop all server processes.

Server Logs

The server logs contain a lot of useful information about what is going on with the server processes. The server logs can be found in the server files/logs/ folder, with the world logs in the world folder and the auth logs in the auth folder. It can take some time getting used to finding your way through the logs to find what you are after, but some errors can be found very easily.

An additional log file, called errors.out can be found in the world logs folder. It contains all of the ERROR tagged log messages. This will often be the best place to look first, but often you will need to then look in the relevant process log to get a bit more information.

Note: The errors.out file is not reset after each server start, but the other logs are.

Problems Starting the Server

Java: Command Not Found

When starting the server a message may come up in the console similar to: ./auth.sh: line 241: java: command not found

This means cygwin cannot find Java installed on your computer. Make sure Java jre version 5 or newer is installed on your computer and that the environment variable for Java has been set (Instructions on how to do that to be added soon).

Access Denied for User

An error message saying: Access denied for user ‘root’@’localhost’ (using password: YES) or similar means the username or password specified in the properties file is not correct. Open up auth.props or world.props in the bin folder and change:

  • atavism.db_user=
  • atavism.db_password=

So they have the correct MySQL login details.

Access Denied for Remote Database

If the server is connecting to a remote database the server needs to be granted access to connect. This can be done by logging into the command line for the database and typing the following:

grant all on databasename.* to user@’ip address’ identified by ‘password’;

Replacing databasename, user, ip address and password with the correct information. Note that the ip address is the address of the machine where the atavism server is located. This needs to be done for all databases (master, admin and world_content).