MoodleDocs - User contributions [en]

Installation on Solaris 10 with Oracle 10

2008-08-01T14:40:29Z

Vdabgg:

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add template Purpose of this document
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:Image006.jpg]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image007.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image008.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image009.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image010.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image011.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image012.jpg]]This is the final step in the database set-up sequence.

[[Image:Image013.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image014.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image015.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image016.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image017.jpg]]

== Add template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:39:06Z

Vdabgg:

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:Image006.jpg]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image007.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image008.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image009.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image010.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image011.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image012.jpg]]This is the final step in the database set-up sequence.

[[Image:Image013.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image014.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image015.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image016.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image017.jpg]]

== Add template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:38:00Z

Vdabgg: /* Add VDAB template */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:Image006.jpg]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image007.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image008.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image009.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image010.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image011.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image012.jpg]]This is the final step in the database set-up sequence.

[[Image:Image013.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image014.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image015.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image016.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image017.jpg]]

== Add template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:35:04Z

Vdabgg:

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:Image006.jpg]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image007.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image008.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image009.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image010.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image011.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image012.jpg]]This is the final step in the database set-up sequence.

[[Image:Image013.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image014.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image015.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image016.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image017.jpg]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:33:47Z

Vdabgg: /* Install language packs */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:Image006.jpg]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image007.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image010.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image011.jpg]]This is the final step in the database set-up sequence.

[[Image:Image012.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image013.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image014.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image015.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image016.jpg]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:32:55Z

Vdabgg: /* Start with empty Moodle */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image010.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image011.jpg]]This is the final step in the database set-up sequence.

[[Image:Image012.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image013.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image014.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:Image015.jpg]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:Image016.jpg]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:32:30Z

Vdabgg: /* Set up Frontpage */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image010.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image011.jpg]]This is the final step in the database set-up sequence.

[[Image:Image012.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image013.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:Image014.jpg]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:32:17Z

Vdabgg: /* Setting up the administrator account */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image010.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image011.jpg]]This is the final step in the database set-up sequence.

[[Image:Image012.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:Image013.jpg]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:31:57Z

Vdabgg: /* Automatic database setup */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:Image010.jpg]]After each sequence a '''confirmation of success '''appears.

[[Image:Image011.jpg]]This is the final step in the database set-up sequence.

[[Image:Image012.jpg]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:31:20Z

Vdabgg: /* Release information */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:Image009.jpg]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:31:05Z

Vdabgg: /* Licence agreement */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:Image008.jpg]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:30:51Z

Vdabgg: /* Confirmation for written configuration file. */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:Image007.jpg]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:30:33Z

Vdabgg: /* Install language packs */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:Image006.jpg]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:30:18Z

Vdabgg: /* Server checks for installed components */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:Image005.jpg]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:30:03Z

Vdabgg: /* Set Database connection */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:Image004.jpg]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:29:47Z

Vdabgg: /* Set installation and data directories */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:Image003.jpg]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-08-01T14:29:31Z

Vdabgg: /* Check PHP settings */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:Image002.jpg]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

File:Image017.jpg

2008-08-01T14:28:19Z

Vdabgg:

File:Image016.jpg

2008-08-01T14:28:09Z

Vdabgg:

File:Image015.jpg

2008-08-01T14:27:58Z

Vdabgg:

File:Image014.jpg

2008-08-01T14:27:48Z

Vdabgg:

File:Image013.jpg

2008-08-01T14:27:37Z

Vdabgg:

File:Image012.jpg

2008-08-01T14:27:27Z

Vdabgg:

File:Image011.jpg

2008-08-01T14:27:13Z

Vdabgg:

File:Image010.jpg

2008-08-01T14:26:59Z

Vdabgg:

File:Image009.jpg

2008-08-01T14:26:41Z

Vdabgg:

File:Image008.jpg

2008-08-01T14:26:30Z

Vdabgg:

File:Image007.jpg

2008-08-01T14:26:21Z

Vdabgg:

File:Image005.jpg

2008-08-01T14:25:56Z

Vdabgg:

File:Image004.jpg

2008-08-01T14:25:44Z

Vdabgg:

File:Image003.jpg

2008-08-01T14:25:34Z

Vdabgg:

File:Image002.jpg

2008-08-01T14:25:23Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-08-01T14:24:54Z

Vdabgg: /* Choose installation language */

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:Image001.jpg]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

File:Image001.jpg

2008-08-01T14:23:04Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-08-01T14:19:59Z

Vdabgg: This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

<center>'''Installation Documentation'''</center>

<center>''for''</center>

<center>''Moodle at VDAB''</center>

'''Table of Contents'''1 Purpose of this document1

2 Setting up the Oracle Database2

3 Configuring Apache2

3.1 Install Apache2

3.2 Install OCI 8 and Oracle Instant Client3

3.3 Install PHP4

3.4 Change PHP settings6

3.5 Add GNU Coreutils7

4 Install Moodle7

4.1 Prepare the Moodle installation files7

4.2 Choose installation language8

4.3 Check PHP settings8

4.4 Set installation and data directories10

4.5 Set Database connection11

4.6 Server checks for installed components12

4.7 Install language packs19

4.8 Confirmation for written configuration file.21

4.9 Licence agreement21

4.10 Release information21

4.11 Automatic database setup22

4.12 Setting up the administrator account23

4.13 Set up Frontpage24

4.14 Start with empty Moodle25

4.15 Add VDAB template26= Purpose of this document =
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation
* Configuring Apache 2.2 for a secure and high-performance webserver
* Preparing all necessary PHP packages for Apache and Oracle
* Preparing PHP settings for Moodle
* An overview of the steps in the Moodle installation wizard.

= Setting up the Oracle Database =
We set up '''2 parallel Moodle installations '''on one and a '''database on a separate server'''. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's '''DBCA '''tool.

* This is testzone1 on the test server testitis00
* Database name = testitis02.vdab.be
* We used the ''General purpose'' template for the database set-up;
* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a '''separate Tablespace''':

* First Moodle installation on testzone2:
** MOODLE_DATA with initial size of 300MB
** User: MOODLEUSER, password: moodle
** The user only has rights within the specified tablespace
* Second Moodle installation on testzone3:
** MOODLE_DATA2 with initial size of 300MB
** User: MOODLEUSER2, password: moodle
** The user only has rights within the specified tablespace

= Configuring Apache =
== Install Apache ==
First '''download the latest Apache '''e.g. httpd-2.2.8.tar.gz from [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi] to the folder /usr/local/apache2

Log in as root, '''uncompress the Apache files '''and go to the installation folder.

<nowiki># gzip -d httpd-2.2.8.tar.gz</nowiki>

<nowiki># tar -xvf httpd-2.2.8.tar</nowiki>

<nowiki># cd httpd-2.2.8</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.</nowiki>

'''Configure and make Apache''':

<nowiki># make clean --> only if necessary</nowiki>

<nowiki># ./configure \</nowiki>

--prefix=/usr/local/apache2 \

--with-included-apr

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to increase performance '''edit''' the following in the httpd.conf file:

<nowiki># vi /usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor</nowiki>

'''DirectoryIndex '''index.php

'''Listen''' 8002 -- > for VDAB

'''DocumentRoot''' “/usr/local/moodle_1.9+/moodle”

'''AcceptPathInfo '''on

== Install OCI 8 and Oracle Instant Client ==
'''Download the 32bit Solaris Basic en SDK''': instantclient-basic-solaris6432-10.2.0.3-20070101.zip and

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from

[http://www.oracle.com/technology/tech/oci/instantclient/index.html http://www.oracle.com/technology/tech/oci/instantclient/index.html] to a folder e.g. /oracle/product.

Log in as the user oracle and '''uncompress the installation files''':

$ cd /oracle/product

$ unzip instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the directory instantclient_10_2

$ unzip instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the directory instantclient_10_2

'''Adapt the tnsnames '''to set an alias or Oracle net service name. Each net service name entry contains connect descriptors that define listener and service information.

$ cd $TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi tns_admin _--> Below an example adaptation:_

moodle =

(DESCRIPTION =

(ADDRESS =

(COMMUNITY = TCPDEV.world)

(PROTOCOL = TCP)

(HOST = testzone1)

(PORT = 1521)

)

(CONNECT_DATA =

(SID = testitis02)

)

)

If necessary, create and adapt a sqlnet.ora file. For VDAB this was not necessary.

Create two '''Symbolic Links'''.

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s /oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

== Install PHP ==
To '''install PHP '''on the Apache server, download php-5.2.5.tar.gz from [http://www.php.net/downloads http://www.php.net/downloads] to the folder /usr/local/apache2

Log in as root, '''uncompress the PHP files '''and go to the installation folder.

<nowiki># gzip -d php-5.2.5.tar.gz</nowiki>

<nowiki># tar -xvf php-5.2.5.tar</nowiki>

<nowiki># cd php-5.2.5</nowiki>

Adapt the '''Environment Variables '''to make sure the correct gcc and make are used.

<nowiki># export PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin</nowiki>

<nowiki># export LD_LIBRARY_PATH=/oracle/product/instantclient_10_2</nowiki>

The following table provides a brief overview of the PHP extensions and what they are used for. All of these are required to do a fully functional Moodle installation.

{| class="prettytable"
! <center>PHP Extensions</center>
! <center>Description</center>

|-
| GD

Freetype 2
| GD is commonly used to generate charts, graphics, thumbnails, etc. on the fly.

Freetype provides an API to manipulate fonts.

Moodle uses these modules to generate dynamic graphs from the logs.

|-
| OCI8
| Required connector for Oracle

|-
| zlib (alternatively use zip or unzip)
| Zlib is required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this functionality, but this impacts the use of server resources.

|-
| curl
| curl is a client to get files from servers. It is used for handling files using a wide variety of protocols.

This is a requirement for Moodle 1.8 and later

|-
| openssl
| Library to enable secured connections to a server. This is mainly used for connections between Moodle installations e.g. to share courses.

|-
| php5-LDAP
| Enables the use of LDAP functions in PHP

|-
| aspell-xx
| The optional aspell modules provide a free spelling checker functionality embedded in Moodle. This module support a very large number of languages. XX represents the 2-letter code for the language.

|}
For a default Solaris most of these modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from [http://curl.haxx.se/ http://curl.haxx.se] to /usr/local/apache2.

Log in as root, '''uncompress the curl files '''and go to the installation folder to '''make''' and '''install'''.

<nowiki># gunzip curl-7.18.1.tar.gz</nowiki>

<nowiki># tar -xvf curl-7.18.1.tar</nowiki>

<nowiki># cd curl-7.18.1</nowiki>

<nowiki># ./configure</nowiki>

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

In order to '''test''' the curl installation do

/usr/local/bin/curl -V

If necessary, extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and '''install the PHP for Apache make links to the PHP extensions'''.

<nowiki># cd /usr/local/apache2/php-5.2.5</nowiki>

<nowiki># ./configure \</nowiki>

--with-apxs2=/usr/local/apache2/bin/apxs \

--with-config-file-path=/usr/local/apache2/conf \

--with-oci8=instantclient,/oracle/product/instantclient_10_2 \

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

--with-ldap=/usr/local

<nowiki># make</nowiki>

<nowiki># make install</nowiki>

== Change PHP settings ==
By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table below. Afterwards we will make a copy of this file and make it the active Php configuration file.

<nowiki># vi /usr/local/apache2/conf/php.ini-recommended --> Open text editor and make adaptations</nowiki>

<nowiki># cp /usr/local/apache2/php-5.2.5/php.ini-recommended /usr/local/apache2/conf/php.ini</nowiki>

'''In the file edit the following settings:'''

{| class="prettytable"
! <center>Setting</center>
! <center>Value we used in php.ini</center>

|-
| Safe mode must be off
| <nowiki>; Safe mode</nowiki>

safe_mode = Off

|-
| memory_limit is at least 128MB
| <nowiki>; Resource Limits</nowiki>

memory_limit = 128M <nowiki>; Maximum amount of memory a script may consume</nowiki>

|-
| session.save_handler needs to be set to FILES.
| <nowiki>[Session]</nowiki>

<nowiki>; Handler used to store/retrieve data.</nowiki>

session.save_handler = files

|-
| magic_quotes_gpc needs to be ON

magic_quotes_runtime needs to be OFF
| <nowiki>; Magic quotes for incoming GET/POST/Cookie data.</nowiki>

magic_quotes_gpc = On

<nowiki>; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.</nowiki>

magic_quotes_runtime = Off

|-
| file_uploads needs to be ON
| <nowiki>; Whether to allow HTTP file uploads.</nowiki>

file_uploads = On

|-
| session.auto_start needs to be OFF
| <nowiki>; Initialize session on request startup.</nowiki>

session.auto_start = 0

|-
| session.bug_compat_warn needs to be OFF
| session.bug_compat_warn = 0

|-
| post_max_size is too small by default and needs to be increased e.g. when you run into problems while creating online content
| <nowiki>; Maximum size of POST data that PHP will accept.</nowiki>

post_max_size = 300M

|-
| upload_max_filesize needs to be increased e.g. to allow uploading larger course packages
| <nowiki>; Maximum allowed size for uploaded files.</nowiki>

upload_max_filesize = 300M

|-
| magic_quotes_sybase should be on for Oracle installations.
| magic_quotes_sybase = On

|}
== Add GNU Coreutils ==
Also install the GNU Coreutils for Solaris in order to avoid Apache error described in case MDL-6850 . The Coreutils will include the du command which is required by Moodle to collect and calculate data on file sizes.

'''Download '''coreutils-6.4-sol10-sparc-local.gz from [http://www.sunfreeware.com/solaris_2.5_list.html#coreutils http://www.sunfreeware.com/solaris_2.5_list.html#coreutils] to your global zone as root .

gunzip coreutils-6.4-sol10-sparc-local.gz

pkgadd -d coreutils-6.4-sol10-sparc-local.gz

Go to Administration > Configuration > Variables > Operating System and enter the path to entry pathtodu to the GNU du in /usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du entry.

= Install Moodle =
== Prepare the Moodle installation files ==
Now that we have completed the set-up for Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for the Moodle installation.

Log in as root and '''create a moodle user''' assigned to a group and set a password.

<nowiki># mkdir /export/home/moodle</nowiki>

<nowiki># useradd -u 1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle</nowiki>

<nowiki># chown moodle:users /export/home/moodle</nowiki>

<nowiki># passwd moodle</nowiki>

Log in as root to '''create a directory for the Moodle installation''':

<nowiki># mkdir /usr/local/moodle_1.9+</nowiki>

<nowiki># chown moodle:users /usr/local/moodle_1.9+</nowiki>

'''Download '''moodle-weekly-19.tgz from [http://download.moodle.org/ http://download.moodle.org/]. Log in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

$ gunzip moodle-weekly-19.tgz

$ tar -vxf moodle-weekly-19.tar --> creates subdirectory 'moodle'

Now log onto the system where you will install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the '''environment variables''', preferable in the .profile of the de user moodle:

$ export ORACLE_HOME=/oracle/product/instantclient_10_2

$ export LD_LIBRARY_PATH=$ORACLE_HOME

$ export TNS_ADMIN=/var/opt/oracle

$ export PATH=$PATH:/usr/local/bin:/local/bin:.

'''Start Apache '''with the configuration file adapted to moodle:

$ /usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf

If desired you can install other languages during the installation wizard by downloading the appropriate language files e.g. Dutch ([http://download.moodle.org/lang16/nl_utf8.zip http://download.moodle.org/lang16/nl_utf8.zip]) to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.

<nowiki># unzip nl_utf8.zip </nowiki>

A list of additional languages is available from the administration interface. Moodle then automatically downloads and installs the selected languages.

== Choose installation language ==
Choose the installation language from the drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

[[Image:]]

== Check PHP settings ==
If you followed the above mentioned instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP settings in php.ini.

[[Image:]]

== Set installation and data directories ==
In this step you define the basic locations of all Moodle-related files. Unless you chose a different location for the moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

[[Image:]]

== Set Database connection ==
In this step we will set up the connection to the database:

* Select Oracle from the drop-down list
* For an Oracle installation, leave the Host entry empty
* Provide the name of the Oracle database you created e.g. moodle
* The database admin username and password
* Add a table prefix e.g. m_

[[Image:]]

== Server checks for installed components ==
The installation wizard will now perform an '''availability check '''on the required System Components.

If you checked all the required PHP settings and modules during the pre-installation phase, you should get the following screen.

[[Image:]]

== Install language packs ==
Since we chose a '''Dutch installation''', we now get an option to download the '''Dutch language files '''for the user interface. Provided you have direct write access to the Moodle server, the set-up of the language pack is '''automatic'''.

[[Image:]]If the '''download is unsuccessful''', you will get the error message below. To resolve this problem, you can either:

* Select other languages by using the ''Administrator interface ''when the installation is complete (Administration > Language > Language packs).
* ''Unzip the language file on the server ''in the lang files directory e.g. <nowiki><path to Moodle directory>/moodledata/lang</nowiki>

[[Image:]]

== Confirmation for written configuration file. ==
All the settings we made in prior steps are now collected and written to the '''Moodle configuration file '''(config.php).

[[Image:]]In this step, the basic Moodle configuration is complete. In the next steps, the setup will add the database tables and prepare Moodle for use.

== Licence agreement ==
Carefully read and '''accept the licence agreement '''before proceeding to the final installation steps.

[[Image:]]

== Release information ==
This page provides the release information and the possibility to perform the following steps automatically (unattended). We will simply click next in order to capture potential setup errors.

[[Image:]]

Following steps can be performed automatically (unattended) or with manual confirmation.

== Automatic database setup ==
What follows is a series of screens for the '''setup of the database tables for all of the standard Moodle components'''. Apart from clicking next, no user interaction is required.

[[Image:]]After each sequence a '''confirmation of success '''appears.

[[Image:]]This is the final step in the database set-up sequence.

[[Image:]]

== Setting up the administrator account ==
Now that the system is ready, we only need to provide details for an initial administrator account.

These data can be changed and/or complemented later. This is the account that will initially be used after installation to allow further configuration of the system.

[[Image:]]

== Set up Frontpage ==
During this final step of the installation wizard, we will put:

* The '''Full site name '''e.g. the name of the institution. This will be visible in the title bar in all of the standard templates.
* As '''Short name for the site'''.
* A '''Front page description''' of the site. This will be displayed as a welcome message on the start page.

[[Image:]]

== Start with empty Moodle ==
We are then automatically redirected to the '''Moodle start page'''. Our Moodle is up and running and we can now continue with the configuration of the system.

[[Image:]]

When we click '''Turn editing on''' we can start the configuration. We will need to verify the system location of some additional components. The installation procedure does not check for the availability of a zip program. Moodle especially needs zip and unzip when handling SCORM packages. Using the built-in unzip feature may impact server performance.

[[Image:]]

== Add VDAB template ==
To add a theme to a Moodle installation:

* Extract a theme to /usr/local/moodle_1.9+/moodledata/theme
* Log into Moodle as admin, go to Site Administration >Appearance >Themes > Theme Selector
* Select the VDAB theme from the list.

Installation on Solaris 10 with Oracle 10

2008-07-25T12:36:03Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:35:00Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:33:01Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:29:54Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:29:14Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:25:15Z

Vdabgg:

The '''VDAB''' (Public employment and vocational training service of the Dutch-speaking part of Belgium) is currently preparing an implementation of Moodle 1.9 on a large scale for its clients.

As a first step we have installed Moodle on a standard environment for VDAB being a '''Solaris 10''' with '''Oracle 10g'''. Since this operation went succefully, problems encountered were solved, the VDAB offers the installation documentation to the Moodle community.

'''Contact person:''' [mailto:gerd.goetschalckx@vdab.be Gerd Goetschalckx]

<div class=Section1>

Installation Documentation

for

Moodle at VDAB

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>1               
Document information</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='border-collapse:collapse'>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Document
status:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Final
2008/07/23
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Owning
process:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
VDAB
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Created
by:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Toby De
Loght
</td>
</tr>
</table>

</div>

 


<div class=Section2>

Table of Contents

</div>

 


<div class=Section3>

1 Document information____________________________________________________________ 1

2 Purpose
of this document__________________________________________________________ 2

3 Setting
up the Oracle Database_____________________________________________________ 2

4 Configuring
Apache_______________________________________________________________ 2

4.1 Install Apache................................................................................................................... 2

4.2 Install OCI 8 and Oracle Instant Client.............................................................................. 3

4.3 Install PHP....................................................................................................................... 4

4.4 Change PHP settings......................................................................................................... 6

4.5 Add GNU Coreutils........................................................................................................... 7

5 Install
Moodle___________________________________________________________________ 7

5.1 Prepare the Moodle installation files.................................................................................. 7

5.2 Choose installation language............................................................................................. 8

5.3 Check PHP settings........................................................................................................... 8

5.4 Set installation and data directories.................................................................................... 9

5.5 Set Database connection.................................................................................................. 10

5.6 Server checks for installed components............................................................................ 11

5.7 Install language packs..................................................................................................... 12

5.8 Confirmation for written configuration
file...................................................................... 14

5.9 Licence agreement.......................................................................................................... 14

5.10 Release information....................................................................................................... 14

5.11 Automatic database setup.............................................................................................. 15

5.12 Setting up the administrator account............................................................................. 16

5.13 Set up Frontpage........................................................................................................... 17

5.14 Start with empty Moodle............................................................................................... 18

6 Document
control_______________________________________________________________ 19

</div>

 


<div class=Section4>

 

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>2               
Purpose of this document</h1>

</div>

This document provides an in-depth
installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different
steps involved:

l  Preparing
Oracle 10g for a large Moodle installation

l  Configuring
Apache 2.2 for a secure and high-performance webserver

l  Preparing
all necessary PHP packages for Apache and Oracle

l  Preparing
PHP settings for Moodle

l  An
overview of the steps in the Moodle installation wizard.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>3               
Setting up the Oracle Database</h1>

</div>

We set up 2 parallel Moodle
installations on one and a database on a separate server. Both
installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a
Solaris 10 and is set up using Oracle's DBCA tool. 

l  This is testzone1 on the test
server testitis00

l  Database name = testitis02.vdab.be

l  We
used the General purpose template for the database set-up;

l  And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a separate
Tablespace:

l  First
Moodle installation on testzone2:

  MOODLE_DATA with initial size of 300MB

  User: MOODLEUSER, password: moodle

  The
user only has rights within the specified tablespace

l  Second
Moodle installation on testzone3:

  MOODLE_DATA2 with initial size of 300MB

  User: MOODLEUSER2, password: moodle

  The
user only has rights within the specified tablespace

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>4               
Configuring Apache</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.1         
Install Apache</h2>

First download the latest Apache e.g. httpd-2.2.8.tar.gz from <a href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>
to the folder /usr/local/apache2

Log in as root, uncompress
the Apache files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d
httpd-2.2.8.tar.gz

# tar -xvf httpd-2.2.8.tar

# cd httpd-2.2.8

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.

</div>

Configure and make Apache:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# make clean --> only
if necessary

# ./configure \

--prefix=/usr/local/apache2
\

--with-included-apr

# make

# make install

</div>

In order to increase performance edit
the following in the httpd.conf file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor

DirectoryIndex index.php

Listen 8002 -- > for VDAB

DocumentRoot “/usr/local/moodle_1.9+/moodle”

AcceptPathInfo on

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.2         
Install OCI 8 and Oracle Instant Client</h2>

Download the 32bit Solaris Basic en SDK: instantclient-basic-solaris6432-10.2.0.3-20070101.zip and 

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from 

<a
href="http://www.oracle.com/technology/tech/oci/instantclient/index.html">http://www.oracle.com/technology/tech/oci/instantclient/index.html</a>
to a folder e.g. /oracle/product.

 

Log in as the user oracle and uncompress the installation files:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd /oracle/product

$ unzip
instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the
directory instantclient_10_2

$ unzip
instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the
directory instantclient_10_2

</div>

 

Adapt the tnsnames to set an alias or Oracle net service
name. Each net service name entry contains connect descriptors that define
listener and service information.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd $TNS_ADMIN --> for
VDAB this is /var/opt/oracle)

$ vi tns_admin _-->
Below an example adaptation:_

 moodle =

 (DESCRIPTION =

 (ADDRESS =

 (COMMUNITY
= TCPDEV.world)

 (PROTOCOL
= TCP)

 (HOST =
testzone1)

 (PORT =
1521)

 )

 (CONNECT_DATA
= 

 (SID =
testitis02)

 )

 )

</div>

 

If necessary,
create and adapt a sqlnet.ora file. For VDAB this was not necessary.

 

Create two Symbolic Links.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ ln -s
/oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s
/oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.3         
Install PHP</h2>

To install PHP on the Apache
server, download php-5.2.5.tar.gz from <a
href="http://www.php.net/downloads">http://www.php.net/downloads</a> to the
folder /usr/local/apache2

Log in as root, uncompress
the PHP files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d php-5.2.5.tar.gz

# tar -xvf php-5.2.5.tar

# cd php-5.2.5

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin

# export
LD_LIBRARY_PATH=/oracle/product/instantclient_10_2

</div>

The following table provides a brief
overview of the PHP extensions and what they are used for. All of these are
required to do a fully functional Moodle installation.

 

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
PHP Extensions
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Description
</td>
</tr>
</thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD
Freetype 2
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD is
commonly used to generate charts, graphics, thumbnails, etc. on the fly. 
Freetype provides an API to
manipulate fonts. 
Moodle uses these modules to generate
dynamic graphs from the logs.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
OCI8
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Required
connector for Oracle
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
zlib
(alternatively use zip or unzip)
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Zlib is
required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this
functionality, but this impacts the use of server resources.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl is
a client to get files from servers. It is used for handling files using a
wide variety of protocols.
This is a requirement for Moodle 1.8
and later
 
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
openssl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Library
to enable secured connections to a server. This is mainly used for
connections between Moodle installations e.g. to share courses.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
php5-LDAP
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Enables
the use of LDAP functions in PHP
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
aspell-xx
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
The
optional aspell modules provide a free spelling checker functionality
embedded in Moodle. This module support a very large number of languages. XX
represents the 2-letter code for the language.
</td>
</tr>
</table>

 

For a default Solaris most of these
modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from <a href="http://curl.haxx.se/">http://curl.haxx.se</a> to /usr/local/apache2.

Log in as root, uncompress
the curl files and go to the installation folder to make and
install.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gunzip
curl-7.18.1.tar.gz

# tar -xvf curl-7.18.1.tar

# cd curl-7.18.1

# ./configure

# make

# make install

</div>

In order to test the curl installation do

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

/usr/local/bin/curl -V

</div>

If necessary,
extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and install the PHP
for Apache make links to the PHP extensions.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# cd
/usr/local/apache2/php-5.2.5

# ./configure \

--with-apxs2=/usr/local/apache2/bin/apxs
\

--with-config-file-path=/usr/local/apache2/conf
\

--with-oci8=instantclient,/oracle/product/instantclient_10_2
\

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

# make

# make install

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.4         
Change PHP settings</h2>

By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the
table below. Afterwards we will make a copy of this file and make it the active
Php configuration file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/apache2/conf/php.ini-recommended --> Open text editor and make
adaptations

# cp
/usr/local/apache2/php-5.2.5/php.ini-recommended
/usr/local/apache2/conf/php.ini

</div>

In the file edit the following
settings:

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Setting
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Value we used in php.ini
</td>
</tr>
</thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Safe
mode must be off
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Safe
mode
safe_mode
= Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
memory_limit
is at least 128MB
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Resource Limits
memory_limit
= 128M ; Maximum amount of memory a script may consume
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.save_handler
needs to be set to FILES.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
[Session]
; Handler used to store/retrieve
data.
session.save_handler = files
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_gpc
needs to be ON
magic_quotes_runtime needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Magic
quotes for incoming GET/POST/Cookie data.
magic_quotes_gpc = On
; Magic quotes for runtime-generated
data, e.g. data from SQL, from exec(), etc.
magic_quotes_runtime = Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
file_uploads
needs to be ON
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Whether to allow HTTP file uploads.
file_uploads = On
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.auto_start
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Initialize session on request startup.
session.auto_start = 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
= 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
post_max_size
is too small by default and needs to be increased e.g. when you run into
problems while creating online content
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum size of POST data that PHP will accept.
post_max_size = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
upload_max_filesize
needs to be increased e.g. to allow uploading larger course packages
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum allowed size for uploaded files.
upload_max_filesize = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
should be on for Oracle installations.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
= On
</td>
</tr>
</table>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.5         
Add GNU Coreutils</h2>

Also install the GNU Coreutils for
Solaris in order to avoid Apache error described in case MDL-6850 . The
Coreutils will include the du command which is required by Moodle to collect
and calculate data on file sizes. 

Download coreutils-6.4-sol10-sparc-local.gz from <a
href="http://www.sunfreeware.com/solaris_2.5_list.html#coreutils">http://www.sunfreeware.com/solaris_2.5_list.html#coreutils</a>
to your global zone as root .

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

gunzip
coreutils-6.4-sol10-sparc-local.gz

pkgadd -d
coreutils-6.4-sol10-sparc-local.gz

</div>

Go to Administration > Configuration >
Variables > Operating System and enter the
path to entry pathtodu to the GNU du in
/usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle
administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du
entry.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>5               
Install Moodle</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>5.1         
Prepare the Moodle installation files</h2>

Now that we have completed the set-up for
Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for
the Moodle installation.

Log in as root and create
a moodle user assigned to a group and set a password.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir
/export/home/moodle

# useradd -u 1005 -g 101
-d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle

# chown moodle:users
/export/home/moodle

# passwd moodle

</div>

Log in as root to create
a directory for the Moodle installation:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir /usr/local/moodle_1.9+

# chown moodle:users
/usr/local/moodle_1.9+

</div>

Download moodle-weekly-19.tgz
from <a href="http://download.moodle.org/">http://download.moodle.org/</a>. Log
in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ gunzip
moodle-weekly-19.tgz

$ tar -vxf
moodle-weekly-19.tar --> creates subdirectory 'moodle'

</div>

Now log onto the system where you will
install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the environment variables,
preferable in the .profile of the de
user moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ export
ORACLE_HOME=/oracle/product/instantclient_10_2 

$ export
LD_LIBRARY_PATH=$ORACLE_HOME 

$ export
TNS_ADMIN=/var/opt/oracle 

$ export
PATH=$PATH:/usr/local/bin:/local/bin:. 

</div>

Start Apache with the configuration file adapted to moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$
/usr/local/apache2/bin/apachectl -k start -f
/usr/local/moodle_1.9+/moodle/httpd.conf 

</div>

If desired you can install other
languages during the installation wizard by downloading the appropriate
language files e.g. Dutch (<a
href="http://download.moodle.org/lang16/nl_utf8.zip">http://download.moodle.org/lang16/nl_utf8.zip</a>)
to /usr/local/moodle_1.9+/moodledata/lang
and uncompress the file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# unzip nl_utf8.zip 

</div>

A list of additional languages is
available from the administration interface. Moodle then automatically
downloads and installs the selected languages.

<h2 style='margin-left:0cm;text-indent:0cm'>5.2         
Choose installation language</h2>

Choose the installation language from the
drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

<img width=391 height=238
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image001.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.3         
Check PHP settings</h2>

If you followed the above mentioned
instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP
settings in php.ini.

<img width=381 height=335
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image002.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.4         
Set installation and data directories</h2>

In this step you define the basic locations
of all Moodle-related files. Unless you chose a different location for the
moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle
software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

<img border=0 width=398 height=334
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image003.jpg">

 

<h2 style='margin-left:0cm;text-indent:0cm'>5.5         
Set Database connection</h2>

In this step we will set up the
connection to the database:

l  Select
Oracle from the drop-down list

l  For
an Oracle installation, leave the Host entry empty

l  Provide the name of the Oracle database you created e.g. moodle

l  The
database admin username and password

l  Add a table prefix e.g. m_

<img width=416 height=475
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image004.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.6         
Server checks for installed components</h2>

The installation wizard will now perform
an availability check on the required System Components.

If you checked all the required PHP
settings and modules during the pre-installation phase, you should get the
following screen.

<img width=395 height=556
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image005.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.7         
Install language packs</h2>

Since we chose a Dutch installation,
we now get an option to download the Dutch language files for the user
interface. Provided you have direct write access to the Moodle server, the
set-up of the language pack is automatic. 

<img width=419 height=270
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image006.jpg"> 
If the download is unsuccessful, you will get the error
message below. To resolve this problem, you can either:

l  Select
other languages by using the Administrator interface when the
installation is complete (Administration > Language > Language packs).

l  Unzip the language file on the server in
the lang files directory e.g. <path to Moodle directory>/moodledata/lang

<img width=420 height=385
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image007.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.8         
Confirmation for written configuration file.</h2>

All the settings we made in prior steps
are now collected and written to the Moodle configuration file (config.php). 

<img width=393 height=190
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image008.jpg"> 
In this step, the basic Moodle configuration is complete. In
the next steps, the setup will add the database tables and prepare Moodle for
use.

<h2 style='margin-left:0cm;text-indent:0cm'>5.9         
Licence agreement</h2>

Carefully read and accept the licence
agreement before proceeding to the final installation steps.

<img width=665 height=259
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image009.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.10      Release information</h2>

This page provides the release
information and the possibility to perform the following steps automatically
(unattended). We will simply click next in order to capture potential setup
errors.

<img width=665 height=139
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image010.jpg"> 


<a name="DDE_LINK">Following steps can be
performed automatically (unattended) or with manual confirmation.</a>

<h2 style='margin-left:0cm;text-indent:0cm'>5.11      Automatic database setup</h2>

What follows is a series of screens for
the setup of the database tables for all of the standard Moodle components.
Apart from clicking next, no user interaction is required.

<img width=469 height=439
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image011.jpg"> 
After each sequence a confirmation of success appears. 

<img width=599 height=402
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image012.jpg"> 
This is the final step in the database set-up sequence.

<img width=534 height=250
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image013.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.12      Setting up the administrator account</h2>

Now that the system is ready, we only
need to provide details for an initial administrator account. 

These data can be changed and/or
complemented later. This is the account that will initially be used after
installation to allow further configuration of the system.

<img width=665 height=452
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image014.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.13      Set up Frontpage</h2>

During this final step of the
installation wizard, we will put:

l  The Full
site name e.g. the name of the institution. This will be visible in the
title bar in all of the standard templates.

l  As Short
name for the site.

l  A Front
page description of the site. This will be displayed as a welcome message
on the start page.

 

<img width=665 height=375
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image015.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.14      Start with empty Moodle</h2>

We are then automatically redirected to
the Moodle start page. Our Moodle is up and running and we can now
continue with the configuration of the system.

<img width=665 height=295
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image016.jpg"> 


When we click Turn editing on we
can start the configuration. We will need to verify the system location of some
additional components. The installation procedure does not check for the
availability of a zip program. Moodle especially needs zip and unzip when
handling SCORM packages. Using the built-in unzip feature may impact server
performance.

<img width=665 height=431
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image017.jpg"> 


<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>6               
Document control</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Role
</td>
<td width=193 valign=top style='width:115.95pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Names
</td>
<td width=107 valign=top style='width:64.1pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Date
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Comment
</td>
</tr>
</thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Create
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080414
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Document
set-up
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080507
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
installation specifics from Stefaan Houthuys
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080514
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Update
after final discussion with Stefaan on 20080509
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Add
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080722
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
topic “Add GNU Coreutils” from Stefaan (Moodle tuning changes-20080714.pdf)
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
</tr>
</table>

 

 

</div>

Installation on Solaris 10 with Oracle 10

2008-07-25T12:21:34Z

Vdabgg:

The '''VDAB''' (Public employment and vocational training service of the Dutch-speaking part of Belgium) is currently preparing an implementation of Moodle 1.9 on a large scale for its clients.

As a first step we have installed Moodle on a standard environment for VDAB being a '''Solaris 10''' with '''Oracle 10g'''. Since this operation went succefully, problems encountered were solved, the VDAB offers the installation documentation to the Moodle community.

'''Contact person:''' [mailto:gerd.goetschalckx@vdab.be Gerd Goetschalckx]

<div class=Section1>

Installation
Documentation<o:p></o:p>

for<o:p></o:p>

Moodle at
VDAB<o:p></o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>1               
Document information<o:p></o:p></h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0cm 0cm 0cm 0cm'>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Document status:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Final 2008/07/23
</td>
</tr>
<tr style='mso-yfti-irow:1'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Owning process:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
VDAB
</td>
</tr>
<tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Created by:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Toby De Loght
</td>
</tr>
</table>

<o:p> </o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>2               
Purpose of this document<o:p></o:p></h1>

</div>

This
document provides an in-depth installation manual for Moodle on Solaris 10 with
Oracle 10.2.0.2.<o:p></o:p>

We
provide an overview of the different steps involved:

l  Preparing Oracle 10g for a large
Moodle installation<o:p></o:p>

l  Configuring Apache 2.2 for a secure
and high-performance webserver<o:p></o:p>

l  Preparing all necessary PHP packages
for Apache and Oracle<o:p></o:p>

l  Preparing PHP settings for Moodle

l  An overview of the steps in the
Moodle installation wizard.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>3               
Setting up the Oracle Database<o:p></o:p></h1>

</div>

We set up
2 parallel Moodle installations on one and a database on a separate
server. Both installations share the same Oracle database, but use a
different tablespace.<o:p></o:p>

The
Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's DBCA
tool. <o:p></o:p>

l  This is testzone1 on the test server testitis00<o:p></o:p>

l  Database name = testitis02.vdab.be<o:p></o:p>

l  We used the General purpose
template for the database set-up;<o:p></o:p>

l  And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each
Moodle installation we create a separate Tablespace:<o:p></o:p>

l  First Moodle installation on testzone2:<o:p></o:p>

 
MOODLE_DATA with initial size of 300MB

  User: MOODLEUSER, password: moodle

 
The user only has
rights within the specified tablespace

l  Second Moodle installation on testzone3:

 
MOODLE_DATA2 with initial size of 300MB

  User: MOODLEUSER2, password: moodle

 
The user only has
rights within the specified tablespace

  


<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>4               
Configuring Apache<o:p></o:p></h1>

</div>

<h2>4.1         
Install Apache<o:p></o:p></h2>

First download
the latest Apache e.g. httpd-2.2.8.tar.gz from <a
href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>
to the folder /usr/local/apache2

Log in as
root, uncompress the Apache files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gzip -d
httpd-2.2.8.tar.gz

# tar -xvf
httpd-2.2.8.tar

# cd
httpd-2.2.8

</div>

Adapt the
Environment Variables to make sure the correct gcc and make are
used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.

</div>

Configure and make Apache:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# make clean
--> only if necessary

# ./configure
\<o:p></o:p>

--prefix=/usr/local/apache2
\<o:p></o:p>

--with-included-apr

# make

# make
install

</div>

In order
to increase performance edit the following in the httpd.conf
file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# vi
/usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor

DirectoryIndex
index.php<o:p></o:p>

Listen 8002 -- > for VDAB<o:p></o:p>

DocumentRoot “/usr/local/moodle_1.9+/moodle”<o:p></o:p>

AcceptPathInfo
on<o:p></o:p>

</div>

 <o:p></o:p>

<h2>4.2         
Install OCI 8 and Oracle Instant Client<o:p></o:p></h2>

Download
the 32bit Solaris Basic en SDK: instantclient-basic-solaris6432-10.2.0.3-20070101.zip and <o:p></o:p>

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from <o:p></o:p>

<a
href="http://www.oracle.com/technology/tech/oci/instantclient/index.html">http://www.oracle.com/technology/tech/oci/instantclient/index.html</a>
to a folder e.g. /oracle/product.<o:p></o:p>

 <o:p></o:p>

Log in as
the user oracle and uncompress the installation files:<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ cd
/oracle/product<o:p></o:p>

$ unzip
instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the
directory instantclient_10_2<o:p></o:p>

$ unzip
instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the
directory instantclient_10_2<o:p></o:p>

</div>

 <o:p></o:p>

Adapt
the tnsnames to set an alias or Oracle net service name. Each net service name entry
contains connect descriptors that define listener and service information.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ cd
$TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi
tns_admin _--> Below an example adaptation:_<o:p></o:p>

moodle =<o:p></o:p>

      
(DESCRIPTION =<o:p></o:p>

            
(ADDRESS =<o:p></o:p>

                  
(COMMUNITY = TCPDEV.world)<o:p></o:p>

                  
(PROTOCOL = TCP)<o:p></o:p>

                  
(HOST = testzone1)<o:p></o:p>

                  
(PORT = 1521)<o:p></o:p>

            
)<o:p></o:p>

            
(CONNECT_DATA = <o:p></o:p>

                  
(SID = testitis02)<o:p></o:p>

            
)<o:p></o:p>

      
)<o:p></o:p>

</div>

 <o:p></o:p>

If necessary, create and adapt a sqlnet.ora file. For VDAB
this was not necessary.

 

Create two Symbolic
Links.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1<o:p></o:p>

/oracle/product/instantclient_10_2/libclntsh.so<o:p></o:p>

$ ln -s
/oracle/product/instantclient_10_2/libocci.so.10.1<o:p></o:p>

/oracle/product/instantclient_10_2/libocci.so<o:p></o:p>

</div>

<h2>4.3         
Install PHP<o:p></o:p></h2>

To install
PHP on the Apache server, download php-5.2.5.tar.gz from <a
href="http://www.php.net/downloads">http://www.php.net/downloads</a> to the
folder /usr/local/apache2<o:p></o:p>

Log in as
root, uncompress the PHP files and go to the installation folder.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gzip -d
php-5.2.5.tar.gz<o:p></o:p>

# tar -xvf
php-5.2.5.tar<o:p></o:p>

# cd
php-5.2.5<o:p></o:p>

</div>

Adapt the
Environment Variables to make sure the correct gcc and make are
used.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin<o:p></o:p>

# export
LD_LIBRARY_PATH=/oracle/product/instantclient_10_2<o:p></o:p>

</div>

The
following table provides a brief overview of the PHP extensions and what they
are used for. All of these are required to do a fully functional Moodle
installation.

 

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse;mso-yfti-tbllook:1184;
mso-padding-alt:0cm 0cm 0cm 0cm'>
<thead>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=203 valign=top style='width:121.55pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
PHP Extensions
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Description
</td>
</tr>
</thead>
<tr style='mso-yfti-irow:1'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD
Freetype
2
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD is commonly used to generate charts,
graphics, thumbnails, etc. on the fly. <o:p></o:p>
Freetype
provides an API to manipulate fonts.  <o:p></o:p>
Moodle
uses these modules to generate dynamic graphs from the logs.<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:2'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
OCI8
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Required connector for Oracle
</td>
</tr>
<tr style='mso-yfti-irow:3'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
zlib (alternatively use zip or unzip)
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Zlib is required for zip/unzip funcitonality
based on the deflate compression method. 
Moodle
itself can also handle this functionality, but this impacts the use of server
resources.
</td>
</tr>
<tr style='mso-yfti-irow:4'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl is a client to get files from servers.
It is used for handling files using a wide variety of protocols.
This
is a requirement for Moodle 1.8 and later
 
</td>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
openssl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Library to enable secured connections to a
server. This is mainly used for connections between Moodle installations e.g.
to share courses.<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
php5-LDAP
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Enables the use of LDAP functions in PHP
</td>
</tr>
<tr style='mso-yfti-irow:7;mso-yfti-lastrow:yes'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
aspell-xx
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
The optional aspell modules provide a free
spelling checker functionality embedded in Moodle. This module support a very
large number of languages. XX represents the 2-letter code for the language.<o:p></o:p>
</td>
</tr>
</table>

 <o:p></o:p>

For a
default Solaris most of these modules are available by default. We only need to
install curl and enable these modules in the Apache-Php configuration.

We first
install curl. Download the package curl-7.18.1.tar.gz from <a href="http://curl.haxx.se/">http://curl.haxx.se</a>
to /usr/local/apache2.

Log in as
root, uncompress the curl files and go to the installation folder to make
and install.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gunzip
curl-7.18.1.tar.gz

# tar -xvf
curl-7.18.1.tar<o:p></o:p>

# cd
curl-7.18.1<o:p></o:p>

# ./configure<o:p></o:p>

# make

# make
install

</div>

In order
to test the curl installation do

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

/usr/local/bin/curl
-V<o:p></o:p>

</div>

If necessary, extend PATH to /usr/local/bin. This was not
necessary for VDAB.

Next, we
will configure, and install the PHP for Apache make links to
the PHP extensions.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# cd
/usr/local/apache2/php-5.2.5<o:p></o:p>

# ./configure
\<o:p></o:p>

--with-apxs2=/usr/local/apache2/bin/apxs
\<o:p></o:p>

--with-config-file-path=/usr/local/apache2/conf
\<o:p></o:p>

--with-oci8=instantclient,/oracle/product/instantclient_10_2
\<o:p></o:p>

--enable-sigchild
\

--enable-mbstring
\

--with-gd \

--with-openssl
\

--with-curl=/usr/local/apache2/curl-7.18.1

# make

# make
install

</div>

 

<h2>4.4         
Change PHP settings<o:p></o:p></h2>

By
default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table
below. Afterwards we will make a copy of this file and make it the active Php
configuration file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# vi
/usr/local/apache2/conf/php.ini-recommended --> Open text editor and make
adaptations<o:p></o:p>

# cp
/usr/local/apache2/php-5.2.5/php.ini-recommended
/usr/local/apache2/conf/php.ini<o:p></o:p>

</div>

In the
file edit the following settings:

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse;mso-yfti-tbllook:1184;
mso-padding-alt:0cm 0cm 0cm 0cm'>
<thead>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=401 valign=top style='width:240.4pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Setting
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Value we used in
php.ini
</td>
</tr>
</thead>
<tr style='mso-yfti-irow:1'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Safe mode must be off<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Safe mode<o:p></o:p>
safe_mode = Off<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:2'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
memory_limit is at least 128MB
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Resource Limits<o:p></o:p>
memory_limit =
128M      ; Maximum amount of memory a script may
consume<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:3'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.save_handler needs to be set to
FILES.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
[Session]<o:p></o:p>
;
Handler used to store/retrieve data.<o:p></o:p>
session.save_handler
= files<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:4'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_gpc needs to be ON<o:p></o:p>
magic_quotes_runtime
needs to be OFF<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Magic quotes for incoming GET/POST/Cookie
data.<o:p></o:p>
magic_quotes_gpc
= On<o:p></o:p>
;
Magic quotes for runtime-generated data, e.g. data from SQL, from exec(),
etc.<o:p></o:p>
magic_quotes_runtime
= Off
</td>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
file_uploads needs to be ON<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Whether to allow HTTP file uploads.<o:p></o:p>
file_uploads
= On
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.auto_start needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Initialize session on request startup.<o:p></o:p>
session.auto_start
= 0
</td>
</tr>
<tr style='mso-yfti-irow:7'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn = 0
</td>
</tr>
<tr style='mso-yfti-irow:8'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
post_max_size is too small by default and
needs to be increased e.g. when you run into problems while creating online
content
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Maximum size of POST data that PHP will
accept.
post_max_size
= 300M
</td>
</tr>
<tr style='mso-yfti-irow:9'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
upload_max_filesize needs to be increased
e.g. to allow uploading larger course packages<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Maximum allowed size for uploaded files.<o:p></o:p>
upload_max_filesize
= 300M
</td>
</tr>
<tr style='mso-yfti-irow:10;mso-yfti-lastrow:yes'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase should be on for Oracle
installations.<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase = On
</td>
</tr>
</table>

 

<h2>4.5         
Add GNU Coreutils<o:p></o:p></h2>

Also
install the GNU Coreutils for Solaris in order to avoid Apache error described
in case MDL-6850 . The Coreutils will include the du command which is required
by Moodle to collect and calculate data on file sizes. 

Download
coreutils-6.4-sol10-sparc-local.gz from <a
href="http://www.sunfreeware.com/solaris_2.5_list.html#coreutils">http://www.sunfreeware.com/solaris_2.5_list.html#coreutils</a>
to your global zone as root .<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

gunzip
coreutils-6.4-sol10-sparc-local.gz<o:p></o:p>

pkgadd -d coreutils-6.4-sol10-sparc-local.gz<o:p></o:p>

</div>

Go to Administration
> Configuration > Variables > Operating System and enter the path to entry pathtodu
to the GNU du in
/usr/local/bin/du (was /usr/bin/du) .<o:p></o:p>

Set the
correct path in the Moodle administration interface. Go to Administration
> Server > System Paths and fill out the correct path in the Path to du entry.<o:p></o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>5               
Install Moodle<o:p></o:p></h1>

</div>

<h2>5.1         
Prepare the Moodle installation files<o:p></o:p></h2>

Now that
we have completed the set-up for Apache, PHP, Oracle and the connection between
PHP and Oracle we prepare for the Moodle installation.

Log in as
root and create a moodle user assigned to a group and set a password.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# mkdir
/export/home/moodle

# useradd -u
1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle

# chown
moodle:users /export/home/moodle

# passwd
moodle

</div>

Log in as
root to create a directory for the Moodle installation:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# mkdir
/usr/local/moodle_1.9+

# chown
moodle:users /usr/local/moodle_1.9+

</div>

Download
moodle-weekly-19.tgz
from <a href="http://download.moodle.org/">http://download.moodle.org/</a>. Log
in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ gunzip
moodle-weekly-19.tgz<o:p></o:p>

$ tar -vxf
moodle-weekly-19.tar --> creates subdirectory 'moodle'

</div>

Now log
onto the system where you will install Moodle e.g. testzone3
on server testitis03 as the user moodle.

Set the environment
variables, preferable in the .profile of the  de user moodle: <o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ export
ORACLE_HOME=/oracle/product/instantclient_10_2 <o:p></o:p>

$ export
LD_LIBRARY_PATH=$ORACLE_HOME <o:p></o:p>

$ export
TNS_ADMIN=/var/opt/oracle <o:p></o:p>

$ export
PATH=$PATH:/usr/local/bin:/local/bin:. <o:p></o:p>

</div>

Start
Apache with the
configuration file adapted to moodle: <o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$
/usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf
<o:p></o:p>

</div>

If
desired you can install other languages during the installation wizard by
downloading the appropriate language files e.g. Dutch (<a
href="http://download.moodle.org/lang16/nl_utf8.zip">http://download.moodle.org/lang16/nl_utf8.zip</a>)
to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# unzip
nl_utf8.zip <o:p></o:p>

</div>

A list of
additional languages is available from the administration interface. Moodle
then automatically downloads and installs the selected languages.<o:p></o:p>

<h2>5.2         
Choose installation language<o:p></o:p></h2>

Choose
the installation language from the drop-down list. This choice only applies to
the installation wizard.<o:p></o:p>

Click the
next button to continue.<o:p></o:p>

<img border=0 width=391
height=238 id="_x0000_i1041"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image001.jpg"> 


<h2>5.3         
Check PHP settings<o:p></o:p></h2>

If you
followed the above mentioned instructions for php, you should get the following
screen.

In case
of a Fail, recheck the PHP settings in php.ini.

<img border=0 width=381
height=335 id="_x0000_i1040"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image002.jpg"> 


<h2>5.4         
Set installation and data directories<o:p></o:p></h2>

In this
step you define the basic locations of all Moodle-related files. Unless you
chose a different location for the moodledata folder you do not need to change
anything.

It is
adviseable to keep the Moodle software and the data (courses, uploaded
assignments etc.) separately;

In case
of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

<img border=0 width=398
height=334 id="_x0000_i1039"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image003.jpg">

 

<h2>5.5         
Set Database connection<o:p></o:p></h2>

In this
step we will set up the connection to the database:

l  Select Oracle
from the drop-down list<o:p></o:p>

l  For an Oracle installation, leave
the Host entry empty<o:p></o:p>

l  Provide the name of the Oracle database you
created e.g. moodle

l  The database admin username and
password<o:p></o:p>

l  Add a table prefix e.g. m_<o:p></o:p>

<img border=0 width=416
height=475 id="_x0000_i1038"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image004.jpg"> 


<h2>5.6         
Server checks for installed components<o:p></o:p></h2>

The
installation wizard will now perform an availability check on the
required System Components.<o:p></o:p>

If you
checked all the required PHP settings and modules during the pre-installation
phase, you should get the following screen.<o:p></o:p>

<img border=0 width=395
height=556 id="_x0000_i1037"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image005.jpg"> 


<h2>5.7         
Install language packs<o:p></o:p></h2>

Since we
chose a Dutch installation, we now get an option to download the Dutch
language files for the user interface. Provided you have direct write
access to the Moodle server, the set-up of the language pack is automatic.


<img border=0 width=419
height=270 id="_x0000_i1036"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image006.jpg"> 
If the download is
unsuccessful, you will get the error message below. To resolve this
problem, you can either:<o:p></o:p>

l  Select other languages by using the Administrator
interface when the installation is complete (Administration > Language
> Language packs).<o:p></o:p>

l  Unzip the language file on the server in the lang files directory e.g. <path to Moodle directory>/moodledata/lang

<img border=0 width=420
height=385 id="_x0000_i1035"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image007.jpg"> 


<h2>5.8         
Confirmation for written configuration file.<o:p></o:p></h2>

All the
settings we made in prior steps are now collected and written to the Moodle
configuration file (config.php). 

<img border=0 width=393
height=190 id="_x0000_i1034"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image008.jpg"> 
In this step, the basic Moodle
configuration is complete. In the next steps, the setup will add the database
tables and prepare Moodle for use.

<h2>5.9         
Licence agreement<o:p></o:p></h2>

Carefully
read and accept the licence agreement before proceeding to the final
installation steps.<o:p></o:p>

<img border=0 width=665
height=259 id="_x0000_i1033"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image009.jpg"> 


<h2>5.10      Release information<o:p></o:p></h2>

This page
provides the release information and the possibility to perform the following
steps automatically (unattended). We will simply click next in order to capture
potential setup errors.

<img border=0 width=665
height=139 id="_x0000_i1032"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image010.jpg"> 


<a name="DDE_LINK">Following steps can be performed automatically (unattended) or with
manual confirmation.</a>

<h2>5.11      Automatic database setup<o:p></o:p></h2>

What
follows is a series of screens for the setup of the database tables for all
of the standard Moodle components. Apart from clicking next, no user
interaction is required.<o:p></o:p>

<img border=0 width=469
height=439 id="_x0000_i1031"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image011.jpg"> 
After each sequence a confirmation
of success appears. <o:p></o:p>

<img border=0 width=599
height=402 id="_x0000_i1030"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image012.jpg"> 
This is the final step in the
database set-up sequence.

<img border=0 width=534
height=250 id="_x0000_i1029"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image013.jpg"> 


<h2>5.12      Setting up the administrator account<o:p></o:p></h2>

Now that
the system is ready, we only need to provide details for an initial
administrator account. 

These
data can be changed and/or complemented later. This is the account that will
initially be used after installation to allow further configuration of the
system.

<img border=0 width=665
height=452 id="_x0000_i1028"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image014.jpg"> 


<h2>5.13      Set up Frontpage<o:p></o:p></h2>

During
this final step of the installation wizard, we will put:

l  The Full site name e.g. the
name of the institution. This will be visible in the title bar in all of the
standard templates.

l  As Short name for the site.<o:p></o:p>

l  A Front page description of
the site. This will be displayed as a welcome message on the start page.

 

<img border=0 width=665
height=375 id="_x0000_i1027"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image015.jpg"> 


<h2>5.14      Start with empty Moodle<o:p></o:p></h2>

We are
then automatically redirected to the Moodle start page. Our Moodle is up
and running and we can now continue with the configuration of the system.

<img border=0 width=665
height=295 id="_x0000_i1026"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image016.jpg"> 


When we
click Turn editing on we can start the configuration. We will need to
verify the system location of some additional components. The installation
procedure does not check for the availability of a zip program. Moodle
especially needs zip and unzip when handling SCORM packages. Using the built-in
unzip feature may impact server performance.

<img border=0 width=665
height=431 id="_x0000_i1025"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image017.jpg"> 


</div>

Installation on Solaris 10 with Oracle 10

2008-07-25T12:20:36Z

Vdabgg:

The '''VDAB''' (Public employment and vocational training service of the Dutch-speaking part of Belgium) is currently preparing an implementation of Moodle 1.9 on a large scale for its clients.

As a first step we have installed Moodle on a standard environment for VDAB being a '''Solaris 10''' with '''Oracle 10g'''. Since this operation went succefully, problems encountered were solved, the VDAB offers the installation documentation to the Moodle community.

'''Contact person:''' [mailto:gerd.goetschalckx@vdab.be Gerd Goetschalckx]

<style>

</style>

<div class=Section1>

Installation
Documentation<o:p></o:p>

for<o:p></o:p>

Moodle at
VDAB<o:p></o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>1               
Document information<o:p></o:p></h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='border-collapse:collapse;mso-yfti-tbllook:1184;mso-padding-alt:0cm 0cm 0cm 0cm'>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Document status:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Final 2008/07/23
</td>
</tr>
<tr style='mso-yfti-irow:1'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Owning process:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
VDAB
</td>
</tr>
<tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes'>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Created by:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Toby De Loght
</td>
</tr>
</table>

<o:p> </o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>2               
Purpose of this document<o:p></o:p></h1>

</div>

This
document provides an in-depth installation manual for Moodle on Solaris 10 with
Oracle 10.2.0.2.<o:p></o:p>

We
provide an overview of the different steps involved:

l  Preparing Oracle 10g for a large
Moodle installation<o:p></o:p>

l  Configuring Apache 2.2 for a secure
and high-performance webserver<o:p></o:p>

l  Preparing all necessary PHP packages
for Apache and Oracle<o:p></o:p>

l  Preparing PHP settings for Moodle

l  An overview of the steps in the
Moodle installation wizard.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>3               
Setting up the Oracle Database<o:p></o:p></h1>

</div>

We set up
2 parallel Moodle installations on one and a database on a separate
server. Both installations share the same Oracle database, but use a
different tablespace.<o:p></o:p>

The
Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's DBCA
tool. <o:p></o:p>

l  This is testzone1 on the test server testitis00<o:p></o:p>

l  Database name = testitis02.vdab.be<o:p></o:p>

l  We used the General purpose
template for the database set-up;<o:p></o:p>

l  And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each
Moodle installation we create a separate Tablespace:<o:p></o:p>

l  First Moodle installation on testzone2:<o:p></o:p>

 
MOODLE_DATA with initial size of 300MB

  User: MOODLEUSER, password: moodle

 
The user only has
rights within the specified tablespace

l  Second Moodle installation on testzone3:

 
MOODLE_DATA2 with initial size of 300MB

  User: MOODLEUSER2, password: moodle

 
The user only has
rights within the specified tablespace

  


<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>4               
Configuring Apache<o:p></o:p></h1>

</div>

<h2>4.1         
Install Apache<o:p></o:p></h2>

First download
the latest Apache e.g. httpd-2.2.8.tar.gz from <a
href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>
to the folder /usr/local/apache2

Log in as
root, uncompress the Apache files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gzip -d
httpd-2.2.8.tar.gz

# tar -xvf
httpd-2.2.8.tar

# cd
httpd-2.2.8

</div>

Adapt the
Environment Variables to make sure the correct gcc and make are
used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.

</div>

Configure and make Apache:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# make clean
--> only if necessary

# ./configure
\<o:p></o:p>

--prefix=/usr/local/apache2
\<o:p></o:p>

--with-included-apr

# make

# make
install

</div>

In order
to increase performance edit the following in the httpd.conf
file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# vi
/usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor

DirectoryIndex
index.php<o:p></o:p>

Listen 8002 -- > for VDAB<o:p></o:p>

DocumentRoot “/usr/local/moodle_1.9+/moodle”<o:p></o:p>

AcceptPathInfo
on<o:p></o:p>

</div>

 <o:p></o:p>

<h2>4.2         
Install OCI 8 and Oracle Instant Client<o:p></o:p></h2>

Download
the 32bit Solaris Basic en SDK: instantclient-basic-solaris6432-10.2.0.3-20070101.zip and <o:p></o:p>

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from <o:p></o:p>

<a
href="http://www.oracle.com/technology/tech/oci/instantclient/index.html">http://www.oracle.com/technology/tech/oci/instantclient/index.html</a>
to a folder e.g. /oracle/product.<o:p></o:p>

 <o:p></o:p>

Log in as
the user oracle and uncompress the installation files:<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ cd
/oracle/product<o:p></o:p>

$ unzip
instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the
directory instantclient_10_2<o:p></o:p>

$ unzip
instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the
directory instantclient_10_2<o:p></o:p>

</div>

 <o:p></o:p>

Adapt
the tnsnames to set an alias or Oracle net service name. Each net service name entry
contains connect descriptors that define listener and service information.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ cd
$TNS_ADMIN --> for VDAB this is /var/opt/oracle)

$ vi
tns_admin _--> Below an example adaptation:_<o:p></o:p>

moodle =<o:p></o:p>

      
(DESCRIPTION =<o:p></o:p>

            
(ADDRESS =<o:p></o:p>

                  
(COMMUNITY = TCPDEV.world)<o:p></o:p>

                  
(PROTOCOL = TCP)<o:p></o:p>

                  
(HOST = testzone1)<o:p></o:p>

                  
(PORT = 1521)<o:p></o:p>

            
)<o:p></o:p>

            
(CONNECT_DATA = <o:p></o:p>

                  
(SID = testitis02)<o:p></o:p>

            
)<o:p></o:p>

      
)<o:p></o:p>

</div>

 <o:p></o:p>

If necessary, create and adapt a sqlnet.ora file. For VDAB
this was not necessary.

 

Create two Symbolic
Links.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ ln -s /oracle/product/instantclient_10_2/libclntsh.so.10.1<o:p></o:p>

/oracle/product/instantclient_10_2/libclntsh.so<o:p></o:p>

$ ln -s
/oracle/product/instantclient_10_2/libocci.so.10.1<o:p></o:p>

/oracle/product/instantclient_10_2/libocci.so<o:p></o:p>

</div>

<h2>4.3         
Install PHP<o:p></o:p></h2>

To install
PHP on the Apache server, download php-5.2.5.tar.gz from <a
href="http://www.php.net/downloads">http://www.php.net/downloads</a> to the
folder /usr/local/apache2<o:p></o:p>

Log in as
root, uncompress the PHP files and go to the installation folder.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gzip -d
php-5.2.5.tar.gz<o:p></o:p>

# tar -xvf
php-5.2.5.tar<o:p></o:p>

# cd
php-5.2.5<o:p></o:p>

</div>

Adapt the
Environment Variables to make sure the correct gcc and make are
used.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin<o:p></o:p>

# export
LD_LIBRARY_PATH=/oracle/product/instantclient_10_2<o:p></o:p>

</div>

The
following table provides a brief overview of the PHP extensions and what they
are used for. All of these are required to do a fully functional Moodle
installation.

 

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse;mso-yfti-tbllook:1184;
mso-padding-alt:0cm 0cm 0cm 0cm'>
<thead>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=203 valign=top style='width:121.55pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
PHP Extensions
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Description
</td>
</tr>
</thead>
<tr style='mso-yfti-irow:1'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD
Freetype
2
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD is commonly used to generate charts,
graphics, thumbnails, etc. on the fly. <o:p></o:p>
Freetype
provides an API to manipulate fonts.  <o:p></o:p>
Moodle
uses these modules to generate dynamic graphs from the logs.<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:2'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
OCI8
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Required connector for Oracle
</td>
</tr>
<tr style='mso-yfti-irow:3'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
zlib (alternatively use zip or unzip)
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Zlib is required for zip/unzip funcitonality
based on the deflate compression method. 
Moodle
itself can also handle this functionality, but this impacts the use of server
resources.
</td>
</tr>
<tr style='mso-yfti-irow:4'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl is a client to get files from servers.
It is used for handling files using a wide variety of protocols.
This
is a requirement for Moodle 1.8 and later
 
</td>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
openssl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Library to enable secured connections to a
server. This is mainly used for connections between Moodle installations e.g.
to share courses.<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
php5-LDAP
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Enables the use of LDAP functions in PHP
</td>
</tr>
<tr style='mso-yfti-irow:7;mso-yfti-lastrow:yes'>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
aspell-xx
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
The optional aspell modules provide a free
spelling checker functionality embedded in Moodle. This module support a very
large number of languages. XX represents the 2-letter code for the language.<o:p></o:p>
</td>
</tr>
</table>

 <o:p></o:p>

For a
default Solaris most of these modules are available by default. We only need to
install curl and enable these modules in the Apache-Php configuration.

We first
install curl. Download the package curl-7.18.1.tar.gz from <a href="http://curl.haxx.se/">http://curl.haxx.se</a>
to /usr/local/apache2.

Log in as
root, uncompress the curl files and go to the installation folder to make
and install.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# gunzip
curl-7.18.1.tar.gz

# tar -xvf
curl-7.18.1.tar<o:p></o:p>

# cd
curl-7.18.1<o:p></o:p>

# ./configure<o:p></o:p>

# make

# make
install

</div>

In order
to test the curl installation do

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

/usr/local/bin/curl
-V<o:p></o:p>

</div>

If necessary, extend PATH to /usr/local/bin. This was not
necessary for VDAB.

Next, we
will configure, and install the PHP for Apache make links to
the PHP extensions.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# cd
/usr/local/apache2/php-5.2.5<o:p></o:p>

# ./configure
\<o:p></o:p>

--with-apxs2=/usr/local/apache2/bin/apxs
\<o:p></o:p>

--with-config-file-path=/usr/local/apache2/conf
\<o:p></o:p>

--with-oci8=instantclient,/oracle/product/instantclient_10_2
\<o:p></o:p>

--enable-sigchild
\

--enable-mbstring
\

--with-gd \

--with-openssl
\

--with-curl=/usr/local/apache2/curl-7.18.1

# make

# make
install

</div>

 

<h2>4.4         
Change PHP settings<o:p></o:p></h2>

By
default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the table
below. Afterwards we will make a copy of this file and make it the active Php
configuration file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# vi
/usr/local/apache2/conf/php.ini-recommended --> Open text editor and make
adaptations<o:p></o:p>

# cp
/usr/local/apache2/php-5.2.5/php.ini-recommended
/usr/local/apache2/conf/php.ini<o:p></o:p>

</div>

In the
file edit the following settings:

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse;mso-yfti-tbllook:1184;
mso-padding-alt:0cm 0cm 0cm 0cm'>
<thead>
<tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
<td width=401 valign=top style='width:240.4pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Setting
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Value we used in
php.ini
</td>
</tr>
</thead>
<tr style='mso-yfti-irow:1'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Safe mode must be off<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Safe mode<o:p></o:p>
safe_mode = Off<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:2'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
memory_limit is at least 128MB
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Resource Limits<o:p></o:p>
memory_limit =
128M      ; Maximum amount of memory a script may
consume<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:3'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.save_handler needs to be set to
FILES.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
[Session]<o:p></o:p>
;
Handler used to store/retrieve data.<o:p></o:p>
session.save_handler
= files<o:p></o:p>
</td>
</tr>
<tr style='mso-yfti-irow:4'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_gpc needs to be ON<o:p></o:p>
magic_quotes_runtime
needs to be OFF<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Magic quotes for incoming GET/POST/Cookie
data.<o:p></o:p>
magic_quotes_gpc
= On<o:p></o:p>
;
Magic quotes for runtime-generated data, e.g. data from SQL, from exec(),
etc.<o:p></o:p>
magic_quotes_runtime
= Off
</td>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
file_uploads needs to be ON<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Whether to allow HTTP file uploads.<o:p></o:p>
file_uploads
= On
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.auto_start needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Initialize session on request startup.<o:p></o:p>
session.auto_start
= 0
</td>
</tr>
<tr style='mso-yfti-irow:7'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn = 0
</td>
</tr>
<tr style='mso-yfti-irow:8'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
post_max_size is too small by default and
needs to be increased e.g. when you run into problems while creating online
content
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Maximum size of POST data that PHP will
accept.
post_max_size
= 300M
</td>
</tr>
<tr style='mso-yfti-irow:9'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
upload_max_filesize needs to be increased
e.g. to allow uploading larger course packages<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Maximum allowed size for uploaded files.<o:p></o:p>
upload_max_filesize
= 300M
</td>
</tr>
<tr style='mso-yfti-irow:10;mso-yfti-lastrow:yes'>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase should be on for Oracle
installations.<o:p></o:p>
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase = On
</td>
</tr>
</table>

 

<h2>4.5         
Add GNU Coreutils<o:p></o:p></h2>

Also
install the GNU Coreutils for Solaris in order to avoid Apache error described
in case MDL-6850 . The Coreutils will include the du command which is required
by Moodle to collect and calculate data on file sizes. 

Download
coreutils-6.4-sol10-sparc-local.gz from <a
href="http://www.sunfreeware.com/solaris_2.5_list.html#coreutils">http://www.sunfreeware.com/solaris_2.5_list.html#coreutils</a>
to your global zone as root .<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

gunzip
coreutils-6.4-sol10-sparc-local.gz<o:p></o:p>

pkgadd -d coreutils-6.4-sol10-sparc-local.gz<o:p></o:p>

</div>

Go to Administration
> Configuration > Variables > Operating System and enter the path to entry pathtodu
to the GNU du in
/usr/local/bin/du (was /usr/bin/du) .<o:p></o:p>

Set the
correct path in the Moodle administration interface. Go to Administration
> Server > System Paths and fill out the correct path in the Path to du entry.<o:p></o:p>

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1>5               
Install Moodle<o:p></o:p></h1>

</div>

<h2>5.1         
Prepare the Moodle installation files<o:p></o:p></h2>

Now that
we have completed the set-up for Apache, PHP, Oracle and the connection between
PHP and Oracle we prepare for the Moodle installation.

Log in as
root and create a moodle user assigned to a group and set a password.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# mkdir
/export/home/moodle

# useradd -u
1005 -g 101 -d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle

# chown
moodle:users /export/home/moodle

# passwd
moodle

</div>

Log in as
root to create a directory for the Moodle installation:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# mkdir
/usr/local/moodle_1.9+

# chown
moodle:users /usr/local/moodle_1.9+

</div>

Download
moodle-weekly-19.tgz
from <a href="http://download.moodle.org/">http://download.moodle.org/</a>. Log
in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ gunzip
moodle-weekly-19.tgz<o:p></o:p>

$ tar -vxf
moodle-weekly-19.tar --> creates subdirectory 'moodle'

</div>

Now log
onto the system where you will install Moodle e.g. testzone3
on server testitis03 as the user moodle.

Set the environment
variables, preferable in the .profile of the  de user moodle: <o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$ export
ORACLE_HOME=/oracle/product/instantclient_10_2 <o:p></o:p>

$ export
LD_LIBRARY_PATH=$ORACLE_HOME <o:p></o:p>

$ export
TNS_ADMIN=/var/opt/oracle <o:p></o:p>

$ export
PATH=$PATH:/usr/local/bin:/local/bin:. <o:p></o:p>

</div>

Start
Apache with the
configuration file adapted to moodle: <o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

$
/usr/local/apache2/bin/apachectl -k start -f /usr/local/moodle_1.9+/moodle/httpd.conf
<o:p></o:p>

</div>

If
desired you can install other languages during the installation wizard by
downloading the appropriate language files e.g. Dutch (<a
href="http://download.moodle.org/lang16/nl_utf8.zip">http://download.moodle.org/lang16/nl_utf8.zip</a>)
to /usr/local/moodle_1.9+/moodledata/lang and uncompress the file.<o:p></o:p>

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;margin-left:
1.0cm;margin-right:1.0cm'>

# unzip
nl_utf8.zip <o:p></o:p>

</div>

A list of
additional languages is available from the administration interface. Moodle
then automatically downloads and installs the selected languages.<o:p></o:p>

<h2>5.2         
Choose installation language<o:p></o:p></h2>

Choose
the installation language from the drop-down list. This choice only applies to
the installation wizard.<o:p></o:p>

Click the
next button to continue.<o:p></o:p>

<img border=0 width=391
height=238 id="_x0000_i1041"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image001.jpg"> 


<h2>5.3         
Check PHP settings<o:p></o:p></h2>

If you
followed the above mentioned instructions for php, you should get the following
screen.

In case
of a Fail, recheck the PHP settings in php.ini.

<img border=0 width=381
height=335 id="_x0000_i1040"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image002.jpg"> 


<h2>5.4         
Set installation and data directories<o:p></o:p></h2>

In this
step you define the basic locations of all Moodle-related files. Unless you
chose a different location for the moodledata folder you do not need to change
anything.

It is
adviseable to keep the Moodle software and the data (courses, uploaded
assignments etc.) separately;

In case
of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

<img border=0 width=398
height=334 id="_x0000_i1039"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image003.jpg">

 

<h2>5.5         
Set Database connection<o:p></o:p></h2>

In this
step we will set up the connection to the database:

l  Select Oracle
from the drop-down list<o:p></o:p>

l  For an Oracle installation, leave
the Host entry empty<o:p></o:p>

l  Provide the name of the Oracle database you
created e.g. moodle

l  The database admin username and
password<o:p></o:p>

l  Add a table prefix e.g. m_<o:p></o:p>

<img border=0 width=416
height=475 id="_x0000_i1038"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image004.jpg"> 


<h2>5.6         
Server checks for installed components<o:p></o:p></h2>

The
installation wizard will now perform an availability check on the
required System Components.<o:p></o:p>

If you
checked all the required PHP settings and modules during the pre-installation
phase, you should get the following screen.<o:p></o:p>

<img border=0 width=395
height=556 id="_x0000_i1037"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image005.jpg"> 


<h2>5.7         
Install language packs<o:p></o:p></h2>

Since we
chose a Dutch installation, we now get an option to download the Dutch
language files for the user interface. Provided you have direct write
access to the Moodle server, the set-up of the language pack is automatic.


<img border=0 width=419
height=270 id="_x0000_i1036"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image006.jpg"> 
If the download is
unsuccessful, you will get the error message below. To resolve this
problem, you can either:<o:p></o:p>

l  Select other languages by using the Administrator
interface when the installation is complete (Administration > Language
> Language packs).<o:p></o:p>

l  Unzip the language file on the server in the lang files directory e.g. <path to Moodle directory>/moodledata/lang

<img border=0 width=420
height=385 id="_x0000_i1035"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image007.jpg"> 


<h2>5.8         
Confirmation for written configuration file.<o:p></o:p></h2>

All the
settings we made in prior steps are now collected and written to the Moodle
configuration file (config.php). 

<img border=0 width=393
height=190 id="_x0000_i1034"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image008.jpg"> 
In this step, the basic Moodle
configuration is complete. In the next steps, the setup will add the database
tables and prepare Moodle for use.

<h2>5.9         
Licence agreement<o:p></o:p></h2>

Carefully
read and accept the licence agreement before proceeding to the final
installation steps.<o:p></o:p>

<img border=0 width=665
height=259 id="_x0000_i1033"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image009.jpg"> 


<h2>5.10      Release information<o:p></o:p></h2>

This page
provides the release information and the possibility to perform the following
steps automatically (unattended). We will simply click next in order to capture
potential setup errors.

<img border=0 width=665
height=139 id="_x0000_i1032"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image010.jpg"> 


<a name="DDE_LINK">Following steps can be performed automatically (unattended) or with
manual confirmation.</a>

<h2>5.11      Automatic database setup<o:p></o:p></h2>

What
follows is a series of screens for the setup of the database tables for all
of the standard Moodle components. Apart from clicking next, no user
interaction is required.<o:p></o:p>

<img border=0 width=469
height=439 id="_x0000_i1031"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image011.jpg"> 
After each sequence a confirmation
of success appears. <o:p></o:p>

<img border=0 width=599
height=402 id="_x0000_i1030"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image012.jpg"> 
This is the final step in the
database set-up sequence.

<img border=0 width=534
height=250 id="_x0000_i1029"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image013.jpg"> 


<h2>5.12      Setting up the administrator account<o:p></o:p></h2>

Now that
the system is ready, we only need to provide details for an initial
administrator account. 

These
data can be changed and/or complemented later. This is the account that will
initially be used after installation to allow further configuration of the
system.

<img border=0 width=665
height=452 id="_x0000_i1028"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image014.jpg"> 


<h2>5.13      Set up Frontpage<o:p></o:p></h2>

During
this final step of the installation wizard, we will put:

l  The Full site name e.g. the
name of the institution. This will be visible in the title bar in all of the
standard templates.

l  As Short name for the site.<o:p></o:p>

l  A Front page description of
the site. This will be displayed as a welcome message on the start page.

 

<img border=0 width=665
height=375 id="_x0000_i1027"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image015.jpg"> 


<h2>5.14      Start with empty Moodle<o:p></o:p></h2>

We are
then automatically redirected to the Moodle start page. Our Moodle is up
and running and we can now continue with the configuration of the system.

<img border=0 width=665
height=295 id="_x0000_i1026"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image016.jpg"> 


When we
click Turn editing on we can start the configuration. We will need to
verify the system location of some additional components. The installation
procedure does not check for the availability of a zip program. Moodle
especially needs zip and unzip when handling SCORM packages. Using the built-in
unzip feature may impact server performance.

<img border=0 width=665
height=431 id="_x0000_i1025"
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image017.jpg"> 


</div>

Installation on Solaris 10 with Oracle 10

2008-07-25T12:13:41Z

Vdabgg: /* Setting up the Oracle Database */

Installation on Solaris 10 with Oracle 10

2008-07-25T12:13:24Z

Vdabgg: /* Purpose of this document */

The '''VDAB''' (Public employment and vocational training service of the Dutch-speaking part of Belgium) is currently preparing an implementation of Moodle 1.9 on a large scale for its clients.

As a first step we have installed Moodle on a standard environment for VDAB being a '''Solaris 10''' with '''Oracle 10g'''. Since this operation went succefully, problems encountered were solved, the VDAB offers the installation documentation to the Moodle community.

'''Contact person:''' [mailto:gerd.goetschalckx@vdab.be Gerd Goetschalckx]

== Setting up the Oracle Database ==

We set up 2 parallel Moodle installations on one and a database on a separate server. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's DBCA tool.

* This is testzone1 on the test server testitis00

* Database name = testitis02.vdab.be

* We used the General purpose template for the database set-up;

* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a separate Tablespace:

* First Moodle installation on testzone2:

* MOODLE_DATA with initial size of 300MB

** User: MOODLEUSER, password: moodle

** The user only has rights within the specified tablespace

* Second Moodle installation on testzone3:

** MOODLE_DATA2 with initial size of 300MB

** User: MOODLEUSER2, password: moodle

** The user only has rights within the specified tablespace

<div class=Section1>

Installation Documentation

for

Moodle at VDAB

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>1               
Document information</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='border-collapse:collapse'>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Document
status:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Final
2008/07/23
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Owning
process:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
VDAB
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Created
by:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Toby De
Loght
</td>
</tr>
</table>

</div>

 


<div class=Section2>

Table of Contents

</div>

 


<div class=Section3>

1 Document information____________________________________________________________ 1

2 Purpose
of this document__________________________________________________________ 2

3 Setting
up the Oracle Database_____________________________________________________ 2

4 Configuring
Apache_______________________________________________________________ 2

4.1 Install Apache................................................................................................................... 2

4.2 Install OCI 8 and Oracle Instant Client.............................................................................. 3

4.3 Install PHP....................................................................................................................... 4

4.4 Change PHP settings......................................................................................................... 6

4.5 Add GNU Coreutils........................................................................................................... 7

5 Install
Moodle___________________________________________________________________ 7

5.1 Prepare the Moodle installation files.................................................................................. 7

5.2 Choose installation language............................................................................................. 8

5.3 Check PHP settings........................................................................................................... 8

5.4 Set installation and data directories.................................................................................... 9

5.5 Set Database connection.................................................................................................. 10

5.6 Server checks for installed components............................................................................ 11

5.7 Install language packs..................................................................................................... 12

5.8 Confirmation for written configuration
file...................................................................... 14

5.9 Licence agreement.......................................................................................................... 14

5.10 Release information....................................................................................................... 14

5.11 Automatic database setup.............................................................................................. 15

5.12 Setting up the administrator account............................................................................. 16

5.13 Set up Frontpage........................................................................................................... 17

5.14 Start with empty Moodle............................................................................................... 18

6 Document
control_______________________________________________________________ 19

</div>

 


<div class=Section4>

 

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>2               
Purpose of this document</h1>

</div>

This document provides an in-depth
installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different
steps involved:

l  Preparing
Oracle 10g for a large Moodle installation

l  Configuring
Apache 2.2 for a secure and high-performance webserver

l  Preparing
all necessary PHP packages for Apache and Oracle

l  Preparing
PHP settings for Moodle

l  An
overview of the steps in the Moodle installation wizard.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>3               
Setting up the Oracle Database</h1>

</div>

We set up 2 parallel Moodle
installations on one and a database on a separate server. Both
installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a
Solaris 10 and is set up using Oracle's DBCA tool. 

l  This is testzone1 on the test
server testitis00

l  Database name = testitis02.vdab.be

l  We
used the General purpose template for the database set-up;

l  And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a separate
Tablespace:

l  First
Moodle installation on testzone2:

  MOODLE_DATA with initial size of 300MB

  User: MOODLEUSER, password: moodle

  The
user only has rights within the specified tablespace

l  Second
Moodle installation on testzone3:

  MOODLE_DATA2 with initial size of 300MB

  User: MOODLEUSER2, password: moodle

  The
user only has rights within the specified tablespace

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>4               
Configuring Apache</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.1         
Install Apache</h2>

First download the latest Apache e.g. httpd-2.2.8.tar.gz from <a href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>
to the folder /usr/local/apache2

Log in as root, uncompress
the Apache files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d
httpd-2.2.8.tar.gz

# tar -xvf httpd-2.2.8.tar

# cd httpd-2.2.8

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.

</div>

Configure and make Apache:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# make clean --> only
if necessary

# ./configure \

--prefix=/usr/local/apache2
\

--with-included-apr

# make

# make install

</div>

In order to increase performance edit
the following in the httpd.conf file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor

DirectoryIndex index.php

Listen 8002 -- > for VDAB

DocumentRoot “/usr/local/moodle_1.9+/moodle”

AcceptPathInfo on

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.2         
Install OCI 8 and Oracle Instant Client</h2>

Download the 32bit Solaris Basic en SDK: instantclient-basic-solaris6432-10.2.0.3-20070101.zip and 

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from 

<a
href="http://www.oracle.com/technology/tech/oci/instantclient/index.html">http://www.oracle.com/technology/tech/oci/instantclient/index.html</a>
to a folder e.g. /oracle/product.

 

Log in as the user oracle and uncompress the installation files:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd /oracle/product

$ unzip
instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the
directory instantclient_10_2

$ unzip
instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the
directory instantclient_10_2

</div>

 

Adapt the tnsnames to set an alias or Oracle net service
name. Each net service name entry contains connect descriptors that define
listener and service information.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd $TNS_ADMIN --> for
VDAB this is /var/opt/oracle)

$ vi tns_admin _-->
Below an example adaptation:_

 moodle =

 (DESCRIPTION =

 (ADDRESS =

 (COMMUNITY
= TCPDEV.world)

 (PROTOCOL
= TCP)

 (HOST =
testzone1)

 (PORT =
1521)

 )

 (CONNECT_DATA
= 

 (SID =
testitis02)

 )

 )

</div>

 

If necessary,
create and adapt a sqlnet.ora file. For VDAB this was not necessary.

 

Create two Symbolic Links.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ ln -s
/oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s
/oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.3         
Install PHP</h2>

To install PHP on the Apache
server, download php-5.2.5.tar.gz from <a
href="http://www.php.net/downloads">http://www.php.net/downloads</a> to the
folder /usr/local/apache2

Log in as root, uncompress
the PHP files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d php-5.2.5.tar.gz

# tar -xvf php-5.2.5.tar

# cd php-5.2.5

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin

# export
LD_LIBRARY_PATH=/oracle/product/instantclient_10_2

</div>

The following table provides a brief
overview of the PHP extensions and what they are used for. All of these are
required to do a fully functional Moodle installation.

 

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
PHP Extensions
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Description
</td>
</tr>
</thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD
Freetype 2
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD is
commonly used to generate charts, graphics, thumbnails, etc. on the fly. 
Freetype provides an API to
manipulate fonts. 
Moodle uses these modules to generate
dynamic graphs from the logs.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
OCI8
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Required
connector for Oracle
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
zlib
(alternatively use zip or unzip)
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Zlib is
required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this
functionality, but this impacts the use of server resources.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl is
a client to get files from servers. It is used for handling files using a
wide variety of protocols.
This is a requirement for Moodle 1.8
and later
 
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
openssl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Library
to enable secured connections to a server. This is mainly used for
connections between Moodle installations e.g. to share courses.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
php5-LDAP
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Enables
the use of LDAP functions in PHP
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
aspell-xx
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
The
optional aspell modules provide a free spelling checker functionality
embedded in Moodle. This module support a very large number of languages. XX
represents the 2-letter code for the language.
</td>
</tr>
</table>

 

For a default Solaris most of these
modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from <a href="http://curl.haxx.se/">http://curl.haxx.se</a> to /usr/local/apache2.

Log in as root, uncompress
the curl files and go to the installation folder to make and
install.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gunzip
curl-7.18.1.tar.gz

# tar -xvf curl-7.18.1.tar

# cd curl-7.18.1

# ./configure

# make

# make install

</div>

In order to test the curl installation do

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

/usr/local/bin/curl -V

</div>

If necessary,
extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and install the PHP
for Apache make links to the PHP extensions.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# cd
/usr/local/apache2/php-5.2.5

# ./configure \

--with-apxs2=/usr/local/apache2/bin/apxs
\

--with-config-file-path=/usr/local/apache2/conf
\

--with-oci8=instantclient,/oracle/product/instantclient_10_2
\

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

# make

# make install

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.4         
Change PHP settings</h2>

By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the
table below. Afterwards we will make a copy of this file and make it the active
Php configuration file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/apache2/conf/php.ini-recommended --> Open text editor and make
adaptations

# cp
/usr/local/apache2/php-5.2.5/php.ini-recommended
/usr/local/apache2/conf/php.ini

</div>

In the file edit the following
settings:

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Setting
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Value we used in php.ini
</td>
</tr>
</thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Safe
mode must be off
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Safe
mode
safe_mode
= Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
memory_limit
is at least 128MB
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Resource Limits
memory_limit
= 128M ; Maximum amount of memory a script may consume
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.save_handler
needs to be set to FILES.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
[Session]
; Handler used to store/retrieve
data.
session.save_handler = files
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_gpc
needs to be ON
magic_quotes_runtime needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Magic
quotes for incoming GET/POST/Cookie data.
magic_quotes_gpc = On
; Magic quotes for runtime-generated
data, e.g. data from SQL, from exec(), etc.
magic_quotes_runtime = Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
file_uploads
needs to be ON
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Whether to allow HTTP file uploads.
file_uploads = On
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.auto_start
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Initialize session on request startup.
session.auto_start = 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
= 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
post_max_size
is too small by default and needs to be increased e.g. when you run into
problems while creating online content
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum size of POST data that PHP will accept.
post_max_size = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
upload_max_filesize
needs to be increased e.g. to allow uploading larger course packages
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum allowed size for uploaded files.
upload_max_filesize = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
should be on for Oracle installations.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
= On
</td>
</tr>
</table>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.5         
Add GNU Coreutils</h2>

Also install the GNU Coreutils for
Solaris in order to avoid Apache error described in case MDL-6850 . The
Coreutils will include the du command which is required by Moodle to collect
and calculate data on file sizes. 

Download coreutils-6.4-sol10-sparc-local.gz from <a
href="http://www.sunfreeware.com/solaris_2.5_list.html#coreutils">http://www.sunfreeware.com/solaris_2.5_list.html#coreutils</a>
to your global zone as root .

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

gunzip
coreutils-6.4-sol10-sparc-local.gz

pkgadd -d
coreutils-6.4-sol10-sparc-local.gz

</div>

Go to Administration > Configuration >
Variables > Operating System and enter the
path to entry pathtodu to the GNU du in
/usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle
administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du
entry.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>5               
Install Moodle</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>5.1         
Prepare the Moodle installation files</h2>

Now that we have completed the set-up for
Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for
the Moodle installation.

Log in as root and create
a moodle user assigned to a group and set a password.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir
/export/home/moodle

# useradd -u 1005 -g 101
-d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle

# chown moodle:users
/export/home/moodle

# passwd moodle

</div>

Log in as root to create
a directory for the Moodle installation:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir /usr/local/moodle_1.9+

# chown moodle:users
/usr/local/moodle_1.9+

</div>

Download moodle-weekly-19.tgz
from <a href="http://download.moodle.org/">http://download.moodle.org/</a>. Log
in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ gunzip
moodle-weekly-19.tgz

$ tar -vxf
moodle-weekly-19.tar --> creates subdirectory 'moodle'

</div>

Now log onto the system where you will
install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the environment variables,
preferable in the .profile of the de
user moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ export
ORACLE_HOME=/oracle/product/instantclient_10_2 

$ export
LD_LIBRARY_PATH=$ORACLE_HOME 

$ export
TNS_ADMIN=/var/opt/oracle 

$ export
PATH=$PATH:/usr/local/bin:/local/bin:. 

</div>

Start Apache with the configuration file adapted to moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$
/usr/local/apache2/bin/apachectl -k start -f
/usr/local/moodle_1.9+/moodle/httpd.conf 

</div>

If desired you can install other
languages during the installation wizard by downloading the appropriate
language files e.g. Dutch (<a
href="http://download.moodle.org/lang16/nl_utf8.zip">http://download.moodle.org/lang16/nl_utf8.zip</a>)
to /usr/local/moodle_1.9+/moodledata/lang
and uncompress the file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# unzip nl_utf8.zip 

</div>

A list of additional languages is
available from the administration interface. Moodle then automatically
downloads and installs the selected languages.

<h2 style='margin-left:0cm;text-indent:0cm'>5.2         
Choose installation language</h2>

Choose the installation language from the
drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

<img width=391 height=238
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image001.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.3         
Check PHP settings</h2>

If you followed the above mentioned
instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP
settings in php.ini.

<img width=381 height=335
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image002.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.4         
Set installation and data directories</h2>

In this step you define the basic locations
of all Moodle-related files. Unless you chose a different location for the
moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle
software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

<img border=0 width=398 height=334
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image003.jpg">

 

<h2 style='margin-left:0cm;text-indent:0cm'>5.5         
Set Database connection</h2>

In this step we will set up the
connection to the database:

l  Select
Oracle from the drop-down list

l  For
an Oracle installation, leave the Host entry empty

l  Provide the name of the Oracle database you created e.g. moodle

l  The
database admin username and password

l  Add a table prefix e.g. m_

<img width=416 height=475
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image004.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.6         
Server checks for installed components</h2>

The installation wizard will now perform
an availability check on the required System Components.

If you checked all the required PHP
settings and modules during the pre-installation phase, you should get the
following screen.

<img width=395 height=556
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image005.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.7         
Install language packs</h2>

Since we chose a Dutch installation,
we now get an option to download the Dutch language files for the user
interface. Provided you have direct write access to the Moodle server, the
set-up of the language pack is automatic. 

<img width=419 height=270
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image006.jpg"> 
If the download is unsuccessful, you will get the error
message below. To resolve this problem, you can either:

l  Select
other languages by using the Administrator interface when the
installation is complete (Administration > Language > Language packs).

l  Unzip the language file on the server in
the lang files directory e.g. <path to Moodle directory>/moodledata/lang

<img width=420 height=385
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image007.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.8         
Confirmation for written configuration file.</h2>

All the settings we made in prior steps
are now collected and written to the Moodle configuration file (config.php). 

<img width=393 height=190
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image008.jpg"> 
In this step, the basic Moodle configuration is complete. In
the next steps, the setup will add the database tables and prepare Moodle for
use.

<h2 style='margin-left:0cm;text-indent:0cm'>5.9         
Licence agreement</h2>

Carefully read and accept the licence
agreement before proceeding to the final installation steps.

<img width=665 height=259
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image009.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.10      Release information</h2>

This page provides the release
information and the possibility to perform the following steps automatically
(unattended). We will simply click next in order to capture potential setup
errors.

<img width=665 height=139
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image010.jpg"> 


<a name="DDE_LINK">Following steps can be
performed automatically (unattended) or with manual confirmation.</a>

<h2 style='margin-left:0cm;text-indent:0cm'>5.11      Automatic database setup</h2>

What follows is a series of screens for
the setup of the database tables for all of the standard Moodle components.
Apart from clicking next, no user interaction is required.

<img width=469 height=439
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image011.jpg"> 
After each sequence a confirmation of success appears. 

<img width=599 height=402
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image012.jpg"> 
This is the final step in the database set-up sequence.

<img width=534 height=250
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image013.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.12      Setting up the administrator account</h2>

Now that the system is ready, we only
need to provide details for an initial administrator account. 

These data can be changed and/or
complemented later. This is the account that will initially be used after
installation to allow further configuration of the system.

<img width=665 height=452
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image014.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.13      Set up Frontpage</h2>

During this final step of the
installation wizard, we will put:

l  The Full
site name e.g. the name of the institution. This will be visible in the
title bar in all of the standard templates.

l  As Short
name for the site.

l  A Front
page description of the site. This will be displayed as a welcome message
on the start page.

 

<img width=665 height=375
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image015.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.14      Start with empty Moodle</h2>

We are then automatically redirected to
the Moodle start page. Our Moodle is up and running and we can now
continue with the configuration of the system.

<img width=665 height=295
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image016.jpg"> 


When we click Turn editing on we
can start the configuration. We will need to verify the system location of some
additional components. The installation procedure does not check for the
availability of a zip program. Moodle especially needs zip and unzip when
handling SCORM packages. Using the built-in unzip feature may impact server
performance.

<img width=665 height=431
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image017.jpg"> 


<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>6               
Document control</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Role
</td>
<td width=193 valign=top style='width:115.95pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Names
</td>
<td width=107 valign=top style='width:64.1pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Date
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Comment
</td>
</tr>
</thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Create
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080414
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Document
set-up
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080507
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
installation specifics from Stefaan Houthuys
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080514
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Update
after final discussion with Stefaan on 20080509
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Add
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080722
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
topic “Add GNU Coreutils” from Stefaan (Moodle tuning changes-20080714.pdf)
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
</tr>
</table>

 

 

</div>

Installation on Solaris 10 with Oracle 10

2008-07-25T12:11:02Z

Vdabgg: /* Setting up the Oracle Database */

The '''VDAB''' (Public employment and vocational training service of the Dutch-speaking part of Belgium) is currently preparing an implementation of Moodle 1.9 on a large scale for its clients.

As a first step we have installed Moodle on a standard environment for VDAB being a '''Solaris 10''' with '''Oracle 10g'''. Since this operation went succefully, problems encountered were solved, the VDAB offers the installation documentation to the Moodle community.

'''Contact person:''' [mailto:gerd.goetschalckx@vdab.be Gerd Goetschalckx]

== Purpose of this document ==
This document provides an in-depth installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different steps involved:

* Preparing Oracle 10g for a large Moodle installation

* Configuring Apache 2.2 for a secure and high-performance webserver

* Preparing all necessary PHP packages for Apache and Oracle

* Preparing PHP settings for Moodle

* An overview of the steps in the Moodle installation wizard.

== Setting up the Oracle Database ==

We set up 2 parallel Moodle installations on one and a database on a separate server. Both installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a Solaris 10 and is set up using Oracle's DBCA tool.

* This is testzone1 on the test server testitis00

* Database name = testitis02.vdab.be

* We used the General purpose template for the database set-up;

* And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a separate Tablespace:

* First Moodle installation on testzone2:

* MOODLE_DATA with initial size of 300MB

** User: MOODLEUSER, password: moodle

** The user only has rights within the specified tablespace

* Second Moodle installation on testzone3:

** MOODLE_DATA2 with initial size of 300MB

** User: MOODLEUSER2, password: moodle

** The user only has rights within the specified tablespace

<div class=Section1>

Installation Documentation

for

Moodle at VDAB

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>1               
Document information</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='border-collapse:collapse'>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Document
status:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Final
2008/07/23
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Owning
process:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
VDAB
</td>
</tr>
<tr>
<td width=198 valign=top style='width:118.75pt;padding:0cm 0cm 0cm 0cm'>
Created
by:
</td>
<td width=633 valign=top style='width:379.85pt;padding:0cm 0cm 0cm 0cm'>
Toby De
Loght
</td>
</tr>
</table>

</div>

 


<div class=Section2>

Table of Contents

</div>

 


<div class=Section3>

1 Document information____________________________________________________________ 1

2 Purpose
of this document__________________________________________________________ 2

3 Setting
up the Oracle Database_____________________________________________________ 2

4 Configuring
Apache_______________________________________________________________ 2

4.1 Install Apache................................................................................................................... 2

4.2 Install OCI 8 and Oracle Instant Client.............................................................................. 3

4.3 Install PHP....................................................................................................................... 4

4.4 Change PHP settings......................................................................................................... 6

4.5 Add GNU Coreutils........................................................................................................... 7

5 Install
Moodle___________________________________________________________________ 7

5.1 Prepare the Moodle installation files.................................................................................. 7

5.2 Choose installation language............................................................................................. 8

5.3 Check PHP settings........................................................................................................... 8

5.4 Set installation and data directories.................................................................................... 9

5.5 Set Database connection.................................................................................................. 10

5.6 Server checks for installed components............................................................................ 11

5.7 Install language packs..................................................................................................... 12

5.8 Confirmation for written configuration
file...................................................................... 14

5.9 Licence agreement.......................................................................................................... 14

5.10 Release information....................................................................................................... 14

5.11 Automatic database setup.............................................................................................. 15

5.12 Setting up the administrator account............................................................................. 16

5.13 Set up Frontpage........................................................................................................... 17

5.14 Start with empty Moodle............................................................................................... 18

6 Document
control_______________________________________________________________ 19

</div>

 


<div class=Section4>

 

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>2               
Purpose of this document</h1>

</div>

This document provides an in-depth
installation manual for Moodle on Solaris 10 with Oracle 10.2.0.2.

We provide an overview of the different
steps involved:

l  Preparing
Oracle 10g for a large Moodle installation

l  Configuring
Apache 2.2 for a secure and high-performance webserver

l  Preparing
all necessary PHP packages for Apache and Oracle

l  Preparing
PHP settings for Moodle

l  An
overview of the steps in the Moodle installation wizard.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>3               
Setting up the Oracle Database</h1>

</div>

We set up 2 parallel Moodle
installations on one and a database on a separate server. Both
installations share the same Oracle database, but use a different tablespace.

The Oracle 10.2.0.2 database runs on a
Solaris 10 and is set up using Oracle's DBCA tool. 

l  This is testzone1 on the test
server testitis00

l  Database name = testitis02.vdab.be

l  We
used the General purpose template for the database set-up;

l  And set UTF8 character encoding to NLS_LANG=AMERICAN_AMERICA.AL32UTF8

For each Moodle installation we create a separate
Tablespace:

l  First
Moodle installation on testzone2:

  MOODLE_DATA with initial size of 300MB

  User: MOODLEUSER, password: moodle

  The
user only has rights within the specified tablespace

l  Second
Moodle installation on testzone3:

  MOODLE_DATA2 with initial size of 300MB

  User: MOODLEUSER2, password: moodle

  The
user only has rights within the specified tablespace

 

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>4               
Configuring Apache</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.1         
Install Apache</h2>

First download the latest Apache e.g. httpd-2.2.8.tar.gz from <a href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>
to the folder /usr/local/apache2

Log in as root, uncompress
the Apache files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d
httpd-2.2.8.tar.gz

# tar -xvf httpd-2.2.8.tar

# cd httpd-2.2.8

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin:.

</div>

Configure and make Apache:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# make clean --> only
if necessary

# ./configure \

--prefix=/usr/local/apache2
\

--with-included-apr

# make

# make install

</div>

In order to increase performance edit
the following in the httpd.conf file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/moodle_1.9+/moodle/httpd.conf -- > opens text editor

DirectoryIndex index.php

Listen 8002 -- > for VDAB

DocumentRoot “/usr/local/moodle_1.9+/moodle”

AcceptPathInfo on

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.2         
Install OCI 8 and Oracle Instant Client</h2>

Download the 32bit Solaris Basic en SDK: instantclient-basic-solaris6432-10.2.0.3-20070101.zip and 

instantclient-sdk-solaris6432-10.2.0.3-20070101.zip from 

<a
href="http://www.oracle.com/technology/tech/oci/instantclient/index.html">http://www.oracle.com/technology/tech/oci/instantclient/index.html</a>
to a folder e.g. /oracle/product.

 

Log in as the user oracle and uncompress the installation files:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd /oracle/product

$ unzip
instantclient-basic-solaris6432-10.2.0.3-20070101.zip --> creates the
directory instantclient_10_2

$ unzip
instantclient-sdk-solaris6432-10.2.0.3-20070101.zip --> is put into the
directory instantclient_10_2

</div>

 

Adapt the tnsnames to set an alias or Oracle net service
name. Each net service name entry contains connect descriptors that define
listener and service information.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ cd $TNS_ADMIN --> for
VDAB this is /var/opt/oracle)

$ vi tns_admin _-->
Below an example adaptation:_

 moodle =

 (DESCRIPTION =

 (ADDRESS =

 (COMMUNITY
= TCPDEV.world)

 (PROTOCOL
= TCP)

 (HOST =
testzone1)

 (PORT =
1521)

 )

 (CONNECT_DATA
= 

 (SID =
testitis02)

 )

 )

</div>

 

If necessary,
create and adapt a sqlnet.ora file. For VDAB this was not necessary.

 

Create two Symbolic Links.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ ln -s
/oracle/product/instantclient_10_2/libclntsh.so.10.1

/oracle/product/instantclient_10_2/libclntsh.so

$ ln -s
/oracle/product/instantclient_10_2/libocci.so.10.1

/oracle/product/instantclient_10_2/libocci.so

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>4.3         
Install PHP</h2>

To install PHP on the Apache
server, download php-5.2.5.tar.gz from <a
href="http://www.php.net/downloads">http://www.php.net/downloads</a> to the
folder /usr/local/apache2

Log in as root, uncompress
the PHP files and go to the installation folder.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gzip -d php-5.2.5.tar.gz

# tar -xvf php-5.2.5.tar

# cd php-5.2.5

</div>

Adapt the Environment Variables to
make sure the correct gcc and make are used.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# export
PATH=$PATH:/usr/sfw/bin:/usr/ccs/bin

# export
LD_LIBRARY_PATH=/oracle/product/instantclient_10_2

</div>

The following table provides a brief
overview of the PHP extensions and what they are used for. All of these are
required to do a fully functional Moodle installation.

 

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
PHP Extensions
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Description
</td>
</tr>
</thead>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD
Freetype 2
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
GD is
commonly used to generate charts, graphics, thumbnails, etc. on the fly. 
Freetype provides an API to
manipulate fonts. 
Moodle uses these modules to generate
dynamic graphs from the logs.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
OCI8
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Required
connector for Oracle
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
zlib
(alternatively use zip or unzip)
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Zlib is
required for zip/unzip funcitonality based on the deflate compression method.

Moodle itself can also handle this
functionality, but this impacts the use of server resources.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
curl is
a client to get files from servers. It is used for handling files using a
wide variety of protocols.
This is a requirement for Moodle 1.8
and later
 
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
openssl
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Library
to enable secured connections to a server. This is mainly used for
connections between Moodle installations e.g. to share courses.
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
php5-LDAP
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Enables
the use of LDAP functions in PHP
</td>
</tr>
<tr>
<td width=203 valign=top style='width:121.55pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
aspell-xx
</td>
<td width=628 valign=top style='width:377.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
The
optional aspell modules provide a free spelling checker functionality
embedded in Moodle. This module support a very large number of languages. XX
represents the 2-letter code for the language.
</td>
</tr>
</table>

 

For a default Solaris most of these
modules are available by default. We only need to install curl and enable these modules in the Apache-Php configuration.

We first install curl. Download the package curl-7.18.1.tar.gz from <a href="http://curl.haxx.se/">http://curl.haxx.se</a> to /usr/local/apache2.

Log in as root, uncompress
the curl files and go to the installation folder to make and
install.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# gunzip
curl-7.18.1.tar.gz

# tar -xvf curl-7.18.1.tar

# cd curl-7.18.1

# ./configure

# make

# make install

</div>

In order to test the curl installation do

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

/usr/local/bin/curl -V

</div>

If necessary,
extend PATH to /usr/local/bin. This was not necessary for VDAB.

Next, we will configure, and install the PHP
for Apache make links to the PHP extensions.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# cd
/usr/local/apache2/php-5.2.5

# ./configure \

--with-apxs2=/usr/local/apache2/bin/apxs
\

--with-config-file-path=/usr/local/apache2/conf
\

--with-oci8=instantclient,/oracle/product/instantclient_10_2
\

--enable-sigchild \

--enable-mbstring \

--with-gd \

--with-openssl \

--with-curl=/usr/local/apache2/curl-7.18.1

# make

# make install

</div>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.4         
Change PHP settings</h2>

By default there is no php.ini file. However, there is a php.ini-recommended which we will use to make the required adaptations listed in the
table below. Afterwards we will make a copy of this file and make it the active
Php configuration file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# vi
/usr/local/apache2/conf/php.ini-recommended --> Open text editor and make
adaptations

# cp
/usr/local/apache2/php-5.2.5/php.ini-recommended
/usr/local/apache2/conf/php.ini

</div>

In the file edit the following
settings:

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Setting
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Value we used in php.ini
</td>
</tr>
</thead>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Safe
mode must be off
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Safe
mode
safe_mode
= Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
memory_limit
is at least 128MB
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Resource Limits
memory_limit
= 128M ; Maximum amount of memory a script may consume
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.save_handler
needs to be set to FILES.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
[Session]
; Handler used to store/retrieve
data.
session.save_handler = files
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_gpc
needs to be ON
magic_quotes_runtime needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
; Magic
quotes for incoming GET/POST/Cookie data.
magic_quotes_gpc = On
; Magic quotes for runtime-generated
data, e.g. data from SQL, from exec(), etc.
magic_quotes_runtime = Off
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
file_uploads
needs to be ON
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Whether to allow HTTP file uploads.
file_uploads = On
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.auto_start
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Initialize session on request startup.
session.auto_start = 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
needs to be OFF
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
session.bug_compat_warn
= 0
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
post_max_size
is too small by default and needs to be increased e.g. when you run into
problems while creating online content
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum size of POST data that PHP will accept.
post_max_size = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
upload_max_filesize
needs to be increased e.g. to allow uploading larger course packages
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
;
Maximum allowed size for uploaded files.
upload_max_filesize = 300M
</td>
</tr>
<tr>
<td width=401 valign=top style='width:240.4pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
should be on for Oracle installations.
</td>
<td width=403 valign=top style='width:241.85pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
magic_quotes_sybase
= On
</td>
</tr>
</table>

 

<h2 style='margin-left:0cm;text-indent:0cm'>4.5         
Add GNU Coreutils</h2>

Also install the GNU Coreutils for
Solaris in order to avoid Apache error described in case MDL-6850 . The
Coreutils will include the du command which is required by Moodle to collect
and calculate data on file sizes. 

Download coreutils-6.4-sol10-sparc-local.gz from <a
href="http://www.sunfreeware.com/solaris_2.5_list.html#coreutils">http://www.sunfreeware.com/solaris_2.5_list.html#coreutils</a>
to your global zone as root .

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

gunzip
coreutils-6.4-sol10-sparc-local.gz

pkgadd -d
coreutils-6.4-sol10-sparc-local.gz

</div>

Go to Administration > Configuration >
Variables > Operating System and enter the
path to entry pathtodu to the GNU du in
/usr/local/bin/du (was /usr/bin/du) .

Set the correct path in the Moodle
administration interface. Go to Administration > Server > System Paths and fill out the correct path in the Path to du
entry.

<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>5               
Install Moodle</h1>

</div>

<h2 style='margin-left:0cm;text-indent:0cm'>5.1         
Prepare the Moodle installation files</h2>

Now that we have completed the set-up for
Apache, PHP, Oracle and the connection between PHP and Oracle we prepare for
the Moodle installation.

Log in as root and create
a moodle user assigned to a group and set a password.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir
/export/home/moodle

# useradd -u 1005 -g 101
-d /export/home/moodle -s /bin/bash -c "Moodle" -m moodle

# chown moodle:users
/export/home/moodle

# passwd moodle

</div>

Log in as root to create
a directory for the Moodle installation:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# mkdir /usr/local/moodle_1.9+

# chown moodle:users
/usr/local/moodle_1.9+

</div>

Download moodle-weekly-19.tgz
from <a href="http://download.moodle.org/">http://download.moodle.org/</a>. Log
in as the user moodle and copy the file to /usr/local/moodle_1.9+ and uncompress the file:

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ gunzip
moodle-weekly-19.tgz

$ tar -vxf
moodle-weekly-19.tar --> creates subdirectory 'moodle'

</div>

Now log onto the system where you will
install Moodle e.g. testzone3 on server testitis03 as the user moodle.

Set the environment variables,
preferable in the .profile of the de
user moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$ export
ORACLE_HOME=/oracle/product/instantclient_10_2 

$ export
LD_LIBRARY_PATH=$ORACLE_HOME 

$ export
TNS_ADMIN=/var/opt/oracle 

$ export
PATH=$PATH:/usr/local/bin:/local/bin:. 

</div>

Start Apache with the configuration file adapted to moodle: 

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

$
/usr/local/apache2/bin/apachectl -k start -f
/usr/local/moodle_1.9+/moodle/httpd.conf 

</div>

If desired you can install other
languages during the installation wizard by downloading the appropriate
language files e.g. Dutch (<a
href="http://download.moodle.org/lang16/nl_utf8.zip">http://download.moodle.org/lang16/nl_utf8.zip</a>)
to /usr/local/moodle_1.9+/moodledata/lang
and uncompress the file.

<div style='border:solid gray 1.0pt;padding:1.0pt 1.0pt 1.0pt 1.0pt;background:
#FFFFCC;margin-left:1.0cm;margin-right:1.0cm'>

# unzip nl_utf8.zip 

</div>

A list of additional languages is
available from the administration interface. Moodle then automatically
downloads and installs the selected languages.

<h2 style='margin-left:0cm;text-indent:0cm'>5.2         
Choose installation language</h2>

Choose the installation language from the
drop-down list. This choice only applies to the installation wizard.

Click the next button to continue.

<img width=391 height=238
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image001.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.3         
Check PHP settings</h2>

If you followed the above mentioned
instructions for php, you should get the following screen.

In case of a Fail, recheck the PHP
settings in php.ini.

<img width=381 height=335
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image002.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.4         
Set installation and data directories</h2>

In this step you define the basic locations
of all Moodle-related files. Unless you chose a different location for the
moodledata folder you do not need to change anything.

It is adviseable to keep the Moodle
software and the data (courses, uploaded assignments etc.) separately;

In case of VDAB the web address is e.g. testzone2 or testzone3 and the data directory is /usr/local/moodle_1.9+/moodle

<img border=0 width=398 height=334
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image003.jpg">

 

<h2 style='margin-left:0cm;text-indent:0cm'>5.5         
Set Database connection</h2>

In this step we will set up the
connection to the database:

l  Select
Oracle from the drop-down list

l  For
an Oracle installation, leave the Host entry empty

l  Provide the name of the Oracle database you created e.g. moodle

l  The
database admin username and password

l  Add a table prefix e.g. m_

<img width=416 height=475
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image004.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.6         
Server checks for installed components</h2>

The installation wizard will now perform
an availability check on the required System Components.

If you checked all the required PHP
settings and modules during the pre-installation phase, you should get the
following screen.

<img width=395 height=556
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image005.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.7         
Install language packs</h2>

Since we chose a Dutch installation,
we now get an option to download the Dutch language files for the user
interface. Provided you have direct write access to the Moodle server, the
set-up of the language pack is automatic. 

<img width=419 height=270
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image006.jpg"> 
If the download is unsuccessful, you will get the error
message below. To resolve this problem, you can either:

l  Select
other languages by using the Administrator interface when the
installation is complete (Administration > Language > Language packs).

l  Unzip the language file on the server in
the lang files directory e.g. <path to Moodle directory>/moodledata/lang

<img width=420 height=385
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image007.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.8         
Confirmation for written configuration file.</h2>

All the settings we made in prior steps
are now collected and written to the Moodle configuration file (config.php). 

<img width=393 height=190
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image008.jpg"> 
In this step, the basic Moodle configuration is complete. In
the next steps, the setup will add the database tables and prepare Moodle for
use.

<h2 style='margin-left:0cm;text-indent:0cm'>5.9         
Licence agreement</h2>

Carefully read and accept the licence
agreement before proceeding to the final installation steps.

<img width=665 height=259
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image009.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.10      Release information</h2>

This page provides the release
information and the possibility to perform the following steps automatically
(unattended). We will simply click next in order to capture potential setup
errors.

<img width=665 height=139
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image010.jpg"> 


<a name="DDE_LINK">Following steps can be
performed automatically (unattended) or with manual confirmation.</a>

<h2 style='margin-left:0cm;text-indent:0cm'>5.11      Automatic database setup</h2>

What follows is a series of screens for
the setup of the database tables for all of the standard Moodle components.
Apart from clicking next, no user interaction is required.

<img width=469 height=439
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image011.jpg"> 
After each sequence a confirmation of success appears. 

<img width=599 height=402
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image012.jpg"> 
This is the final step in the database set-up sequence.

<img width=534 height=250
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image013.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.12      Setting up the administrator account</h2>

Now that the system is ready, we only
need to provide details for an initial administrator account. 

These data can be changed and/or
complemented later. This is the account that will initially be used after
installation to allow further configuration of the system.

<img width=665 height=452
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image014.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.13      Set up Frontpage</h2>

During this final step of the
installation wizard, we will put:

l  The Full
site name e.g. the name of the institution. This will be visible in the
title bar in all of the standard templates.

l  As Short
name for the site.

l  A Front
page description of the site. This will be displayed as a welcome message
on the start page.

 

<img width=665 height=375
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image015.jpg"> 


<h2 style='margin-left:0cm;text-indent:0cm'>5.14      Start with empty Moodle</h2>

We are then automatically redirected to
the Moodle start page. Our Moodle is up and running and we can now
continue with the configuration of the system.

<img width=665 height=295
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image016.jpg"> 


When we click Turn editing on we
can start the configuration. We will need to verify the system location of some
additional components. The installation procedure does not check for the
availability of a zip program. Moodle especially needs zip and unzip when
handling SCORM packages. Using the built-in unzip feature may impact server
performance.

<img width=665 height=431
src="VDAB_Moodle_Installation_DOC_1.0_bestanden/image017.jpg"> 


<div style='border:none;border-bottom:solid black 1.0pt;padding:0cm 0cm 0cm 0cm'>

<h1 style='margin-left:0cm;text-indent:0cm'>6               
Document control</h1>

</div>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0
style='margin-left:2.75pt;border-collapse:collapse'>
<thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Role
</td>
<td width=193 valign=top style='width:115.95pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Names
</td>
<td width=107 valign=top style='width:64.1pt;border:solid black 1.0pt;
border-right:none;background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Date
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
background:black;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Comment
</td>
</tr>
</thead>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Create
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080414
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Document
set-up
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080507
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
installation specifics from Stefaan Houthuys
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Edit
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080514
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Update
after final discussion with Stefaan on 20080509
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Add
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Toby De
Loght
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
20080722
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
Added
topic “Add GNU Coreutils” from Stefaan (Moodle tuning changes-20080714.pdf)
</td>
</tr>
<tr>
<td width=86 valign=top style='width:51.75pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=193 valign=top style='width:115.95pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=107 valign=top style='width:64.1pt;border-top:none;border-left:
solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none;
padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
<td width=420 valign=top style='width:252.05pt;border:solid black 1.0pt;
border-top:none;padding:2.75pt 2.75pt 2.75pt 2.75pt'>
 
</td>
</tr>
</table>

 

 

</div>

Installation on Solaris 10 with Oracle 10

2008-07-25T12:08:43Z

Vdabgg: /* Setting up the Oracle Database */

Installation on Solaris 10 with Oracle 10

2008-07-25T12:07:25Z

Vdabgg: /* Purpose of this document */

Installation on Solaris 10 with Oracle 10

2008-07-25T12:06:05Z

Vdabgg:

Installation on Solaris 10 with Oracle 10

2008-07-25T12:05:03Z

Vdabgg: