Local GalaxyTool under Mac OS

Ex ante

Why is this a Mac OS guide only?

Simple answer: I'm a Mac user and don't know how to setup a web server on a PC ;)

What is a local web server?

A web server is a computer which transmits documents to web browsers. Web servers are mainly used as WWW-service in the internet, but also in corporate networks and locally. This way, documents can be made available world wide, company-internal or locally.

Who will have access to the local Galaxytool?

This guide will tell you how to setup a Galaxytool on a local web server. Thus only yourself and people in the same local network can access it. In principle, you can make your Galaxytool available to all your Allymates. But the software which is used in this guide is designed for local use only and unsafe if it's used in another way.

The software

Under Mac OS there is a pre-installed apache web server. But we need PHP and MySQL modules in order to make the Galaxytool work on the web server.

XAMPP for Mac OS X

After downloading simply run the following commands in the terminal (Programs/Utility Programs):

     Installation requires an admin account.
     # Enter „sudo su“. You will be prompted for a password.
     # tar xfvz xampp-macosx-0.7.2.tar.gz -C /

     Notice: all old installations of XAMPP for MacOS X will be overwritten! 

That's all. XAMPP is now installed below the /Applications/xampp directory.

Activating the web server

You activate your web server under Programs/Configuration/Sharing

Simply check the box next to "Web-Sharing"

Setting up the Galaxytool

First of all, download the latest Galaxytool software Version: 4.3.2 tar.gz and extract the files to your desktop.

The following steps are taken from the GalaxyTool Guide, but attention, there are some major changes.

Open TextEdit for this.

Once TextEdit is open, you will need to open the config folder. I will assume that you saved the extracted file to the desktop. Open the Galaxy tool folder. Open config

We will only be changing four things

     $dbusername = "databasename"; // database username
     $dbpassword = "userpassword"; // database password
     $dbname = "databasename"; // database name
     $dbhost = "mysql"; // host address of your mysql server

--> insert:

     $dbusername = "root";
     $dbpassword = "";
     $dbname = "galatool";
     $dbhost = "localhost";

Once you have made the changes save the file (Not save as).

Now from TextEdit open attributes. Here is what you will need to change

     $owner = "youralliancenamehere";
     The quotes must remain

     $email_to = 'youremailhere'
     Quotes must stay

     $default_language = "languageyouwanthere";
     Quotes must remain

     $global_universe = 00;
     Put your universe number there. Keep the ;

Now save this (not save as). Close TextEdit.

Assembling the Galaxytool and the web server

Open your browser and visit

http://localhost/xampp/

Here go to phpMyAdmin and create a new database "galatool" (collation latin1)

Now take your Galaxytool folder and move it to

/Your User name/Websites

Installing the Galaxytool

Open your browser and visit

http://localhost/~Username/galaxytool/secret/install.php

click "install"

It's ready!

Now your offline Galaxytool should be ready, the URL of the login screen is

http://localhost/~Username/galaxytool

     Username: admin
     Pw: galatool

You will have to start the database every time your systems is rebooted. You start the database with the "XAMPP Control Panel" (see xampp folder), simply start all components.

Settings for the Galaxytoolbar

     OgameServername: unixx.ogame.org
     Galaxytool URL: http://localhost/~Username/galaxytool/secret/galaxyplugin.php
     Username: admin
     Password: galatool