9 | | * If you have shell access to your web server, you may wish to download the Dolphin archive directly to your web server using a browser (such as 'lynx'). |
10 | | |
11 | | If your browser is '''lynx''' you should perform one of the following commands to do that: |
12 | | |
13 | | {{{ |
14 | | lynx http://get.boonex.com/Dolphin-v.6.0-Free |
15 | | }}} |
16 | | (for the Free version) |
17 | | |
18 | | or |
19 | | |
20 | | {{{ |
21 | | lynx http://get.boonex.com/Dolphin-v.6.0-AdFree |
22 | | }}} |
23 | | (for the Ad-Free version) |
24 | | |
25 | | In other browsers the command will look similarly. |
26 | | |
27 | | Then you will be able to unzip the package under your shell account using the following command: |
28 | | {{{ |
| 9 | * If you have shell access to your web server, you may wish to download the Dolphin archive directly to your web server using the '''wget''' command. |
| 10 | |
| 11 | {{{ |
| 12 | wget http://get.boonex.com/Dolphin-v.6.1-Free |
| 13 | }}} |
| 14 | (for the Free version) |
| 15 | |
| 16 | or |
| 17 | {{{ |
| 18 | wget http://get.boonex.com/Dolphin-v.6.1-AdFree |
| 19 | }}} |
| 20 | (for the Ad-Free version) |
| 21 | |
| 22 | Then you will be able to unzip the package under your shell account using the following command: |
| 23 | {{{ |
37 | | If your hosting provider has cPanel, you can follow these instructions to create your Dolphin database and user. |
38 | | |
39 | | 1. Log in to your cPanel. |
40 | | 2. Click MySQL Databases. |
41 | | 3. Create a database user: |
42 | | 1. Choose a username for Dolphin (for example "dolphin") and enter it in the Username field. |
43 | | 2. Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and input it into the Password field. |
44 | | 3. Click Create user. |
45 | | 4. Create a Dolphin database and add the user to it: |
46 | | 1. Choose a name for your Dolphin database (for example "dolphin" or "community"), input it in the New Database field and click Create Database. |
47 | | 2. Under Add Users To Your Database, select your Dolphin username from the User dropdown list, then select your Dolphin database from the Database dropdown list. Make sure ALL is checked under Privileges, then click Add User To Database. |
48 | | 5. When you return to the main MySQL Account Maintenance screen, cPanel will list information about the database you just created. You should see the username you just added to the database (with ALL PRIVILEGES), as well as a few sample Connection Strings for you to use in Perl or PHP scripts to connect to the database. The PHP code will have the following format: |
49 | | {{{ |
| 33 | '''Using CPanel''' |
| 34 | |
| 35 | If your hosting provider has cPanel, you can follow these instructions to create your Dolphin database and user. |
| 36 | |
| 37 | 1. Log in to your cPanel. |
| 38 | |
| 39 | 2. Click MySQL Databases. |
| 40 | |
| 41 | 3. Create a database user: |
| 42 | |
| 43 | 1. Choose a username for Dolphin (for example "dolphin") and enter it in the Username field. |
| 44 | |
| 45 | 2. Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and input it into the Password field. |
| 46 | |
| 47 | 3. Click Create user. |
| 48 | |
| 49 | 4. Create a Dolphin database and add the user to it: |
| 50 | |
| 51 | 1. Choose a name for your Dolphin database (for example "dolphin" or "community"), input it in the New Database field and click Create Database. |
| 52 | |
| 53 | 2. Under Add Users To Your Database, select your Dolphin username from the User dropdown list, then select your Dolphin database from the Database dropdown list. Make sure ALL is checked under Privileges, then click Add User To Database. |
| 54 | |
| 55 | 5. When you return to the main MySQL Account Maintenance screen, cPanel will list information about the database you just created. You should see the username you just added to the database (with ALL PRIVILEGES), as well as a few sample Connection Strings for you to use in Perl or PHP scripts to connect to the database. The PHP code will have the following format: |
| 56 | {{{ |
58 | | If your web server has phpMyAdmin installed, and you are logged in as the MySQL administrator, you can follow these instructions to create your Dolphin username and database. |
59 | | |
60 | | '''Note''': These instructions are written for phpMyAdmin 2.6.1; the phpMyAdmin user interface can vary slightly between versions. |
61 | | |
62 | | 1. Create a database: |
63 | | 1. Choose a name for your Dolphin database (for example "dolphin" or "mycommunity"), enter it in the Create new database field and click Create. |
64 | | 2. Click the Home icon in the upper left to return to the main page, then click Privileges and follow these steps tp create a user: |
65 | | 1. Click Add a new User. |
66 | | 2. Chose a user name for Dolphin (for example "dolphin") and enter it in the User name field (make sure Use text field: is selected from the dropdown list). |
67 | | 3. Leave the Host field blank. |
68 | | 4. Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the Password field (make sure Use text field: is selected from the dropdown list.) Re-enter the password in the Re-type field. |
69 | | 3. Write down the username and password you have chosen. |
70 | | 4. Leave the default values for the Global privileges section. |
71 | | 5. Click Go. |
72 | | 2. Return to the Privileges screen and click the Edit privileges icon on the user you've just created for Dolphin. In the Database-specific privileges section, select the database you've just created for Dolphin from the Add privileges to the following database dropdown list. The page will refresh with privileges for that database. Click Check All to select all privileges, and click Go. |
73 | | 3. On the resulting page, make note of the host name listed after Server: at the top of the page. (This will usually be ''localhost''.) |
| 67 | If your web server has phpMyAdmin installed, and you are logged in as the MySQL administrator, you can follow these instructions to create your Dolphin username and database. |
| 68 | |
| 69 | '''Note''': These instructions are written for phpMyAdmin 2.6.1; the phpMyAdmin user interface can vary slightly between versions. |
| 70 | |
| 71 | 1. Create a database: |
| 72 | |
| 73 | 1. Choose a name for your Dolphin database (for example "dolphin" or "mycommunity"), enter it in the Create new database field and click Create. |
| 74 | |
| 75 | 2. Click the Home icon in the upper left to return to the main page, then click Privileges and follow these steps tp create a user: |
| 76 | |
| 77 | 1. Click Add a new User. |
| 78 | |
| 79 | 2. Chose a user name for Dolphin (for example "dolphin") and enter it in the User name field (make sure Use text field: is selected from the dropdown list). |
| 80 | |
| 81 | 3. Leave the Host field blank. |
| 82 | |
| 83 | 4. Choose a difficult-to-guess password (ideally containing a combination of upper- and lower-case letters, numbers, and symbols), and enter it in the Password field (make sure Use text field: is selected from the dropdown list.) Re-enter the password in the Re-type field. |
| 84 | |
| 85 | 3. Write down the username and password you have chosen. |
| 86 | |
| 87 | 4. Leave the default values for the Global privileges section. |
| 88 | |
| 89 | 5. Click Go. |
| 90 | |
| 91 | 2. Return to the Privileges screen and click the Edit privileges icon on the user you've just created for Dolphin. In the Database-specific privileges section, select the database you've just created for Dolphin from the Add privileges to the following database dropdown list. The page will refresh with privileges for that database. Click Check All to select all privileges, and click Go. |
| 92 | |
| 93 | 3. On the resulting page, make note of the host name listed after Server: at the top of the page. (This will usually be ''localhost''.) |
99 | | }}} |
100 | | |
101 | | In the above: |
102 | | |
103 | | * adminusername will typically be root, unless you have another high-privileged account set up. |
104 | | * dolphin or mycommunity can be sample values for databasename. |
105 | | * dolphin is a sample value for dolphinusername. |
106 | | * hostname will usually be localhost. If you don't know what this value should be, refer to your system administrator. If you are the system administrator, just figure out what this value should be. |
107 | | * password should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols. |
108 | | |
109 | | Write down the values you used for databasename, dolphinusername, hostname, and password. |
110 | | |
| 119 | }}} |
| 120 | |
| 121 | In the above: |
| 122 | |
| 123 | * adminusername will typically be root, unless you have another high-privileged account set up. |
| 124 | |
| 125 | * dolphin or mycommunity can be sample values for databasename. |
| 126 | |
| 127 | * dolphin is a sample value for dolphinusername. |
| 128 | |
| 129 | * hostname will usually be localhost. If you don't know what this value should be, refer to your system administrator. If you are the system administrator, just figure out what this value should be. |
| 130 | |
| 131 | * password should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols. |
| 132 | |
| 133 | Write down the values you used for databasename, dolphinusername, hostname, and password. |
| 134 | |
| 135 | ---- |
146 | | * Using FTP client. |
147 | | Log into your FTP account using your favorite FTP client and navigate to the folder in which you uploaded the contents of the Dolphin-v.X.X.zip archive. |
148 | | Notice the folders and files names on the installation screen which are unwritable and set the following permissions using right click on the corresponding files and folders: |
149 | | {{{ |
150 | | 777 for folder (777 means that the objects possessing these permissions will be readable, writable and executable). |
151 | | }}} |
152 | | {{{ |
| 172 | * Using FTP client. |
| 173 | |
| 174 | Log into your FTP account using your favorite FTP client and navigate to the folder in which you uploaded the contents of the Dolphin-v.X.X.zip archive. |
| 175 | |
| 176 | Notice the folders and files names on the installation screen which are unwritable and set the following permissions using right click on the corresponding files and folders: |
| 177 | {{{ |
| 178 | 777 for folders and ffmpeg.exe (777 means that the objects possessing these permissions will be readable, writable and executable). |
154 | | }}} |
155 | | * Using shell client. |
156 | | Log into your shell account using your favorite shell client and change directory for that which contains your Dolphin script files. Now run the following commands under your SSH prompt: |
157 | | |
158 | | Dolphin/Ray/Orca folders to be writable for script operation: |
159 | | |
160 | | {{{ |
161 | | chmod -v 777 ./backup ./cache ./groups/gallery ./groups/orca/cachejs ./groups/orca/log ./inc ./langs ./media/images ./media/images/banners ./media/images/blog ./media/images/classifieds ./media/images/gallery ./media/images/profile ./media/images/profile_bg ./media/images/promo ./media/images/sdating ./media/images/sharingImages ./media/sound ./media/video ./orca/cachejs ./orca/log ./periodic ./tmp ./ray/modules/board/files ./ray/modules/im/files ./ray/modules/movie/files ./ray/modules/mp3/files ./ray/modules/music/files ./ray/modules/global/app/ffmpeg.exe |
162 | | }}} |
163 | | |
164 | | Dolphin/Ray/Orca files to be writable to perform the installation of all of them: |
165 | | |
166 | | {{{ |
167 | | chmod -v 666 ./inc/menu_content.inc.php ./inc/params.inc.php ./periodic/cmd.php ./periodic/notifies.php ./periodic/tags.php ./ray/modules/global/inc/cron.inc.php ./ray/modules/global/inc/header.inc.php |
168 | | }}} |
169 | | |
170 | | Ray XML files to be writable. This will allow you to install Ray Widgets via Ray Base easily: |
171 | | |
172 | | {{{ |
173 | | chmod -v 666 ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml |
174 | | }}} |
175 | | |
176 | | '''NOTE: Do not forget to install [http://www.boonex.net/ray/wiki/RayServerInstall Ray Media Server (RMS)] on your server or use [http://www.boonex.com/products/bms/ BoonEx Media Server] to run Ray fully operational'''. |
177 | | |
178 | | |
179 | | Click Next to continue. |
| 180 | |
| 181 | }}} |
| 182 | |
| 183 | * Using shell client. |
| 184 | |
| 185 | Log into your shell account using your favorite shell client and change directory for that which contains your Dolphin script files. Now run the following commands under your SSH prompt: |
| 186 | |
| 187 | Dolphin/Ray/Orca folders and ffmpeg.exe to be writable for script operation: |
| 188 | |
| 189 | {{{ |
| 190 | chmod 777 ./backup ./cache ./groups/gallery ./groups/orca/cachejs ./groups/orca/classes ./groups/orca/js ./groups/orca/layout ./groups/orca/log ./inc ./langs ./media/images ./media/images/banners ./media/images/blog ./media/images/classifieds ./media/images/gallery ./media/images/profile ./media/images/profile_bg ./media/images/promo ./media/images/promo/original ./media/images/sdating ./media/images/sharingImages ./media/sound ./media/video ./orca/cachejs ./orca/classes ./orca/conf ./orca/js ./orca/layout ./orca/log ./periodic ./tmp |
| 191 | |
| 192 | chmod 777 ./ray/modules/board/files ./ray/modules/chat/files ./ray/modules/im/files ./ray/modules/movie/files ./ray/modules/mp3/files ./ray/modules/music/files ./ray/modules/global/app/ffmpeg.exe |
| 193 | |
| 194 | }}} |
| 195 | |
| 196 | Dolphin/Ray/Orca files to be writable to perform the installation of all of them: |
| 197 | |
| 198 | {{{ |
| 199 | chmod 666 ./inc/db_cached/MenuContent.inc ./inc/db_cached/PageView.inc ./inc/db_cached/ProfileFields.inc ./inc/db_cached/SiteStat.inc ./inc/params.inc.php ./inc/prof.inc.php ./periodic/cmd.php ./periodic/cupid.php ./periodic/notifies.php |
| 200 | |
| 201 | }}} |
| 202 | |
| 203 | Ray XML files to be writable. This will allow you to install Ray Widgets via Ray Base easily: |
| 204 | |
| 205 | {{{ |
| 206 | ./ray/modules/board/xml/config.xml ./ray/modules/board/xml/langs.xml ./ray/modules/board/xml/main.xml ./ray/modules/board/xml/skins.xml ./ray/modules/chat/xml/config.xml ./ray/modules/chat/xml/langs.xml ./ray/modules/chat/xml/main.xml ./ray/modules/chat/xml/skins.xml ./ray/modules/desktop/xml/config.xml ./ray/modules/desktop/xml/langs.xml ./ray/modules/desktop/xml/main.xml ./ray/modules/desktop/xml/skins.xml ./ray/modules/global/data/integration.dat ./ray/modules/global/inc/cron.inc.php ./ray/modules/global/inc/header.inc.php ./ray/modules/global/xml/config.xml ./ray/modules/global/xml/main.xml ./ray/modules/im/xml/config.xml ./ray/modules/im/xml/langs.xml ./ray/modules/im/xml/main.xml ./ray/modules/im/xml/skins.xml ./ray/modules/movie/xml/config.xml ./ray/modules/movie/xml/langs.xml ./ray/modules/movie/xml/main.xml ./ray/modules/movie/xml/skins.xml ./ray/modules/mp3/xml/config.xml ./ray/modules/mp3/xml/langs.xml ./ray/modules/mp3/xml/main.xml ./ray/modules/mp3/xml/skins.xml ./ray/modules/music/xml/config.xml ./ray/modules/music/xml/langs.xml ./ray/modules/music/xml/main.xml ./ray/modules/music/xml/skins.xml ./ray/modules/presence/xml/config.xml ./ray/modules/presence/xml/langs.xml ./ray/modules/presence/xml/main.xml ./ray/modules/presence/xml/skins.xml ./ray/modules/shoutbox/xml/config.xml ./ray/modules/shoutbox/xml/langs.xml ./ray/modules/shoutbox/xml/main.xml ./ray/modules/shoutbox/xml/skins.xml ./ray/modules/video/xml/config.xml ./ray/modules/video/xml/langs.xml ./ray/modules/video/xml/main.xml ./ray/modules/video/xml/skins.xml ./inc/ProfileFields.inc |
| 207 | |
| 208 | }}} |
| 209 | |
| 210 | '''NOTE: Do not forget to install [http://www.boonex.net/ray/wiki/RayServerInstall Ray Media Server (RMS)] if you're installing an Ad-Free package or use [http://www.boonex.com/products/bms/ BoonEx Media Server] if you're installing a Free package. This is necessary to run Audio/Video features in some Ray widgets (such as Chat and IM) and some widgets won't work without Ray Media Server at all (such as Video Recorder and Whiteboard)'''. |
| 211 | |
| 212 | |
| 213 | Click Next to continue. |
185 | | * Site URL: here you should indicate the URL of your Dolphin folder including "http", such as: |
186 | | http://mysite.com/mycommunity/ |
187 | | (this path is usually properly determined by the installation script but you still should double check) |
188 | | |
189 | | * Directory root: this should be the server absolute path to the Dolphin folder, such as: |
190 | | {{{ |
| 219 | * Site URL: here you should indicate the URL of your Dolphin folder including "http", such as:[[BR]] |
| 220 | http://mysite.com/mycommunity/[[BR]] |
| 221 | (this path is usually properly determined by the installation script but you still should double check) |
| 222 | |
| 223 | * Directory root: this should be the server absolute path to the Dolphin folder, such as: |
| 224 | {{{ |
271 | | 1. Using CPanel: |
272 | | 1. Click the Cron Jobs link under your CPanel account and choose Advanced (Linux Style) |
273 | | 2. Indicate the email address for collecting information about cron execution |
274 | | 3. Return to the Dolphin installation page and copy the first command to be run as cron (omitting the zeros and asterisks), for example: |
275 | | {{{ |
276 | | /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/cmd.php |
277 | | }}} |
278 | | and insert it into the first field of your CPanel cron jobs management page |
279 | | schedule the time for this job, which also can be fetched from the Dolphin installation page, such as: |
280 | | {{{ |
| 314 | 1. Using CPanel: |
| 315 | |
| 316 | 1. Click the Cron Jobs link under your CPanel account and choose Advanced (Linux Style) |
| 317 | |
| 318 | 2. Indicate the email address for collecting information about cron execution |
| 319 | |
| 320 | 3. Return to the Dolphin installation page and copy the first command to be run as cron (omitting the zeros and asterisks), for example: |
| 321 | {{{ |
| 322 | /usr/local/bin/php -q m:/home/localhost/www/dolphin61/periodic/cmd.php |
| 323 | }}} |
| 324 | and insert it into the first field of your CPanel cron jobs management page schedule the time for this job, which also can be fetched from the Dolphin installation page, such as: |
| 325 | {{{ |
282 | | }}} |
283 | | 4. Apply the changes and click Back to return to the Cron Management page |
284 | | 5. Do the same for the second cron script: |
285 | | {{{ |
286 | | /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/notifies.php |
287 | | }}} |
288 | | and schedule the time for it: |
289 | | {{{ |
| 327 | }}} |
| 328 | |
| 329 | 4. Apply the changes and click Back to return to the Cron Management page |
| 330 | |
| 331 | 5. Do the same for the second cron script: |
| 332 | {{{ |
| 333 | /usr/local/bin/php -q m:/home/localhost/www/dolphin61/periodic/notifies.php |
| 334 | |
| 335 | }}} |
| 336 | and schedule the time for it: |
| 337 | {{{ |
311 | | 1) create batch files for every cron you wish to create. For example:[[BR]] |
312 | | ''c:\wamp\www\periodic\cmd.bat''[[BR]] |
313 | | ''c:\wamp\www\periodic\notifies.bat''[[BR]] |
314 | | ''c:\wamp\www\periodic\tags.bat'' |
315 | | |
316 | | This are sample contents of the above mentioned files: |
317 | | |
318 | | '''''c:\wamp\www\periodic\cmd.bat''''': |
319 | | {{{ |
| 374 | 1) create batch files for every cron you wish to create. For example:[[BR]] |
| 375 | ''c:\wamp\www\periodic\cmd.bat''[[BR]] |
| 376 | ''c:\wamp\www\periodic\notifies.bat''[[BR]] |
| 377 | ''c:\wamp\www\periodic\cupid.bat'' |
| 378 | |
| 379 | This are sample contents of the above mentioned files: |
| 380 | |
| 381 | '''''c:\wamp\www\periodic\cmd.bat''''': |
| 382 | {{{ |
343 | | 7. Now you should set the post-installation permissions and after '''delete the install folder'''. |
344 | | |
345 | | * Using FTP client. |
346 | | Log into your FTP account using your favorite FTP client and navigate to the folder in which you have installed Dolphin script. |
347 | | Notice the chmod commands for specified folders and files on the final installation screen and set the following permissions using right click on the corresponding files and folders: |
348 | | {{{ |
| 406 | Now you should set the post-installation permissions and after '''delete the install folder'''. |
| 407 | |
| 408 | * Using FTP client. |
| 409 | |
| 410 | Log into your FTP account using your favorite FTP client and navigate to the folder in which you have installed Dolphin script. |
| 411 | |
| 412 | Notice the chmod commands for specified folders and files on the final installation screen and set the following permissions using right click on the corresponding files and folders: |
| 413 | {{{ |
369 | | '''The final step for those installing Dolphin 6.1.0 beta1''' |
370 | | |
371 | | * You need to log into your Admin Panel and navigate to '''Plugins -> Orca''' |
372 | | |
373 | | * Click the link '''en''' next to the '''Compile languages''' wording |
374 | | |
375 | | * Refresh the Orca page after that |
| 432 | === Step 5: Final Step === |
| 433 | |
| 434 | Now you need to perform some final actions to register Dolphin, Orca and Ray and compile Orca language: |
| 435 | |
| 436 | * You need to log into your Admin Panel and you will be given the prompt to register Dolphin. |
| 437 | |
| 438 | * Proceed to '''Plugins -> Ray Suite -> open a widget -> click "Register"''' - you should perform this for every widget. |
| 439 | |
| 440 | * In case you're going to use RMS (Ray Media Server), proceed to '''Base Settings''' and specify the IP or domain address of your RMS, the ports it's going to use (usually 1935 and 5080) and tick the '''Use RMS''' checkbox. |
| 441 | |
| 442 | If you have installed Free package, you can use !BoonEx RMS. In this case you only have to tick the '''Use RMS''' checkbox without changing the other settings in this window. |
| 443 | |
| 444 | Click '''Save -> OK''' and close the Ray Suite window. |
| 445 | |
| 446 | * Proceed to to '''Plugins -> Orca''' |
| 447 | |
| 448 | Click the link '''en''' next to the '''Compile languages''' wording |
| 449 | |
| 450 | Refresh the Orca page after that. |