Xoops 2.3 Installation notes
A / Download and package installation
• • • • Phase Phase Phase Phase I : Uploading files to the webserver II : Security of folders /xoops_data and /xoops_lib III : Management of CHMODS IV : Installation of Protector module
B / Installation using wizard
• • • • • • • • • • • Step Step Step Step Step Step Step Step Step Step Step 1: 2: 3: 4: 5: 6: 7: 8: 9: 10 11 Language selection Introduction server configuration checking physical paths and website URL Connecting to the database Database configuration mainfile.php configuration Xoops tables creation Administrator account creation : Database initialization : End of installation and website access
Xoops package downloading
fig.01 - xoops.org
fig.02 - frxoops.org
fig.03 - Sourceforge.net
Xoops package can be downloaded on the official Xoops project website (fig.01) or on local support websites (for example, fig.02 french support) or on Sourceforge.net (fig.03).
WARNING: This tutorial gives details about a fresh installation of a Xoops 2.3 website. It doesn’t cover the updating of an existing Xoops website.
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
1
A / Download and files installation
• Phase I : Uploading files to the webserver
fig.04
fig.06
fig.05
Uncompress the downloaded package (fig.04) and display the content of the folder /htdocs (fig.05). This folder includes all files which are necessary to the installation of Xoops 2.3. Copy the content of the folder /htdocs in the root of your webserver (fig.06) or in a subfolder.
How can I have several Xoops websites on a webserver ? If you want to install several website on the same web space hosting, put Xoops files into differents subfolders : • www/01_xoops/ • www/02_xoops/ • www/03_xoops/ • www/etc. The wizard is able to distinguish between : - Webserver root folder (/www), - and the root folder of each Xoops website (named XOOPS_ROOT_FOLDER).
2
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Phase II : Security of directories /xoops_data and /xoops_lib
This second step is not strictly mandatory to the Xoops installation and its operation. Nevertheless, it is highly recommended to do this step to improve your website protection.
fig.08 fig.09
fig.07
Rename as you want folders /xoops_data and /xoops_lib (without using special characters). Then move these two folders in the “off line” area of your webserver.
fig.10
fig.11
Where is the «off line» area on my webserver ? In the webserver directory tree, the «off line» area is located one level above the website root folder (fig.10, folder /www). In fact, this area includes the folder /www and some others files placed by your host itself (fig.11). This area is only accessible by FTP method, and it is securized. If your host doesn’t give an access to this area, then you can only rename the two folders /xoops_data and /xoops_lib, without move them.
3
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Phase III : Management of CHMODS
Before launching the wizard, permissions (CHMODS) associated to files and directories must be set properly.
fig.12
fig.13
fig.14
fig.15
fig.16
Below, this is the list of all directories which must be writeable (CHMOD 755, see fig.18) : • xoops_data/ • xoops_data/caches/ • xoops_data/caches/smarty_cache/ • xoops_data/caches/smarty_compile/ • xoops_data/caches/xoops_cache/ Note : at this level, your folder /xoops_data should have an other name (see fig.08).
How modify a permission (CHMOD) ?
fig.17
fig.18 Directory or file CHMOD changes can be directly perform with your ftp software. In above example, Filezilla ftp client is used (Filezilla ) 1. 2. 3. 4. Right click on the resource that you want to change permissions Select «Files attributs» in the contextual menu (fig.17) check / uncheck options in function of permissions you want (fig.18) Click the OK button.
4
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Phase IV : Installation of Protector module
Even if your Xoops website can work properly without this module, it is highly recommended to install it. This module protects your website and give you an access to a log file in case of issue. This module is developed by GiJoe on xoops.peak.ne.jp
fig.19
fig.20
fig.21
Xoops 2.3 is released with the Protector module. To install it through the wizard, you must replace a file : • Open the directory /extra present in the xoops package (fig.19) • Rename the file mainfile.dist.php.protector (fig.20) to mainfile.dist.php (fig.21) • Upload the renamed file to website root folder (XOOPS_ROOT_PATH) and confirm the replacement by clicking on the OK button when appears the prompt window.
fig.22
5
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
B / Installation using wizard
With eleven steps (and screens), the wizard will help you to install your Xoops website : • configuration of access codes and paths (mainfile.dist.php file) • Database tables creation and first data insertion • etc. Before beginning the installation of Xoops, you have to collect certain number of information. They will be asked you in the various stages of the process : • Step 4: the name of directories / xoops_data and / xoops_lib such as you given in to the
Phase II : Protection of directories /xoops_data and /xoops_lib
• Step 5: the name of the server of database, the name of the base, the login and the password to connect to this database (these informations are given to you by your host) To start the wizard, type the URL pointing to your server : • This can be a name of domain or the temporary address supplied by your host • If necessary, add the subfolder with all Xoops website files
fig.23
fig.24
• Step 1 : Language selection
The first screen of the wizard gives you the ability to select the default language of your website. Once your choice done, click on the Next button.
fig.25
6
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Step 2 : Introduction
The introduction screen displays in the language previously selected. On this screen some information are given : • Xoops license : GPL • The mandatory environment to install properly Xoops 2.3 • the necessity to have a database, manipulations relating to CHMODS (see Phase III: Management of CHMODS ) and the setup of your navigator (acceptance of cookies and javascript)
fig.26
Once checks were performed, click on Next button.
• Step 3 : server configuration checking
fig.27
The wizard confirms in green the compatibility of your server with Xoops 2.3. Click on Next button.
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
7
• Step 4 : physical paths and website URL
fig.28
The wizard discerns automatically the ways of access to the site: • physical paths • Virtual path (or URL) So as stated to the Phase II: Security of directory / xoops_data and / xoops_lib : • you undertook the moving of these two directories • and renamed them ... the wizard is anymore capable to access these files automatically. You must therefore grab the appropriate path. A green symbol confirms you the accuracy of grabbed information (Fig.29)
fig.29
Help need ? The wizard is provided with an help which is useful to find fast an information or a signification of an option. To access it, click on the icon put in the part the upper right of the screen.
8
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Step 5 : Connecting to the database
This step is going to allow to the wizard to connect itself to your database. In order to do that, you must give to him the name of the server of database, your login and your password (indication: they also serve you for the connection in PhpMyAdmin). This confidential information is transmitted to you by your host. Once accomplished, click on Next button.
fig.30
• Step 6 : Database configuration
The sixth step allows to target database thanks to its name (in shared hosting, this name is fixed by the host) and to allocate a (free) prefix at the tables of your site. For a good interpretation of accentuated characters, the installation must be performed with : • characters set latin 1 - cp1252 West European • collation latin1_swedish_ci
fig.31
Once information were given, click on Next button.
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
9
• Step 7 : mainfile.php configuration
Step 7 recapitulates to the screen all personal data and records them in the mainfile.php file. Click on Next button.
fig.32
• Step 8 : Xoops tables creation
The eighth stage lists 32 tables created and necessary for the functioning of Xoops. Click on Next button to continue the installation.
fig.33
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
10
• Step 9 : Administrator account creation
Step 9 allows you to create your administrator account. Once your given personal information, click on Next button.
fig.34
• Step 10 : Database initialization
Step 10 inserts initial information in the tables of the site. Click on Next button to finish the installation.
fig.35
11
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin
• Step 11 : End of installation and website access
It is finished! You can access your site Xoops 2.3 from now on with your administrator account (codes given at Step 9: Administrator account creation ).
fig.36
Suppression of the installation directory and security of the mainfile.php file
fig.37 During your first access in the administration zone, two alerts are shown. You must imperatively take into account it to secure your site and do via FTP the following actions : 1. Suppression of the installation directory 2. Modification of CHMOD of the mainfile.php file, to choose CHMOD 444
12
Xoops Project - 2008 - Creative Commons Licence English translation by Vexin