Installing Xoops

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

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

Download Xoops

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

Copy files to UniformServer

C) Expand the folder xoops-2.3.1
D) Copy folder htdocs to Uniform's root folder www
E) Rename the copied folder htdocs to xoops (can be any name)
E1) Expand this folder (xoops)
F) Move (do not copy) the two folders:
xoops_data and xoops_lib to Uniforms's home folder
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.

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

If not already running start Uniform Server. Xoops installation is mostly a click through exercise.
Type the following into a browser: http://localhost/xoops/
Choose your language: Click Next
Welcome to the XOOPS installation assistant: Click Next
Checking your server configuration: Click Next
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

Database connection: Enter root for user name and root for password click Next
Database configuration: For database name enter xoops click Next
Saving your system configuration: Click Next
Database tables creation: Click Next
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
Saving your settings to the database: Click Next
Welcome to your XOOPS site:
"You can now access the home page of your site." -- don't click the link.
Click Next
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