Old:Installing Xoops on 4.0-Mona

Installing Xoops on 4.0-Mona

Introduction

This step-by-step guide shows how to install Xoops on Uniform Server V4.0-Mona and resolve a portability issue.

Pre-Installation

Install Uniform server

A) Create a new folder named xoops_b (Can be any name)
Extract a new copy of Uniform Server V4.0-Mona to this folder
Start Uniform Server.

Download Xoops

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

Copy files to Uniform Server

C) Expand the folder xoops-2.3.2b
D) Copy folder htdocs to Uniform Servers'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: Z:/www/xoops/xoops_data to Z:\home\xoops_data
(Note when you click in the next text box the above path will be found)
Change path from: Z:/www/xoops/xoops_lib to Z:\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: root66 -- 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 and click Administration Menu link

Note: These warnings:

WARNING: Directory Z:/www/xoops/install/ exists on your server.
Please remove this directory for security reasons.

WARNING: File Z:/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 warnings 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 (Z:) are hard coded to make it portable let PHP automatically determine the drive letter as follows:

Edit file UniServer\udrive\www\xoops\mainfile.php (you will need to remove read only attribute)

Locate this section of code:

    // XOOPS Physical Paths
    
    // Physical path to the XOOPS documents (served) directory WITHOUT trailing slash
    define( 'XOOPS_ROOT_PATH', 'Z:/www/xoops' );

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

Replace with:

    // XOOPS Physical Paths
    $root= substr($_SERVER["DOCUMENT_ROOT"],0,-4);
    
    // Physical path to the XOOPS documents (served) directory WITHOUT trailing slash
    define( 'XOOPS_ROOT_PATH', $root.'/www/xoops' );

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

$root= substr($_SERVER["DOCUMENT_ROOT"],0,-4); Effectively gives the drive (e.g. Z:) for virtual or disk-root installations. If installed as a service gives the path to the server root folder.

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

Note 2: Copy folder UniServer and all its content to a USB stick and you have fully portable Xoops server.

Top

Conclusion

You have seen how easy it is to install Xoops and make it fully portable.

Related links:

Mini Server 21 - Xoops 2.3.1

Installing Xoops (US 3.5)

Top