Installation (CentOS)

This guide covers how to install [Hercules] on wikipedia:CentOS
and other wikipedia:List_of_Linux_distributions#RPM-based that use wikipedia:Yellowdog_Updater,_Modified.

• Requirements
• Prerequisites
  • Install Prerequisites
  • Create a non-root Linux user
  • Configure MySQL
    • Set a root password
    • Create SQL database for Hercules
    • Setup a MySQL user for Hercules
• Install Hercules
  • Login as your non-root Linux user
  • Git Clone
  • Import MySQL
  • :Category:Configuration
  • Compile Source Code
    • How to Recompile
• Start your Hercules Server
• See Also

Requirements

• wikipedia:CentOS or an wikipedia:List_of_Linux_distributions#RPM-based that has the wikipedia:Yellowdog_Updater,_Modified command
• root access or access to an account that has wikipedia:Sudo
• an Internet connection to download install packages

Prerequisites

All of these commands will be typed at the wikipedia:Command-
line_interface.

Install Prerequisites

1. Login to your server via wikipedia:Secure_Shell, or if you are already logged into a wikipedia:Graphical_user_interface press Ctrl+Alt+T to open a terminal window.

2. Type the following command (this will install GCC, Make, MySQL, MySQL header files, MySQL Server, PCRE header files, Git, and Zlib header files)

   yum install gcc make mysql mysql-devel mysql-server pcre-devel git zlib-devel
   

3. (Optional) type the following command to install some additional packages:

   yum -y install dos2unix gdb nano screen unzip wget zip
   

Create a non-root Linux user

By the wikipedia:Principle_of_least_privilege, it is recommended you do NOT run Hercules as root.

1. Type the following command to create a non-root Linux account:

   useradd --create-home --shell /bin/bash hercules1234
   
   --create-home
   

= create the user's home directory

    --shell

= sets their login shell to wikipedia:Bash_(Unix_shell)

 **

    hercules1234

** = the login name of the new Linux account

 _

    1234

_ = pick your own random numbers to make the username more unique

1. Set a password for the new user (run this command and follow the prompts):

   passwd hercules1234
   

Configure MySQL

Set a root password

The default MySQL Server install creates a MySQL user 'root'@'localhost' with
NO password. It is recommended you create a password for the root user.

1. Run this command and follow the prompts:

   First Start MySQL:

   /etc/init.d/mysqld start
   

   Then configure MySQL by:

   mysql_secure_installation
   

2. Login to your MySQL Server as root:

   When prompted, enter your root MySQL password.

   mysql --user=root -p
   

3. Now your prompt should look like this (the MySQL command prompt):

   mysql>
   

Create SQL database for Hercules

1. At the MySQL prompt, type this to create a database (replace

   hercules1234
   

with the Linux username you created earlier):

    mysql> CREATE DATABASE hercules1234_rag;

1. Create a separate database for logs:

   mysql> CREATE DATABASE hercules1234_log;
   

Setup a MySQL user for Hercules

1. At the MySQL prompt, type something like this to create a new MySQL user:

   mysql> CREATE USER 'hercules1234'@'localhost' IDENTIFIED BY 'secretpassword';
   
   hercules1234
   

= the name of the MySQL user (we named it the same as the Linux user to make
it easier to identify)

    localhost

= the hostname or IP it will connect from

 **

    secretpassword

** = the password for this MySQL user

1. Grant privileges to the 'hercules' MySQL user:

   mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON `hercules1234\_rag`.* TO 'hercules1234'@'localhost';
   
   mysql> GRANT SELECT,INSERT ON `hercules1234\_log`.* TO 'hercules1234'@'localhost';
   

(note the escaped underscore)

Install [Hercules]

Login as your non-root Linux user

The rest of the setup is done as hercules1234 (the Linux user you created in
step 2.2)

1. Logout from root SSH (or minimize the window).
2. Login to your server via SSH as the hercules1234 Linux user.

Git Clone

{{:Git Clone/Unix}}

Import MySQL

Tables

1. Change directory to the sql-files folder.

   cd sql-files/
   

2. Execute these commands:

   When prompted, enter your MySQL root password.

   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodblog
   

3. If your Control Panel software or website requires it, you may also import the item, monster and monster skill databases (not necessary for the correct operation of Hercules)

   (pre-renewal)

   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   

   (renewal)

   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   

   (common to renewal and pre-renewal)

   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   
   mysql -u root -prootpassword hercuser_rodb
   

NOTE: if you want to use different SQL DBs for login/char/map servers this is
the list of databases each server use:

1. login-server: global_acc_reg_num_db, global_acc_reg_str_db, ipbanlist, login, loginlog
2. map-server: autotrade_data, autotrade_merchants, mapreg, npc_market_data
3. char-server: everything else

Note that the sql_updates table is needed by all three servers.

:Category:Configuration

Compile Source Code

cd Hercules
./configure
make sql

How to Recompile

In the future (after you update or edit any file in /src) to recompile, add
make clean before make sql:

cd Hercules
./configure
**make clean**
make sql

Start your Hercules Server

//change access mode of athena-start file so that you can execute it.
//Use (dos2unix athena-start) if yo uare getting ^M errors ie. newline errors 
chmod a+x athena-start



//To Start
./athena-start start
//To Stop
./athena-start stop
//To Restart
./athena-start restart

See Also

Category:Installation Guides