EQ2Emulator - User contributions [en]

Admins:Linux Server:CentOS

2008-05-01T06:50:40Z

Hippsta: /* Guide Written By: Hippsta */

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.
As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.

== CentOS / Fedora / RedHat ==

Before you even touch the emulator you must install/update the following packages, as well as their required dependencies from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. (The platforms currently supported are: aix ansi bsd freebsd generic linux macosx mingw posix solaris)

Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====
Special Thanks to Andrew, for the parts I didn't feel like rewriting :P

Admins:Linux Server

2008-05-01T05:29:35Z

Hippsta: /* Linux Distribution List */

===Linux Distribution List===
*[[Admins:Linux Server:ArchLinux|ArchLinux]]
*[[Admins:Linux Server:Gentoo|Gentoo]]
*[[Admins:Linux Server:Ubuntu|Ubuntu]]
*[[Admins:Linux Server:CentOS|CentOS]]

Admins:Linux Server:CentOS

2008-05-01T05:27:13Z

Hippsta: /* Lua 5.1.3 */

Admins:Linux Server:CentOS

2008-05-01T05:24:50Z

Hippsta:

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.
As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.

== CentOS / Fedora / RedHat ==

Before you even touch the emulator you must install/update the following packages, as well as their required dependencies from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are: aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server:CentOS

2008-05-01T05:21:17Z

Hippsta:

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.
(CentOS, Fedora, RHEL3+)
In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.

== CentOS / Fedora / RedHat ==

Before you even touch the emulator you must install/update the following packages, as well as their required dependencies from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are: aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server:CentOS

2008-05-01T05:20:11Z

Hippsta: /* Lua 5.1.3 */

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.
(CentOS, Fedora, RHEL3+)

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.

== CentOS / Fedora / RedHat ==

Before you even touch the emulator you must install/update the following packages, as well as their required dependencies from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are: aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server:CentOS

2008-05-01T05:18:20Z

Hippsta: /* CentOS / Fedora / RedHat */

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.
(CentOS, Fedora, RHEL3+)

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.

== CentOS / Fedora / RedHat ==

Before you even touch the emulator you must install/update the following packages, as well as their required dependencies from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are:
aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server:CentOS

2008-05-01T05:14:50Z

Hippsta: /* Security */

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.
(CentOS, Fedora, RHEL3+)

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.

== CentOS / Fedora / RedHat ==

Before we even touch the emulator you must install/update the following packages, as well as their required dependencies needed from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are:
aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server:CentOS

2008-05-01T05:12:06Z

Hippsta: CentOS, Fedora, RedHat Tutorial

__NOTOC__
This page details how to Install the Emulator on CentOS Linux.

As CentOS is based on the RHEL kernel, this tutorial is likely valid for most redhat-based distros.
(CentOS, Fedora, RHEL3+)

In this tutorial we are going to install the dependencies, download the latest version of the source code from the repository, compile it and start a server.

== CentOS / Fedora / RedHat ==

Before we even touch the emulator you must install/update the following packages, as well as their required dependencies needed from the repositories. (I'm assuming you are logged in as root, if not use sudo or su - )
But first we're going to enable the atomic turtle repo.

wget http://www.atomicrocketturtle.com/RPM-GPG-KEY.art.txt
rpm --import RPM-GPG-KEY.art.txt
wget -q -O - http://www.atomicorp.com/installers/atomic.sh | sh

Then:

yum install mysql-* mysqlclient14* binutils subversion glibc* zlib gcc*

== Lua 5.1.3 ==
Once those are done, you must now download and compile Lua 5.1.3:

cd /etc
wget http://www.lua.org/ftp/lua-5.1.3.tar.gz
tar xvzf lua-5.1.3.tar.gz
cd lua-5.1.3

Building Lua on Unix systems should be very easy. First do "make" and see if your platform is listed. If so, just do "make xxx", where xxx is your platform name. The platforms currently supported are:
aix ansi bsd freebsd generic linux macosx mingw posix solaris
Eventhough we are using linux, lets use posix to make lua.. otherwise the dynamic linker (ld) fails during make of the emulator.

make posix
make install

and finally the main event!

== Download the source ==

To compile and run the server you must install download the source code. For this example we are going to run our server in a folder called eq2server and download the code into a folder called eq2emulator.

mkdir eq2server
cd eq2server
svn co https://eq2emulator.svn.sourceforge.net/svnroot/eq2emulator eq2emulator

== Compile it ==

Now we have downloaded the source we need to compile it. If you are compiling the source on a 64 bit OS then you will need to change the makefile located in the Source/World folder.

cd eq2emulator/Source/World/

Open the makefile and change -llua5.1 to -llua

make clean
make

This should compile the source code and you will be left with a program called eq2world.

== Setting it up ==

Now you have built the program you need to put all the pieces together. Copy the following files into the eq2server folder.

/eq2emulator/Source/World/eq2world
/eq2emulator/Config Files/EQ2_Structs.xml
/eq2emulator/Config Files/LoginServer.ini
/eq2emulator/Config Files/world_db.ini
/eq2emulator/Config Files/World\ Structs/WorldStructs.xml
/eq2emulator/Config Files/World\ Structs/charactersheet_struct.txt
/eq2emulator/Config Files/Common\ Structs/CommonStructs.xml

Once you have done that you will now have to edit a few files. First open LoginServer.ini

worldname=WORLD_NAME_HERE
worldaddress=EXTERNAL_IP_HERE
#internalworldaddress=INTERNAL_IP_HERE (If used, otherwise blank)

* worldname should be the name you registered your server as on eq2emulator.net.
* worldaddress should be your IP address as seen by other people. If you do not know your IP address you can get it from [http://www.whatismyip.com/ whatismyip.com]
* internalworldaddress is your internal IP address in cases where you are behind a router you may have a different IP address as seen from the outside.

After that you must then edit world_db.ini which holds your database information.

host=ip address
user=username
password=password
database=eq2

* host refers to your MySQL IP address. If your MySQL database is on the same computer that is running that server then put "localhost" (without quotes)
* user is your MySQL username that you want the login server to connect to your database with
* password is your MySQL password
* database is the name of the database on your MySQL server.

Make sure this User / Database exists, and that the user has full permissions on every table.

GRANT ALL ON dbname.* TO user IDENTIFIED BY 'password'

== Starting Your World ==

After you have completed the entire compilation, and pre-req setup process without error, the following will start your world server.

cd eq2server
./eq2world

To stop your world the following will need to be typed

'Ctrl-C'
killall -9 eq2world*

== Security ==

Now is when we want to create a different user for the eq2world server to run as.
It is very wise to run as few services as root as possible.

Useradd name -G group -d /path/to/emulator
cd ..
chown -R name:group eq2server/

Make sure to also open/forward ports 9000, 9100, 9101, and 9102 in your firewall/router.

If anyone has any questions, or if I forgot something;
Feel free to PM me on the forum.

Thanks! :)

==== Guide Written By: Hippsta ====

Admins:Linux Server

2008-05-01T04:20:29Z

Hippsta: /* Linux Distribution List */

===Linux Distribution List===
[[Admins:Linux Server:ArchLinux|ArchLinux]]
[[Admins:Linux Server:Gentoo|Gentoo]]
[[Admins:Linux Server:Ubuntu|Ubuntu]]
[[Admins:Linux Server:CentOS|CentOS]]