Changes between Version 35 and Version 36 of DetailedInstall

Timestamp:

May 6, 2009, 1:32:15 PM (15 years ago)

Author:

IgorL

Comment:

--

DetailedInstall

@@ -5 +5 @@
     [http://www.boonex.com/products/dolphin/download/ Download] and unzip the Dolphin package.
 
-    * 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.
-
-    * 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.
-
-    {{{
-wget http://get.boonex.com/Dolphin-v.6.1-Free
-    }}}
-    (for the Free version)
-
-    or
-    {{{
-wget http://get.boonex.com/Dolphin-v.6.1-AdFree
-    }}}
-    (for the Ad-Free version)
-
-    Then you will be able to unzip the package under your shell account using the following command:
-    {{{
-unzip -d Dolphin-v.X.X Dolphin-v.X.X.zip
-    }}}
-
-    "v.X.X" stands for the 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.
+    * If you are going to upload Dolphin to a remote web server, download it to your computer using a web browser and unzip the package into some folder on your local computer.
+
+    * If you have shell access to your web server (for UNIX systems), you may wish to download the Dolphin archive directly to your web server using the '''wget''' command.
+
+    {{{
+wget http://get.boonex.com/Dolphin-v.6.1
+
+    }}}
+
+    * Then you will be able to unzip the package under your shell account using the following command:
+    {{{
+unzip -d Dolphin-v.6.1.5.zip
+
+    }}}
+
+    * Thus, the Dolphin package will be extracted into the folder called ''Dolphin-v.6.1.5'' in the same directory where you have uploaded ''Dolphin-v.6.1.5.zip''.
 
 ----
@@ -96 +91 @@
 '''Using MySQL Client'''
 
-    If 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.
+    If you have shell access to your web server, 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.
     {{{
 $ mysql -u adminusername -p
@@ -121 +116 @@
     In the above:
 
-        * adminusername will typically be root, unless you have another high-privileged account set up.
-                
-        * dolphin or mycommunity can be sample values for databasename.
-                
-        * dolphin is a sample value for dolphinusername.
-                
-        * 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.
-                
-        * password should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols.
+        * ''adminusername'' will typically be ''root'', unless you want to specify a different privileged account.
+                
+        * ''dolphin'' or ''mycommunity'' can be sample values for databasename.
+                
+        * ''dolphin'' can be a sample value for dolphinusername.
+                
+        * ''hostname'' will usually be ''localhost''. If you don't know what this value should be, refer to your system administrator.
+                
+        * ''password'' should be a difficult-to-guess password, ideally containing a combination of upper- and lower-case letters, numbers, and symbols.
 
     Write down the values you used for databasename, dolphinusername, hostname, and password.
@@ -146 +141 @@
 ''In the Root Directory''
 
-    * 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.
-    * 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.
+    * 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.6.1.5.zip archive into the root directory of your web site.
+    * 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.6.1.5 directory (but not the directory itself) into the root directory of your web site.
 
 
 ''In a Subdirectory''
 
-    * 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.
-    * 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.
+    * 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.6.1.5.zip archive into the created directory.
+    * If your files are already on your web server, and you are using shell access to install Dolphin, move the Dolphin-v.6.1.5 directory to your desired location within the root directory of your web site and rename the directory to your desired name.
 
 ----
@@ -168 +163 @@
 === Permissions === 
 
-1. 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:
-
-    * Using FTP client.
-        
-    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.
-        
-    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:
-    {{{
-777 for folders and ffmpeg.exe (777 means that the objects possessing these permissions will be readable, writable and executable).
-666 for files (666 means that such objects will be readable and writable).
-
-    }}}
-        
-    * Using shell client.
+On the first page of the install process you can see the files and folders whose permissions should be properly set up.
+   There are the following ways to do this:
+
+  1) If PHP is running as an Apache module on Unix systems
+
+    * Using a shell client.
         
     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:
 
-    Dolphin/Ray/Orca folders and ffmpeg.exe to be writable for script operation:
-
     {{{
 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
@@ -192 +177 @@
 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
 
-    }}}
-
-    Dolphin/Ray/Orca files to be writable to perform the installation of all of them:
-
-    {{{
 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
 
-    }}}
-
-    Ray XML files to be writable. This will allow you to install Ray Widgets via Ray Base easily:
-
-    {{{
 chmod 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/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
 
-    }}}                 
-        
-    '''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)'''.
-                
-
-    Click Next to continue.
+    }}}
+  
+    * Using an FTP client.
+        
+    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.6.1.5.zip archive.
+    Now run the same commands as in the previous paragraph but replacing '''chmod''' with '''SITE CHMOD''' and placing every file or folder on a separate line, for example:
+    {{{
+SITE CHMOD 777 ./backup
+SITE CHMOD 777 ./cache
+SITE CHMOD 777 ./groups/gallery
+SITE CHMOD 777 ./groups/orca/cachejs
+SITE CHMOD 777 ./groups/orca/classes
+SITE CHMOD 666 ./ray/modules/board/xml/config.xml
+    }}}
+        
+  2) If PHP is running as CGI on Unix systems
+
+    In this case all folders should have 755 permissions and all files should have 644 permissions, except for the '''ffmpeg.exe file''', which should have 755 permissions.
+
+    To do this quickly, you can run the following commands when you're in the Dolphin installation folder under your SSH account:
+    {{{
+find ./ -type d -exec chmod 755 {} \;
+find ./ -type f -exec chmod 644 {} \;
+chmod 755 ray/modules/global/app/ffmpeg.exe;
+
+    }}}
+
+  3) If your site is to be installed on Windows, you don't need to change any permissions.
+
+After all permissions are correctly set, click '''Next''' to continue.
 
 === Script Paths ===
 
-2. On the second page of the install you will have to indicate the necessary paths demanded by the script. Here they are:
+On the second page of the install you will have to indicate the necessary paths demanded by the script. Here they are:
         
     * Site URL: here you should indicate the URL of your Dolphin folder including "http", such as:[[BR]]
@@ -260 +259 @@
         * Check ''GD'' installed: this field shows whether GD library is installed or not
         
-Click Next to continue.
+Click '''Next''' to continue.
         
 === Database Credentials ===
         
-3. On the third page you will have to specify the database information:
+On the third page you will have to specify the database information:
         
         * '''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.
@@ -276 +275 @@
         * '''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.
         
-Click Next to continue.
+Click '''Next''' to continue.
 
 
 === General Site Configuration ===
 
-4. On this page you will have to set up General Site Configuration:
+On this page you will have to set up General Site Configuration:
         
         * '''Site Title/Logo''': this is a word or phrase which will be displayed on the title bar of your web browser
@@ -306 +305 @@
 === Setting up Cron jobs ===
         
-6. If you made the previous steps correctly, the next step will guide you through the setting cron jobs.
+If you made the previous steps correctly, the next step will guide you through the setting cron jobs.
 
 To set up cron jobs, use one of the following ways:[[BR]]
@@ -411 +410 @@
     Log into your FTP account using your favorite FTP client and navigate to the folder in which you have installed Dolphin script.
         
-    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:
-    {{{
-755 for folders (755 means that the objects possessing these permissions will be readable and executable).
-644 for files (644 means that such objects will be only readable).
+    Run the following commands:
+    {{{
+SITE CHMOD 755 ./inc
+SITE CHMOD 755 ./periodic
+SITE CHMOD 644 ./periodic/cmd.php
+SITE CHMOD 644 ./periodic/notifies.php
+SITE CHMOD 644 ./periodic/cupid.php
+SITE CHMOD 644 ./periodic/tags.php
+SITE CHMOD 644 ./ray/modules/global/inc/header.inc.php
 
     }}}         
@@ -433 +437 @@
 === Step 5: Final Step ===
 
-    Now you need to perform some final actions to register Dolphin, Orca and Ray and compile Orca language:
+    '''NOTE: You should install [http://www.boonex.net/ray/wiki/RayServerInstall Ray Media Server (RMS)] if you're going to use Audio/Video features in some Ray applications (such as Chat and IM). Besides, some Ray applications won't work without Ray Media Server at all (such as Video Recorder and Whiteboard)'''.
+
+    Now you need to perform some final actions to register Dolphin, specify RMS for the Ray applications and compile languages for the Orca forum:
 
     * You need to log into your Admin Panel and you will be given the prompt to register Dolphin.
         
-    * Proceed to '''Plugins -> Ray Suite -> open a widget -> click "Register"''' - you should perform this for every widget.
-        
-    * In case you're going to use RMS (Ray Media Server), proceed to the '''Base Settings''', check '''Use RMS''', specify '''RMS Address''' (the IP address of your RMS), '''RMS Port''' ('''1935''' by default) and '''RMS HTTP Port''' ('''5080''' by default).
+    * Proceed to '''Plugins -> Ray Suite -> Base Settings''', check '''Use RMS''', specify '''RMS Address''' (the IP address of your RMS), '''RMS Port''' ('''1935''' by default) and '''RMS HTTP Port''' ('''5080''' by default).
         
     Click '''Save -> OK'''. If you see no error notification, your RMS is running properly. If the notification '''Can't connect to RMS''' appears, refer to this [http://www.boonex.com/trac/ray/wiki/GenRayTshooter#MyRMSwidgetsChatIMVideoRecorderendupinConnecting.WhatshouldIdo Troubleshooter]
 
-    '''Note''': If you have installed the Free package, you can use !BoonEx RMS rather than install your own one. In this case you have to navigate to '''Base Settings''', tick the '''Use RMS''' checkbox and specify the following values: '''rms.boonex.com''' for '''RMS Address''', '''10000''' for '''RMS Port''' and '''10080''' for '''RMS HTTP Port'''. Click '''Save -> OK'''. If the notification '''Can't connect to RMS''' appears, report this problem to '''support@boonex.com'''
-
-    * Proceed to to '''Plugins -> Orca'''
-        
-    Click the link '''en''' next to the '''Compile languages''' wording.
-        
-    Click the '''Manage Forum''' link and specify your Orca license.
-        
-    Navigate to http://your_site_url/groups/orca and click the link '''en''' next to the '''Compile languages''' wording. Refresh the page.
-
+    * Proceed to to '''Plugins -> Orca Forum'''
+        
+    Click the link '''en''' next to the '''Compile Langs''' wording. Refresh the page.
+    Navigate to http://your_site_url/groups/orca and click the link '''en''' next to the '''Compile Langs''' wording. Refresh the page.
+    Now you won't see these annoying [L] letters anymore :)