Installing Xoops: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edits by Upazixorys (Talk); changed back to last version by Ric)
 
Line 1: Line 1:
=[http://ukusypumi.co.cc Under Construction! Please Visit Reserve Page. Page Will Be Available Shortly]=
<span id="top"></span>
&lt;span id=&quot;top&quot;&gt;&lt;/span&gt;
<div style="padding:0;margin:0; border-bottom:3px inset #000000">
&lt;div style=&quot;padding:0;margin:0; border-bottom:3px inset #000000&quot;&gt;
{|  
{|  
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
How to install Xoops on Uniform Server 3.5-Apollo  
How to install Xoops on Uniform Server 3.5-Apollo  
|}
|}
&lt;/div&gt;
</div>
{| cellpadding=&quot;2&quot;
{| cellpadding="2"
|
|
__TOC__
__TOC__
Line 18: Line 17:
{|
{|
|-
|-
|valign=&quot;top&quot;|
|valign="top"|
'''''Install Uniform server'''''
'''''Install Uniform server'''''


Line 28: Line 27:


'''''Download Xoops'''''  
'''''Download Xoops'''''  
&lt;ol start=&quot;6&quot;&gt;
<ol start="6">
&lt;li&gt; '''B)''' Create a new folder '''xoops_temp''' (Can be any name its only a tempory folder)&lt;/li&gt;
<li> '''B)''' Create a new folder '''xoops_temp''' (Can be any name its only a tempory folder)</li>
&lt;li&gt; Download the latest version (xoops-2.3.1.zip) of Xoops from  [http://www.xoops.org/modules/core/ www.xoops.org]&lt;/li&gt;
<li> Download the latest version (xoops-2.3.1.zip) of Xoops from  [http://www.xoops.org/modules/core/ www.xoops.org]</li>
&lt;li&gt; Copy the file dowloaded ('''xoops-2.3.1.zip''') to '''xoops_temp'''&lt;/li&gt;
<li> Copy the file dowloaded ('''xoops-2.3.1.zip''') to '''xoops_temp'''</li>
&lt;li&gt; Unzip xoops-2.3.1.zip into this folder.&lt;/li&gt;
<li> Unzip xoops-2.3.1.zip into this folder.</li>
&lt;/ol&gt;
</ol>
'''''Copy files to UniformServer'''''
'''''Copy files to UniformServer'''''
&lt;ol start=&quot;10&quot;&gt;
<ol start="10">
&lt;li&gt; '''C)''' Expand the folder '''xoops-2.3.1'''&lt;/li&gt;
<li> '''C)''' Expand the folder '''xoops-2.3.1'''</li>
&lt;li&gt; '''D)''' Copy folder '''htdocs''' to Uniform's root folder '''www'''&lt;/li&gt;
<li> '''D)''' Copy folder '''htdocs''' to Uniform's root folder '''www'''</li>
&lt;li&gt; '''E)''' Rename the copied folder '''htdocs''' to '''xoops''' (can be any name)&lt;/li&gt;
<li> '''E)''' Rename the copied folder '''htdocs''' to '''xoops''' (can be any name)</li>
&lt;li&gt; '''E1)''' Expand this folder ('''xoops''')&lt;/li&gt;
<li> '''E1)''' Expand this folder ('''xoops''')</li>
&lt;li&gt; '''F)''' '''Move''' (do not copy) the two folders:&lt;br&gt;'''xoops_data''' and '''xoops_lib''' to Uniforms's '''home''' folder &lt;/li&gt;
<li> '''F)''' '''Move''' (do not copy) the two folders:<br>'''xoops_data''' and '''xoops_lib''' to Uniforms's '''home''' folder </li>
&lt;li&gt; While in folder xoops remove the read only attribute for the following folders:&lt;br&gt;(right click properties uncheck read only box click apply)&lt;/li&gt;
<li> While in folder xoops remove the read only attribute for the following folders:<br>(right click properties uncheck read only box click apply)</li>
&lt;/ol&gt;
</ol>


:*G1) '''uploads/'''
:*G1) '''uploads/'''
Line 49: Line 48:


Still in folder xoops locate file '''mainfile.php''' and '''mainfile.dist.php''' check they are writeable if not remove read only atribute.
Still in folder xoops locate file '''mainfile.php''' and '''mainfile.dist.php''' check they are writeable if not remove read only atribute.
&lt;ol start=&quot;16&quot;&gt;
<ol start="16">
&lt;li&gt; '''H)''' Expand folder &quot;'''home'''&quot; remove the read-only attribute&lt;br&gt;for the following folder and all its sub-folders:
<li> '''H)''' Expand folder "'''home'''" remove the read-only attribute<br>for the following folder and all its sub-folders:
&lt;/ol&gt;
</ol>
:* xoops_data/
:* xoops_data/
:*xoops_data/configs/
:*xoops_data/configs/
Line 66: Line 65:


# If not already running start Uniform Server. Xoops installation is mostly a click through exercise.
# If not already running start Uniform Server. Xoops installation is mostly a click through exercise.
# Type the following into a browser: '''&lt;nowiki&gt;http://localhost/xoops/&lt;/nowiki&gt;'''
# Type the following into a browser: '''<nowiki>http://localhost/xoops/</nowiki>'''
# Choose your language: Click '''Next'''
# Choose your language: Click '''Next'''
# Welcome to the XOOPS installation assistant: Click '''Next'''
# Welcome to the XOOPS installation assistant: Click '''Next'''
Line 72: Line 71:
# Paths settings: This will fail on '''xoops_data''' and '''xoops_lib''' these were moved for security.
# Paths settings: This will fail on '''xoops_data''' and '''xoops_lib''' these were moved for security.


::* Change the path from: '''W:/www/xoops/xoops_data''' to '''W:\home\xoops_data'''&lt;br&gt;(Note when you click in the next text box the above path will be found)
::* Change the path from: '''W:/www/xoops/xoops_data''' to '''W:\home\xoops_data'''<br>(Note when you click in the next text box the above path will be found)
::* Change path from: '''W:/www/xoops/xoops_lib''' to '''W:\home\xoops_lib'''&lt;br&gt;(Click in one of the other text boxes the path will be found)
::* Change path from: '''W:/www/xoops/xoops_lib''' to '''W:\home\xoops_lib'''<br>(Click in one of the other text boxes the path will be found)
::*Click '''Nex'''t
::*Click '''Nex'''t
&lt;ol start=&quot;7&quot;&gt;
<ol start="7">
&lt;li&gt; Database connection: Enter root for user name and root for password click '''Next'''&lt;/li&gt;
<li> Database connection: Enter root for user name and root for password click '''Next'''</li>
&lt;li&gt; Database configuration: For database name enter xoops click '''Next'''&lt;/li&gt;
<li> Database configuration: For database name enter xoops click '''Next'''</li>
&lt;li&gt; Saving your system configuration: Click Next&lt;/li&gt;
<li> Saving your system configuration: Click Next</li>
&lt;li&gt; Database tables creation: Click '''Next'''&lt;/li&gt;
<li> Database tables creation: Click '''Next'''</li>
&lt;li&gt; Please enter your initial settings:&lt;br&gt;Admin login: '''admin'''&lt;br&gt;Admin e-mail: '''fred@someone.com''' -- use a real e-mail address&lt;br&gt;Admin password: '''admin''' -- use a real password&lt;br&gt;Click '''Next'''&lt;/li&gt;
<li> Please enter your initial settings:<br>Admin login: '''admin'''<br>Admin e-mail: '''fred@someone.com''' -- use a real e-mail address<br>Admin password: '''admin''' -- use a real password<br>Click '''Next'''</li>
&lt;li&gt; Saving your settings to the database: Click '''Next'''&lt;/li&gt;
<li> Saving your settings to the database: Click '''Next'''</li>
&lt;li&gt; Welcome to your XOOPS site:&lt;br&gt;&quot;You can now access the home page of your site.&quot; -- '''don't click the link'''.&lt;br&gt;'''Click Next'''&lt;/li&gt;
<li> Welcome to your XOOPS site:<br>"You can now access the home page of your site." -- '''don't click the link'''.<br>'''Click Next'''</li>
&lt;li&gt; Login as admin&lt;/li&gt;
<li> Login as admin</li>
&lt;/ol&gt;
</ol>


'''''Note'': ''These warnings'':'''
'''''Note'': ''These warnings'':'''
&lt;pre&gt;
<pre>
WARNING: Directory W:/www/xoops/install/ exists on your server.
WARNING: Directory W:/www/xoops/install/ exists on your server.
Please remove this directory for security reasons.
Please remove this directory for security reasons.
&lt;/pre&gt;
</pre>


&lt;pre&gt;
<pre>
WARNING: File W:/www/xoops/mainfile.php is writeable by the server.
WARNING: File W:/www/xoops/mainfile.php is writeable by the server.
Please change the permission of this file for security reasons.
Please change the permission of this file for security reasons.
in Unix (444), in Win32 (read-only)
in Unix (444), in Win32 (read-only)
&lt;/pre&gt;
</pre>


Make above changes and refresh the page warning no longer displayed.
Make above changes and refresh the page warning no longer displayed.
Line 102: Line 101:
'''''Note'':'''
'''''Note'':'''


You can access your site by typing the following into a browser: '''&lt;nowiki&gt;http://localhost/xoops/index.php&lt;/nowiki&gt;'''
You can access your site by typing the following into a browser: '''<nowiki>http://localhost/xoops/index.php</nowiki>'''


'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
Line 113: Line 112:


Replace every occurrence of drive letter “W” with the variable $_ENV['Disk'] as show in the lines outdented.   
Replace every occurrence of drive letter “W” with the variable $_ENV['Disk'] as show in the lines outdented.   
&lt;pre&gt;
<pre>
     // XOOPS Physical Paths
     // XOOPS Physical Paths
      
      
Line 128: Line 127:
define( 'XOOPS_VAR_PATH', $_ENV['Disk'].':/home/xoops_data' );
define( 'XOOPS_VAR_PATH', $_ENV['Disk'].':/home/xoops_data' );
     // Alias of XOOPS_PATH, for compatibility, temporary solution
     // Alias of XOOPS_PATH, for compatibility, temporary solution
     define(&quot;XOOPS_TRUST_PATH&quot;, XOOPS_PATH);
     define("XOOPS_TRUST_PATH", XOOPS_PATH);
&lt;/pre&gt;
</pre>


'''''Note'':''' After saving the file set it’s file attribute back to '''read only'''.
'''''Note'':''' After saving the file set it’s file attribute back to '''read only'''.

Latest revision as of 08:35, 24 November 2010

MPG UniCenter

How to install Xoops on Uniform Server 3.5-Apollo

Xoops is easy to install on Uniform Server 3.5-Apollo.

This step-by-step guide shows how to install Xoops and resolve a portability issue.

Pre-Installation

Install Uniform server

  1. A) Create a new folder named xoops_uniform_server
  2. Extract a new copy of Uniform Server to this folder
  3. Run Uniform Server. From apanel select PHP configuration (left menu)
  4. Set Register Globals: Off click Save
  5. Restart Uniform Server.

Download Xoops

  1. B) Create a new folder xoops_temp (Can be any name its only a tempory folder)
  2. Download the latest version (xoops-2.3.1.zip) of Xoops from www.xoops.org
  3. Copy the file dowloaded (xoops-2.3.1.zip) to xoops_temp
  4. Unzip xoops-2.3.1.zip into this folder.

Copy files to UniformServer

  1. C) Expand the folder xoops-2.3.1
  2. D) Copy folder htdocs to Uniform's root folder www
  3. E) Rename the copied folder htdocs to xoops (can be any name)
  4. E1) Expand this folder (xoops)
  5. F) Move (do not copy) the two folders:
    xoops_data and xoops_lib to Uniforms's home folder
  6. While in folder xoops remove the read only attribute for the following folders:
    (right click properties uncheck read only box click apply)
  • G1) uploads/
  • G2) cache/
  • G3) templates_c/

Still in folder xoops locate file mainfile.php and mainfile.dist.php check they are writeable if not remove read only atribute.

  1. H) Expand folder "home" remove the read-only attribute
    for the following folder and all its sub-folders:
  • xoops_data/
  • xoops_data/configs/
  • xoops_data/caches/
  • xoops_data/caches/xoops_cache/
  • xoops_data/caches/smarty_cache/
  • xoops_data/caches/smarty_compile/

Top

Install Xoops

  1. If not already running start Uniform Server. Xoops installation is mostly a click through exercise.
  2. Type the following into a browser: http://localhost/xoops/
  3. Choose your language: Click Next
  4. Welcome to the XOOPS installation assistant: Click Next
  5. Checking your server configuration: Click Next
  6. Paths settings: This will fail on xoops_data and xoops_lib these were moved for security.
  • Change the path from: W:/www/xoops/xoops_data to W:\home\xoops_data
    (Note when you click in the next text box the above path will be found)
  • Change path from: W:/www/xoops/xoops_lib to W:\home\xoops_lib
    (Click in one of the other text boxes the path will be found)
  • Click Next
  1. Database connection: Enter root for user name and root for password click Next
  2. Database configuration: For database name enter xoops click Next
  3. Saving your system configuration: Click Next
  4. Database tables creation: Click Next
  5. Please enter your initial settings:
    Admin login: admin
    Admin e-mail: fred@someone.com -- use a real e-mail address
    Admin password: admin -- use a real password
    Click Next
  6. Saving your settings to the database: Click Next
  7. Welcome to your XOOPS site:
    "You can now access the home page of your site." -- don't click the link.
    Click Next
  8. Login as admin

Note: These warnings:

WARNING: Directory W:/www/xoops/install/ exists on your server.
Please remove this directory for security reasons.
WARNING: File W:/www/xoops/mainfile.php is writeable by the server.
Please change the permission of this file for security reasons.
in Unix (444), in Win32 (read-only)

Make above changes and refresh the page warning no longer displayed.

Note:

You can access your site by typing the following into a browser: http://localhost/xoops/index.php

Top

Portability

A few paths are hard coded if after installation you wish to use a different drive letter make the following modifications to Xoops.

Edit file mainfile.php found in the xoops folder (you will need to remove read only attribute)

The variable $_ENV['Disk'] picks up the current virtual drive letter.

Replace every occurrence of drive letter “W” with the variable $_ENV['Disk'] as show in the lines outdented.

    // XOOPS Physical Paths
    
    // Physical path to the XOOPS documents (served) directory WITHOUT trailing slash
//define( 'XOOPS_ROOT_PATH', 'W:/www/xoops' );
define( 'XOOPS_ROOT_PATH', $_ENV['Disk'].':/www/xoops' );

    // For forward compatibility
    // Physical path to the XOOPS library directory WITHOUT trailing slash
//define( 'XOOPS_PATH', 'W:/home/xoops_lib' );
define( 'XOOPS_PATH', $_ENV['Disk'].':/home/xoops_lib' );
    // Physical path to the XOOPS datafiles (writable) directory WITHOUT trailing slash
//define( 'XOOPS_VAR_PATH', 'W:/home/xoops_data' );
define( 'XOOPS_VAR_PATH', $_ENV['Disk'].':/home/xoops_data' );
    // Alias of XOOPS_PATH, for compatibility, temporary solution
    define("XOOPS_TRUST_PATH", XOOPS_PATH);

Note: After saving the file set it’s file attribute back to read only.

Top

Conclusion

From the above you have seen how easy it is to install Xoops.

If you only want to explore the package take a look at Mini Server 21 - Xoops 2.3.1 it's a pre-installed ready to go package.

Top


Ric