server installation/upgrade guide - duke university · v3.8.x.mpkg). choose ‘easy ... server...

© 2001-2009 Echo360, Inc.

Server Installation/Upgrade Guide

System Version 3.8

Echo360 is a trademark of Echo360, Inc. Echo360 is a registered trademark of Echo360 Inc. in Australia. All other trademarks are property of their respective owner(s).

Server Installation/Upgrade Guide Author: Michael Fardon System Version 3.8 Editor: Kate Goodwin, Damyon Wiese, Darren Matchett LSV3801.6 Last Modified: 7-Oct-09 of 30

Contents Introduction ..................................................................... 4 1.1 Installer Contents .............................................................................................................4 1.2 Software Updates and Technical Notes...........................................................................4

Upgrading from v3.7 or older ............................................ 5 2.1 Perform Backup ...............................................................................................................5 2.2 Upgrade MySQL (if required) ...........................................................................................5 2.3 Install Lectopia software...................................................................................................5 2.4 Apache Configuration.......................................................................................................6 2.5 Lectopia Database Update...............................................................................................7 2.6 System Test .....................................................................................................................7 2.7 System Configuration.......................................................................................................7 2.8 UTF-8 Database Upgrade................................................................................................7

Mac OS X Installation ....................................................... 8 3.1 Username/Password Scheme..........................................................................................8 3.2 System Requirements......................................................................................................8 3.3 Web Server (Apache) Configuration ................................................................................8 3.4 MySQL Installation/Configuration...................................................................................13 3.5 Install Lasso Professional Server...................................................................................13 3.6 Install Lectopia Server software .....................................................................................16 3.7 System Test ...................................................................................................................17 3.8 System Configuration.....................................................................................................17 3.9 Upgrade to v3.8.x...........................................................................................................17

Linux Installation .............................................................18 4.1 Username/Password Scheme........................................................................................18 4.2 System Requirements....................................................................................................18 4.3 Web Server (Apache) Configuration ..............................................................................18 4.4 Java Configuration .........................................................................................................19 4.5 MySQL Installation/Configuration...................................................................................19 4.6 Install Lasso Professional Server...................................................................................19 4.7 Install Lectopia Server software .....................................................................................20 4.8 System Test ...................................................................................................................20 4.9 System Configuration.....................................................................................................20 4.10 Upgrade to v3.8.x ..........................................................................................................21

UTF-8 Database Upgrade ..................................................23 Run UTF-8 Upgrade Package (database on same server) .....................................................23 Run UTF-8 Upgrade SQL Script (database on separate server) ............................................23

Database Generation and Population .................................25

FTP Service and Configuration ...........................................26 Mac OS X Configuration..........................................................................................................26 Linux Configuration .................................................................................................................28

Uninstall ing the Lectopia Server .........................................29 Uninstalling Lectopia ‘ilectures’ database ...............................................................................29 Uninstalling Lasso Professional Server ...................................................................................29

Server Installation/Upgrade Guide of 30

Section 1 Introduction

1.1 Installer Contents

Welcome to the installer documentation for Lectopia Server v3.8. This document outlines the sequence of steps that should be followed to install or upgrade the Lectopia Server to v3.8. This version of the Lectopia Server requires: Mac OS X Server 10.5.x, Mac OS X Server 10.6.x or Red Hat Enterprise

Linux 4 (CentOS 4) MySQL v5.0.x or v4.1.x Lasso Professional Server v8.5 Note: Mac OS X Server 10.4.x is not supported for use with Lectopia Server v3.8.5 If you are using this version you will need to upgrade to Mac OS X Server 10.5.x or Mac OS X Server 10.6.x before you can install Lectopia Server v3.8.5.

This document includes instructions for performing new server installs as well as upgrading from previous versions. Section 2: Upgrading from v3.7 or older (Mac OS X only) Section 3: Mac OS X Installation Section 4: Linux Installation

1.2 Software Updates and Technical Notes

Please check the Lectopia Community site for late-breaking software updates and related technical notes for Lectopia Server v3.8 and above. http://www.lectopia.com.au/community.lasso


Section 2 Upgrading from previous versions

This section outlines the sequence of steps that should be followed to upgrade Lectopia Server v3.8.4 or older to v3.8.5.

2.1 Perform Backup

It is recommended that you backup your Server prior to performing the upgrade. In particular you should perform a full dump of the Lectopia (‘ilectures’) database (both table schema and data). See the Database Backup and Restore how-to guide on the Lectopia Community website for further details regarding backing up the Lectopia database (http://www.lectopia.com.au/community.lasso).

2.2 Upgrade MySQL (if required)

Note: MySQL v4.0.x is not supported for use with Lectopia Server v3.8. If you are using this version you will need to upgrade to MySQL v5.0.x or v4.1.x before you can install Lectopia Server v3.8. Please ensure that MySQL v4.0.x has been removed before upgrading.

Ensure you have a backup of your Lectopia (‘ilectures’) database before

proceeding (see step above) Download the appropriate MySQL package from

http://dev.mysql.com/downloads (last accessed: 20071207) Run the MySQL package installer Run the MySQL startup item package installer Restore your Lectopia (‘ilectures’) database to MySQL using the instructions

in the Database Backup and Restore how-to guide For more information about how to install and use your MySQL service, please consult the MySQL installation package README.txt file or http://www.mysql.com (last accessed: 20071207).

2.3 Upgrade OS X (if required)

Note: OS X 10.4.x is not supported for use with Lectopia Server v3.8.5. If you are using this version you will need to upgrade to OS X 10.5.x or OS X 10.6.x before you can install Lectopia Server v3.8.5.

To upgrade a Lectopia system from OSX 10.4 to OSX 10.5 it is recommended to perform a full backup, followed by a clean install of OSX 10.5 and Lectopia and then a recovery of the backed up data. See the Database Backup and Restore how-to guide on the Community website for further details regarding backing up the Lectopia database (http://www.lectopia.com.au/community.lasso).

2.4 Install Lectopia software (OSX only)

Run the Lectopia Server installer package (Lectopia Server Installer v3.8.x.mpkg).

Choose ‘Easy Install’. Note: the software will be installed into the default installation paths:


/Applications/Lasso Professional 8 /Library/WebServer/Documents Run the ‘permissions-update-3.8.sh’ file. This file is located in the Lectopia

Server installer package. The script will ask you to: o Confirm the path to the root directory of the Web Service o Confirm the FTP account for use with the Lectopia Server o Confirm if you want to set directory permissions (see note below) Note: if you select ‘yes’ this may take some time depending on how many recordings are in your system.

2.5 Install Lectopia software (Linux only)

Go to the Lectopia Community site software releases - http://www.lectopia.com.au/community.lasso

Download the ‘LectopiaServer_v3.8.x.tar.gz’ package (where 'x' is the latest version number).

Extract to a folder on the Desktop. If not already installed, install Php version 5 and Mysql version 5 for Red Hat

Enterprise Linux 4 (CentOS 4). To do this use the script included in the ‘LectopiaServer_v3.8.x.tar.gz’ package:

mkdir /root/php5-install cp <path to script>/install-php5-on-rhel4.sh /root/php5-install cd /root/php5-install

# install dependencies

yum install perl-DBI openssl-devel curl \ libidn libtool-libs

sh ./install-php5-on-rhel4.sh

Run the LectopiaServerFiles RPM installer (as root user).

Note: for Linux Server upgrades, only the LectopiaServerFiles RPM is required. rpm –Uvh LectopiaServerFiles-3-8.x.i386.rpm

You may also wish to run the ‘linux-permissions-update-3.8.sh’ file as the

root user. This file is located in the Lectopia Server installer package. The script will ask you to:

o Confirm the FTP account for use with the Lectopia Server o Confirm if you want to set directory permissions (yes)

Note: if you select ‘yes’ this may take some time depending on how many recordings are in your system.

2.6 Apache Configuration

Edit the following files: Apache 1 - /etc/httpd/sites/ (each file in the directory) - /etc/httpd/httpd.conf Apache 2 - /etc/apache2/sites/ (each file in the directory)


- /etc/apache2/httpd.conf Change all occurrences of “AllowOverride None”, to “AllowOverride All”.

Also in the apache configuration file: Enable Php support if it is not already enabled. To do this on OS X – remove the # from the beginning of the line:

LoadModule php5_module libexec/apache2/libphp5.so

This step is not required on Linux as installing the rpm file enables Php. Restart Apache. Note: this step is very important to enable capture appliance support.

2.7 Lectopia Database Update

Go to the Lectopia Administration Tool: http://<servername>/lectopia_admin/ You will be required to perform the database update(s) 3.x -> 3.8. This completes the Lectopia v3.8 upgrade.

2.8 System Test

It is good practice to test that all aspects of your system are operating correctly following your upgrade. A Server Update/Testing Checklist how-to guide is available for download from the Lectopia Community site.

2.9 System Configuration

Refer to the Lectopia System Configuration documentation for further details about how to configure the Lectopia system and its components.

2.10 UTF-8 Database Upgrade

After installing v3.8 you may wish to convert your Lectopia database to UTF-8 to enable support for foreign languages in Lectopia. Please refer to Appendix A: UTF-8 Database Upgrade.


Section 3 Mac OS X Installation

3.1 Username/Password Scheme

The Lectopia Server requires a number of user accounts for different services – some of these are ‘administrator’ accounts. You should determine a password scheme to assist you with managing these passwords. The following user accounts are required: Mac OS X administrator user – not used by the Lectopia application, but

required to install the Lectopia application components MySQL root user – not used by the Lectopia application, but required to run

MySQL via Terminal and create the Lectopia database MySQL Lectopia application user – used by Lasso Professional Server to

connect to the Lectopia database Lasso Professional Server administrator user – used by the Lectopia

configuration wizard as the default Lectopia Administrator Lectopia FTP user – an account that will be used by the Lectopia application

to transfer files to the Lectopia Server

3.2 System Requirements

Lectopia Server v3.8 requires: Mac OS X Server 10.5.x or Mac OS X 10.6.x X11 Note: Mac OS X Server 10.4.x is not supported for use with Lectopia Server v3.8.5 If you are using this version you will need to upgrade to Mac OS X Server 10.5.x or Mac OS X 10.6.x before you can install Lectopia Server v3.8.5.

Note: If using the SFTP service in Mac OS X 10.6, default sshd configuration file needs to me modified in order to work correctly with Lectopia. This file is located at: /etc/sshd_config And the following setting needs to be modified: #PasswordAuthentication no Should be changed to: PasswordAuthentication yes

3.3 Web Server (Apache) Configuration

3.3.1 Start Web Service

Mac OS X Server Steps Open the Server Admin application


Connect to the local server using the Administrator username and password

Note: if you are running the Server Admin application from a remote computer, ensure the version you are using is compatible with the version of the server.

Enable the Web Service Select the server name and then the Services tab Make sure that the Web service is enabled

Fig 3-1. Enable the Web Service To configure the Web Service: Select the Web service in the localhost list, then the Settings tab Select the Sites tab, then the default site (denoted by a blank ‘Domain

Name’ field and ‘*’ in the ‘Address’ field). Click on the ‘Edit’ button below the Sites window.

Select the General tab and enter an appropriate ‘Administrator email’ Select the Options tab and select “Allow Overrides”


Fig 3-2. Allow Overrides Select the Logging tab to configure the logging options (it is suggested that

you archive the access and error logs at most every 28 days)


Fig 3-3. Setting Logging options Select the modules tab and ensure that the php5 module is enabled

Note: this step is very important to enable capture appliance support.


Fig 3-4. Enable php5 Select ‘Save’ and click on the ‘Editing’ button to return to the list of sites See the Mac OS X Server Admin documentation for further information about

configuring the Apache Web Service Select ‘Start Web’ to start the Web service

Mac OS X Client Steps

Note: please ignore these steps if you are using Mac OS X Server.

Configure the Apache configuration files: Edit the following files:

o Apache 1 - /etc/httpd/httpd.conf o Apache 2 - /etc/apache2/httpd.conf o Find the entry <Directory "/Library/WebServer/Documents">, and

delete 'Indexes' from the line - Options Indexes FollowSymLinks MultiViews

• Save the file

Edit the following files: o Apache 1 - /etc/httpd/httpd.conf o Apache 2 - /etc/apache2/httpd.conf o Change all occurrences of “AllowOverride None”, to “AllowOverride

All”. o Also in the apache configuration file: Enable php support if it is not

already enabled. • To do this – remove the # from the beginning of the line:


LoadModule php5_module libexec/apache2/libphp5.so

Restart Apache

Note: this step is very important to enable capture appliance support. Open the System Preferences application

o Select the Sharing panel o Enable Personal Web Sharing

3.4 MySQL Installation/Configuration

This section introduces the steps for installing and initialising MySQL and creating the Lectopia database on the Lectopia Server itself. The Lectopia Server application can also be configured to connect to the Lectopia database running on a different MySQL server. Note: We have purposely removed specific MySQL Terminal commands as included in earlier versions of this document, as they may differ according to the MySQL version and installation type you are using.

3.4.1 MySQL Install Note: Please check the Lectopia Community site for information about the latest MySQL version compatibility with Lectopia. Download the MySQL v5.1.x package from

http://dev.mysql.com/downloads/mysql/ (last accessed: 20081127) The recommended download is: Mac OS X (package format) downloads “Mac OS X 10.5 (x86)”

Run the MySQL package installer Run the MySQL startup item package installer Start the MySQL service Configure the MySQL root user password Start the MySQL client For more information about how to install and use your MySQL service, please consult the MySQL installation package README.txt file or http://www.mysql.com (last accessed: 20081127).

3.4.2 Database Generation and Population This step is only necessary if you intend to install the Lectopia database on a dedicated database server rather than the Lectopia Server itself. For more information please see Appendix B: Database Generation and Population.

3.5 Install Lasso Professional Server

Lectopia Server v3.8 requires Lasso Professional Server v8.5 (at the time of writing v8.5.5 was verified).


The Lectopia Server also requires X11 as Lasso Professional Server image tag manipulation capabilities are implemented using ImageMagick. Note: X11 is only available on the Mac OS X Client Install DVD (Optional Installs Applications) but it is safe to install on Mac OS X Server.

To perform a clean install of Lasso Professional Server: Download Lasso Professional Server v8.5 for Mac OS X from the LassoSoft

website: http://download.lassosoft.com/pub/Lasso85/ (last accessed: 20081127)

Run the Lasso Professional installer (Easy Install)

A Lasso Professional 8 directory will be created in the Applications directory. The Lasso Initialize web page will be launched automatically - if not, it is possible that a problem has occurred during installation. If this occurs, try starting Lasso in Console mode by running the consoleLassoService.command file located at /Applications/Lasso Professional 8/Tools/.

Open Safari and navigate to http://localhost/ServerAdmin.LassoApp

Initialise Lasso Professional Server Enter the Lasso serial number and the Lasso Server Administrator username and password. Click ‘Submit Information’ once complete.

Figure 3-6. Initialisation page for Lasso Professional Server


• Open Lasso Server Administration Tool An Initialization Complete page will be displayed once this information is validated. Click the ‘Open Server Administration’ button – you will be prompted to enter the Lasso Server Administrator authentication details.

Figure 3-7. Initialisation complete page for Lasso Professional Server Note: You can access the Lasso Server Administration Tool at any time: http://<servername>/ServerAdmin.0.LassoApp


Figure 3-8. Lasso Server Administration Tool

3.6 Install Lectopia Server software

Run the Lectopia Server installer package (‘Lectopia Server Installer v3.8.x.mpkg’).

Choose ‘Customize’. Make sure these options are selected:

o Base Data o Base Auth Tags o Lectopia Database

Note: the software will be installed into the default installation paths: /Applications/Lasso Professional 8 /Library/WebServer/Documents Run the ‘permissions-update-3.8.sh’ file. This file is located in the Lectopia

Server installer package. The script will ask you to: o Confirm the path to the root directory of the Web Service o Confirm the FTP account for use with the Lectopia Server o Confirm if you want to set directory permissions (yes)

3.6.1 Create Default Lectopia Administrator

Go to the Lectopia Administration Tool: http://<servername>/lectopia_admin/ The first time you access the Lectopia Administration Tool you will be redirected to the Configuration Wizard, where you will be prompted to enter the Lasso Server Administrator username and password. Upon entering these details you


will be asked to create the default Lectopia Administrator – the Lasso Server Administrator username and password will be used for this purpose.

3.7 System Test

It is good practice to test that all aspects of your system are operating correctly following your upgrade. A Server Update/Testing Checklist how-to guide is available for download from the Lectopia Community site: http://www.lectopia.com.au/community.lasso



3.9 Upgrade to v3.8.x

There will be occasional updates released for Lectopia Server v3.8. These instructions describe how to apply the latest update to your installation.

1. Go to the Lectopia Community site software releases -

http://www.lectopia.com.au/community.lasso 2. Download and run 'Lectopia Server Installer v3.8.x.mpkg' (where 'x' is the

latest version number). 3. Click on ‘Upgrade’ to run the Easy Install (Note: Base Data, Base Auth

Tags and Lectopia Database should be unselected in the ‘Customize’ menu).

4. Open the Lectopia Administration Tool - http://<servername>/lectopia_admin/ 5. Run the required update(s). You will be required to restart Lasso for each

update.

Note: after Lasso has restarted you may need to refresh the page to bring the Administration Tool back into view.

You may also wish to run the ‘permissions-update-3.8.sh’ file. This file is located in the Lectopia Server installer package. The script will ask you to:

o Confirm the path to the root directory of the Web Service o Confirm the FTP account for use with the Lectopia Server o Confirm if you want to set directory permissions (see note) Note: if you select ‘yes’ this may take some time depending on how many recordings are in your system.


Section 4 Linux Installation

4.1 Username/Password Scheme

The Lectopia Server requires a number of user accounts for different services – some of these are ‘administrator’ accounts. You should determine a password scheme to assist you with managing these passwords. The following user accounts are required: Linux root user – not used by the Lectopia application, but required to install

the Lectopia application components Lasso Professional Server administrator user – used by the Lectopia

configuration wizard as the default Lectopia Administrator Lectopia FTP user – an account that will be used by the Lectopia application

to transfer files to the Lectopia Server

4.2 System Requirements

Lectopia Server v3.8 requires: Red Hat Enterprise Linux 4 (CentOS 4)

4.3 Web Server (Apache) Configuration

In Terminal (as root user), run the following command to ensure that Apache starts after each reboot: /sbin/chkconfig --levels 2345 httpd on Web server configuration occurs automatically during Server installation. For reference, the following file is edited: /etc/httpd/conf/httpd.conf

4.4 Php 5/MySQL 5 Configuration

Lectopia requires Php version 5.1. On a standard install of Redhat EL 4, only Php version 4 is available. To make use of Php version 5 on Redhat EL 4, you must install a Php version 5 rpm file (and it’s dependencies, including MySQL 5) from a source outside of the official package repositories. To make this process easier we have provided a shell script to download and install the required RPM files from the CentOS Plus repository. Cent OS Plus is a set of additional packages designed to work with CentOS 4, which is designed to be binary compatible with Redhat EL 4. This script is included in the server installer file and is called install-php5-on-rhel4.sh. To use the script, copy it to a new directory, change to that directory and run it as the root user: mkdir /root/php5-install


cp <path to script>/install-php5-on-rhel4.sh /root/php5-install cd /root/php5-install # install dependencies yum install perl-DBI openssl-devel curl \

libidn libtool-libs sh ./install-php5-on-rhel4.sh After running this script, both php5 and mysql5 will be installed on the Redhat EL 4 machine. For users with an existing MySQL 4 database, the database will be upgraded in-place and no configuration changes are necessary.

4.4 Java Configuration

If Java is installed in a non-standard location, then Lasso will not be able to load Java. To test for this, start Lasso in console mode. If there is an error/warning message re: libjvm.so, then you will need to symlink all the .so files from the Java JRE lib folder (e.g. /usr/java/jre/lib/i386) to /usr/local/lib.

4.5 MySQL Installation/Configuration

The Lectopia Server application can be configured to connect to the Lectopia database running on the same server or a different MySQL server.

4.5.1 MySQL Install Note: Please check the Lectopia Community site for information about the latest MySQL version compatibility with Lectopia. In Terminal (as root user), run the following command: yum install mysql-server Whilst still in Terminal (as root user), run the following command to ensure that MySQL starts after each reboot: /sbin/chkconfig –-add mysqld /sbin/chkconfig –-levels 5 mysqld on For more information about how to install and use your MySQL service, please consult http://www.mysql.com (last accessed: 20081127).

4.5.2 Database Generation and Population This step is only necessary if you intend to install the Lectopia database on a dedicated database server rather than the Lectopia Server itself. For more information please see Appendix B: Database Generation and Population.

4.6 Install Lasso Professional Server

Lectopia Server v3.8 requires Lasso Professional Server v8.5 (at the time of writing v8.5.5 was verified).


The Lectopia Server also requires X11 as Lasso Professional Server image tag manipulation capabilities are implemented using ImageMagick. Should ImageMagick not be installed on your machine, run the following command in Terminal (as root user): yum install ImageMagick To perform a clean install of Lasso Professional Server: Download Lasso Professional Server v8.5 for Linux from the LassoSoft

website: http://download.lassosoft.com/pub/Lasso85/ (last accessed: 20081127)

Extract to a folder on the Desktop and run the three Lasso Professional

Server RPM installers (as the root user):

rpm –ivh *.rpm

Open http://<servername>/ServerAdmin.LassoApp Enter the Lasso serial number and the Lasso Server Administrator username and password. Click ‘Submit Information’ once complete.

See the remaining steps in section 3.5 Install Lasso Professional Server.

4.7 Install Lectopia Server software

Go to the Lectopia Community site software releases - http://www.lectopia.com.au/community.lasso

Download the ‘LectopiaServer_v3.8.tar.gz’ package Extract to a folder on the Desktop and run all RPM installers (as root user):

rpm –ivh *.rpm

Run the ‘linux-permissions-update-3.8.sh’ file as the root user. This file is

located in the Lectopia Server installer package. The script will ask you to: o Confirm the FTP account for use with the Lectopia Server o Confirm if you want to set directory permissions (yes)

4.7.1 Create Default Lectopia Administrator

Go to the Lectopia Administration Tool: http://<servername>/lectopia_admin/ The first time you access the Lectopia Administration Tool you will be redirected to the Configuration Wizard, where you will be prompted to enter the Lasso Server Administrator username and password. Upon entering these details you will be asked to create the default Lectopia Administrator – the Lasso Server Administrator username and password will be used for this purpose.




4.9 System Test

It is good practice to test that all aspects of your system are operating correctly following your upgrade. A Server Update/Testing Checklist how-to guide is available for download from the Lectopia Community site: http://www.lectopia.com.au/community.lasso

4.10 Upgrade to v3.8.x

There will be occasional updates released for Lectopia Server v3.8. These instructions describe how to apply the latest update to your installation. Go to the Lectopia Community site software releases -

http://www.lectopia.com.au/community.lasso Download the ‘LectopiaServer_v3.8.x.tar.gz’ package (where 'x' is the latest

version number). Install the additional dependencies for Lectoia Server v3.8.5. Lectopia

Server v3.8.5 introduced several additional dependencies, which will need to be installed before upgrading to this server version (or a later version). These additional dependencies are php5 and mysql5. To make this process easier we have provided a script to install the additional dependencies.

This script is included in the server installer file and is called install-php5-on-rhel4.sh. To use the script, copy it to a new directory, change to that directory and run it as the root user: mkdir /root/php5-install cp <path to script>/install-php5-on-rhel4.sh /root/php5-install cd /root/php5-install # install dependencies yum install perl-DBI openssl-devel curl \

libidn libtool-libs sh ./install-php5-on-rhel4.sh After running this script, both php5 and mysql5 will be installed on the Redhat EL 4 machine. For users with an existing MySQL 4 database, the database will be upgraded in-place and no configuration changes are necessary.

Extract to a folder on the Desktop and run the LectopiaServerFiles RPM

installer (as root user). Note: for Linux Server upgrades, only the LectopiaServerFiles RPM is required. rpm –Uvh LectopiaServerFiles-3-8.x.i386.rpm

You may also wish to run the ‘linux-permissions-update-3.8.sh’ file as the

root user. This file is located in the Lectopia Server installer package. The script will ask you to:

o Confirm the FTP account for use with the Lectopia Server


o Confirm if you want to set directory permissions (yes)

Note: if you select ‘yes’ this may take some time depending on how many recordings are in your system.


Appendix A UTF-8 Database Upgrade

After upgrading to v3.8 from v3.7 or older on Mac OS X you may wish to convert your Lectopia Database to UTF-8 to enable support for foreign languages in Lectopia. If your database contains a lot of data this upgrade can take a lot of time. It should be scheduled to run at an appropriate time as it may take several hours to complete and the Lectopia service will be unavailable during this time. Note: A new Mac OS X or Linux installation of Lectopia Server v3.8 automatically includes UTF-8 support. It is recommended that you backup your database prior to performing the upgrade. In particular you should perform a full dump of the Lectopia (‘ilectures’) database (both table schema and data). See the Database Backup and Restore how-to guide on the Community website for further details regarding backing up the Lectopia database (http://www.lectopia.com.au/community.lasso). Note: You may wish to configure an error message to display to users during the upgrade. Refer to the Apache documentation on how to achieve this.

Run UTF-8 Upgrade Package (database on same server)

Note: This section is only relevant when the Lectopia database is installed on the Lectopia server itself. Stop the Lasso Service: Locate /Applications/Lasso Professional 8/Tools/ Run ‘stopLassoService.command’ Run the Lectopia Server UTF-8 Upgrade package – Easy Install (‘Lectopia Server UTF8 Database Upgrade v3.8.x.pkg’). This is located in the Lectopia Server v3.8 installer disk image. Note: This step may take as long as an hour to complete depending on the size of your database. Start the Lasso Service: Locate /Applications/Lasso Professional 8/Tools/ Run ‘startLassoService.command’

Run UTF-8 Upgrade SQL Script (database on separate server)

Note: This section is only relevant when the Lectopia database is installed on a separate server to the Lectopia Server itself.

Stop the Lasso Service: Locate /Applications/Lasso Professional 8/Tools/ Run ‘stopLassoService.command’ Run the upgrade script:


Copy the dbscripts directory from the Lectopia Server v3.8 installer disk image to the root directory (/) on the database server.

• Launch MySQL Client – Note: we recommend using the ‘-v’ option to open

the MySQL Client with verbose messaging (consult your MySQL reference guides for more information e.g. http://www.mysql.com)

• Run database upgrade script (lectopiaDB_utf8.sql):

mysql> source <FullyQualifiedPathToFile>

Note: No spaces are permitted in the path to the script files. Note: This step may take as long as an hour to complete depending on the size of your database. Start the Lasso Service: Locate /Applications/Lasso Professional 8/Tools/ Run ‘startLassoService.command’


Appendix B Database Generation and Population

Note: you should only follow these instructions if you intend to install the Lectopia database on a dedicated database server rather than the Lectopia Server itself. The following user accounts are required: MySQL root user – not used by the Lectopia application, but required to run

MySQL via Terminal and create the Lectopia database MySQL Lectopia application user – used by Lasso Professional Server to

connect to the Lectopia database In the Lectopia Server install package you will find a dbscripts directory that contains SQL scripts for the following purposes: generating the Lectopia database (lectopiaDB_generation.sql) installing the base data (lectopiaDB_basedatainsert.sql) creating a database user (lectopiaDB_useraccesstemplate.sql) converting a Lectopia database to UTF-8 after an upgrade to Lectopia v3.8

from v3.7 or older (lectopiaDB_utf8.sql)

1. Copy the dbscripts directory from the Lectopia Server package to the root directory (/) on the database server.

2. Launch MySQL Client – Note: we recommend using the ‘-v’ option to open

the MySQL Client with verbose messaging (consult your MySQL reference guides for more information e.g. http://www.mysql.com (last accessed: 20081127))

3. Run database generation script (lectopiaDB_generation.sql).

mysql> source <FullyQualifiedPathToFile> 4. Run database default data script (lectopiaDB_basedatainsert.sql).

mysql> source <FullyQualifiedPathToFile> 5. Open the user access template script (lectopiaDB_useraccesstemplate.sql).

Save it as ‘lectopiaDB_useraccess.sql. 6. Now modify the user access script using an appropriate text editor and add

the required password [LectopiaDatabasePassword] for your configuration. You will also need to add the DNS details [LectopiaDatabaseHost].

7. Run database users script (lectopiaDB_useraccess.sql).

mysql> source <FullyQualifiedPathToFile> mysql> quit


Appendix C FTP Service and Configuration

Note: You can configure your Lectopia Server to use FTP or SFTP.

Note: When using the SFTP service on OS X 10.6 the default sshd configuration file needs to me modified in order to work correctly with Lectopia. This file is located at: /etc/sshd_config And the following setting needs to be modified: #PasswordAuthentication no Should be changed to: #PasswordAuthentication yes

Mac OS X Configuration

Start FTP Service

Mac OS X Server Steps Open the Workgroup Manager application Select the Accounts panel

o Select the user “FTP User” that will be used by the Lectopia application to transfer files to the Lectopia Server.

o Update the password for the “FTP User” to your chosen password.

Select the Sharing panel o Create a Share Point to the lectopia_data directory located in the

web directory (usually /Library/WebServer/Documents/lectopia_data/)

o This item will only need to be shared using FTP, i.e. AFP and SMB need not be enabled.

Open the Server Admin application Connect to the local server using the Administrator username and password Configure the FTP Service Select the Settings tab of the ‘FTP’ service Configure the Advanced panel by allowing Authenticated users to see ‘FTP

Root and Share Points’


Figure C-1. Configuring the Advanced panel Select the Logging tab and configure the logging options as desired In the General tab, it is recommended that ’Allow a maximum of

authenticated users’ should be ‘50’ (and anonymous users ‘0’)

Figure C-2. Setting limit of authenticated users See the Server Admin documentation for further information about

configuring the FTP Service. Select ‘Start Service’ to start the FTP service.

Mac OS X Client Steps Open the System Preferences application Select the Accounts panel


o Select the user “FTP User” that will be used by the Lectopia application to transfer files to the Lectopia Server.

o Update the password for the “FTP User” to your chosen password.

• Select the Sharing panel Enable FTP Access

Linux Configuration

Install FTP Server using Package Management Create a user with permissions to write to the following FTP folder:

/usr/share/lectopia/lectopia_data/

Add this path to the system server configuration details in the Lectopia

Administration Tool System servers – ‘list Lectopia Server (system server)

Enable FTP service to run on startup. Enter the following in Terminal (as the root user):

/sbin/chkconfig --levels 2345 vsftpd on


Appendix D Uninstalling the Lectopia Server

The Lectopia Server installation process requires the installation/configuration of MySQL, Lasso Professional Server and the Lectopia server software itself. The steps describe how to uninstall (or undo) all or parts of the Lectopia installation (excluding MySQL).

Uninstalling Lectopia ‘ilectures’ database

Mac OS X instructions To uninstall the Lectopia ‘ilectures’ database: Launch MySQL Client: /usr/local/mysql/bin/mysql -u root -p [will prompt for password] Drop the ‘ilectures’ database: mysql> drop database ilectures;

Linux instructions

To uninstall the Lectopia ‘ilectures’ database: Launch MySQL Client: mysql -u root -p [will prompt for password] Drop the ‘ilectures’ database: mysql> drop database ilectures;

Uninstalling Lasso Professional Server

Mac OS X instructions

To uninstall Lasso Professional Server: Stop the Lasso Service Locate /Applications/Lasso Professional 8/Tools/ Run ‘stopLassoService.command’ Archive (or delete) the Lasso Professional Server files and directories /Applications/Lasso Professional 8 /Library/StartupItems/LassoPro8 /Library/Receipts/Lasso_Pro_8_Apache.pkg /Library/Receipts/Lasso_Pro_8_Docs.pkg /Library/Receipts/Lasso_Pro_8.pkg


To uninstall the Lectopia software: Archive (or delete) the Lectopia software directories /Library/WebServer/Documents/ess /Library/WebServer/Documents/lectopia /Library/WebServer/Documents/lectopia_admin /Library/WebServer/Documents/lectopia_api /Library/WebServer/Documents/lectopia_plugins /Library/Receipts/Lectopia-Server* You may also choose to archive (or delete) the following directory, however if you are upgrading from a previous version please keep in mind that this directory contains recording data and related media relevant to your previous install. /Library/WebServer/Documents/lectopia_data

Linux instructions

To uninstall Lasso Professional Server: Note: As the Lectopia software is dependant on Lass, uninstalling Lasso Professional Server will also uninstall the Lectopia software. Uninstall all three packages through the RPM: rpm –e Lasso-Apache2Connector Lasso-Documentation Lasso-Service

To uninstall the Lectopia software: Uninstall all four packages through the RPM (no line break): rpm –e LectopiaServerTemplates LectopiaServerCustomAuthTags LectopiaServerFiles LectopiaServerDatabase You may also choose to archive (or delete) the following directory, however if you are upgrading from a previous version of v3.8.x please keep in mind that this directory contains recording data and related media relevant to your previous install. /usr/share/lectopia/lectopia_data