My Monitor Installation Guide

Transcription

1

2 My Monitor Installation Guide Copyright 2008, Monitor Business Machines The software contains proprietary information of Monitor Business Machines Ltd. It is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Monitor Business Machines Ltd. All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Monitor Business Machines Ltd. Level Grafton Road, Auckland, NEW ZEALAND This manual was created: Wednesday, 16 January 2008 The Monitor Logo and Supervisor are registered trademarks of Monitor Business Machines Ltd. Any other products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks.

3 Contents Introduction Product Overview System Requirements Typographical Conventions Site Security Assumptions Made Windows 2000 Server Windows 2003 Server Installing.Net Framework Net 2.0 Installation Procedure... 4 Installing and Configuring SQL Express Installing SQL Express... 6 Installing SQL Express Management... Studio 8 Creating the Real-Time Export... Database 9 Open the Real-Time Export Setup... Log File 11 Enable Local and Remote SQL... Connections 13 Connecting Supervisor Net to the Real-Time Export Database 17 Creating an ODBC DSN for the... Real-Time Export Database 17 Making the Connection Testing the Connection Installing Supervisor SOAP Server 29 Install Supervisor SOAP Server Check the SOAP Server is Running Open the SOAP Server Log File Installing and Configuring PHP 33 PHP Installation Procedure... Configuring PHP for IIS-6... Enabling ... Enabling PHP Error Logging... Restarting Web Services... Required PHP Ini File Settings... IonCube Loader... Installing the My Monitor Web Site Installing the My Monitor Web... Site Files Raise the IUSR Account's Database... Permissions Upgrade the Real-Time Export... Database Check the WebConfig table... Lower the IUSR Account's Database... Permissions Open the User Login Page Index Contents i

4

5 Introduction Product Overview My Monitor provides a web-based interface to Supervisor Net accounts. The web site user, either a parent or student, can use the site to monitor and manage Supervisor Net accounts. The site offers the following facilities: See the balance of all accounts belonging to one or more associated Supervisor Net users. Add money to accounts using a secure credit card payment system. Transfer money between accounts. Generate detail and summary reports. Receive reports automatically on a daily, weekly, or monthly basis. Lock and unlock accounts Users can change their own PIN number in the event of losing their card System Requirements Supervisor Net 4.2 or later with a WPY license. IIS Web Server 5.1 or 6.0. PHP or later. Supervisor SOAP Server 1.3 on the Supervisor Net machine or on another server. SMTP (Mail) Server on the Supervisor Net machine or on another server. Real-Time Export Database running on SQL Server (not Access MDB). ODBC driver for SQL Server. Note: 64-bit Windows is not supported for the web server operating system because PHP is not currently available on this platform. Typographical Conventions Before you start using this guide, it is important to understand the terms and typographical conventions used in the documentation. The following kinds of formatting in the text identify special information. Formatting convention Type of Information Special Bold Items you must select, such as menu options, command buttons, or items in a list. Emphasis Use to emphasize the importance of a point or for variable expressions such as parameters. CAPITALS Names of keys on the keyboard. for example, ENTER, DELETE, or END. Introduction 1

6 Site Security Monitor strongly recommends that My Monitor is only used on a secure web server. If it is used on an unsecured server your users address, password, and all the text shown on the pages is sent between the client browser and web server in clear text. This could be intercepted by malicious users monitoring the network. Using a secure server ensures that your users details are not compromised. An unsecured site uses the HTTP protocol, while a secured site uses HTTPS and all communication between the browser and server is encrypted. In order to set up a secure server, you must purchase and install a SSL certificate from a licensing company like Thawte ( or Verisign ( These companies offer a range of SSL products, with pricing depending on the security level and duration of the license. Monitor also recommends that you pay close attention to the configuration of your web server and PHP to ensure that the site is not vulnerable to attacks. 2 Introduction

7 Assumptions Made Windows 2000 Server Supervisor Net is installed and working correctly with a spare WPY (Supervisor Webpay) license. IIS5 is installed as the default web server on Port 80 and working correctly. PHP is not installed. If PHP is installed and is not in the directory C:\PHP, and your IIS document root directory is not C:\inetpub\wwwroot you will have to modify the paths shown in Installing and Configuring PHP to match your settings. Windows 2003 Server Supervisor Net is installed and working correctly with a spare WPY (Supervisor Webpay) license. IIS6 is installed as the default web server on Port 80 and working correctly. PHP is not installed. If PHP is installed and is not in the directory C:\PHP, and your IIS document root directory is not C:\inetpub\wwwroot you will have to modify the paths shown in Installing and Configuring PHP to match your settings. Assumptions Made 3

8 Installing.Net Framework 2.0.Net 2.0 Installation Procedure Installation is Required Check to see if you already have the.net Framework 2.0 package installed on your target system. If you do not, then follow the procedure below. 1. Run the.net 2.0 installation program. At the Welcome dialog click Next to continue. 2. Accept the Licence Agreement. Click Install to continue. 4 Installing.Net Framework 2.0

9 3. The installation begins. 4. When the Setup Complete dialog displays, click Finish to continue. 5. This completes the.net Framework 2.0 installation. Installing.Net Framework 2.0 5

10 Installing and Configuring SQL Express 2005 Installing SQL Express This section describes installing SQL Express on a Windows 2003 Standard Edition server. Installation Procedure 1. Run the SQLExpress installation program. This program is called SQLEXPR.EXE. 2. Proceed through the installation until you arrive at the following system check screen. 3. Confirm that all of the system configuration checks are successful. If any check fails: click the Report button to get more detail then stop the installation and fix the problem. 4. If the all of the system configuration checks are successful, Click Next to continue. 5. The installation begins. 6. Enter the Name and Company. Click Next to continue. Microsoft defines Name as being the person responsible for administering the server. 6 Installing and Configuring SQL Express 2005

11 7. In the Feature Selection dialog: click Connectivity Components button (marked with an X), this will display a menu. 8. Click the Will be installed on local hard drive option. 9. Select the Windows Authentication Mode. Click Next to continue. Installing and Configuring SQL Express

12 10.Click Next to continue. 11.SQL Express is now ready to install. Click Install to continue and proceed through the screens that follow. 12.Press Finish to end the installation process. The next step is to install the Microsoft SQL Server Management Studio tool. Please follow the instructions in the next section. Installing SQL Express Management Studio Microsoft SQL Server Express has a graphical user interface called Microsoft SQL Server Management Studio Express. This tool is installed by running a program called SQLServer2005_SSMSEE.msi. You should download this file and install it because it is required for the My Monitor Web Site Installation. 8 Installing and Configuring SQL Express 2005

13 Installation Procedure 1. Run SQLServer2005_SSMSEE.msi. There are no special options to choose during the installation process, so follow the instructions down the bottom of each screen until you arrive at the end. 2. Click Finish to end the installation process. Creating the Real-Time Export Database Supervisor Net includes a set of batch files to install, backup and restore the Real-Time Export Database. Typically these batch files are stored in the following directory: C:\Program Files\Monitor Business Machines\Supervisor\RealTimeExport Create the Real-Time Export Database 1. Open windows explorer and browse to the C:\Program Files\Monitor Business Machines\Supervisor\RealTimeExport folder: Installing and Configuring SQL Express

14 2. Double-click the item 'SetupDB.bat' 3. You are asked to allow My Monitor access to the database. Type y and press the ENTER key to continue 10 Installing and Configuring SQL Express 2005

15 4. When the script has completed, you should see phrases like "The Real-Time Export Database is setup" and "My Monitor is granted access to the database" at the bottom of the command window. 5. If the Real-Time Export database is set up, go to the Enable Local and Remote SQL Connections section. If the setup script fails you will see the phrase "The Real-Time Export Database setup failed" at the bottom of the command window. When this happens, follow the instructions in the next section. Open the Real-Time Export Setup Log File When the you run SetupDB script, it creates a log file called SetupRTEDatabase.log. This is a text file that is useful for troubleshooting if there are problems creating the Real-Time export database If your Real-Time export database was created successfully you can skip this section. Opening the Real-Time Export Database Setup Log File 1. Open Windows Explorer Installing and Configuring SQL Express

16 2. Browse to the C:\Program Files\Monitor Business Machines\Supervisor\RealTimeExport folder. Note that your RealTimeExport folder may be in a different directory depending on where you installed Supervisor Net. 12 Installing and Configuring SQL Express 2005

17 3. Open the SetupRTEDatabase.log file with Notepad. The log file for a successful installation will look something like this: 4. Browse the contents of the log file. 5. Close Notepad when you have finished looking at the log file. 6. Close Windows Explorer. Enable Local and Remote SQL Connections You must configure SQL Express to operate with local and remote TCP/IP access. To enable remote access, follow this procedure. Enable Remote Access to SQL Server 1. Click the Start button on your Windows taskbar. 2. Click the All Programs menu item. 3. Open the Surface Area Tool by clicking the Microsoft SQL Server 2005 Configuration Tools SQL Server Surface Area Configuration item. This opens the SQL Server Surface Area Configuration tool. Installing and Configuring SQL Express

18 4. Click on Surface Area Configuration for Services and Connections link. 5. Select the Remote Connections item 14 Installing and Configuring SQL Express 2005

19 6. Select Local and Remote Connections option and select Using TCP/IP only. Click the Apply button to continue. 7. Click OK to close the alert message. Installing and Configuring SQL Express

20 8. Click the Service item in the Surface Area Configuration window. 9. Click the Stop button and wait for SQL Server to shut down. 10.Click the Start button and wait for SQL Server to start running again. 11.Close the Surface Area Configuration window. Now SQL Server will accept local and remote TCP/IP connections. Now you are ready to connect Supervisor Net to the Real-Time Export database. 16 Installing and Configuring SQL Express 2005

21 Connecting Supervisor Net to the Real-Time Export Database Creating an ODBC DSN for the Real-Time Export Database My Monitor and Supervisor Net use ODBC to connect to the SQL Server database. You must set up a DSN by following the procedure below. If you already have an existing DSN skip to the next section on Connecting Supervisor Net to the ODBC DSN. ODBC DSN Setup Procedure 1. Open the Data Sources (ODBC) application in the Administrative Tools menu. 2. Select the System DSN tab. 3. Click the Add button. 4. Select SQL Native Client from the list of drivers and click Finish. This displays the SQL Native Client window. 5. Enter a name for the DSN, we recommend using rtesqlsvr. 6. Enter a description, such as Supervisor Net Real-Time Export. Connecting Supervisor Net to the Real-Time Export Database 17

22 7. Select your SQL Server instance name from the Server drop-down list. Click Next to continue. 8. Use the default settings for the authentication dialog (Integrated Windows authentication). Click Next to continue. 18 Connecting Supervisor Net to the Real-Time Export Database

23 9. Tick Change the default database to and pick supervisornet from the drop-down list. Click Next to continue. 10.Use the defaults for this dialog. Click Finish to continue, this opens the Test Data Source dialog box. Connecting Supervisor Net to the Real-Time Export Database 19

24 11.Check the connection by clicking Test Data Source. 12.If the test was successful, click OK an close the data sources window, otherwise review your settings. Your ODBC DSN is set up. 20 Connecting Supervisor Net to the Real-Time Export Database

25 Making the Connection To connect Supervisor Net to the RTE database you must set Real-Time ODBC Export string using Supervisor Net Administrator. This section explains how to do this step-by-step. Set up the RealTime Export Connection String DSN Connection Procedure 1. Open Supervisor Net Administrator. 2. Select the Configuration menu. Then select the Server Settings option. 3. Click on the Core Server Settings tab. Connecting Supervisor Net to the Real-Time Export Database 21

26 4. Click the Select DSN button near the bottom-right corner of the window, this will display a menu of DSN names. 5. Click the rtesqlsvr DSN item. If you are using a different DSN, you must pick the DSN you want to use. 6. Click the Save button to close the Server Settings form. Now you have restart Supervisor Net, so the Database server picks up its new settings. 7. Click the Tools menu. 22 Connecting Supervisor Net to the Real-Time Export Database

27 8. Select the Restart Services option. 9. Wait for Supervisor Net to restart. 10.Open the Supervisor Service Centre and confirm all of the services are running. 11.Close the Supervisor Service Centre. 12.Close Administrator Connecting Supervisor Net to the Real-Time Export Database 23

28 The Real-Time ODBC Export Connection is configured. Now you should test the connection by following the instructions in the next section. Testing the Connection You can test the connection by creating an add value transaction in a test account, opening the RTE database and checking to see that the transaction has been created. Testing the Supervisor Net Real-Time Export Database Connection 1. Open Supervisor Net Administrator. 2. Select the File Primary option to open the Primary Database form. 3. Select the 007 Technician Account Record. 24 Connecting Supervisor Net to the Real-Time Export Database

29 4. Click the Add Value button. 5. Enter 10 in the Amount field 6. Click the Save button. 7. Confirm 007's account balance has increased by $ Close Administrator. The next step is to query the Real-Time export database and confirm the transaction was added. 9. Click the Start button on your Windows taskbar. Connecting Supervisor Net to the Real-Time Export Database 25

30 10.Click the All Programs menu item. 11.Click the Microsoft SQL Server 2005 item. 12.Click the Microsoft SQL Server Management Studio Express option. 13.Wait for the SQL Server Management Studio tool to open. 14.Click Connect to open the SQL Server Management Studio's main window. 15.Click the New Query button in the menu bar, this will open a new query tab. 26 Connecting Supervisor Net to the Real-Time Export Database

31 16.Select supervisornet in the combo box (next to the Execute button). 17.Type in the following text in the query window: select where rtedatetime, primarynumber, primarynumber='007' transactionprice from Connecting Supervisor Net to the Real-Time Export Database rtetable 27

32 18.Click the Execute button in the toolbar. This will run the query for all transactions for the 007 account. You should see a Results pane looking something like this one. You can see the $10 added in the transactionprice column. 19.This confirms the Supervisor Net ODBC connection is working. Close the SQL Server Management Studio window. 20.Click the No button. The next step is to install the Supervisor SOAP server on your computer. 28 Connecting Supervisor Net to the Real-Time Export Database

33 Installing Supervisor SOAP Server Install Supervisor SOAP Server My Monitor uses Supervisor SOAP Server to communicate with Supervisor Net. This section explains how to install SOAP server on your computer. To use My Monitor you must install SOAP Server 1.3 or later How to Install Supervisor SOAP Server 1. Shut down all of your applications. 2. Run SOAPServer_setup.exe, this will start the SOAP server installation program. 3. There are no options that require your further attention, so simply choose the default option on each page. 4. Click the Finish button to close the installation package. The Supervisor SOAP Server is installed. The next step is to check the SOAP Server is running. Go to the next section and follow the instructions. Check the SOAP Server is Running Checking Supervisor SOAP Server is Running 1. Click the Start button on your Windows taskbar. 2. Click the All Programs menu item. 3. Click the Monitor Business Machines item. 4. Click the Supervisor Net SOAP Server Item. Installing Supervisor SOAP Server 29

34 5. Select the SOAP Server Manager item. This opens the Soap Server Manager window. 6. Check the Server Status text, it should say "Running" in green. If this is the case, the SOAP server is up and running. 7. Close the SOAP Server manager window. If the SOAP Server is running then go to the section on Installing and Configuring PHP. However, if the Server Status says "Stopped" try clicking the Start button. But if that doesn't work, follow the instructions in the next section. Open the SOAP Server Log File If you have problems running Supervisor SOAP Server, the first place to look is the log file. This will give you clues about what is going wrong. Opening the SOAP Server Log File To begin with you must find out where the log files are stored on your system - follow these steps to find out. 1. Click the Start button on your Windows taskbar. 2. Click the All Programs menu item. 3. Select the Monitor Business Machines Supervisor Net SOAP Server Soap Server Manager option from the All Programs menu. This opens the SOAP Server Manager. 4. Click the Configuration button in the SOAP Server Manager window. This displays the configuration details in the window. 5. Look for the Logging section and click on the Log File name edit box. 30 Installing Supervisor SOAP Server

35 Here you can see the SOAP Server's log files are stored in the C:\Program Files\Monitor Business Machines\MBMSOAPServer directory. This may be different on your computer. 6. Click on the Log File edit box. 7. Push the End key on your keyboard, this makes the end of the log file name visible. In this case the SOAP Server Log file names begin with SVNetSOAPServer. The log file names may begin with something different on your system. Now you have found out where the log files are stored and what they are called. 8. Close the SOAP Server Manager window. Installing Supervisor SOAP Server 31

36 9. Open Windows Explorer. Browse to where the SOAP Server log files are stored. In this example, the log file directory is C:\Program Files\Monitor Business Machines \MBMSOAPServer 10.Find the most recent SOAP Server log file by looking at the Modified Date column. 11.Open it with Notepad. In this example you can see the Naming Service has stopped. 12.Close Notepad when you have finished studying the log file. 13.Close Windows Explorer. 32 Installing Supervisor SOAP Server

37 Installing and Configuring PHP PHP Installation Procedure Install PHP by running the application Monitor_PHP_setup_v1.2.0_(PHP_5.2.5).exe, supplied by Monitor. This application will install PHP, and the IonCube Loader. It also configures PHP with options suitable for running My Monitor. PHP Installation Procedure 1. Run the Monitor_PHP_setup_v1.2.0_(PHP_5.2.5).exe application. Click Next to continue. 2. For best performance, accept the default choices made by the installation application. 3. Click the Finish button to restart your computer. A restart is required. The PHP 5.2.5's installation will be complete when your computer has restarted. Installing and Configuring PHP 33

38 Configuring PHP for IIS-6 Configuration Procedure 1. Open Internet Information Services Manager from the Administrative Tools menu. 2. Expand the Internet Information Services tree (in the left hand pane) until you can see the Default Web Site item. 3. Right click on the Default Web Site item 4. Select Properties from the menu. This opens the Default Web Site Properties window. 5. Click the Home Directory tab (which may also be called 'Virtual Directory' or 'Directory'). 34 Installing and Configuring PHP

39 6. Set Execute Permissions to Scripts only. 7. Click the Configuration button, this opens the Application Configuration window. Installing and Configuring PHP 35

40 8. Click the Add button, this opens a window where you can add the.php extension. 9. Type c:\php\php5isapi.dll in the Executable edit box. 10.Type.php in the Extension edit box 11.Tick the Script engine check box. 12.Click the OK Button. This adds a mapping for the PHP extension. 13.Click OK in the Application Configuration window. 14.Click the Documents tab in the Default Web Site Properties window. 15.Click the Add button (on the right-hand side of the window). This displays the Default Content page dialog 16.Type in index.php and click OK. 17.Click OK in the Default Web Site Properties window. 36 Installing and Configuring PHP

41 18.Click on the Web Service Extensions Item in the Internet Information Services window. 19.Click the Add a new Web service extension link in the right hand pane. This opens the New Web Service Extension window. 20.Type php in the Extension name edit box. 21.Click the Add button, this displays the Add file window. 22.Type c:\php\php5isapi.dll into the edit box and click OK. Installing and Configuring PHP 37

42 23.You should see the New Web Service Extension window looking like this. Click OK. 24.The PHP Web Extension is added to IIS 6 25.Close the IIS Manager window. Now you are ready to enable PHP's function. Enabling My Monitor uses to send passwords and statements. You must configure PHP to use your server. Enable PHP's Mail Function 1. Start Notepad by choosing Start All Programs Accessories Notepad on the Windows taskbar. 2. Open the php.ini file 38 Installing and Configuring PHP

43 3. Find the [mail function] section 4. Go to the line that says "; For Win32 only", directly underneath that line is one that starts with "SMTP =". 5. Change the SMTP line so it points to your mail server. In this example it has been changed to mail.monitorbm.co.nz 6. Save the php.ini file 7. Close Notepad. Now you must enable PHP's error logging function. Please go to the next section. Enabling PHP Error Logging PHP can write error messages into a log file. This feature is very useful when you are troubleshooting problems with My Monitor. Enable PHP's Error Logging 1. Open Windows Explorer and browse to the c:\php directory. 2. Create a new folder called logs in the c:\php directory. Installing and Configuring PHP 39

44 3. Right-click on the logs directory and select the Sharing and Security option, this opens the properties window for the logs directory. 4. Click the Security tab. 5. Click the Users entry in the Group or user names pane. 6. Tick the Write permission check box in the Permissions for Users pane. 7. Click OK to save your settings. 8. Close Windows Explorer. 9. Open Notepad from the Start All Programs Accessories menu. 10.Open the c:\php\php.ini file. 11.Go to the line which says ;error_log = filename 12.Change this line to read error_log = c:\php\logs\phperror.log. Make sure you delete the semicolon in front of the line. 13.Save the php.ini file. 14.Close Notepad. 40 Installing and Configuring PHP

45 Now you must restart the Web Services for all of your configuration changes to take effect. Restarting Web Services This section explains how to restart the IIS (Internet Information Server) Web services. You must restart web services for changes in your php.ini file to take effect. Restarting your Computer's Web Services 1. Click Start All Programs Monitor Business Machines Services option to open the Services Window. 2. Select the line saying IIS Admin Service. 3. Select the Action Restart menu option in the Services window. Installing and Configuring PHP 41

46 4. Click the Yes button in the Restart Other Services window. 5. Wait for the Web Services to restart 6. Close the Services Window. Your php.ini file changes will now take effect. Required PHP Ini File Settings This section is provided for reference, it provides details of php.ini options required by My Monitor. If you have installed the Monitor supplied PHP package (see PHP Installation Procedure) you should skim-read this section. It is assumed that your PHP installation is working correctly. PHP needs the following settings in the php.ini file. (The php.ini file is usually found in either the PHP installation directory or in c:\windows): The 'include_path' directive must include the path to the mbmweblib folder. e.g. include_path = ".;c:\;c:\inetpub\wwwroot\" The following standard PHP extensions need to be enabled: curl, gd2, mcrypt, mhash, openssl and sockets. Locate the extensions section of the ini file (lines beginning with 'extension=') and make sure the following lines do not have semicolons at the start of the line: extension=php_curl.dll extension=php_gd2.dll extension=php_mcrypt.dll extension=php_mhash.dll extension=php_openssl.dll extension=php_sockets.dll Find the ' magic_quotes_gpc' option and set it to: 42 Installing and Configuring PHP

47 magic_quotes_gpc = On The function must be enabled. Find the SMTP line in the mail function section and set it to your mail server. e.g. SMTP=mail.monitorbm.co.nz The following options must be set: display_errors = Off register_globals = Off log_errors = On odbc.defaultlrl = session.use_cookies = 1 session.use_only_cookies = 1 session.cookie_lifetime = 1800 Note: You must stop and start your web server to make the changes to the PHP options come into effect. IonCube Loader This section is provided for reference. If you have installed the Monitor PHP package (see PHP Installation Procedure), the ioncube loader will already be set up. You should skim-read this section. The ioncube Loader is required for operation of the site. The My Monitor PHP files are encrypted, the ioncube loader decrypts them when users request pages from IIS. Installing the ioncube loader in an existing PHP installation 1. Download the loader installation from 2. Install the ioncube loader in your PHP directory. Monitor's PHP install package installs the loader files into c:\php\ioncube 3. Read the ioncube loader's readme files on how to install the loader 4. Open your php.ini file using Notepad. Installing and Configuring PHP 43

48 5. The Win 5.2 loader DLL must be enabled in the php.ini file. This is done by adding a line like this one to the end of your php.ini file. zend_extension_ts = C:\PHP\ionCube\ioncube_loader_win_5.2.dll 6. Save the changes to your php.ini file. 7. Restart your web services. 44 Installing and Configuring PHP

49 Installing the My Monitor Web Site Installing the My Monitor Web Site Files Once you have installed all of the prerequisite software you can install the My Monitor web site. When you run the My Monitor installation wizard. You will be asked to select your web server root directory. For most IIS installations this will be C:\inetpub\wwwroot. The installer will copy files to your system. This will result in two directories being created: C:\Inetpub\wwwroot\mbmweblib C:\Inetpub\wwwroot\mymonitor The My Monitor directory contains the main pages for the site, while mbmweblib contains supporting files. Install the My Monitor Web Site 1. Run the mymonitor_setup.exe program. Click Next in the welcome dialog box. 2. Study the license agreement. 3. Accept the agreement and click Next. Installing the My Monitor Web Site 45

50 4. Click Next, this sets destination folder to C:\inetpub\wwwroot. 5. Click Yes button in the Folder Exists dialog box. 6. Click Install button in the Ready to Install dialog and the web site's files will be installed. 7. The files will be installed on your computer in a few seconds. 46 Installing the My Monitor Web Site

51 8. Click the Finish button in the Finished dialog box. The My Monitor web site is installed. The next step is to run My Monitor. Raise the IUSR Account's Database Permissions After you have installed the My Monitor web site you must log in to the Admin page and upgrade the Real-Time export database. This upgrade process creates a table called WebConfig which holds your My Monitor site settings. Before you can upgrade the database you must raise the permissions of the IUSR account. You need to give the IUSR account membership of these roles: db_datareader db_datawriter db_ddladmin IIS uses the IUSR_<computername> account to access My Monitor's PHP files when people use the My Monitor site. In this manual, the computer's name is W2003ServerSQL, so the IUSR account is IUSR_W2003SERVERSQL. Raising IUSR account permissions 1. Open the SQL Server Management Studio tool and connect to the database. Installing the My Monitor Web Site 47

52 2. Drill down to Databases/superVISornet/Security/Users folder. 3. Right-click on the IUSR item (highlighted in the previous image), this displays a context menu. 48 Installing the My Monitor Web Site

53 4. Select the Properties item in the context menu, the IUSR accounts details will appear. 5. Move your mouse pointer down to the Database role membership pane. Installing the My Monitor Web Site 49

54 6. Tick the db_datareader, db_datawriter and db_ddladmin items. 7. Click the OK button to save your changes. 8. Close the SQL Server Management Studio tool. Now you are ready to login to My Monitor's admin page and upgrade the Real-Time export database. Upgrade the Real-Time Export Database When you have given the computer's IUSR account the correct privileges you can login to My Monitor's admin pages and upgrade the Real-Time export database. The admin pages enable you to customise My Monitor to work for your particular site. 50 Installing the My Monitor Web Site

55 Upgrading the Real-Time Export Database 1. Point your web browser to you will see a blank login page looking like this one. 2. Enter the name and password of your Supervisor Net MASTER user account. 3. Type into the SOAP Server Address field. 4. Type 8082 into the Port field. Installing the My Monitor Web Site 51

56 5. Click the Login button, this will login to My Monitor's admin page. 52 Installing the My Monitor Web Site

57 6. You will see the administration page with an upgrade error message at the bottom. Click the Upgrade button. Installing the My Monitor Web Site 53

58 7. You should see a message saying the upgrade is successful. Click the OK Button, this will take you back to the Administration page. 54 Installing the My Monitor Web Site

59 8. Click the Save All Options button, this will populate the Real-Time Export database with your initial My Monitor settings. 9. Click the red Log Out link in the top left-hand corner of the page. This will take you back to the login page. 10.Close your web browser window. You have upgraded your Real-Time Export database successfully. Now it is a good idea to check the contents of the WebConfig table, instructions for this are in the next section. If you have technical difficulties running My Monitor, check the c:\php\logs\phperror.log file, this will give you clues about what is going wrong. The phperror.log file is set up in Enabling PHP Error Logging section. Check the WebConfig table The WebConfig table contains your My Monitor site settings. WebConfig is created in the database upgrade process (see Upgrade the Real-Time Export Database). It's a good idea to check this table so you can confirm your settings are being saved. Check the WebConfig Table 1. Open the SQL Server Management Studio tool and connect to the database. Installing the My Monitor Web Site 55

60 2. Drill down to the supervisornet database in the Object Explorer window. 3. Click the New Query button. 4. Type in the command select * from webconfig into the query pane on the right-hand side of the window. 56 Installing the My Monitor Web Site

61 5. Click the Execute button in the toolbar, this will run the query. There should be around 50 records in the results pane. 6. Close the SQL Server Management Studio and abandon your changes to the new query. When you see the WebConfig records you know the Real-Time database is upgraded. Now you should lower your IUSR account's privileges to a safer level, instructions on how to do this are in the next section. Installing the My Monitor Web Site 57

62 Lower the IUSR Account's Database Permissions After you have confirmed your My Monitor settings are saved in the WebConfig table, you must remove lower the IUSR accounts privileges down to a safer level. Lowering your IUSR Account's Database Permissions 1. Open Microsoft SQL Server Management Studio. 2. Drill down to the Databases/superVISornet/Security/Users item in the Object Explorer. 3. Right-click on your computer's IUSR account. 4. Select the properties item in the menu. 5. Clear the db_ddladmin flag in the role membership list. Make sure you have db_datareader and db_datawriter ticked. 58 Installing the My Monitor Web Site

63 6. Click OK to save your IUSR account's settings 7. Close the Microsoft SQL Server Management Studio tool. Now you are ready to browse to the My Monitor web site, go to the next section for instructions. Installing the My Monitor Web Site 59

64 Open the User Login Page Opening the Login Page 1. Open your web browser and point it to 2. Close your web browser. Your My Monitor Software installation is finished! Now you can set up your site and add user accounts to it. 60 Installing the My Monitor Web Site

65 Index -TTest the Real-Time Export Database Connection 24 Typographical Conventions 1 -AASP.Net 2.0 Installation 4 -U- -CChecking the SOAP Server is Running 29 Checking the WebConfig Table 55 Configuring PHP for IIS-6 34 Connect to the Real-Time Export Database 21 Creating an ODBC DSN 17 Creating the Real-Time Export Database 9 Upgrading the Real-Time Export Database 50 -WWindows 2000 Server Assumptions Windows 2003 Server Assumptions 3 3 -EEnable Error Logging in PHP 39 Enable Local and Remote SQL Connections Enabling in PHP IInstall the Supervisor SOAP Server 29 Installing SQL Express 6 Installing SQL Express Management Studio IonCube Loader Settings LLower IUSR Account Permissions 58 -MMy Monitor Web Site Installation 45 -OOpen the My Monitor Login Page 60 Open the Real-Time Export Setup Log File Open the SOAP Server Log File PPHP Installation Procedure Product Overview RRaising IUSR Account Permissions Required PHP Ini File Settings 42 Restarting the Web Services SSite Security 2 System Requirements 1 Index 61

66 Monitor Business Machines Wireless House, Grafton Road, Auckland, New Zealand. Phone: Web: