· 10 years ago · Feb 11, 2016, 11:42 PM
1EQdkp OpenSource DKP
2Copyright (C) 2002-2005 The EQdkp Project Team
3
4Installation:
5-------------
6Pre-install:
7 Create, or have ready a MySQL database that EQdkp can use. It
8 should already have a username and password assigned to it.
9
10Step 1:
11 Making sure to keep the directory structure intact, move the
12 unzipped files to a web-accessible directory.
13
14Step 2:
15 All files and directories should be owned by your webserver's user/group
16 (Example: chown apache.apache -R *). All .php files should be
17 readable/executable
18
19 $ chmod a+rx -R *.php
20
21Step 3:
22 Make sure the directory 'templates/cache' exists and that all sub-directories
23 are readable/writable/executable
24
25 Note: The installer will attempt to do this for you, but should an error occurr,
26 you will need to do this manually:
27
28 $ mkdir templates/cache ; chmod -R 777 templates/cache
29
30Step 4:
31 If you want the installation script to automatically set up your config.php file for
32 you, it should be readable/writeable
33
34 Note: The installer will attempt to do this for you, but should an error occurr,
35 you will need to do this manually:
36
37 $ chmod 666 config.php
38
39Step 5:
40 Browse to http://www.yourserver.com/eqdkp/install.php
41
42 You should be presented with a page describing your server's settings and information.
43 Once you are sure that your server meets EQdkp's requirements, you can click the
44 'Start Install' button.
45
46 Step 5-1:
47 Database Host:
48 Your MySQL server name. If it resides on the same server as the web server,
49 you should enter 'localhost'
50 Database Name:
51 The name of the database you created for EQdkp, usually 'eqdkp'.
52 Database Username:
53 The username with permission to access the database. If you didn't
54 create the database yourself, your host should have given you this
55 information.
56 Database Password:
57 The password used with the username from above.
58 Prefix for EQdkp tables:
59 Simply prefixes the name of each table that EQdkp creates and uses.
60 The default of 'eqdkp_' should be sufficient for most installations.
61
62 Domain Name:
63 Should be detected automatically by the installation script, but if not
64 just put the domain name of your server here (ex: mydomain.com, www.myhost.com).
65 Webserver port:
66 Unless the web server is running on a port other than the default (80), just leave
67 the setting as-is.
68 Script path:
69 The path following the domain name where the script is located. Example: If the full
70 path to the install script is http://mydomain.com/user/eqdkp/, you would enter
71 '/user/eqdkp/', if the full path was http://mydomain.com/eqdkp/', the path would be
72 '/eqdkp/'.
73
74 Step 5-2:
75 Administrator Username:
76 This should be a username of your choosing. It will be your administrative account
77 for your EQdkp installation.
78 Administrator Password:
79 A password of your choosing.
80 Administrator Password [ confirm ]:
81 Simply re-type the password to verify it.
82 Administrator Email Address:
83 Your (valid) e-mail address.
84
85 After you're satisfied with the values for the above fields, click the button to proceed. The
86 installer will automatically fill your config.php file and present you with a login field.
87
88 You will be notified if your passwords didn't match, and it will be reset to a default of "admin" -
89 change this later by going to Settings.
90
91 Log in to automatically be redirected to the EQdkp configuration panel where you can configure all
92 aspects of EQdkp. After that, you're ready to begin using EQdkp.
93
94You should now have a functional installation of EQdkp. Remove the install.php file for extra security.
95
96Upgrading:
97----------
98Step 1:
99 BACK UP YOUR DATABASE. This cannot be stressed enough. Because some tables in EQdkp can
100 get to be VERY large (eqdkp_raid_attendees, eqdkp_logs), you should consider using
101 phpMyAdmin (http://www.phpmyadmin.net) which can use Completed Inserts that will be
102 necessary if you need to restore the database.
103
104Step 2:
105 Seriously, go back up your database since you skipped step 1.
106
107Step 3:
108 Back up your config.php file. You will not need to change any values in this file and you'll
109 want to be sure that unzipping the new version of EQdkp won't overwrite your old settings. 1.3.0
110 doesn't have a new config.php file, so you shouldn't have an issue here - but back it up anyway.
111
112Step 4:
113 Unzip the new EQdkp version. Copy your old config.php file from Step 2, overwriting the
114 new version's config.php file into the unzipped directory to retain your old settings.
115
116Step 5:
117 Access http://www.yourserver.com/eqdkp/upgrade.php and select the version you're upgrading
118 from. The script will perform all the necessary changes to upgrade from the version you selected
119 to the newest version.
120
121Step 5:
122 Delete everything in the templates/cache directory ( rm ./templates/cache/* ).
123
124Step 6:
125 Seriously, delete everything in the templates/cache directory. Your new install may
126 not work right until you do this.
127
128Remove the upgrade.php file (or rename it to something else).
129
130Configuration:
131--------------
132Once you've logged in to your administrator account, your next step should be changing
133the EQdkp configuration settings. Click on the 'Administration Panel' link in the top
134menu, and then on the 'Configuration' link in the left frame. This is where you can
135control all of EQdkp's settings.
136
137Most of the fields have descriptions where appropriate, but some need to be reinforced.
138
139 Site Name:
140 Optional, appears in a large font above the menu of each page. Usually it's something like
141 'Guild Point System'.
142
143 Site Description:
144 Also optional, appears below the site name in a smaller font. Usually a short tagline or a
145 URL to the guild's official web site.
146
147 Point Name:
148 Some guilds may find the use of the 'DKP' acronym archaic (or even stupid) and may wish to change
149 their point system name to something else.
150
151 Enable Account Activation:
152 None - Everyone who registers is given an account and automatically set up with the default
153 permissions (see below).
154 User - A user must validate their e-mail address in order for the account to become active.
155 Admin - The administrator must approve the account personally for it to become active.
156
157 Enable Gzip Compression:
158 If your PHP installation supports Zlib, you may consider using this option. It compresses
159 the output of pages to save you some bandwidth, but may use slightly more processing power.
160
161 Default Permissions:
162 Probably the MOST important thing you'll set up here. When a person comes to your EQdkp site and
163 isn't logged in, you may not want them seeing what your guild has killed in the last couple of
164 days, or who got what item.
165
166 These default permissions are also given to people when they register and can only be changed by
167 an administrator with the 'Manage Users' permission. Items in bold text should only be given
168 to trusted members of your guild who will be responsible for maintaining the point system.
169
170 Cookie Settings:
171 For 99% of the installations, the default values should be sufficient.
172
173
174 Default Game:
175 If you are running something other than EverQuest for your game, you'll need to change it
176 now. Select WoW, Everquest2, or any of the other games available.
177
178 Backup Database:
179 This will take you to an add-on that will let you back-up your eqdkp database without having to
180 use phpMyAdmin - very useful if you don't have access to the box after the admin leaves the
181 guild, no? Can also be used to restore a database - so be very careful as there are no
182 special permissions needed for this functionality - admin access allows access to backup (this
183 is intentional)
184
185Have Fun!