TeleFlowRelay Web Services Installation

From TeleFlow

(Difference between revisions)

Wikilib (Talk | contribs)
(New page: == Apache Web Services == Apache along with PHP and MySQL can be installed very easily with LAMP and WAMP stacks. Please review the information provided before for hints on installing thi...)
Next diff →

Current revision

1 Apache Web Services
- 1.1 Installing Web Services
- 1.2 Troubleshooting
  - 1.2.1 Windows XP

Apache Web Services

Apache along with PHP and MySQL can be installed very easily with LAMP and WAMP stacks. Please review the information provided before for hints on installing this environment.

Installing Web Services

Install and configure the required applications and services for the website:
- Install from image
  - Note that XAMPP can be obtained from here: http://www.apachefriends.org/en/xampp-windows.html
  - Use this version: xampp-win32-1.7.2.exe
  - Newer versions of XAMPP may require testing.
- install to default location
- The installer simply extracts to the local drive
  - for "Destination folder", use default of C:\ (installer will create C:\xampp)
  - use default answer for the rest of the install questions
    - eg: "Should I add shortcuts to the startmenu/desktop? (y/n): y"
- Run XAMPP Control Panel
  - Under "Modules" select the services to install: Apache & MySQL
  - Click "Start" for each of these two services
Copy the [INSTALL DIR]\TeleFlowRelay directory and all its contents, including subdirectories, to C:\ on the web or phone server you are installing.
Set this as the home web directory:
- For IIS (Internet Services: IIS with PHP Install
- For Apache: (NOTE: The Apache instructions assume that XAMPP was used to install Apache/PHP/MySQL.)
  - Open C:\xampp\apache\bin\php.ini
    - NOTE: If this file doesn't exist here, run phpinfo() to determine where the "Loaded Configuration File" is.
    - Search php.ini for doc_root, and set the line to doc_root="C:\TeleFlowRelay\www\"
    - Search php.ini for "extension=php_mysql.dll". If it doesn't exist, or is commented out, add or uncomment the line where the extensions are listed.
  - Open C:\xampp\apache\conf\httpd.conf
    - Search httpd.conf for the DocumentRoot. You will need to change this in TWO locations.
      - The first line starts with "DocumentRoot", and should be set to: DocumentRoot "/TeleFlowRelay/www"
      - The second line starts with "<Directory", and should be set to: <Directory "/TeleFlowRelay/www">
    - Restart the Apache service
  - Determine the PEAR include path: Run a page with phpinfo() in it to find the include_path for PEAR:
    - A file is included in TeleFlowRelay\www to do this; my_php_info.php
    - From a web browser, browse to http://127.0.0.1/my_php_info.php
    - IMPORTANT: After you are finished with TeleFlowRelay\www\my_php_info.php it must be deleted.
  - Extract [INSTALL DIR]\WebApps\pear.zip into the parent directory to the pear include directory, overwriting all existing files. (EG. If include_path=C:\xampp\php\pear, extract all the files into C:\xampp\php)
  - Restart the Apache service

Extract the TeleFlowRelay Web Foundation ZIP into the web root directory
- ie: Copy files and directories into C:\TeleFlowRelay\www)
- This is where the directories must reside, because JavaScript must be referenced by the relative web location.
  - Note: TFR references the library_js as /, so if you install to a directory other than root, leave the javascript directory at the root.

- SPECIAL: If you want your web services on the phone server to have only the absolute minimum files to serve TeleFlow applications, you can selectively install the following files and directories, copying them from [INSTALL DIR]\WebApps\engenic_app_root to C:\TeleFlowRelay\www:
  - Files:
  - license.txt
    - cr_*.*
    - LocalSettings*.*
  - Directories:
    - cr_data_loader
    - cr_sql_statements
    - cr_transfer_system
    - images
    - include
    - swift_emailer
    - library

Troubleshooting

Windows XP

Windows XP has a connection limit of 10 sessions, which can quickly lock out new users. This limit can be upped to 40 simultaneous connections.

(( From the internet: ))

Alot of people were pinging me today about getting 403.9's when trying to access my website (Access Forbidden: Too many users are connected Internet Information Services).

It turns out that the IIS on Windows XP comes configured out of the box for a maximum of 10 HTTP connections. What's worse, IE (actually URLMON) seems to use up 2 connections when hitting a website. I tried figuring out how to raise the connection limit, but there didn't seem to be a documented way of doing this on a non-server version of Windows. Fortunately, my good friend Geoff is the Architect of IIS and was able to help me out. Here's his tip:

This can be bumped up to 40 but not higher (40 is the hardcoded limit).
To do this, find the adsutil.vbs script (should be in c:\inetpub\AdminScripts or similar) and run the following command:

adsutil set w3svc/MaxConnections 40

You can also try to prevent individuals from hogging a bunch of connections and thereby blocking out other users. (IE will normally use 2 connections to a web site.) To do this, launch the IIS admin tool (under control panel / administrative tools), right click on your ‘default web site’ (under ‘web sites’ in the outline control), and mess with the settings in the “connections” part of the “web site” tab. Lowering the timeout (default is 5 min) will cause idle connections to get dropped quicker. Disabling keep alives will cause connections to disconnect immediately after the request is handled instead of waiting for new requests on the same connection. This is a little extreme but you probably don’t care that much about responsiveness, so you might want to just try that and see if it solves the problem.

Thanks Geoff! I hope I didn't cost the company too many W2K3 licenses by posting this :-)