Roster:Install

From WoWRosterWiKi
(Difference between revisions)
Jump to: navigation, search
Line 27: Line 27:
  
 
* Decompress the downloads on your local machine, then upload the expanded files to your site
 
* Decompress the downloads on your local machine, then upload the expanded files to your site
** Most commonly, it ends up living in "www.[domain].com/roster"
+
** Most installs end up installing Roster in "www.[domain].com/roster"
  
* Browse to where you have roster installed, www.[domain].com/roster/
+
* Browse to the roster installation, www.[domain].com/roster/
 
** Follow on-screen instructions
 
** Follow on-screen instructions
 
** Roster is now installed...
 
** Roster is now installed...
  
* Configure Roster by going to Roster Config and checking out all the settings
+
* Configure Roster by going to RosterCP and checking out all the settings
 
** Check out the [[Roster:FirstUpload|First Upload]] instructions for help
 
** Check out the [[Roster:FirstUpload|First Upload]] instructions for help
  
* Have guildies install CharacterProfiler (and optional PVPLog)
+
* Have members install CharacterProfiler (and optional PVPLog)
** Deputize people in the guild you trust with your roster's admin password to also run GuildProfiler [http://www.wowroster.net/Downloads/c=3.html Profiler Add-ons can be downloaded here]
+
** Deputize people you trust with the Roster Upload/Officer password to also run GuildProfiler
** Give them the officer level password.
+
** [http://www.wowroster.net/Downloads/c=3.html Profiler Add-ons can be downloaded here]
  
* Have everyone upload their data with regularity or look into using [[UniUploader]] or [[JUniUploader|java UniUploader]] with [[UniAdmin]]
+
* Have everyone upload their data with regularity or look into using [[UniUploader]], [[JUniUploader|javaUniUploader]], or [[phpUniUploader|phpUniUploader]]
 +
** You can also use [[UniAdmin]] to distribute AddOns and settings to UU, jUU, and phpUU
  
  
Line 85: Line 86:
 
If you want the installation script to automatically set up your conf.php file for you, it should be readable/writeable
 
If you want the installation script to automatically set up your conf.php file for you, it should be readable/writeable
  
Note: The installer will attempt to do this for you, but should an error occurr, you may need to do this manually:
+
Note: The installer will attempt to do this for you, but should an error occur, you may need to do this manually:
 
<pre>$ chmod 666 conf.php</pre>
 
<pre>$ chmod 666 conf.php</pre>
  
Line 134: Line 135:
 
* Administrator Password [ confirm ]:
 
* Administrator Password [ confirm ]:
 
*: Simply re-type the password to verify it.
 
*: Simply re-type the password to verify it.
 +
* Note that the guild/user and officer/upload passwors will be set to this as well
 +
*: You can change them later via RosterCP
  
 
====Step 5====
 
====Step 5====
Line 145: Line 148:
 
You can change this later by going to Roster Config.
 
You can change this later by going to Roster Config.
  
This will also be the password for the Officer and Guild logins, change them via RosterCP
+
This will also be the password for the Officer/Upload and Guild/User logins, change them via RosterCP
  
 
Navigate to [[Roster:CP|Roster Control Panel]], this is where you can [[Roster:CP|configure]] all aspects of WoWRoster.<br>
 
Navigate to [[Roster:CP|Roster Control Panel]], this is where you can [[Roster:CP|configure]] all aspects of WoWRoster.<br>
Line 202: Line 205:
 
Unzip the new WoWRoster version.<br>
 
Unzip the new WoWRoster version.<br>
 
Overwrite ALL files!<br>
 
Overwrite ALL files!<br>
It's best to delete everything in the roster folder ''EXCEPT!'' your conf.php file.
+
It's best to delete everything in the roster folder ''EXCEPT!'' your conf.php file first, before copying over files.
  
 
=====Step 5=====
 
=====Step 5=====
Access www.[domain].com/roster/upgrade.php
+
Access www.[domain].com/roster
  
 
Select the version you're upgrading from.<br>
 
Select the version you're upgrading from.<br>
Line 211: Line 214:
  
 
=====Step 6=====
 
=====Step 6=====
Navigate to Roster Config, this is where you can configure all aspects of WoWRoster.
+
Navigate to RosterCP, this is where you can configure all aspects of WoWRoster.
  
Remove the files install.php, upgrade.php and the install/ folder for extra security.
+
Remove the file install.php for extra security.
  
  

Revision as of 16:32, 19 August 2007

WR.net

Important note: When you edit this page, you agree to release your contribution into the public domain.
If you do not want this or can not do this because of license restrictions, please do not edit.

Contents


Roster Installation

Installation guide

phpMyAdmin Create Database
phpMyAdmin Database Created
File:Roster fi install 0.png
WoWRoster Install Step 0
File:Roster fi install 1.png
WoWRoster Install Step 1
File:Roster fi install 1b.png
WoWRoster Install Step 1b
File:Roster fi install 1c.png
WoWRoster Install Step 1c
File:Roster fi install 1d.png
WoWRoster Install Step 1d
File:Roster fi install 1e.png
WoWRoster Install Step 1e
File:Roster fi install 2.png
WoWRoster Install Step 2
File:Roster fi install 3.png
WoWRoster Install Step 3
File:Roster fi install 4.png
WoWRoster Install Step 4
File:Roster fi install 4b.png
WoWRoster Install Step 4b

Installation Overview


Hints


Installing Roster

Pre-install

(Figure 'phpMyAdmin Create Database')
(Figure 'phpMyAdmin Database Created')
Create, or have ready a MySQL database that WoWRoster can use.
It should already have a username and password assigned to it.

Step 1

Making sure to keep the directory structure intact, move the unzipped files to a web-accessible directory.

Step 2

All files and directories should be owned by your webserver's user/group
(Example: chown apache.apache -R *).
All .php files should be readable/executable

$ chmod a+rx -R *.php

Step 3

If you want the installation script to automatically set up your conf.php file for you, it should be readable/writeable

Note: The installer will attempt to do this for you, but should an error occur, you may need to do this manually:

$ chmod 666 conf.php

Step 4

Browse to www.[domain].com/roster/
(Figure 'WoWRoster Install Step 1')

You should be presented with a page describing your server's settings and information.
Once you are sure that your server meets WoWRoster's requirements, you can click the [ Start Install ] button.

On this step, you may be presented with information

Step 4-1

(Figure 'WoWRoster Install Step 2')

Step 4-2

(Figure 'WoWRoster Install Step 3')

Step 5

After you're satisfied with the values for the above fields, click the button to proceed.
The installer will automatically fill your conf.php file.
(Figure 'WoWRoster Install Step 4')

If the creation of conf.php failed, the installer will give you code to copy and paste in this file.

You will be notified if your passwords didn't match (Figure 'WoWRoster Install Step 4b'), and it will be reset to a default of "admin"
You can change this later by going to Roster Config.

This will also be the password for the Officer/Upload and Guild/User logins, change them via RosterCP

Navigate to Roster Control Panel, this is where you can configure all aspects of WoWRoster.
After that, you're ready to begin using WoWRoster.

You should now have a functional installation of WoWRoster.
Remove the files install.php, upgrade.php and the install/ folder for extra security.


Upgrading Roster

As always, we recommend a fresh install, in a clean folder, and a clean database.
But for those that absolutely need to upgrade, we have worked really hard for you on the upgrade script.

Special Instructions for < 2.0.0 to 2.0.x

There is no upgrade path from versions lower than 2.0.0

This is because Roster 2.0.0 gathers much more data from WoW than earlier versions and causes errors in the core files.


Special Instructions for 1.6.0 to 1.7.x

This information is specific on upgrading from Roster 1.6.0 to 1.7.x

Back up your conf.php file!
WoWRoster 1.7.x DOES have a new conf.php file, so you should back it up!
The new conf.php file should be automatically be upgraded for you.
If this fails, the upgrader will give you the option to download this file, then you can upload it to your web server.

Access www.[domain].com/roster/upgrade.php
YOU MUST go to www.[domain].com/roster/upgrade.php
If you go to any other page, it WILL display "Detected Invalid Access..."

Make sure you visit the Roster Config page
You will need to visit this page as the upgrader only upgrade certain important fields from version 1.6.0

General Instructions

Step 1

BACK UP YOUR DATABASE.


This cannot be stressed enough.


You should consider using phpMyAdmin (http://www.phpmyadmin.net)
This can use 'Completed Inserts' that will be necessary if you need to restore the database.

Step 2

Seriously, go back up your database since you skipped step 1.

Step 3

Back up your conf.php file.
Usually we would never touch this file during an upgrade...but just in case something weird happens

Step 4

Unzip the new WoWRoster version.
Overwrite ALL files!
It's best to delete everything in the roster folder EXCEPT! your conf.php file first, before copying over files.

Step 5

Access www.[domain].com/roster

Select the version you're upgrading from.
The script will perform all the necessary changes to upgrade from the version you selected to the newest version.

Step 6

Navigate to RosterCP, this is where you can configure all aspects of WoWRoster.

Remove the file install.php for extra security.


Re-Installing Roster

Perhaps there has been some weird problem that you cannot solve
Such as database corruption, updating errors, data errors, etc...

You can try re-installing Roster

Pre re-install

Make sure you have the install directory and install.php in your roster folder on your web server

Step 1

Delete conf.php from the roster directory

Step 2

Drop all `roster_` tables in the database you created for Roster
Note: `roster_` may be different if you changed the table prefix

You can also just drop the database you created for Roster
If you didn't create a new database for Roster, use the first method for removing the tables

Step 3

Run install.php


Un-Installing Roster

First of all, we'd like to thank you for trying our software and hope it was a good experience for you
Sometimes Roster doesn't work on all servers although we try our best to improve this aspect

Step 1

Remove/delete the roster directory from your webserver

Step 2

Drop all `roster_` tables in the database you created for Roster
Note: `roster_` may be different if you changed the table prefix

You can also just drop the database you created for Roster
If you didn't create a new database for Roster, use the first method for removing the tables

Personal tools
Namespaces
Variants
Actions
WoWRoster
Navigation
Toolbox