Server Installation/Upgrade Guide

Transcription

1 Server Installation/Upgrade Guide System Version Echo 360, Inc.

2 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).

3 Contents Introduction Installer Contents Software Updates and Technical Notes...4 Upgrading from v3.7 or older Perform Backup Upgrade MySQL (if required) Install Lectopia software Apache Configuration Lectopia Database Update System Test System Configuration UTF-8 Database Upgrade...7 Mac OS X Installation Username/Password Scheme System Requirements Web Server (Apache) Configuration MySQL Installation/Configuration Install Lasso Professional Server Install Lectopia Server software System Test System Configuration Upgrade to v3.8.x...17 Linux Installation Username/Password Scheme System Requirements Web Server (Apache) Configuration Java Configuration MySQL Installation/Configuration Install Lasso Professional Server Install Lectopia Server software System Test System Configuration 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 Uninstalling the Lectopia Server...29 Uninstalling Lectopia ilectures database...29 Uninstalling Lasso Professional Server...29 Server Installation/Upgrade Guide System Version 3.8 LSV Author: Michael Fardon Editor: Kate Goodwin, Damyon Wiese, Darren Matchett Last Modified: 7-Oct-09 Page 3 of 30

4 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 v 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. Server Installation/Upgrade Guide Page 4 of 30

5 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 v 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 ( 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 (last accessed: ) 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 (last accessed: ). 2.3 Upgrade OS X (if required) Note: OS X 10.4.x is not supported for use with Lectopia Server v 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 v 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 ( 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: Server Installation/Upgrade Guide Page 5 of 30

6 /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 - 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) Server Installation/Upgrade Guide Page 6 of 30

7 - /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: 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 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. Server Installation/Upgrade Guide Page 7 of 30

8 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 v 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 Start Web Service Mac OS X Server Steps Open the Server Admin application Server Installation/Upgrade Guide Page 8 of 30

9 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 Select the Options tab and select Allow Overrides Server Installation/Upgrade Guide Page 9 of 30

10 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) Server Installation/Upgrade Guide Page 10 of 30

11 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. Server Installation/Upgrade Guide Page 11 of 30

12 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: Server Installation/Upgrade Guide Page 12 of 30

13 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 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 (last accessed: ) 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 (last accessed: ) 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). Server Installation/Upgrade Guide Page 13 of 30

14 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: (last accessed: ) 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 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 Server Installation/Upgrade Guide Page 14 of 30

15 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: Server Installation/Upgrade Guide Page 15 of 30

16 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) Create Default Lectopia Administrator Go to the Lectopia Administration Tool: 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 Server Installation/Upgrade Guide Page 16 of 30

17 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: System Configuration Refer to the Lectopia System Configuration documentation for further details about how to configure the Lectopia system and its components. 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 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 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. Server Installation/Upgrade Guide Page 17 of 30

18 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-onrhel4.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 Server Installation/Upgrade Guide Page 18 of 30

19 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 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 (last accessed: ) 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). Server Installation/Upgrade Guide Page 19 of 30

20 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: (last accessed: ) Extract to a folder on the Desktop and run the three Lasso Professional Server RPM installers (as the root user): rpm ivh *.rpm Open 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 - 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) Create Default Lectopia Administrator Go to the Lectopia Administration Tool: 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.8 System Configuration Refer to the Lectopia System Configuration documentation for further details about how to configure the Lectopia system and its components. Server Installation/Upgrade Guide Page 20 of 30

21 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: 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 - Download the LectopiaServer_v3.8.x.tar.gz package (where 'x' is the latest version number). Install the additional dependencies for Lectoia Server v 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-onrhel4.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 Server Installation/Upgrade Guide Page 21 of 30

22 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. Server Installation/Upgrade Guide Page 22 of 30

23 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 ( 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: Server Installation/Upgrade Guide Page 23 of 30

24 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. 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 Server Installation/Upgrade Guide Page 24 of 30

25 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. (last accessed: )) 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 Server Installation/Upgrade Guide Page 25 of 30

26 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 Server Installation/Upgrade Guide Page 26 of 30

27 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 Server Installation/Upgrade Guide Page 27 of 30

28 o o Select the user FTP User that will be used by the Lectopia application to transfer files to the Lectopia Server. 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 Server Installation/Upgrade Guide Page 28 of 30

29 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 Server Installation/Upgrade Guide Page 29 of 30

30 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 Server Installation/Upgrade Guide Page 30 of 30