Currently i'm working on a server + client release and the corresponding guide...
In this thread i wanna create a workspace for developement and testing, i'll update the guide and files constantly until they are in a stable state and then i'll release them in an extra thread...
Requirements
- A computer with non-changing ip address
- Internet connection for this computer
- Basic linux skills
1. Install Debian 5.x
You can skip this if Debian is already installed (i.e. vServer)
Internet access is required
- Download Debian 5.x netinstall and burn image to CD
- Boot your PC from CD
- Most of the installation process should be self explaining
- As file system i've selected ext2, if you plan to handle a large amount of small files you should choose a journaling file system i.e. ReiserFS
- When the installer ask for package selection deselect all packages, we will install everything on our own
- After installation is complete, remove CD and reboot
- Login as root with the root password that you had set during installation
- First we update the source list
COMMAND~: apt-get update
- Now we install the first package, the SSH server that will allow you remote access
COMMAND~: apt-get install openssh-server
- The server files used in this guide are bzip2 compressed, bzip2 is required to decompress the files
COMMAND~: apt-get install bzip2
2. Install Kernel
The generic kernel when installing Debian uses ~150 MB RAM, so we going to install a server kernel with a memory footprint of ~40 MB.
If you have enough RAM you can skip this.
SKIP THIS IF YOUR MACHINE IS A VSERVER !!!
- Figure out which kernel you use i.e. linux-image-2.6.26-2-686
COMMAND~: uname -r
- Now view a list of available kernel images
COMMAND~: apt-get install linux-image
- Select one of the vserver kernels that fits with your system (amd64, 686,...)
If you have a 32 Bit system you should install an image with PAE extension to use more than 4GB RAM i.e. linux-image-2.6.26-2-vserver-686-bigmem
COMMAND~: apt-get install linux-image-2.6.26-2-vserver-686-bigmem
- At least you can remove the current kernel if you want to...
During uninstallation you'll be ask if you really wanna remove the kernel that is currently in use, select no to continue uninstallation
COMMAND~: apt-get autoremove linux-image-2.6.26-2-686
3. Install PW-Server Files
- Change to the root directory
COMMAND~: cd /
- Download the server files (host address may change in future)
COMMAND~: wget
You must be registered to see links
- Extract the files
COMMAND~: tar -xf PWServer.tar.bz2
- Now delete the downloaded archive (or keep it if you want)
COMMAND~: rm -f PWServer.tar.bz2
- Set permissions of the pw-server files to 0755
COMMAND~: chmod -R 0755 /PWServer
- Next we have to change all host ip addresses in the pw-server configuration files
- First we check for the current host ip in the server files, in our example lets say 192.168.0.50
COMMAND~: cat /PWServer/glinkd/gamesys.conf | grep address
- Now lets check which host ip your machine has, in our example 81.30.158.174
COMMAND~: ifconfig | grep "inet addr"
- Allright, time to replace all old host ip's with the ip of your machine.
Replace the OLD-IP in the following commands with the ip from the server files (i.e. 192.168.0.50)
Replace the NEW-IP in the following commands with the ip of your host machine (i.e. 81.30.158.174)
COMMAND~: sed s/OLD-IP/NEW-IP/g /PWServer/glinkd/gamesys.conf > /PWServer/glinkd/gamesys.conf.new
COMMAND~: mv -f /PWServer/glinkd/gamesys.conf.new /PWServer/glinkd/gamesys.conf
4. Install Libraries
- Java Runtime Environment is required for the PW Java API (used by authd and pwAdmin)
COMMAND~: apt-get install openjdk-6-jre
- For 64 Bit Debian
Install ia32 libs and copy some required libraries not contained in ia32
COMMAND~: apt-get install ia32-libs
COMMAND~: cp -f /PWServer/.setup/lib/libstdc++.so.5.0.7 /lib32/libstdc++.so.5
COMMAND~: cp -f /PWServer/.setup/lib/libpcre.so.3.12.1 /lib32/libpcre.so.0
COMMAND~: cp -f /PWServer/.setup/lib/libtask.so /lib32/libtask.so
- For 32 Bit Debian
Copy some required libraries
COMMAND~: cp -f /PWServer/.setup/lib/libstdc++.so.5.0.7 /usr/lib/libstdc++.so.5
COMMAND~: cp -f /PWServer/.setup/lib/libpcre.so.3.12.1 /usr/lib/libpcre.so.0
COMMAND~: cp -f /PWServer/.setup/lib/libtask.so /usr/lib/libtask.so
5. Install MySQL
- First install MySQL, during installation you'll be asked for a root password, remeber it!
COMMAND~: apt-get install mysql-server
- After installation you can import the base table scheme.
Replace the PASSWORD in the following command with your mysql password
COMMAND~: mysql -uroot -pPASSWORD -h localhost < /PWServer/.setup/pwdb.sql
- We have to replace the default mysql password in the pw-server files with your mysql password.
Replace the PASSWORD in the following commands with your mysql password
COMMAND~: sed s/password=\"root\"/password=\"PASSWORD\"/g /PWServer/authd/table.xml > /PWServer/authd/table.xml.new
COMMAND~: mv -f /PWServer/authd/table.xml.new /PWServer/authd/table.xml
6. Configure PW Web Administration (Jetty + pwAdmin)
For detailed information about pwAdmin read the
You must be registered to see links
- The following will change the default mysql password to give pwAdmin access to your mysql database
Replace the PASSWORD in the following commands with your mysql
COMMAND~: sed s/db_password\ =\ \"root\"/db_password\ =\ \"PASSWORD\"/g /PWServer/jetty-7.2.0/webapps/pwAdmin/WEB-INF/.pwadminconf.jsp > /PWServer/jetty-7.2.0/webapps/pwAdmin/WEB-INF/.pwadminconf.jsp.new
COMMAND~: mv -f /PWServer/jetty-7.2.0/webapps/pwAdmin/WEB-INF/.pwadminconf.jsp.new /PWServer/jetty-7.2.0/webapps/pwAdmin/WEB-INF/.pwadminconf.jsp
7. Autostart Jetty Web Application Server
The document root of jetty is located in /PWServer/jetty-7.2.0/webapps/ROOT
For more infromation on the jetty web application server read the
You must be registered to see links
- Jetty uses a PHP servlet, so we need to install php-cgi
COMMAND~: apt-get install php5-cgi php5-mysql
- It's really useful to start the webserver with system boot, we install an init script and register it to the startup runlevels
COMMAND~: cp /PWServer/.setup/jetty /etc/init.d/jetty
COMMAND~: update-rc.d jetty defaults
8. Autostart Basic Firewall
- This will install a basic firewall which has incoming ports open on 22(SSH), 8080(HTTP-ALT) and 29000(Perfect World)
COMMAND~: cp /PWServer/.setup/firewall /etc/init.d/firewall
COMMAND~: update-rc.d firewall defaults
9. Finalize
- You have reached the end of the server guide, it's time to restart your machine
COMMAND~: reboot
- You can now open a Web Browser on a remote PC and loading the start page of the server that should show a phpinfo() page if everything is correct
Replace the SERVER-IP in the following command with your server ip
You must be registered to see links
- At the top of the page is a link to pwAdmin and adminer. pwAdmin is the pw-server web administration interface, adminer is a php based mysql administration interface.
Click pwAdmin
- The default password for pwAdmin is "root", but pwAdmin demands to enter a new password, so on the first login enter the password you wanna use (hint: the password will be stored md5 encoded in "WEB-INF/.pwadminconf.jsp" just in case you wanna change it somtime)
- On the account tab you can create a new account
- On the server control tab you can start the server
- Use a client patched with pwd.codeplex.com... guide for client will coming later
- have fun...
Will be updated recently...