Changes between Initial Version and Version 1 of DetailedInstallES


Ignore:
Timestamp:
Aug 8, 2007, 6:47:51 AM (11 years ago)
Author:
admin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DetailedInstallES

    v1 v1  
     1== Detailed installation instructions == 
     2 
     3=== Step 1: Download and Extract === 
     4 
     5[http://www.boonex.com/products/dolphin/download/ Download] and unzip the Dolphin package. 
     6 
     7    * If you are going to upload Dolphin to a remote web server, download it to your computer with your favorite web browser and unzip the package into some folder on your local computer. 
     8 
     9    * If you have shell access to your web server, you may wish to upload the Dolphin archive directly to your web server using an FTP client. This way, you will avoid FTPing multiple files which usually takes a long time.                    Then you will ba able to unzip the package under your shell account using the following command: 
     10{{{ 
     11            unzip -d Dolphin-v.X.X Dolphin-v.X.X.zip 
     12}}} 
     13      
     14 "v.X.X" stands for current latest version index. Thus, the Dolphin package will be extracted into the folder called Dolphin-v.X.X in the same directory where you have uploaded Dolphin-v.X.X.zip. 
     15 
     16 
     17=== Step 2: Create a Database and a User === 
     18 
     19If your hosting provider has cPanel, you can follow these instructions to create your Dolphin database and user. 
     20 
     21   1. Log in to your cPanel. 
     22   2. Click MySQL Databases. 
     23   3. Create a database user: 
     24         1. Choose a username for Dolphin (for example "dolphin") and enter it in the Username field. 
     25         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. 
     26         3. Click Create user.  
     27   4. Create a Dolphin database and add the user to it: 
     28         1. Choose a name for your Dolphin database (for example "dolphin" or "community"), input it in the New Database field and click Create Database. 
     29         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. 
     30   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:  
     31{{{ 
     32$dbh = mysql_connect("hostname", "username", "<PASSWORD HERE>") or die ("message"); 
     33mysql_select_db("databasename"); 
     34}}} 
     35    Write down the values of ''hostname'', ''username'', ''databasename'', and the password you have chosen. (Note that ''hostname'' will usually be ''localhost''.)  
     36 
     37 
     38'''Using phpMyAdmin''' 
     39 
     40If 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. 
     41 
     42'''Note''': These instructions are written for phpMyAdmin 2.6.1; the phpMyAdmin user interface can vary slightly between versions. 
     43 
     44   1. Create a database: 
     45        1. Choose a name for your Dolphin database (for example "dolphin" or "mycommunity"), enter it in the Create new database field and click Create.  
     46        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: 
     47                        1. Click Add a new User. 
     48                        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). 
     49                        3. Leave the Host field blank. 
     50                        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. 
     51         3. Write down the username and password you have chosen. 
     52         4. Leave the default values for the Global privileges section. 
     53         5. Click Go. 
     54   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. 
     55   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''.)  
     56 
     57 
     58'''Using MySQL Client''' 
     59 
     60If you have shell access to your web server, are comfortable with using the command line, and your MySQL user has the permissions to create MySQL users and databases, you can follow the sample session below to create your Dolphin username and database. 
     61{{{ 
     62$ mysql -u adminusername -p 
     63Enter password: 
     64Welcome to the MySQL monitor.  Commands end with ; or \g. 
     65Your MySQL connection id is 5340 to server version: 3.23.54 
     66  
     67Type 'help;' or '\h' for help. Type '\c' to clear the buffer. 
     68  
     69mysql> CREATE DATABASE databasename; 
     70Query OK, 1 row affected (0.00 sec) 
     71  
     72mysql> GRANT ALL PRIVILEGES ON databasename.* TO "dolphinusername"@"hostname" IDENTIFIED BY "password"; 
     73Query OK, 0 rows affected (0.00 sec) 
     74   
     75mysql> FLUSH PRIVILEGES; 
     76Query OK, 0 rows affected (0.01 sec) 
     77 
     78mysql> EXIT 
     79Bye 
     80$  
     81}}} 
     82 
     83In the above: 
     84 
     85    * adminusername will typically be root, unless you have another high-privileged account set up. 
     86    * dolphin or mycommunity can be sample values for databasename. 
     87    * dolphin is a sample value for dolphinusername. 
     88    * 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. 
     89    * password should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols. 
     90 
     91Write down the values you used for databasename, dolphinusername, hostname, and password. 
     92 
     93 
     94=== Step 3: Place the files === 
     95 
     96Now you will need to decide where on your web site Dolphin script should be installed. These are possible options: 
     97 
     98    * In the root directory of your web site. (For example, http://mysite.com/) 
     99    * In a subdirectory of your web site. (For example, http://mysite.com/mycommunity/) 
     100 
     101Note: The location of your root web directory in the filesystem on your web server will vary across hosting providers and operating systems. Check with your hosting provider or system administrator if you do not know where this is. 
     102 
     103In the Root Directory 
     104 
     105    * If you need to upload your files into your web server, use your favorite FTP client to upload all the contents of the Dolphin-v.X.X.zip archive into the root directory of your web site. 
     106    * If your files are already on your web server, and you are using shell access to install Dolphin, move all of the contents of the Dolphin-v.X.X directory (but not the directory itself) into the root directory of your web site. 
     107 
     108 
     109In a Subdirectory 
     110 
     111    * If you need to upload your files into your web server, create a directory with your desired name in the root directory of your web site, then use your favorite FTP client to upload the contents of Dolphin-v.X.X.zip archive into the created directory. 
     112    * If your files are already on your web server, and you are using shell access to install Dolphin, move the Dolphin-v.X.X directory to your desired location within the root directory of your web site and rename the directory to your desired name. 
     113 
     114 
     115=== Step 4: Run the Install Script === 
     116 
     117Using your favorite web browser, navigate to install/index.php within the directory into which you have just installed Dolphin on your web site: 
     118 
     119    * If you installed into a subdirectory called ''mycommunity'', you would navigate to http://mysite.com/mycommunity/install/index.php 
     120    * If you installed into the root directory of your web site, you would open http://mysite.com/install/index.php 
     121 
     122After this the installation instruction should appear in your browser's window. Follow them carefully to complete the installation. Here's a summary of the info you will have to specify: 
     123 
     124=== Permissions ===  
     125 
     1261. On the first page of the install process you can see the files and folders which permissions should be properly set up. There are two ways to do this: 
     127 
     128                * Using FTP client. 
     129                        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. 
     130                        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: 
     131{{{ 
     132                        777 for folder (777 means that the objects possessing these permissions will be readable, writable and executable). 
     133}}} 
     134{{{ 
     135                        666 for files (666 means that such objects will be readable and writable). 
     136}}} 
     137                * Using shell client. 
     138                        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: 
     139{{{ 
     140                        chmod -v 777 backup cache inc langs media/images/banners media/images/blog media/images/gallery media/images/profile media/images/profile_bg media/images/sdating media/sound media/video periodic tmp 
     141}}} 
     142{{{ 
     143                        chmod -v 666 periodic/cmd.php periodic/notifies.php inc/params.inc.php ray/inc/header.inc.php ray/inc/cron.inc.php ray/modules/chat/js/admin.js ray/modules/im/js/invite.js ray/modules/presence/js/update.js orca/inc/header.inc.php inc/menu_content.inc.php ray/modules/im/js/open.js 
     144}}}                      
     145Click Next to continue. 
     146 
     147=== Script Paths === 
     148 
     1492. On the second page of the install you will have to indicate the necessary paths demanded by the script. Here they are: 
     150         
     151        * Site URL: here you should indicate the URL of your Dolphin folder including "http", such as: 
     152                http://mysite.com/mycommunity/ 
     153                (this path is usually properly determined by the installation script but you still should double check) 
     154                 
     155        * Directory root: this should be the server absolute path to the Dolphin folder, such as: 
     156{{{              
     157        /home/myaccount/public_html/mycommunity/ 
     158}}} 
     159(on Unix systems) or 
     160{{{ 
     161        C:/webservers/home/myaccount/www/mycommunity/ 
     162}}} 
     163(on Windows systems) This path is usually properly determined by the installation script but you still should double check. 
     164                 
     165        * Path to php binary: here you should indicate the absolute path to php executable file on your server, such as: 
     166{{{ 
     167        /usr/local/bin/php  
     168}}} 
     169(on Unix systems) or 
     170{{{ 
     171        C:/php/php.exe  
     172}}} 
     173(on Windows systems) This executable will be used to run crons (periodic tasks). 
     174                 
     175        * Path to ''mogrify'', Path to ''convert'' and Path to ''composite'': these paths indicate the location of [http://www.imagemagick.org/ ''ImageMagick''] applications, which will be necessary if ''php'' running on your server is not compiled with [http://www.boutell.com/gd/ ''GD library'']; 
     176        ''Imagemagick'' is just an alternative for ''GD'' - image processing application; 
     177        if ''PHP'' is compiled with ''GD'' library and you're not going to use [http://www.imagemagick.org/ ''ImageMagick''] with Dolphin, you can omit these steps and keep the default values. 
     178        The actual paths can be such: 
     179{{{ 
     180        /usr/local/bin/mogrify 
     181        /usr/local/bin/convert 
     182        /usr/local/bin/composite 
     183}}}      
     184        * Check ''GD'' installed: this field shows whether GD library is installed or not 
     185         
     186Click Next to continue. 
     187         
     188=== Database Credentials === 
     189         
     1903. On the third page you will have to specify the database information: 
     191         
     192        * '''SQL file''': this is the relative path to the database creation file, which is determined by default. If your file resides in a different directory, you should indicate its relative path here. The base folder of the path is considered to be the Dolphin installation folder. 
     193         
     194        * '''Empty database''': choose "yes" or "no". Choosing "yes" will empty the whole database, i.e. removes its tables. Think twice before choosing this option. The option "no" is the default option and will make no harm to your database. 
     195         
     196        * '''Empty tables''': choose "yes" or "no". Choosing "yes" will empty all the tables in the database while keeping the tables structure intact. The default option is "yes" and you shouldn't make any changes here. 
     197         
     198        * '''Database host name''': here you should indicate the host name of your database, which is usually 'localhost'. Refer to the notes you made during database creation. 
     199         
     200        * '''Database name, Database user and Database password''': here you should indicate the name of the database and the user requisites you created in the '''Step 2'''. Again, refer to the notes you made when creating the database and the user. 
     201         
     202Click Next to continue. 
     203         
     204=== Site Information === 
     205 
     2064. On the fourth page you will have to set up General Site Configuration: 
     207         
     208        * '''Site Title/Logo''': this is a word or phrase which will be displayed on the title bar of your web browser 
     209 
     210        * '''Site e-mail''': indicate the email which will be used for getting info about purchased memberships, mass mailer's status, spam reports, and requests for canceling subscriptions. 
     211         
     212        * '''Notify e-mail''': indicate the email address which will be shown in the "From" field of cupid and mass mails as well as profiles confirmation and activation messages. 
     213         
     214        * '''Bug report email''': indicate the email address to collecting MySQL bug reports for subsequent debugging. 
     215         
     216        * '''Currency''': you should indicate your site's currency sign only for display purposes. You can use html entities here, if you can't enter the sign from the keyboard, such as: &pound; for pound sterling. 
     217         
     218Click Next to continue. 
     219 
     220=== Setting up Cron jobs === 
     221         
     2225. If you made the previous steps correctly, you should see the final page of the installation, which will guide you through the final permissions setting and cron jobs installation. 
     223        To set up cron jobs, use one of the following ways: 
     224                1. Using CPanel: 
     225                        1. Click the Cron Jobs link under your CPanel account and choose Advanced (Linux Style) 
     226                        2. Indicate the email address for collecting information about cron execution 
     227                        3. Return to the Dolphin installation page and copy the first command to be run as cron (omitting the zeros and asterisks), for example: 
     228{{{ 
     229                        /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/cmd.php 
     230}}} 
     231                        and insert it into the first field of your CPanel cron jobs management page 
     232                        schedule the time for this job, which also can be fetched from the Dolphin installation page, such as: 
     233{{{ 
     234                        0 0 * * * (which means: run the script every midnight) 
     235}}} 
     236                        4. Apply the changes and click Back to return to the Cron Management page 
     237                        5. Do the same for the second cron script: 
     238{{{ 
     239                        /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/notifies.php 
     240}}} 
     241                        and schedule the time for it: 
     242{{{ 
     243                        */10 * * * * (which means: run the script every 10 minutes) 
     244}}} 
     245                2. Using shell (for experienced users): 
     246                        run the following command 
     247{{{ 
     248                        crontab -e 
     249}}} 
     250                        This will open your default text editor, where you will have to insert the three lines of code to be executed: 
     251{{{ 
     252                        MAILTO=myemail@mysite.com 
     253                        0 0 * * * /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/cmd.php 
     254                        */10 * * * * /usr/local/bin/php -q m:/home/localhost/www/d5605/periodic/notifies.php 
     255                        Save the file and exit the editor. 
     256}}}              
     257 
     258=== Post-Installation file permission === 
     259 
     2606. Now you should set the final permissions and delete the install folder, using an FTP or SSH client. 
     261                * Using FTP client. 
     262                        Log into your FTP account using your favorite FTP client and navigate to the folder in which you have installed Dolphin script. 
     263                        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: 
     264{{{ 
     265                        755 for folders (755 means that the objects possessing these permissions will be readable and executable). 
     266}}} 
     267{{{ 
     268                        644 for files (644 means that such objects will be only readable). 
     269}}}              
     270 
     271'''Now you must delete the ''/install'' folder'''. 
     272 
     273                * Using shell client. 
     274                        Log into your shell account using your favorite shell client and change directory for that which contains your installed Dolphin script. Now run the following commands under your SSH prompt: 
     275{{{ 
     276                        chmod -v 755 inc periodic 
     277                        chmod -v 644 periodic/cmd.php periodic/notifies.php ray/modules/global/inc/header.inc.php 
     278}}}                      
     279 
     280=== Log in to Administration Panel === 
     281 
     2827. Click login to Dolphin Admin Panel to change the admin password. You should use the following paths according to your installation http://www.mysite.com/admin/ or http://www.mysite.com/mycommunity/admin/ 
     283                You will see the admin login page. Input the following default requisites: 
     284{{{ 
     285                log in: admin 
     286                Password: dolphin 
     287}}} 
     288                Once you're in, navigate to Global settings -> Change admin password. 
     289                Fill in the Change administrator password form: 
     290 
     291                        Old Password: dolphin 
     292 
     293                        New Password: choose something difficult-to-guess 
     294 
     295                        Confirm new password  
     296 
     297                        Save Password will complete this operation. 
     298         
     2998. Now you can visit your Dolphin home page by clicking on Site Home in upper right. 
     300                 
     301 ''Don't forget to Log Out from the admin panel when you're done.'' 
 
Below is the legacy version of the Boonex site, maintained for Dolphin.Pro 7.x support.
The new Dolphin solution is powered by UNA Community Management System.
Fork me on GitHub