


October 12, 2002 

Re: 	ReqBuilder Readme


ReqBuilder should be installed on test or development servers before installing to a live production site. To install ReqBuilder do the following: 

1) Unzip the program files into the webroot. 

2) In the ColdFusion administrator, create a Microsoft Access datasource that points to the following *.mdb:

.../REQBUILDER_INSTALLROOT/Database/reqBuilder.mdb

3) Open REQBUILDER_INSTALLROOT/custtags/rbInitAppVars.cfm and look at approximately line 38 for: 

APPLICATION.stCommon.Webport = ":8500";

If you are running ColdFusion MX with the standalone server on port 8500, leave the line as-is. If you are running ColdFusion MX with IIS or another webserver, set the Webport variable to an empty string.

4) In a browser, request the opening page: 

http://HOST_NAME:8500/reqbuilder/

5) Follow the onscreen instructions for logging in. 

6) If for some reason you need to re-initialize the application, open the application.cfm file in the application root and set the variable "Initialized" to FALSE right before the CFIF block that runs the rbInitAppVars.cfm custom tag.

7) If the Flash movie does not come up, it is most likely a ColdFusion configuration issue. See the directions below which we have used successfully to correct such problems. This information was distilled from several postings on the Macromedia forums so check there for additional data and remember that your mileage may vary.

FLASH REMOTING CONFIGURATION

Some elements of the admin area rely on Macromedia Flash technology and communicate with the server through Flash Remoting. To check if Flash remoting is working correctly check this URL in a browser running on the server itself. Replace the server name below with "localhost" if you are running on IIS.

http://localhost:8500/flashservices/gateway

This should bring up a blank page. If it does not bring up a blank page then Flash Remoting is not properly configured. Try the following:

1) Stop all three CFMX services.

2) Stop the WWW service.

3) Run this command in a command line window: "c:\cfusionmx\runtime\bin\wsconfig.exe -v -u"
This command will remove your current configuration in IIS.

4) If the above produces an error about being unable to delete a file, it may be that one of the files is still being used by another program. Stop any other programs that may be using the file that won't delete and run the above again.

Restart the WWW service and all three CFMX services, wait a few seconds and then run this command:

c:\cfusionmx\runtime\bin\wsconfig.exe -ws IIS -site 0 -filter-prefix-only -map .cfm,.cfc,.cfml,.jws,.jsp -v

If there are no error messages, then this should have properly configure your IIS to work with CFMX and allow Flash Remoting to work.


Filename: Normal.dot		Page 2 of 2
Printed: 2/16/2001 11:25 AM

