2015 TIMETABLE ADMINISTRATOR S MANUAL Software Version 5.0 BY GEOFFPARTRIDGE.NET
TABLE OF CONTENTS TOPIC PAGE 1) INTRODUCTION 1 2) TIMETABLE SPECIFICATIONS 1 3) SOFTWARE REQUIRED 1 a. Intranet Server (XAMPP Server) 1 b. Web Sever 1 4) COMPATIBILE INTERNET BROWSERS 1 5) TIMETABLE INSTALLATION PROCESS 2 a. Intranet Server Setup 2 i. Install XAMPP Software 2 ii. Setting Up The Timetable Database 3 iii. Install and Configure Timetable Software 5 iv. Installing the XAMPP Patches 5 v. Testing Timetable Program and changing ICTADMIN account 6 b. Internet Server Setup 7 i. Setting Up the Timetable Database 7 ii. Install and Configure Timetable Software 8 iii. Testing Software 9 Administration Support 9 Page i
1) INTRODUCTION This manual outlines the setup instructions the timetable program for an intranet or internet server. The timetable program is only designed to be run on a web server, using a web browser to access the program. The downloaded Timetable V5.0 package should include the following folders: Manual, timetable, XAMPP V1.7.3, XAMPP Patches and Teamviewer. These folders contain all the software programs and files you require, so you can install the timetable program on an Intranet or Internet server. We assume that the person installing this software has IT and networking experience and understands the install processes outlined below. 2) TIMETABLE SPECIFICATIONS The timetable program is a web based program that runs of a MYSQL server and is not shared with other users outside of your organisation. The timetable program can be accessed using all versions of Windows, MAC or Linux operating systems, including access with handheld devices. 3) SOFTWARE REQUIRED a. Intranet Server (XAMPP Server) XAMPP version 1.7.3 and ensure it has the following: MYSQL; and phpmyadmin Software provided in Timetable V5.0 folder Mozzila Firefox or Google Chrome internet browser (or Safari for Apple devices) b. Web Sever CPanel or Parallels Plesk Panel and ensure it has the following: MYSQL; and phpmyadmin FileZilla FTP Client program (Used to upload files into your web domain account) Mozzila Firefox or Google Chrome internet browser (or Safari for Apple devices) To understand how to install and use the above software, you can view these tutorial videos below: (Just copy and paste URL into your internet browser to view) XAMPP: MYSQL: PLESK Database FileZiller FTP Client: https://www.youtube.com/watch?v=csn34q47bxy http://www.cpanel.net/media/tutorials/addmysql.htm https://www.youtube.com/watch?v=ge77l0qrynu https://www.youtube.com/watch?v=yr_u2ikfat0 4) COMPATIBILE INTERNET BROWSERS Browser Compatibility Notes Avant Browser Yes Comodo Dragon Yes Flock No Google Chrome Yes Recommended Maxthron Cloud Yes Microsoft Internet Explorer No Graphic issues Mozilla Firefox Yes Recommended Netscape No Opera No Safari (Apple Browser) Yes Recommended Sea Monkey Yes IT Department Timetable (V5.0) Administrator Manual Page 1 of 9
5) TIMETABLE INSTALLATION PROCESS a. Intranet Server Setup XAMPP is an intranet web server application program, which allows you to run any web software on your servers. We have found the timetable program works best using XAMPP version 1.7.3 full or lite. i. Install XAMPP Software 1. Within the folder marked XAMPP V1.7.3 you will find either the full or the lite versions of XAMPP. If you are not running an email server, just install the XAMPP lite version. If your using Microsoft Windows 7 or above operating system on the computer you are installing XAMPP on, you will need to do the following: a) Right click on the XAMPP program icon and select properties b) Click the Compatibility tab c) Tick t the Run this program in compatibility mode box d) Select Windows XP (service pack 3) in the drop down box e) Tick Run this program as an administrator box f) Click Apply and than Ok g) Double click on the program icon to install XAMPP program 2. You need to ensure that you install XAMMP in the main directory of your computer s operating system. On Microsoft Windows, this directory is allocated the directory drive name C: IT Department Timetable (V5.0) Administrator Manual Page 2 of 9
3. Once the program has finished installing, a black screen will appear, asking if it should install program shortcuts on your computer s desktop screen. Select based on your own preference. 4. Next it will ask if you want to make a portable drive, select n and press Enter to continue. Once finished, it will prompt you to press return, so press Enter to continue. 5. On the screen that appears next which is describing the process of installing php.ini and my.ini files on your computer, press Enter to continue. 6. On the next screen, type X and press Enter. 7. Go to the program directory (Start menu for windows) and find the folder called XAMPP for Windows, open it and double click on XAMPP Control Panel icon to start XAMPP. 8. Tick both Svc boxes for Apache and MySql and than click the Start button for both modules. Both modules Admin icon should turn green like in the image below. If the Apache Admin does not turn green, it is because the allocated port for your Apache program is being used by another program or it is being blocked by your firewall. You can find videos on Youtube that show you how to correct this problem. For firewall issues, just change the settings for Apache, MySql and XAMPP to allow in your firewall settings and this should fix the problem. ii. Setting Up The Timetable Database 1. With the XAMPP program running like in the above image, click on the Apache Admin button and your web browser should open to XAMPP s language select screen. Select your language preference. You should be redirected to the XAMPP dashboard screen. 2. Click on the Security link and another browser tab will open. Click on the link that reads http://localhost/security/xamppsecurity.php IT Department Timetable (V5.0) Administrator Manual Page 3 of 9
3. Here you will create a password for your MySql program in the section called MYSQL SECTION: "ROOT" PASSWORD. a) Set your password and record this information down (as you will require it latter for the timetable s config.php file settings) b) Tick the http box c) Tick the (File: C:\xampplite\security\mysqlrootpasswd.txt) and d) Click on Password Changing If you wish to secure your XAMPP security information for the above, than you will need to create a username and password for the XAMPP DIRECTORY PROTECTION (.htaccess) section. 4. Now close the security browser tab and return to the main XAMPP dashboard screen. 5. Click on the link called phpmyadmin. You will be required to enter in a username and password. The username is root and the password is what you typed above in point 3 above. 6. Now you should be in the phpmyadmin dashboard screen. Under the section called MySQL localhost, you will need to create your timetable database. In the box below called Create a new database, type the word timetable and click on the Create button (like the below image). 7. Now you will be redirected to your timetable database dashboard screen. a) Click on the Import tab and the upload file box will open. b) In the section called File to import, click on browse button c) Go to the Timetable V5.0 folder and open it d) Open the timetable folder and then the SQL File folder e) Select the file within the MYSQL File folder called timetable and than click Open f) Now you will be returned to the timetable database dashboard screen g) In the first section called File to Import, you should see the following screen h) Click on the Go button and your timetable database should be successfully installed like in this: IT Department Timetable (V5.0) Administrator Manual Page 4 of 9
iii. Install and Configure Timetable Software 1. Go to the Timetable V5.0 folder and copy the timetable folder. 2. Go to the directory where you installed the XAMPP program and open the folder. 3. Locate the folder called htdocs and open it 4. Paste the timetable folder you copied before into this folder 5. Once all timetable files have been copied, open the timetable folder and locate the config.php file, right click on the file icon, select Open With and select Notepad to open the file, like in the image below: 6. Add the following information below in red, save and exit Notepad: a) define('db_name', 'timetable'); b) define('db_user', 'root'); c) define('db_password', ' database password); d) define('db_host', 'localhost'); (The database password is the one you created on page 4, section 3 above.) iv. Installing the XAMPP Patches The purpose of these patches is to correct problems that were identified when trying to open or save completed timetables for Classes, Trainers and Facilities in PDF format, when you clicked on the Save as PDF button under the Build View Timetable section of the timetable program. 1. Go to the Timetable V5.0 folder and open it. 2. Open the XAMPP Patches folder and copy the apache and php folders. 3. Go to the directory where you installed the XAMPP program and open the folder. 4. Paste the apache and php folders into this XAMPP folder. When prompted to replace files or folders, click yes. v. Testing Timetable Program and changing ICTADMIN account IT Department Timetable (V5.0) Administrator Manual Page 5 of 9
1. Open up your web browser and type http://localhost/timetable/ into the URL address bar 2. You should get the below login screen: 3. Type in the default username ADMINICT and the password adminabc123 and than click Login 4. You should be redirected to the main timetable program dashboard screen, as you can see in the image below. If you are not redirected to the dashboard screen, than there is an error with your database username and password settings that you will need to investigate. 5. Once you have successfully logged in to the timetable programme, you will need to change your default administrator password as follows: a) Click on the Admin Area tab b) In the drop down menu click on Setup Users c) In the User Setup screen, click on the + Add button d) Type in your new User ID, your name and select Administrator in the drop down menu e) Do not delete the default user yet, but click on the logout button at the top right hand corner of the browser screen. f) Once you return to the login screen, type in your new username and password and login. g) If successful, than delete the default admin user credentials in the setup user s screen, by clicking on the user so it is highlighted and than click the Remove button. Do not remove the STAFF, STUDENT or ICTSUPPORT user accounts, or staff and students cannot login to check their completed timetables and if you have issues, we cannot login to the timetable programme to assist you later, especially if you accidentally delete your ADMIN account. b. Internet Server Setup IT Department Timetable (V5.0) Administrator Manual Page 6 of 9
To complete this process, you will need to have full access (username and password) to your web domain CPanel or PLESKS control panel. If not, you will have to request this from your domain hosting provider or ask them to setup the timetable program on your behalf. To upload the timetable program into your web server, so you can access it online through the internet, you will require a FTTP upload program. The best one is FileZilla FTP Client, which you can download here: https://filezilla project.org/download.php?type=client i. Setting Up the Timetable Database 1. Login to your website control panel and locate the section for Databases 2. First you will need to create a new database for your timetable program by calling it timetable. 3. You will also need to create an admin username and password (required for the timetable program config.php file later) 4. Most web domain control panels have training videos that explain in a step by step process on Youtube, how to setup your databases. For a CPanel, they use a MySQL Database, which I have included a link above on page 1. All you need to know is the control panel brand used by your domain hosting company, so you can find the instructional video on Youtube. 5. Once you have completed steps 1 to 3 above, you need to go back to the main control panel dashboard screen and under the section for Databases, locate your new database. In CPanel, this is called myphpadmin. Find this icon and click on it. 6. Now you should be in the phpmyadmin dashboard screen. Under the section called MySQL localhost, you will need to create your timetable database. In the box below Create a new database, type the word timetable and click the Create button (like you see in the screen below) 7. Now you will be redirected to the timetable database dashboard screen. a) Click on the Import tab and the upload file box will open. b) In the section called File to import, click on browse button c) Go to the Timetable V5.0 folder and open it d) Open the timetable folder and then the SQL File folder e) Select the file within the MYSQL File folder called timetable and than click Open f) Now you will be returned to the timetable database dashboard screen g) In the first section called File to Import, you should see the following screen IT Department Timetable (V5.0) Administrator Manual Page 7 of 9
8. Click on the Go button and your timetable database should be successfully installed like in this image: ii. Install and Configure Timetable Software 1. Once you have setup your timetable database, go to the Timetable V5.0 folder, open the timetable folder and locate the config.php file. Right click on the file icon, select Open With and select Notepad to open the file, like in this image below: 2. Type in the following details below, save and exit Notepad: e) define('db_name', 'dbname_timetable'); f) define('db_user', 'dbname_user'); g) define('db_password', 'use your timetable database password here); h) define('db_host', 'localhost'); (Database password you created on page 7 section i above.) 3. Using your FileZilla FTP Client program, you will need to login into your website domain. 4. Identify your public_html folder and click on it. The public_html folder, is the folder where your website files are stored. 5. In the Timetable V5.0 folder, select the timetable folder, than drag and drop the timetable folder into your public_html folder. IT Department Timetable (V5.0) Administrator Manual Page 8 of 9
iii. Testing Software 1. Once you have uploaded all the timetable files into your web server, you can now test the timetable program by typing www.mydomainname.com/timteable into your web browser s URL address bar. You should be redirected to the timetable program login screen. 2. Once you have successfully logged in to the timetable programme, you will need to change your default administrator password as follows: a) Click on the Admin Area tab b) In the drop down bar, click on Setup Users c) In the User Setup screen, click on the + Add button d) Type in your new Admin user ID name, your name and select Administrator in the drop down box. e) Do not delete the default user yet, but click on the logout button at the top right hand corner of the screen. f) Once you return to the login screen, type in your new username and password and login. g) If successful, than delete the default admin user credentials from the setup users screen by clicking on the user so it is highlighted and click the Remove button. Do not remove the STAFF, STUDENT or ICTSUPPORT user accounts, or staff and students cannot login to check their completed timetables and if you have issues, we cannot login to the timetable programme to assist you later, especially if you accidentally delete your ADMIN account. 6) Administration Support If you have any issues with the program install process or using the timetable program, please do not hesitate to contact us at support@geoffpartridge.net for assistance. You can also view our timetable program training videos and other documents from www.geoffpartridge.net END OF DOCUMENT IT Department Timetable (V5.0) Administrator Manual Page 9 of 9