::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: LOGICWASH WEB APPLICATION INSTALLATION README.TXT / (version 4.00.00) ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: ********************************* SECTION ONE (Pre-Installation Notes) **************************** ------------------------------------------------------------------------------------------------------- SERVER LOCATION ------------------------------------------------------------------------------------------------------- STAGE SERVER - BETA RELEASE VERSION (in development): File Location: \\192.168.50.50\c$\Inetpub\wwwroot\WebAppStage Website Address: http://192.168.50.50:8550/WebAppStage ....................... .............................................. ....................... PRODUCTION SERVER - CURRENT RELEASE VERSION (used for customer demos): File Location: \\192.168.50.50\c$\Inetpub\wwwroot\WebApp Website Address: http://192.168.50.50:8550/WebApp or http://68.196.84.126:8550/WebApp/ ------------------------------------------------------------------------------------------------------- INSTALLATION FILE LOCATION ------------------------------------------------------------------------------------------------------- ....................... .............................................. ....................... ALL INSTALLATION FILES ARE STORED HERE: \\192.168.50.10\f\Disks\WebAppSoftware * All releases are stored in their corresponding release folder names. * Beta releases are stored in the ROOT folder, and are maked with a 'b'. * Previous releases are stored in the _Archive folder. Examples: Current Release Version - ..\WebAppSoftware\6-00-00\ Beta Release Version - ..\WebAppSoftware\7-00-00b\ Previous Versions - ..\WebAppSoftware\_Archive\1-00-00\ or ..\WebAppSoftware\_Archive\1-00-00b\ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SPECIAL NOTES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * ALWAYS USE THE CURRENT RELEASE VERSION. * ONLY USE THE BETA RELEASE VERSION IF REQUESTED TO DO SO. ------------------------------------------------------------------------------------------------------- INSTALLTION REQUIREMENTS ------------------------------------------------------------------------------------------------------- 1. Windows XP Professional or Windows 2003 Server Edition 2. Internet Information Services 5.1 or later 3. ASP.NET 2.0 Framework 4. SQL 2005 and the most recent version of the LogicWash SQL database 5. Installation of expressmaint.sql onto 'master' system db of SQL server. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SPECIAL NOTES - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * Sometimes it is necessary to remove and reinstall the .Net framework. To do so, issue the following commands: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis -u C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis -i * There is a known issue with some installations of IIS. If during the installation of IIS you receive an error (missing file: statxmem.dll), please refer to the following MS KB Article ID: 894351. More information here: http://support.microsoft.com/kb/894351 ********************************* SECTION TWO (Installation) ************************************** ------------------------------------------------------------------------------------------------------- INSTALLTION OF THE LOGICWASH WEB APPLICATION ------------------------------------------------------------------------------------------------------- 1. On the Customer's server, create three new folders in the Inetpub\wwwroot\ folder: WebApp - WebAppStage - WebAppArchive ** The WebAppStage folder is optional. 2. Copy the entire contents from the ..\WebAppSoftware\XX-XX-XX\ to the newly created WebApp folder on the Customer's server. ** To speed up the file copy, transfer the xx-xx-xx.zip file to the Customer's server, and then extract it. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - EXAMPLE: Copy ...\WebAppSoftware\6-00-00\*.* to C:\Inetpub\wwwroot\WebApp - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ** WHEN COPYING, BE SURE TO PRESERVE FILE AND FOLDER STRUCTURE ** 3. On the newly created WebApp folder, set the proper security permissions for the App_Logs folder. - WRITE access must be set for the App_Logs folder or logging will not occur and the system will throw an exception. - WRITE access must be set for the WebCharts folder or dashboard charts will not work and the system will throw an exception. 4. Copy the .NetFramework and Compile WebApp shortcuts to the Inetpub\wwwroot\ folder. These two files are located in the WebAppSoftware folder. 5. From within IIS (and under the Default Web Site), create a new Virtual Directory. - Use the alias WebApp, and point it to the WebApp folder. Be sure to give it Read, Run, and Execute permissions. 6. Set the TCP Port on the Default Web Site to 8550. 7. Add a new Default Document to the newly created Website. Name it login.aspx, and move it to the top of the Default Documents list. 8. Setup the Default User Groups and User Group Permissions. - Do this by copying the UserLevels and UserLevelPermissions tables from the 50.50 server, or by importing the data from the User Groups spreadsheet. 9. Edit the Web.Config file, if needed. - There are two sections where editing will likely occur: LINES 20-22: LINES 74-79: ***** The passwords above have been stared for security reasons. 10. Create a Desktop Shortcut to http://localhost:8550/WebApp. 11. Compile the WebApp. Do this by double-clicking the 'Compile WebApp' shortcut, or issue the following command: %windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_compiler.exe -v /WebApp 12. Test the system using the hard-coded username and password. - Username: micrologic - Password: $ystem@dmin 13. Configure, if required, OUTSIDE ACCESS to the server on TCP/IP port 8550. 14. Copy the Compile WebApp file to the Customer's C:\Inetpub\wwwroot\ folder. 15. Execute the file from step 12. 16. REPEAT STEPS 1 - 9 FOR THE WebAppStage folder. ** Optional ******************************* SECTION THREE (UPGRADES/UPDATES) ********************************** ------------------------------------------------------------------------------------------------------- UPGRADES AND UPDATES ------------------------------------------------------------------------------------------------------- 1. Create a new folder in the Customer's ..\WebAppArchive folder using the current date. - EXAMPLE: ..\WebAppArchive\01-01-2007 2. Copy the contents of the Customer's WebApp folder into the newly created 'Archive' folder. 3. Delete the Customer's entire contents (see exception below) of the WebApp folder ** EXCEPTION ** DO NOT DELETE THESE FOLDERS/FILES: - \App_Logs - \WebCharts 4. Copy the entire contents from the ..\WebAppSoftware\XX-XX-XX\ to the WebApp folder on the Customer's server. ** To speed up the file copy, transfer the xx-xx-xx.zip file to the Customer's server, and then extract it. 5. Delete the ASP Temporary Files from the Customer's C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\WebApp folder. 6. Compile the WebApp. Do this by double-clicking the 'Compile WebApp' shortcut, or issue the following command: %windir%\Microsoft.NET\Framework\v2.0.50727\aspnet_compiler.exe -v /WebApp 7. TEST!!! http://localhost:8550/WebApp