Chapter 3. Installation of XooNIps

This chapter shows how to set the environment to use XooNIps.

1. Plan and design a website

Before building a website, it is fundamental to make specific plans on its potential users and purposes, etc.

1.1. Describe specific purposes of the website.

Specifically describe the website you are going to build.

Without specific purposes, the website can not draw attentions and nobody will visit it.

The chart below shows an example of planning.

Cause (Why) The increasing needs of exchanging neuroscience related information and sharing them among lab staff members.
Effect: Intended purpose (What) To share information regarding neuroscience and publish lab information.
Profiles of the potential users (Who) Individual researchers as well as internal lab staff who are interested in neuroscience study and research.
Targeted areas (Where) All Japan, worldwide, etc.
Release date/duration, etc. (When) ddd/mmm/yyy, unlimited duration, etc.
Resources (How) Utilize CMS and open source software, etc.

1.2. Decide functions of the website

Decide what kind of functions are necessary to be implemented based on the planning.

XOOPS is operated various functions by the "modules".

Refer to the XOOPS official site, etc. and decide the necessary modules for the website. The following shows the examples of the module.

  • BBS, forum, etc.

  • Posting news articles

  • Calendar

  • Inquiry form

  • Uploading other sites' contents by RSS.

1.3. Select software and hardware

Select specific software and hardware suitable for the website. Note: This manual explains under the condition that the website is to be built based on XOOPS and XooNIps.

1.4. Make a specification document

Decide the things described below according to the actual site operation.

Site URL and site name:

  • Decide a URL in advance since it is necessary for installing XOOPS.

Decide modules:

  • Decide the modules and their versions to be used on XooNIps.

How to activate user accounts:
Choose a manner of activating user accounts (registering a new user) from the following.

  • By E-mailing to the user

  • By automatic activation

  • By the site administrator

Define required information for the user registration
These are examples of required information. Choose items from the list below.

  • Real name

  • Company Name

  • Affiliation

  • Address

  • Zip code

  • Telephone number

  • Fax number

Define the initial value of disk capacity allocated for a registered user.
Define the maximum number of data, registered indexes, initial value of disk capacity for a registered user.

  • Maximum number of registered data (initial value 500)

  • Maximum number of registered indexes (initial value 200)

  • Disk capacity (initial value 500 MB)

Define the initial value of disk capacity allocated for a group
Define maximum number of data, indexes, disk capacity allocated for a group.

  • Maximum number of registered data (initial value 1000)

  • Maximum number of indexes (initial value 500)

  • Disk capacity (initial value 1000 MB)

Define the procedure of certifying data to be published
Choose a manner of certifying data to be published

  • By moderator

  • By automatic certification

Access limitation to the publication area
Choose an access limitation to the publication area from the list below.

  • Permit only the registered users

  • Permit all accesses including guest users

Define a file format for downloading attached files.
Choose a file format for downloading attached files.

  • Compress data including metadata files as a zip file.

  • Compress the registered data (without metadata) as a zip file

Decide the area of items to be viewed.
XooNIps refers the data to be published as the user's performance items.
Choose the area where the items will be viewed

  • [Yes] Permit to choose from all data in the publishing areas.

  • [No] Permit to choose only from the data registered by the user.

Setup for exporting:
Decide the permission of exporting. Choose [Yes] or [No] as below.
Moderators are exclusively permitted to export data regardless of this setting.

  • [Yes] Permit users to export their own data.

  • [No] Do not permit users to export.

Setup for exporting attached files:
Decide the permission of exporting attached files.

  • [Yes] Permit users to export attached files of their data.

  • [No] Do not permit users to export attached files of their data.

Setup for importing:
Choose [Yes] or [No] as below.
Moderators are exclusively permitted to import data regardless of this setting.

  • [Yes] Permit the user to import the data to his/her individual area.

  • [No]Do not permit the user to import data.

Setup the moderator's authority:
Choose [Yes] or [No] for the data editing permission to all users.

  • [Yes] Permit the moderator to edit the data of all users.

  • [No] Do not permit the moderator to edit the data of all users.

2. Server structure components

The followings are necessary software for activating XooNIps.

OS Not specified
Web server Apache 2.0 or later versions
Database MySQL 4.1 or later (Must be applicable to InnoDB)
PHP PHP 5.1 or later
XOOPS XOOPS 2.0.16a-JP

3. OS installation

Install CentOS5 on your PC.

3.1. Obtain CentOS5

Make an install CD or DVD by downloading ISO image files from the official site

The following shows the procedure of making an install DVD.

3.2. Procedure of installation

Insert a DVD into the computer to start installing

When "boot:" appears on the screen below, press Enterto go on to the next.

3.2.1. Media test

Decide whether or not to test the media.

Press Tab key to move to [Skip]. Press [Enter] to go on to the next.

3.2.2. Graphical installation

X Window System comes to run and the keyboard and mouse become active.

Click [Next] when the screen above appears.

3.2.3. Choose a language

Choose a preferred language for instruction:

Choose "English (English)" if you prefer it.

Click on [Next] to go on to the next.

3.2.4. Set up for the keyboard

Choose a type of keyboard:

Select the type of keyboard connected to the computer.

3.2.5. Initialization of the hard disk

An alert message appears to ask whether or not to initialize the hard-disk.

Choose [Yes] to initialize the hard-disk.

3.2.6. Decide a partition

Choose a partition to be installed Linux:

Choose [Remove all partitions on selected drives and create default layout].

Click on the [Next], and a warning message will appear.

Click on [Yes] to delete the partitions.

3.2.7. Set up for the network

If there is DHCP server such as broadband router on the network, click on [Next].

If it is necessary to allocate an unchanging IP address; or there is no DHCP server on the network, click on [Edit].

Be sure to have the checkbox "Enable IPv4 support" checked.

Choose "Manual configuration".

Fill in the "IP address" and "Prefix (Netmask)", respectively.

Untick the checkbox of "Enable IPv6 support".

Click on [OK].

When it returns to the network device screen, input the hostname.

As shown in the dialog box, input [hostname].[domain name]

For example, hostname.domainname.org

Fill in the Gateway IP address at the "Gateway" field.

Fill in the IP address of DNS at the "Primary DNS" field.

Click on [Next].

3.2.8. Set up for time zone

Set up the time zone. Click on a preferred location on the map or pulldown menu.

Untick [System clock uses UTC].

3.2.9. Set up for root password

Set up a root password (six characters or more)

Be sure to remember the password. Make sure to distinguish between capital letters and small letters.

Asked to enter the password twice for confirmation.

Click on [Next].

3.2.10. Choose an install package

Untick all the checkboxes.

Click on [Customize now] on the screen below and then [Next].

3.2.11. Choose an install package 2

Choose "Desktop Environments" and untick the other checkboxes.

Choose "Applications", and untick the other checkboxes.

Choose "Development", and untick the other checkboxes.

Choose "Servers", and untick the other checkboxes.

Choose "Base System", and untick the other checkboxes.

Choose "Virtualization", and untick the other checkboxes.

Choose "Clustering", and untick the other checkboxes.

Choose "Cluster Storage", and untick the other checkboxes.

Choose "Languages", and check a preferred language.

Untick the others

Click on the [Next]

3.2.12. Package Install

Click on [Next] on the following screen, and it will start installation.

The time required for the installation depends on the computer's performance.

3.2.13. Complete Installation

When the screen shows as the following, take out the DVD and click on [Restart]

4. Customize CentOS5

This section shows the setup for installing XooNIps.

4.1. Create an administration account.

Log into the server as root by the following procedure.

xoonips-server login: root ← Enter "root" as a login user.
Password: ← Enter root password(not shown)
[root@xoonips-server ~]# ← (Logged in as root)

Create an administration account by the following commands.

[root@xoonips-server ~]# useradd admin ← Create an admin account.
[root@xoonips-server ~]# passwd admin ← Set an admin password.
Changing password for user admin.
New UNIX password: ← Enter the admin password.
Retype new UNIX password: ← Reenter the admin password.
passwd: all authentication tokens updated successfully.

4.1.1. Setup for authorizing the admin user to execute su.

Under the root authority, which is unrestricted to execute any commands, it may cause critical operation errors such as deleting important files, etc. The following shows how to set it as it takes user admin for usual operations and the root authority by using su command for inevitable cases.

[root@xoonips-server ~]# usermod -G wheel admin ← Add user admin to wheel group
[root@xoonips-server ~]# vi /etc/pam.d/su ← Edit file by vi editor
#auth required pam_whell.so use_uid
auth required pam_whell.so use_uid ← Delete comments

Please refer to web or study guides for the usage of vi editor.

Log out now. Log in as a user admin for the following procedures.

[root@xoonips-server ~]# exit ← Log out

4.2. System Update

Log in as admin by the following commands.

xoonips-server login: admin ← Enter "admin" as a log in user.
Password: ← Enter admin password (not shown)
[admin@xoonips-server ~]$ ← (As admin)

Execute a system update as root user by using the following commands.

[admin@xoonips-server ~]$ su - ← Execute su command to become root.
Password: ← Enter root password.
[root@xoonips-server ~]# ← (As root)

Go on the following procedures under the root authority.

[root@xooinps-server ~]# yum -y update ← Execute a system update command.

The required time depends on the network condition or computer performance.

Now the system has been updated.

4.3. Installing the required packages

XooNIps requires to be installed the following packages.

gcc gcc-c++ glib-devel
glib2-devel libgsf-devel php-mysql
php-gd php-mbstring php-devel
php-xml php-pear php-pecl-Fileinfo
poppler-utils lynx mysql-server
wget    

Execute the following commands to install the packages.

[root@xoonips-server ~]# yum -y install gcc gcc-c++ glib-devel glib2-devel libgsf-devel
[root@xoonips-server ~]# yum -y install php-mysql php-gd php-mbstring php-devel php-xml php-pear
[root@xoonips-server ~]# yum -y install php-pecl-Fileinfo poppler-utils lynx
[root@xoonips-server ~]# yum -y install mysql-server wget make

4.4. Install external programs

Install the external programs required to make XooNIps operable.

Obtain the external support programs.
[root@xoonips-server ~]# wget http://prdownloads.sf.net/chicago/xlhtml-0.5.tgz
[root@xoonips-server ~]# tar -xzvf xlhtml-0.5.tgz ← Expand the obtained files.
[root@xoonips-server ~]# cd xlthml-0.5
[root@xoonips-server ~]# cp /usr/share/automake-1.9/depcomp ./ ← Copy the commands required for installing.
[root@xoonips-server ~]# ./configure ← Execute the configuration.
[root@xoonips-server ~]# make ← Execute the make.
[root@xoonips-server ~]# make install ← Execute the installation.
[root@xoonips-server ~]# cd ← Escape from the expand directory.
Obtain the external support programs.
[root@xoonips-server ~]# wget http://downloads.sourceforge.net/wvware/wv-1.2.4.tar.gz
[root@xoonips-server ~]# tar -xzvf wv-1.2.4.tar.gz ← Expand the obtained files.
[root@xoonips-server ~]# cd wv-1.2.4
[root@xoonips-server ~]# ./configure ← Execute the configuration.
[root@xoonips-server ~]# make ← Execute the make.
[root@xoonips-server ~]# make install ← Perform installation.
[root@xoonips-server ~]# cd ← Escape from the expanded directory.
Create symbolic links to make the external programs operable to XooNIps.
[root@xoonips-server ~]# ln -s /usr/local/bin/xlhtml /usr/bin/xlhtml
[root@xoonips-server ~]# ln -s /usr/local/bin/ppthtml /usr/bin/ppthtml
[root@xoonips-server ~]# ln -s /usr/local/bin/wvText /usr/bin/wvText
Close the installation of the external programs.
[root@xoonips-server ~]# rm -rf xlhtml-0.5
[root@xoonips-server ~]# rm -rf wv-1.2.4
[root@xoonips-server ~]# rm -f xlhtml-0.5.tgz
[root@xoonips-server ~]# rm -f wv-1.2.4.tar.gz

4.5. Set up iptables

Set up for packet filtering.

At the initial condition, the access to the web server is controlled. The following shows how to set up for access permission.

[root@xoonips-server ~]# vi /etc/sysconfig/iptables
Copy the line below.
-A RH-Firewall-l-INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT
↓ Change the "22" in the line to "80".
-A RH-Firewall-l-INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
[root@xoonips-server ~]# /etc/init.d/iptables restart ← Restart the packet filtering software.

4.6. Make SELinux invalid

SELinux has to be invalid to operate XOOPS.

[root@xoonips-server ~]# getenforce ← SElinux status check.
Enforcing ← SELinux is valid.
[root@xoonips-server ~]# setenforce 0 ← SELinux is invalid.
[root@xoonips-server ~]# getenforce ← SELinux status check.
Permissive ← SELinux is invalid.
[root@xoonips-server ~]# vi /etc/sysconfig/selinux ← SELinux config file editing.
SELINUX=enforcing
SELINUX=disabled ← On system startup, make SELinux invalid

4.7. Set up for Apache

Set up for a web server, Apache.

4.7.1. Config file editing.

[root@xoonips-server ~]# vi /etc/httpd/conf/httpd.conf ← Edit config files.
AddDefaultCharset UTF-8
#AddDefaultCharset UTF-8 ← Make it as comment.

4.7.2. Automatic startup for web server

Set up for making the web server automatically started when the computer is restarted.

[root@xoonips-server ~]# /etc/init.d/httpd start ← Startup web server.
[root@xoonips-server ~]# chkconfig httpd on ← Set up for automatic startup for web server.

4.7.3. Check the performance of the web server.

Startup the browser of another computer and enter the address.

For example: http://(The host name decided when having installed the OS.)/

The setup will be successfully completed if the screen appears as follows:

4.8. Setup for MySQL

Set up for a database system to be used on XooNIps:

[root@xoonips-server ~]# vi /etc/my.cnf ← Config file editing.
Add the following two lines in the section of [mysqld].
default-charcter-set=ujis
skip-character-set-client-handshake

4.8.1. MySQL startup and automatic startup.

[root@xoonips-server ~]# /etc/init.d/mysqld start ← MySQL server startup.
[root@xoonips-server ~]# chkconfig mysqld on ← MySQL automatic startup

4.8.2. Set a MySQL password and delete unnecessary data.

[root@xoonips-server ~]# mysql -uroot ← Log into the MySQL server as root user.
Define the password for root user. (Example: mysqlroot@pass)
mysql > set password for root@localhost=password('mysqlroot@pass');
mysql > delete from mysql.user where user=''; ← Delete anonymous users.
mysql > drop database test; ← Delete test database.

4.8.3. Create a database for XooNIps.

Create a database for XooNIps and name it xoonipsdb.
mysql > create database xoonipsdb character set ujis;
Create it with the user name: xoonipsuser, the password: xoonips@pass to access xoonipsdb.
mysql > grant all privileges on xoonipsdb.* to xoonipsuser@localhost identified by'xoonips@pass';
mysql > exit ← Log out of MySQL server.

4.9. Set up for PHP

Modify the PHP config files to set the environment for XooNIps.

[xoonips-server ~]# vi /etc/php.ini ← PHP config file editing.
allow_url_fopen = On
allow_url_fopen = Off ← Change it from "On" to "Off".

The following set values are the required memory sizes for uploading files to a XooNIps server. Adjust them according to the server's structure if necessary.

If it is expected to use files sized 128 MB or bigger on XooNIps, it requires bigger value than the indicated in this manual.

The range of set value have to be memory_limit >= post_max_size >= upload_max_filesize

memory_limit = 16M
memory_limit = 128M ← Set the value bigger.
post_max_size = 8M
post_max_size = 128M ← Set the value bigger.
upload_max_filesize = 2M
upload_max_filesize = 128M ← Set the value bigger.
;session.use_only_cookies = 1
session.use_only_cookies = 1 ← Take out comments.

Set up Multi-byte string functions

;mbstring.internal_encording = EUC-JP
mbstring.interlnal_encording = EUC-JP ← Take out comments.
;mbstring.detect_order = auto
mbstring.detect_order = ASCII,EUC-JP,UTF8 ← Take out comments and add ASCII,EUC-JP,UTF8.

Restart Apache to make the setup valid.

[xoonips-server ~]# /etc/init.d/httpd restart ← Restart the Apache to make the setup valid.

5. Install XOOPS

Install XOOPS, the platform of XooNIps.

Download the most updated version of XOOPS from the official website.(Currently the most updated version is 2.1.6. as of March 2009.)
[root@xoonips-server ~]# wget http://downloads.sourceforge.net/xoopscube/Package_Legacy_2_1_6.zip
[root@xoonips-server ~]# unzip Package_Legacy_2_1_6.zip ← Expand the downloaded files.
Copy the expanded files to the web server document root.
[root@xoonips-server ~]# cp -R Package_Legacy/html/ /var/www/
[root@xoonips-server ~]# rm -rf Package_Legacy ← Delete the expanded directories.
[root@xoonips-server ~]# rm -f Package_Legacy_2_1_6.zip ← Delete the downloaded files.
[root@xoonips-server ~]# chmod 777 /var/www/html/uploads ← Change permissions.
[root@xoonips-server ~]# chmod 777 /var/www/html/cache ← Change permissions.
[root@xoonips-server ~]# chmod 777 /var/www/html/templates_c ← Change permissions.
[root@xoonips-server ~]# chmod 666 /var/www/html/mainfile.php ← Change permissions.

Warning

Find the most updated URL from the official website.

Download page (Legacy2.1.6)

5.1. Set up for XOOPS

Access to http://server name/

Choose a preferred language and click on [Next].

Click on [Next].

Click on [Next].

Enter the database user name, database password and database name which decided on MySQL setup.

Fill in the blanks with the following information and click on [Next].

Database Username xoonipsuser
Database Password xoonips@pass
Database Name xoonipsdb

Click on [Next].

Click on [Next].

Click on [Next].

Click on [Next].

Click on [Next].

Click on [Next].

Enter the following information and click on [Next].

Note that this is for the administrator of XOOPS.

It is different from the users of CentOS and MySQL.

Admin Name XOOPS site administrator's user name (Example: Administrator)
Admin Email XOOPS site administrator's mail address (Example: admin@xoonips.jp)
Admin Password Password
Confirm Password Password

Click on [Next]

Click on [Next].

Enter the XOOPS admin name and click on [User Login].

Click on the "Install" button.

The installation has completed.

Close the web browser now.

5.2. Close the XOOPS installation.

[root@xoonips-server ~]# rm -rf /var/www/html/install/ ← Delete install directories.
[root@xoonips-server ~]# chmod 644 /var/www/html/mainfile.php ← Change permissions.

6. Install XooNIps

Download the most updated XooNIps.

Download the most updated XooNIps.
[root@xoonips-server ~]# wget http://osdn.dl.sourceforge.jp/xoonips/30526/xoonips-3.4.tar.gz
Expand the downloaded files.
[root@xoonips-server ~]# tar -xzvf xoonips-3.4.tar.gz
Copy the XooNIps modules to the module directories.
[root@xoonips-server ~]# cp -R xoonips-3.4/xoonips/ /var/www/html/modules/

Warning

The download URL is subject to be changed due to its mirror site.

Download page

6.1. Set up for XooNIps

Access to http://server name/.

Enter the following information and click on the [Login] button.

Username Administrator's user name (Example: Administrator)
Password Administrator's password

Click on [Administration Menu].

Click on [Module Installation].

Click on the install icon at "Control".

Click on the "Install" button.

Click on [Module Management].

If the XooNIps is successfully installed, the screen shows as above.

6.2. Initial setting and confirmation on XooNIps

How to set up XooNIps.

Click on [XooNIps] on the Administration menu.

Click on [System Configuration].

6.2.1. Change the file upload directory.

Assign a directory where the web server is authorized to write.

[root@xoonips-server ~]# mkdir /var/www/xoonipsupload ← Create a directory.
[root@xoonips-server ~]# chmod a+w /var/www/xoonipsupload ← Change permissions.

Click on [Basic Configuration].

Enter /var/www/xoonipsupload at [File Upload Directory]

Click on [UPDATE].

6.2.2. Setup inline frame

How to change the display area of an index tree:

Click on [Inline Frame]

Enter the desired value of width and height of the index tree and click on the [UPDATE] button.

The size of display area within the block can be changed by indicating the width of the index tree in percentage (%).

Width indicated in 100%. Width indicated in 50%.

The range of display area can be changed by indicating the height of the index tree in pixels.

Height indicated in 400 pixels. Height indicated in 200 pixels.

6.2.3. Setup print formats

How to set the information to be shown as headers on printing:

Click on [Printer Friendly].

The entered information will be printed as a header.

6.2.4. Set up for RSS distribution

XooNIps supports three types of feed formats: RSS1.0(RDF), RSS2.0, Atom1.0

Announcements about newly registered items and the current status within a group can be made by publishing the URL indicated on the "RSS Feeds".

Click on [RSS Feeds]

Choose a feed format and copy it to use for publication.

6.2.5. Set up OAI-PMH

XooNIps adopts OAI-PMH as a structure to automatically collect metadata.

There are two ways: 1. setup for providing metadata to another server applicable to OAI-PMH. (Repository setup), 2. setup for harvesting metadata from another server applicable to OAI-PMH (Harvester setup).

Click on [OAI-PMH].

  • "Repository Configurations" is for providing metadata to another server.

  • Repository Name

    Example:INCF Japan Node XooNIps site

    Database ID

    Set identification data by using site name, etc. to distinguish sites. Example: www.neuroinf.jp

    Number of days for tracking item deletion

    Indicate the days for tracking the item deletion.

    (institution) variable

    Set the variable of institution for reply.

    (publisher) variable

    Set the variable of publisher for reply.

  • The harvester setup is for collecting metadata from another server.

Enter the URLs of the servers for harvesting metadata one by one (press the enter key before entering another URL).

If the line begins with semicolon(;), it is identified as a comment.

6.2.6. Proxy Configuration

This section explains proxy configurations, which are required in the case of using proxy when accessing from XooNIps to another server.

Click on [Proxy].

Host

Enter a host name or IP address of the proxy server.

Port

Enter the port number of the proxy server.

User Name

Enter the user name if required to authenticate the proxy server.

Password

Enter the password for authentication.

6.2.7. Setup for event notification

Decide the kinds of event to be notified to the XooNIps users by using a XOOPS function.

Click on [Notifications].

Choose one from the following.

  • Disable Notification (both styles)

  • Enable only Block-style

  • Enable only Inline-style

  • Enable Notification (both styles)

"Enable Specific Events" accepts multiple choices.

To whom

Indications at the pulldown menu

Purposes

Administrator

Administrator: Item transferred

Notify when an item has been transferred.

Administrator: Account certified

Notify when an account has been certified.

Administrator: Item certified

Notify when a publishing item has been certified.

Administrator: Request for group item certification

Notify when there is a request for approval of transferring an item to a group area.

User

XooNIps User: Item transferred

Notify when an item has been transferred.

XooNIps User: Item updated

Notify when an item has been updated.

XooNIps User: Item certified

Notify when a publishing item has been certified.

XooNIps User: Item rejected

Notify when a publishing item has been rejected.

XooNIps User: File downloaded

Notify when a file has been downloaded.

XooNIps User: Group item certified

Notify when an item has been approved of being registered in a group area.

XooNIps User: Group item rejected

Notify when an item has been rejected to be registered in a group area.

6.2.8. XOOPS Extension

Entitle a user to be able to use XooNIps functions if he/she has been registered through the XOOPS user module.

Delete the user information remained on XooNIps if the user was deleted by the XOOPS user module.

Click on [XOOPS Extension].

Delete or add users by clicking on the icon appeared at "Action".

6.2.9. Configuration Test

How to check the configurations of XooNIps:

Click on [Configuration Test].

Click on [Test].

The results of XooNIps system configuration test will be displayed.

If the "Total Result" indicates "OK", the XooNIps system preparation is successfully completed.

If there are any items indicated in red, it has to be modified as the comment directs.

6.3. How to install item type modules:

Install item type modules.

Copy the item type module to the module directory.
[root@xoonips-server ~]# cp -R xoonips-3.4/itemtypes/* /var/www/html/modules/

6.3.1. Setup for item type modules

The procedure is the same as XooNIps module.

The types of item type module vary with the structure of the website.

Click on [Module Installation]

Click on the install icon at "Control". (same as XooNIps installation)

6.3.2. Close the XooNIps installation

[root@xoonips-server ~]# rm -f xoonips-3.4.tar.gz ← Delete downloaded files.
[root@xoonips-server ~]# rm -rf xoonips-3.4 ← Delete expanded directories.

6.4. Precautions on updating XooNIps

Make sure to overwrite the directories before updating XooNIps modules and item type modules.

Updating to the version XooNIps 3.30 or later is supported only if the original version is XooNIps 3.24 or later.

For updating the version from XooNIps 3.2x to XooNIps 3.4, make sure to install the Binder item type modules.

6.5. Support modules

Supporting modules are, for example, alternative modules for the system modules whose standard status can not satisfy by itself, and protector modules against malicious attacks.

For using the function to comment to the new functions on XooNIps 3.4, install an altsys module and a D3forum module.

The following briefly shows how to install an altsys module and a D3forum module, which are required for utilizing the comment functions on XooNIps.

For detailed information, check the website http://xoops.peak.ne.jp/

6.5.1. Install an altsys module

How to install an altsys module, an alternative module for standard system modules:

Modify mainfile.php

[xoonips-server ~]# vi /var/www/html/mainfile.php ← mainfile.php file edition.
define('XOOPS_TRUST_PATH','');
define('XOOPS_TRUST_PATH','/var/www/xoops_trust_path'); ← Set up for XOOPS_TRUST_PATH

Download the most updated module from the website.

[root@xoonips-server ~]# tar -xzvf altsys-0.6.tar.gz ← Expand the obtained files.
[root@xoonips-server ~]# cp -R xoops_trust_path /var/www/ ← Copy the expanded files.
[root@xoonips-server ~]# cp -R html/modules/altsys /vaw/www/modules ← Copy the expanded files.
[root@xoonips-server ~]# cp html/preload /* vaw/www/html/preload/ ← Copy the expanded files.

Perform installation from the "Module Installation" at "Legacy System" on the Administration menu (same as XooNIps and item type module).

6.5.2. Install D3forum

How to install d3 modules, which is required for using comment functions to the new function items on XooNIps 3.4.:

It is necessary to have completed installing an altsys module in advance.

Download the most updated module from the website.

[root@xoonips-server ~]# tar -xzvf d3forum-0.8.tar.gz ← Expand the obtained files.
[root@xoonips-server ~]# cp -R xoops_trust_path/modules /var/www/xoops_trust_path ← Copy the expanded files.
[root@xoonips-server ~]# cp -R html/modules/d3forum /var/www/modules ← Copy the expanded files.
[root@xoonips-server ~]# cp html/class/smarty/plugins/* var/www/html/class/smarty/plugins/ ← Copy the expanded files.

Perform installation from "Module Installation" at "Legacy System" on the Administration menu (same as XooNIps and item type module).

Last updated: 2009/06/11