Recent versions: ||| Galaxytool: v5.1 ||| Galaxytoolbar: v2.6.32 |||

Difference between revisions of "Installation"

From Galaxytool wiki
Jump to: navigation, search
m (After editing config.php and attributes.php)
m (Important for those hosted on a Linux Server)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Note: Excellent Installation guide==
 
 
An installation guide by Cyberzero can be found on the [http://board.ogame.org/board703-miscellaneous/board156-archive-version-2-0/board705-help-questions-archive/board631-faq-s-guides/273337-galaxietool-guide-v3/#post4677935 OGame forums.] ('''Outdated!''')
 
 
 
== General ==
 
== General ==
  
After [[Download|downloading]] the ZIP file, you need to extract it. After that you will have to modify the config.php and attributes.php (from the /config/ directory) to suit your needs. You receive the required information for the database connection from your [[Hosting_providers_and_the_Galaxytool|webhoster]].
+
After [[Download|downloading]] the ZIP file, you need to extract it.
 
+
After that you need to upload all files to your server.  
'''Note:''' Use Wordpad or a good text editing program and NOT Notepad to edit these files, otherwise things could get garbled.
+
Now you should [[How to set writable permissions|set writable permissions]] to the '''config''' folder.
 
+
Then, start the install.php on your webserver by typing
== config.php ==
 
 
 
Note: you can find the file in the folder /config/
 
 
 
Go to your folder where you have downloaded Galaxytool (if you didn't download it yet go to the [[Download]] section on our page). In the folder you will find the "readme.txt" and some more files (including "install.php"). First, we are going to find "config.php". Open it and then change the following:
 
 
 
$dbusername = "username";
 
 
 
Write the username for your MySQL database in the quotation marks (you get the username from your webhoster).
 
 
 
$dbpassword = "password";
 
 
 
Write the password for your MySQL database in the quotation marks (you get the password from your webhoster, too).
 
 
 
$dbname = "database";
 
 
 
Write the name of your MySQL database in the quotation marks (again, you get the name from your webhoster).
 
 
 
$dbhost = "localhost";
 
 
 
Write the address (e.g. localhost) for your MySQL database in the quotation marks. You will get the address from your webhoster.
 
 
 
$dbprefix = "";
 
 
 
Here you can define a prefix for all table names. This way, you don't have to rename all table names by hand. This variable is usually used when installing several Galaxytools into one database.
 
 
 
 
 
 
 
The following things should not be changed. Use the $dbprefix variable instead, if you need to install more than one Galaxytool into the same database.
 
 
 
$dbtablename = $dbprefix . 'galaxy';
 
 
 
You can write the name of the galaxy table (all the data like planets and coordinates) in the quotation marks.
 
 
 
$utablename = $dbprefix . 'user';
 
 
 
You can write the name of the user table (the users of the tool) in the quotation marks.
 
 
 
$playertable = $dbprefix . 'players';
 
 
 
You can write the name of the players table in the quotation marks.
 
 
 
$allytable = $dbprefix . 'alliances';
 
 
 
You can write the name of the alliance table in the quotation marks.
 
 
 
$noticetable = $dbprefix . 'notices';
 
 
 
You can write the name of the notices table in the quotation marks.
 
 
 
$reporttable = $dbprefix . 'reports';
 
 
 
You can write the name of the espionage reports table in the quotation marks.
 
 
 
$iptablename = $dbprefix . 'iptable';
 
 
 
You can write the name of the IP addresses table (IP addresses from the users of the tool) in the quotation marks.
 
 
 
$shouttable = $dbprefix . 'shoutbox';
 
 
 
You can write the name of the shoutbox table (the shoutbox on the overview page of the tool) in the quotation marks.
 
 
 
$allyhistory = $dbprefix . 'allyhistory';
 
 
 
You can write the name of the allyhistory table in the quotation marks.
 
 
 
$playerhistory = $dbprefix . 'playerhistory';
 
 
 
You can write the name of the playerhistory table in the quotation marks.
 
 
 
$fleetmovetable  = $dbprefix . "fleet_movements";
 
 
 
You can write the name of the fleetmovements table in the quotation marks.
 
 
 
$player_activity = $dbprefix . "player_activity";
 
 
 
You can write the name of the player activities table in the quotation marks.
 
 
 
$messagetable    = $dbprefix . "messages";
 
 
 
You can write the name of the ingame messages table in the quotation marks.
 
 
 
$combattable    = $dbprefix . "combat_reports";
 
 
 
You can write the name of the combat reports table in the quotation marks.
 
 
 
$combatparty    = $dbprefix . "combat_party";
 
 
 
You can write the name of the combat report parties table in the quotation marks.
 
 
 
$reportarchive  = $dbprefix . "report_archive";
 
 
 
You can write the name of the reports archive table in the quotation marks.
 
 
 
== attributes.php ==
 
 
 
Note that you can find the file in the folder: /config/
 
 
 
Now if you have edited "config.php" it is time to edit some stuff to give galaxy tool another look. In the same folder ("config") there is a file called "attributes.php". Open it and we are going to change some things:
 
 
 
$owner = 'yourname';
 
  
Write your alliance or OGame nickname in the quotation marks. It is shown at the login screen to show which tool you are using if you play in different univereses.
+
http://example.com/path/to/galaxytool/install.php (this address is just a template!)
  
$maxshouts = 15;
+
in your browser and have a look at the screen.
  
This is the number of shouts shown in the shoutbox on the overview page. All shouts which are not shown are deleted!
+
Now follow the instructions on the screen.  
 
+
They will give you detailed information about what to enter or they'll tell you, if something did not work as expected.<br>'''Everything is created automatically during installation - no need to edit any file.'''
$email_to = 'admin@yourdomain.com';
 
 
 
Enter your admin Email address where you want to receive emails about newly registered users.
 
 
 
$email_from = 'email@provider.xxx';
 
 
 
Here you can add an email address which should be shown in the FROM field of registration emails. Put the address between quotation marks.
 
If someone registers at the galaxytool, an email is sent to this address showing that someone registered and needs to be activated.
 
If you want to disable registering, you have to delete the register.php file.
 
 
 
If your webserver does not support mail functionality you can also use an external email provider by using these variables:
 
$usePHPMailer = false; // use phpmailer ? (true or false)
 
$phpmailerHost = "smtp.prov.dom"; // smtp hostname
 
$phpmailerUser = "user@prov.dom"; // smtp username
 
$phpmailerPass = "password"; // smtp password
 
 
 
$default_language = 'english';
 
 
 
Write the default language for the tool in the quotation marks.
 
You can choose between: balkan, brazilian, bulgarian, chinese, croatian, czech, danish, dutch, english, finnish, french, german, greek, hungarian, italian, japan, korean, latvian, lithuanian, norwegian, polish, portugues, romanian, russian, serbian, slovak, slovenian swedish, spanish, taiwan, turkish
 
 
 
$global_universe = "Andromeda";
 
 
 
$global_universe = "12";
 
 
 
This is your universe number/universe name. Do not leave out this variable! It will be used to check for the correct universe if you enter data via [[Toolbar|Galaxytool Firefox plugin]].
 
 
 
$def_to_debris = false;
 
 
 
This is for universes in which destroyed defense creates a debris field. If you play in such a universe set it to '''true''' otherwise to '''false'''.
 
 
$debris_rate = 30;
 
 
 
Here you can adjust the percentage of resources that will create the debris field. For most universes the default of '''30''' should be alright, but there are several exceptions e.g. uni40.ogame.org where 40% of the resources create the debris field, so in this case you'd have to enter a '''40'''.
 
This value is used to be sent to online battle reports simulators like speedsim or dragosim.
 
 
 
$speed_rate  = 1;
 
 
 
This option is for speed universes. Here you can set, how fast your universe runs. For example, if your universe runs with double speed, enter a '''2''' .
 
 
 
== After editing config.php and attributes.php ==
 
 
 
After finishing the modification of your config.php and attributes.php, you need to upload all files to your server. Start the install.php on your webserver by typing
 
 
 
http://address.of.your.webspace/path/to/galaxytool/install.php (this address is just a template!)
 
 
 
in your browser and have a look at the screen. You should see something equal to this picture:
 
 
 
[[Image:Install.png]]
 
 
 
If there are any fields which are not green, you have a problem and you cannot start the installation.
 
After the installation you should delete the install.php and the update.php.
 
  
 
== After installation ==
 
== After installation ==
  
After the installation you have to delete the install.php and the update.php!
+
After the installation you have to delete the install.php and the update.php! Then you can logon with the account data created during installation.
 
 
The first login:
 
Loginname: admin
 
Password: galatool
 
 
 
You should change the password for the admin account after you log in the first time! Do this in the [[User_options|User Options]], not in [[User_management|User Management]]
 
  
 
=== Important for those hosted on a Linux Server ===
 
=== Important for those hosted on a Linux Server ===
 +
'''Please note: the following setting can also be harmful for the Galaxytool, so you cannot logon at all, but see only a white page or a Fatal error when you try to do so. This is therefore no general solution.'''<br>
 
For those who have been getting session time out messages as soon as you logged in: the problem is in your php.ini file. Log into your hosting providers control panel and find the php controls. Edit the php.ini: search for session.auto_start and change its attribute of 0 to 1, then save it. Now you should be able to log into gtool as you normally would.
 
For those who have been getting session time out messages as soon as you logged in: the problem is in your php.ini file. Log into your hosting providers control panel and find the php controls. Edit the php.ini: search for session.auto_start and change its attribute of 0 to 1, then save it. Now you should be able to log into gtool as you normally would.
  
 
[[de:Installation]]
 
[[de:Installation]]
 
[[es:Instalación]]
 
[[es:Instalación]]

Latest revision as of 15:06, 16 March 2013

General

After downloading the ZIP file, you need to extract it. After that you need to upload all files to your server. Now you should set writable permissions to the config folder. Then, start the install.php on your webserver by typing

http://example.com/path/to/galaxytool/install.php (this address is just a template!)

in your browser and have a look at the screen.

Now follow the instructions on the screen. They will give you detailed information about what to enter or they'll tell you, if something did not work as expected.
Everything is created automatically during installation - no need to edit any file.

After installation

After the installation you have to delete the install.php and the update.php! Then you can logon with the account data created during installation.

Important for those hosted on a Linux Server

Please note: the following setting can also be harmful for the Galaxytool, so you cannot logon at all, but see only a white page or a Fatal error when you try to do so. This is therefore no general solution.
For those who have been getting session time out messages as soon as you logged in: the problem is in your php.ini file. Log into your hosting providers control panel and find the php controls. Edit the php.ini: search for session.auto_start and change its attribute of 0 to 1, then save it. Now you should be able to log into gtool as you normally would.