Home

PDF - FusionReactor

1. Figure 1 Stop the Server Instance Figure 1 If the server instance you are attempting to remove FusionReactor from is currently running it needs to be stopped in order to completely remove the FusionReactor instance By clicking Stop the Instance Manager can attempt to stop the server instance automatically See Figure 2 If you wish to stop the server at another point or wish to manually restart it click Skip If you have selected to uninstall more than one FusionReactor instance the wizard will advance to the next FusionReactor instance Otherwise the Finish screen Figure 6 will be displayed Tocompletely remove the FusionReactor Instance and all of its components the server instance must be completely shut down If the server instance you are removing FusionReactor from is not running Figure 3 will be displayed coldfusion cimxs INTO05F Attempting to stop server instance coldfusion in Adobe ColdFusion 6 C ColdFusions Figure 2 Stop in Progress Figure 2 FusionReactor is attempting to stop the server instance Please note that stopping the server may take several minutes depending on your system and server coldfusion cfimxs INTOO5F Are you sure you wish to remove FusionReactor from server instance coldfusion Figure 3 Confirm Uninstall Figure 3 By clicking Remove FusionReactor will be completely removed from the server instance If you do not wish to uninstall
2. Setup FusionReactor 4 5 0 Welcome to the FusionReactor Setup Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Next gt Cancel Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen Clicking the Next button will proceed with the installation and open the License Agreement as shown in Figure 2 Clicking Cancel will exit the Setup Setup FusionReactor 4 5 0 License Agreement Please read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before continuing with the installation INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO NOT INSTALL COPY DOWNLOAD OR OTHERWISE USE THE SOFTWARE THIS EULA SHALL APPLY ONLY TO THE SOFTWARE SUPPLIED BY INTERGRAL HEREWITH REGARDLESS OF WHETHER OTHER O
3. Description The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Name of the logger 3 C The name of the logger of the event Level 4 D The level priority of the logging event Message 5 E The message of the logging event Example The file test Frec cfm contains the following lt cflog file test application no text Test Warning type Warning gt Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy 2011 08 30 16 08 07 421 coldfusion user test WARN Test Warning Also See Log Settings Installing FusionReactor Extensions for ColdFusion FREC Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC FREC Log Files CF Realtime and Request Stats realtimestats log amp NOTE It is important that you enable Monitoring and Profiling in ColdFusion to do this check out ColdFusion Settings Section in How to enable FREC guide This log realtimestats log stores real time related information relating to currently active requests Requests include browser requests CFC HTTP requests web services gateways and Flash remoting The information can be fed through to FusionAnalytics to produce detailed graphical representations of the data For further information on what FusionAnalytics is and how it can benefit you click here The log
4. FusionReactor Administration Manager The FusionReactor Administration Manager will be installed enterprise edition After install this will be available by default on port 8087 F Configure ports manually fusion m A kredctor Administration Manager Intergral Information Solutions Figure 5 FusionReactor Administration Manager FRAM Figure 5 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the server ports See Figure 6 If you wish to use the default port settings leave the box unchecked and click Next See Figure 7 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manager HTTP Port 8087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Contral Port 3004 Intergral Information Solutions Figure 6 Manually Configuring Ports Figure 6 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the
5. Perhaps most important is the last key webserver port You must ensure you use a port here which is not in use by any other application Adding the Filter Definition The file ilter def xml contains an XML snippet which must be added to your J2EE container s web xm1 fil e You should ascertain the location of this file by referring to the container s documentation e Open the filter def xml file e Copy the whole content of this file a filter block and a filter mapping block into the clipboard e Open the filter servlet definition file e In ColdFusion s case this is opt coldfusion9 runtime servers coldfusion SERVER INF default web xml e Below the web app start tag just before the first filter definition if one is present if not just before the first servlet definition paste the complete content of the clipboard e Customize the _ INSTANCENAME __ placeholder to point to your newly created instance folder You should now have inserted the FusionReactor filter and filter mapping block just prior to the first filter or servlet definition Copying the fusionreactor jar file Within the folder opt fusionreactor etc 1lib you ll find a copy of the fusionreactor jar file This must be copied to somewhere visible to your J2EE server s webapp instance In our case we copy the file to opt coldfusion9 runtime servers coldfusion SERVER INF 1lib le Finally start your J2EE container and watch its standard out and sta
6. The Administrator password is required to log into the FusionReactor Administration Manager to manage your FusionReactor instances Password Validate Password Z Z O Intergral Information Solutions Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long gt O Setup FusionReactor 4 5 0 Define user and group Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation The user and group selected here must have write privileges on your J2EE container s configuration files If you unsure use the same user your J2EE container runs as or root User jnobody Group Intergral Information Solutions Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Please Note FusionReactor Administration Manager FRAM must be installed as a user who has a real shell and can log in to the system By default the installer will pick nobody root for this purpose but can t presently check that this user can actually log in If your nobody user does not have a shell please change their shell to bin sh or your preferred shell or select another user Setup FusionReactor 4 5 0 Ready to I
7. Installing Third Party JDBC JAR Files In order for the Driver Wrapper to locate the underlying driver the third party JDBC JAR driver file usually delivered as one or more JAR files must be installed in a location visible to the Driver Wrapper classloader We recommend either of the following locations beneath your ColdFusion installation folder for example lt CFDIR gt runtime servers coldfusion SERVER INE lib lt CFDIR gt runtime lib Standalone Installation Servlets etc The driver is packaged within the fusionreactor jar file and you must arrange for this file to be in the JVM classpath when the application runs The URL syntax is as previously described In this configuration you must provide the driver parameter in order that the FusionReactor JDBC Driver Wrapper can load the appropriate underlying wrapped driver Using the FusionReactor JDBC Wrapper Configuration Options The FusionReactor JDBC Driver Wrapper is configured exclusively using JDBC URL driver parameters The following parameters may be specified as pairs separated by semicolons No parameters are mandatory Parameter names are case insensitive driver Value Fully qualitied Java class name Default no underlying driver will be loaded This option instructs FusionReactor JDBC Driver Wrapper to load an underlying wrapped driver This is not necessary only if the JVM is already aware of the target driver i e it has already been loaded with
8. Instances gt Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Finish he J Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Uninstalling FusionReactor on Mac To completely remove FusionReactor from your system you can either double click on the FusionReactor Uninstaller icon in the FusionReactor directory or you can run the uninstall command located in the FusionReactor directory in a shell window The Uninstaller will completely remove the FusionReactor directory including all of the generated data please take care that you save any files you want to keep before running the uninstaller The uninstaller will also remove any installed FusionReactor instances during this process you will be asked to restart any running servers Please note that not stopping the servers means that FusionReactor and all of its components will not be completely removed This may cause issues on these servers FusionRe
9. g Setup FusionReactor Extensions for ColdFusion 1 0 1 Select ColdFusion Servers What ColdFusion servers should the extensions be installed uninstalled into Choose an action to perform and select servers from the list or enter a server directory by changing the selection method Hold Ctrl to select multiple servers Install Update FusionReactor Extensions for ColdFusion 1 0 0 Server Selection Select from list C Enter custom directory Figure 1 Install Update FREC into selected servers The main screen for the Instance Installer Figure 1 shows a list of the FusionReactor instances which it has found by scanning the system In order to install the FREC plugin into a FusionReactor instance select the instance from the list box and make sure that the nstall Update option is selected from the drop down list then click the Next gt button It is possible to select multiple instances from the drop down list amp NOTE To install FREC on multiple instances of FusionReactor hold down the Ctrl key and click on each one g Setup FusionReactor Extensions for ColdFusion 1 0 1 Select ColdFusion Servers What ColdFusion servers should the extensions be installed uninstalled into Choose an action to perform and select servers from the list or enter a server directory by changing the selection method Hold Ctrl to select multiple servers Install Update FusionReactor Extensions for ColdFusion 1
10. Data Sources ColdFusion Collections Add Figure 1 CF Data Source Name JDBC URL Driver Class Driver Name User name Password 16 character limit Description Show Advanced Settings Submit Cancel Figure 2 After submitting this form ColdFusion will immediately test the connection and provide any necessary feedback in the ColdFusion Administrator If the FusionReactor JDBC Driver Wrapper detects any problems with the underlying wrapped driver or with its own options it will also provide feedback in the same way Any exceptions generated by the FusionReactor JDBC Driver Wrapper are prefixed with an exception ID number which may be used to look up more information When running as part of J2EE ColdFusion and if the FusionReactor JDBC Driver Wrapper detects a running FusionReactor application any queries run during the course of the request will be reported to FusionReactor for inclusion in the user interface where appropriate Examples The original data source was an MS SQL Server with the database database name testdb after being wrapped by the FusionReactor wrapped it is now called MyDataSource Original JDBC URL Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee jdbc macromedia sqlserver localhost 1433 databaseName testdb tt nnn m m m m m y jdbc fusionreactor wrapper jdbc macromedi a sgqlserver localhost 1433 databaseName
11. If you have a server which receives bursts of requests all at once then FusionReactor can using queuing spread that load out over time and so protect your server from becoming overwhelmed Preventing Crashes If you periodically have very resource hungry jobs running then FusionReactor can stop new requests being run which could potentially cause the server to become unstable During Development If you need to write a page which cannot use more that a fixed amount of the system resources then crash protection is a good way of tracking where and when you have problems As well as emails crash triggers can also be viewed in a log file Crash Protection Log crashprotection log The Crash Protection Logs are a set of rotating files which you can configure from the Crash Protection Seitings page The log file is formatted as follows Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time at which this log entry was written Date Time ms Version Server Startup Time ms CP Type Action Memory Percentage Memory Threshold Request Count Request Threshold Execution Time Execution Threshold Server ID Script Date Formatted 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K 12 L 13 M 14 N 15 O 16 P The number of milliseconds since the epoch Version number of this log
12. Turn Windows features on or off Uninstall or change a program To uninstall a program select it from the list and then click Uninstall Change or Repair Organize Uninstall Change Name v FusionAnalytics 1 0 2 FusionAnalytics AIR amp FusionReactor _ _Uninstal Change pore Information Solutions IP FusionReactor Enterprise besmroare gral Information Solutions FusionReactor Extensions for ColdFusion Setup 1 0 1 m FusionReactor Extensions for ColdFusion Setup 1 0 1 Google Chrome E Google SketchUp 8 ln HashTab 4 0 0 2 HP 3D DriveGuard HP Advisor W HP Games HP Integrated Module with Bluetooth wireless techn HP MediaSmart DVD WP HP MediaSmart Internet TV WY HP MediaSmart Live TV O HP MediaSmart Music Photo Video HP MediaSmart SmartMenu L3 HP MediaSmart Software Notebook Demo Ke HP MediaSmart Webcam HP Quick Launch Buttons nima Figure 1 Add or Remove Programs Publisher Intergral Information Solutions Intergral Information Solutions Installed On Size 02 05 2012 04 07 2011 Version 1 0 2 1 0 1 20110704 0911 16 05 2012 4 5 0 Intergral Information Solutions Intergral Information Solutions Google Inc Google Inc Implbits Software Hewlett Packard Hewlett Packard WildTangent Broadcom Corporation Hewlett Packard Hewlett Packard Hewlett Packard Hewlett Packard Hewlett Packard Hewlett Packard Hewlett Packard Hewlett
13. You can either select whether the specified request will be excluded from Crash Protection or if it should be included This field is only visible when the Crash Protection restrictions page is in exclude mode Crash Protection Settings page If you are excluding a request from Crash Protection because you know it will run for a long time you can also exclude it from the general server statistics eg myfile ctm folder myfile cim server com myfile cim myfile param value Ignore Ignore Timeout Protection Track Statistics lf you enable Host Checking then the above path should include the host that a page is running on eg mymachine main cim lf Parameter Checking is enabled then you should include the parameters of your page in the path above eg main cim mode batch This option lets you decide ifa page should be restricted from timeout protection or all crash protection lf you are excluding a request from Crash Protection because you Know it will run for a long time you can also exclude it from the general server statistics Once you submit the form the page will be refreshed and your new restriction will be listed at the bottom of the page Managing Existing Restrictions Below the Add Restriction form you will see a list of all existing restrictions Each restriction has two icons next to It Button Name Description Fe Modify Restriction Clicking on this icon wi
14. getRequestUrl lt br gt Start dateObject toString lt br gt lt hr gt lt cfoutput gt lt cfloop gt lt Sleep for 5 seconds gt lt cfobject type Jjava action create class Jjava lang Thread name Thread gt lt cfscript gt Thread sleep JavaCast long 5000 lt cfscript gt Oe en ee ee ee ee ee ne ee ee eee en oe eee ee ee ee eee ee eee This bit of code will print out a list of all requests currently running We ve added a wait at the bottom so we can run it several times and get a result something like this Mozilla Firefox fo File Edit View Go Bookmarks Tools Help a a NA ID 115 URL http 127 0 0 1 8500 rapi_apitest cfm frapitimeout 1 amp timeout 1 Start Fri Apr 28 16 11 49 CEST 2006 ID 116 URL http 127 0 0 1 8500 rapi_apitest cfim frapitimeout 1 amp timeout 1 Start Fri Apr 28 16 11 50 CEST 2006 ID 117 URL http 127 0 0 1 8500 frapi_apitest cfin frapitimeout 1 amp timeout 1 Start Fri Apr 28 16 11 51 CEST 2006 The FusionRequestSurrogate Calling frapi getRunningRequests returns an array of FusionRequestSurrogates These objects contain proxied information from an internal FusionRequest web request It is safe to store references to this object since the data it encapsulates is copied from the underlying FusionRequest There is a lot of data that you can get about a request lt cfscript gt frapiClass createObject
15. testdb name MyDataSource eee eee Constructing JDBC URLs for other DataDirect Drivers CFMX 7 8 9 10 While it is not within the scope of this manual to provide exhaustive information on how ColdFusion internally constructs JDBC URLs for its built in drivers the following template information taken from the neo query xml file within the cfmx lib folder may help you Oracle Class macromedia jdbc MacromediaDriver Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy jdbc macromedia oracle host port SID sid sendStringParametersAsUnicode sendStringParametersAsUnicode eee MS Access Class macromedia jdbc MacromediaDriver FD hl el NNN ell el aD ND Ne Ne mmmn m M jdbc sequelink msaccess host port 1 serverDatasource datasource PostgesQL Class org postgresql Driver Pt ee eee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee eee jdbc postgresql host port data base args MySQL Class org gjt mm mysql Driver elt tt jdbc mysql host port database args IBM DB2 Class macromedia jdbc MacromediaDriver lel er jdbc macromedia db2 host port Da tabaseName database sendStringParamete rsAsUnicode sendStringParametersAsUnicod e args Lee ee eee ee ee e l MS SQL Server Class macromedia jdbc MacromediaDriver Pt ee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee
16. 1 2 Soa Download FusionReactor on a computer with internet access and copy it to your computer without internet access to install FusionReactor will recognize you are not connected to the internet and the screen below will appear Make a note of the Activation Input String and then move over to a computer with internet access Click on the link above the Activation Input String htto Awww fusion reactor com fr activate activate cfm this will take you to an activation page Input the Activation Input String into the Activation text field and press the Submit button you will then be given an activation key Make a note of this Return to the computer with FusionReactor installed and copy out the activation key into the text field titled Activation Key Click Activate License to activate your license FusionReactor Manual License Activation O Click the button on the right to activate your License Activate License Go to the Online Activation page http Awwwfusion reactor com r activate activate cfm and enter the Activation Input String shown below eepo eee OOO G8 84 9 OFF OFF You will receive an Activation Key Enter that Activation Key in the text input field below Activation Key Enter the key from the webpage shown above Please Note Do not restart your server between copying the Activation Input String and getting your Activation Key as the Activation Input String will change after a restart Click
17. 42 449 Free 423 598 Request History The Request History page shows a list of completed requests Please be aware that FusionReactor only keeps a fixed amount of requests in memory If the history size gets too long or you restart you application server then old requests will be removed To change the size of the request history change the History Size value on the Re quest Settings page Note that you can still examine these older requests by looking into the Request Log request log The request history table has the following columns Name Description Finished The time at which the request was completed Ret Code IP The final HTTP return code of the request and the IP address of the caller If the request was killed or if it triggered Crash Protection then you will see a note here letting you know what happened ID The request ID and the name of the thread which is or was servicing the request URL Parameters The URL path and parameters passed to the request You can turn on or off the hostname in the URL by modifying the URL Format value on the Request Settings page Time ms The number of milliseconds that the request took to complete If available then you will also see the amount of actual CPU time that this request used below it Memory KB A snapshot of the state of system memory at the time the request was started The following values are shown Used memory as a percentage of the total available to the JVM t
18. Class forName Macromedia s own DataDirect drivers are loaded automatically by ColdFusion so this option may not be necessary if you are using these drivers However if you are using a user specified driver having a JDBC URL which does not start with jdobc macromedia you must supply this parameter Since the registration of the driver is only ever performed once regardless of how many connections the driver processes this parameter can and should be specified on all FusionReactor wrapped Data Sources If you do not specify this option and the JVM is not aware of the underlying driver FusionReactor will raise an exception and the J2EE server will not verify the driver rowLimit Value integer Default O disabled This option instructs the FusionReactor JDBC Driver Wrapper to limit returned rows to the given value After the application has retrieved this number of rows from the result set FusionReactor will discard any remaining rows notify After Value integer Default 0 disabled This option instructs the FusionReactor JDBC Driver Wrapper to output a notification after n rows have been retrieved for the query remindAfter Value integer Default 0 disabled This option instructs the FusionReactor JDBC Driver Wrapper to periodically output a query reminder every n rows If notifyAfter is specified FusionReactor JDBC Driver Wrapper will only begin reminding after the notification threshold ha
19. Configuration files will not be overwritten Setup has detected instances of FusionReactor with versions prior to version 4 These are not supported by FusionReactor 4 and will be updated during the initial update which is performed by the FusionReactor Administration Manager after the installation After Setup has finished you will be taken to your FusionReactor Administration Manager Instance where you must Update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup ETO he ahhh Do ron Ons Back ext Cancel Figure 2 Update the Current Version Figure 2 If there is already a version of FusionReactor 3 x on your computer that has been installed with the FusionReactor 3 x Setup you will see a screen similar to the one shown Carefully read the information and click Next to proceed with the update Click Cancel to exit the installation wizard License Agreement Please read the following important information before continuing INTERGRAL SOF TAARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AM ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING
20. FusionReactor instance and select either Plugins gt Active Plugins or Plugins gt All Bundles from the Table of Contents You will see a row on both of those screens named FusionReactor ColdFusion Plugin Figures 5 and 6 respectively Remember that you won t see these items listed until you have restarted the target instance after installing the plugin Plugins Active Plugins Plugin Information Version Type Actions O FusionReactor ColdFusion Plugin 1 0 0 OSGi Intergral Information Solutions GmbH fr coldfusion plugin Ponde Logfile FR Plugin This plugin provides access to the ColdFusion log files and Server Monitoring API Configuration ffr coldfusion plugin 7 0 0 jar Figure 5 The plugin within active plugins in FusionReactor Plugins All Plugins 5Seconds vi OI a OSGi Bundle Inventory Start Bundle Information Version Type por Actions FusionReactor ColdFusion Plugin 1 0 0 OSGi G ACTIVE Intergral Information Solutions GmbH fr coldfusion plugin Bundle Stop Start This plugin provides access to the FR GoldFusion log files and Server Plugin Logfile Monitoring API Configuration ffr coldfusion plugin 4 0 0jar Figure 6 The plugin within all plugins in FusionReactor See Also FREC Configuration Guide Uninstalling FREC from FusionReactor Instances In order to remove the FusionReactor Extensions for ColdFusion FREC plugin from in instance of FusionReactor you need to run the FREC Instance Instal
21. Hashcode 60543300 java lang Object wait Object java 77 Nat ive Method java lang Object wait Object java 485 java lang ref Reference SReferenceHandler r un Reference java 116 JVM ID 3 Thread ID Finalizer Priority 8 Hashcode 1142635176 java lang Object wait Object java 77 Nat ive Method java lang ref ReferenceQueue remove Refere nceQueue java 118 java lang ref ReferenceQueue remove Refere nceQueue java 134 java lang ref FinalizerSFinalizerThread ru n Finalizer java 159 Request ID 18 Request URL http 127 0 0 1 8500 cf sleep cfm Status EXECUTING Started Milliseconds 1337071445943 Started Date Time 2012 05 15 10 44 05 943 Thread ID web 4 Client IP Address 127 0 0 1 Request Method GET Execution Time ms 210000 Used Memory percentage 62 Max Memory KB 466048 Used Memory KB 291765 Total Memory KB 394304 Free Memory KB 102538 Query String Return Status Code 200 CPU Time ms O0 JDBC Queries Run 0 JDBC Total Time 0 JDBC Total Execution Time 0 JDBC Total Row Count 0 AMF Request None Bytes Sent 0 Time to First Byte ms O Time to Last Byte ms O Note Data is still streaming Time to Stream Open ms 1 Time to Stream Close ms Note Data is still streaming User Agent Mozilla 5 0 Windows NT 6 1 WOW64 AppleWebKit 535 19 KHTML like Gecko Chrome 18 0 1025 168 Safari 535 19 Using the FusionReactor JDBC Dri
22. If you wish to use the default port configuration click Back and uncheck the Configure ports manually option setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specif an Administrator password for FusionReactor Administration Manager ETO hell Ohi LOT rn OL inns L Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long Reset set eerste sees eee eee ee ee He AE EE EE EE NE EE a ra ee nem hee carer ces Dee pt aa fig E y EAr ra E SE a ot oocrsiatsoocrssisacresaaacr eases ace Sars git E in city ie eA Peers A EEEE DEEE EET ESET ETE TEE EE SS BT B r ah l nk eA ct 0 Pret E PEPEPEPE PEPE PPP errr rrr errr rrr rere Pe ey if Tee Define user and group Which user and group should FusionReactor Administration Wanager run under Select or manually enter the owner and group of this installation The user and group selected here must have write prmaleges on your J2EE container s configuration files ff you unsure use the same user your J2EE container runs as or root User nobody Group bin r Mterateintmenmienai eE Back Next gt Cancel L Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Please Note FusionReactor Administratio
23. Once you have installed your FusionReactor instances you can use the Instance Manager to add them to the FRAM Enterprise Dashboard from where you can easily monitor the status of all configured servers You can also manually add instances to the Enterprise Dashboard in order to see the status of FusionReactor instances which weren t installed by the current FRAM application Troubleshooting There are many different scenarios in which FusionReactor is used each with its own conditions and each requiring a different configuration The following are links to sample configurations for short term immediate troubleshooting and longer term production monitoring e Configuring FusionReactor in emergencies e Log files are critical to understanding what s going on on your server read about log file s and how to configure them Feedback We welcome feedback on all our products and publications To discover the various ways of contacting us please use our contact page We will address your feedback as quickly as possible Support Mailbox You can mail us FusionReactor questions at suoport fusion reactor com Google Group We also provide a Google Group for the community to ask questions in http groups google com group fusionreactor We check and reply to this group regularly so it s also worth searching to see if your question has already been answered FusionReactor User s Guide Getting Started Requests Running Requests
24. Short 3 C Displays a short version of the date DD MM Log message 4 D Contains a message of an event that occurred such as logging that has started Time Short 5 E The time the entry was written Entry 6 F The entry that was written for example the entry might state that a serviet was started up Status Log plugin fr jrun plugin log This plugin creates a log file called plugin fr jrun plugin log which contains information on the status of the plugin when it started stopped if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Log Settings FusionReactor Plugins FusionReactor Log Rotator Plugin Description Manages the maintenance of log files within FusionReactor Features include Two types of mode Centralized Archive and Rotation and Per Log Rotation mode Rotates log files on a given schedule either at a given
25. Status or Log Status are never considered for purge Sets the Keep Don t Keep option on new archives When enabled archives are immediately eligible for purge regardless of whether they have been shipped automatically to FusionAnalytics When disabled archives are not eligible for purge until a successful transfer to FusionAnalytics has occurred The location of where the archives reside on disk is input here A default location is provided Description If set to enabled the user will receive an email daily about the disk usage of the log and archive system See Settings for help configuring the email server If the above option is enabled input the time HH MM in the 24 hour system the monitor job should run If the total archive size reaches the input number here megabytes then an email will be sent warning the user of the excessive amount of space being used The title of the email will read WARNING Overview of FusionReactor Logs FusionReactor provides many helpful graphs and metrics to help you see how your system is performing These graphs are available in real time and will also show you a short history of what happened depending on the amount of data which has been generated but what happens when your server begins to crash Lots of this data is stored in memory so it can be used to generate reports and lists for the FusionReactor Administrator If you are having problems which cause or necessitate resta
26. System FusionReactor used to perform an action e Message This is a brief description of the action that the Subsystem performed Rotate Now To Rotate the logs click on the button that says Rotate Now This will generate a new archive based on the log information gathered since the previous archive was generated The archive will then be written to disk Clear All Archives To clear all the archives click on the button that says Clear All Archives Clicking this will ask you if you want to remove all archives clicking yes will remove them from the system WARNING Make sure you are 100 sure before removing all archives Purge Now To purge the logs click the button that says Purge Now Selecting this will purge remove archives based on rules that have be created by the user Information about purging can be found in the Log Settings section View Logs from a Different Date Clicking the lt symbol allows you to revert back to a previous date allowing you to view the details of older logs clicking the gt symbol advances the date allowing you to move through time and view more recent logs lt 2011 08 14 gt Transfer All Clicking this will transfer all the archives listed in the table to FusionAnalytics FusionAnalytics Settings This page is used to control how the FusionAnalytics Connector will handle log files for transfer to FRAM or FusionAnalytics DataCollector The options in the drop down box ar
27. The corresponding target server will need to be stopped to delete the FusionReactor instances Setup will guide you through the uninstallation process and you will be prompted if any instances are running before Setup will automatically try to restart them Instances that have not been correctly removed will remain installed on the Figure 3 Uninstall FusionReactor Instances Warning Figure 3 If you have other FusionReactor instances installed a warning message will be displayed to highlight the effects of removing FusionReactor Carefully read through this Once you have read it and you have understood it please click Next to uninstall all of the installed FusionReactor instances as well as FusionReactor Otherwise click Cancel to stop the uninstall FusionReactor 4 5 0 Uninstall FusionReactor Uninstall Please wait while FusionReactor is removed from your computer Uninstalling FusionReactor instances coldfusion cfinx9 HP Pdv6 Laptop Figure 4 Uninstall Progress Bar Figure 4 Once you have clicked Next the FusionReactor uninstaller will begin to uninstall FusionReactor and all of the installed FusionReactor instances Figure 5 Stopping a Server Instance Figure 5 If there is a FusionReactor instance that is running the server container for this needs to be stopped in order to successfully remove the FusionReactor Instance Press Yes if Setup should automatically attempt to stop the server instance No if yo
28. This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 2 0 on Solaris Upgrade Not Possible FusionReactor 4 x x does not support upgrades from FusionReactor 2 x If you currently have FusionReactor 2 x installed it is not possible to upgrade to FusionReactor 4 x x When running the FusionReactor 4 x x setup you will be presented with a screen similar to that shown in Figure 1 below setup Fusionkeactor 4 5 0 FusionReactor already installed setup has detected a previous version of FustonReactor Setup has detected that an older version of FusionReactor 2 0 0 is installed in loptfustonreactor The FusionReactor 4 0 0 installer does not support updating that version You must uninstall the older version of FusionReactor before restarting this installer Intergral Information Solutions Figure 1 Update Not Supported To install FusionReactor 4 5 x you must first uninstall FusionReactor 2 x and then run the FusionReactor 4 5 x Setup again Please follow the guide on how to Uninstall FusionReactor 2 x on Solaris Updating FusionReactor 1 0 on Solaris Upgrade Not Possible FusionReactor 4 x
29. Zero or more URLs which point fo FusionAnalytics DataCollectors These will be fhe recipients of archives processed by the FusionAnalytics Connector We recommend all targets are tested before proceeding save Connector Settings Figure 6 Check FRAM target Figure 6 After clicking the test Y button the listed FRAM target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful coldfusion cimxs JNTOO5F Are you sure you want to delete FRAM target http 127 0 0 1 3087 fusionreactor frest ctm Cancel Delete Figure 7 Remove FRAM Target Figure 7 By clicking for the listed FRAM target you will see a confirmation screen Click Delete if you are sure you wish to delete the specified FRAM target Click Cancel to go back to the FusionAnalytics Settings screen Figure 4 Username Status coldfusion cfmxs INTO05F 127 0 0 1 Port 8087 The hosiname and port number of the machine on which ihe FusionResctor Administration Manager is running restuser Password sess The uzemame and password of the FR REST AP user This is only required if ihe FRAI instance requires REST authentication a Check this box if your FusionReactor Adminisiration Manager uses HTTPS fo secure communications Test Target Save FRAM Settings Figure 8 Add
30. accept the agreement do not accept the agreement Intergral Information Solutions Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the I accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard Setup FusionReactor 4 5 0 Select Destination Directory Where should FusionReactor be installed Select the folder where you would like FusionReactor to be installed then click Next Destination directory opt fusionreactor Browse Required disk space 146 8 MB Free disk space 89 170 MB Intergral Information Solutions Figure 3 Installation Directory Selection Figure 3 Now you have to select the directory in which FusionReactor should be installed By default FusionReactor will be installed into opt FusionReactor Setup FusionReactor 4 5 0 FusionReactor Administration Manager ED The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 _ Configure ports manually fusion 4 reactor Administration Manager Intergral Information Solutions lt Back Next gt Cance
31. amount of memory that FusionReactor could use It is recommended that you increase this value in stages and check the memory usage after each increase once the server has run at least the number of request that are kept in the Request History Each query recorded only uses a very small amount of memory but this may become significant if you store hundreds or thousands of queries per request when multiplied by the number of requests maintained in your request history setting When queries are recorded in Slowest Order and the number of queries to record has been reached a slower query will be correctly inserted into the list of recorded queries according to the time it has taken to run and the last entry in the list will removed and added to the Summary Information This threshold value lets you record only SQL statements that run slower than the amount of time you specify here If the SQL statement runs faster than the time you specify it s data will still be added to the Summary information Description When this feature is enabled and a JDBC request is executed FusionReactor will store a Java Stack Trace which can be used to find out the location of each query that ran You change the amount of information which gets stored in this stack trace by going to the JDBC Stack Trace Filter page The resulting stack traces are visible from the Request Detail Page page and within the JDBC Log Files Description If JDBC Logging is ena
32. box to delete the group and refresh the page Enterprise Settings The Enterprise Settings page lets you modify various elements relating to the Enterprise Dashboard The page has the following items Server Shutdown Start Up Alerts Configuration Description Send Alert Email Heartbeat Settings for Monitored Instances Configuration Heartbeat Metrics Fetch Interval Seconds Heartbeat Timeout Seconds Heartbeat Failure Threshold Request Count Configuration With this option you can decide if you want to be sent a notifications via email when a machine starts up and shuts down just shuts down or you can opt to receive no notifications Disable option To receive notifications you must first configure your email server on the FusionReactor Settings page Description This interval tells FusionReactor how long to wait between each fetch of a monitored instance s metric data its heartbeat The heartbeat contains the data that is shown on the Enterprise Dashboard amp NOTE Increasing this value will lower the refresh rate of the metric data shown on the Enterprise Dashboard Decreasing this value may cause heartbeat failures It is NOT recommended to set this value below 5 seconds This timeout governs how long FusionReactor will wait for a heartbeat from a monitored server instance If no heartbeat is received within this time FusionReactor will count it as a heartbeat failure This settin
33. complex file system can take several minutes to complete If FusionReactor Administration Manager can t detect your instance you will have to install it manually See Man ual Instance Installation Install FusionReactor Instance Inside the Instance Manager you will be able to install FusionReactor into any server instance listed To do this click on the F button next to the desired server or click the F button in the rightmost column header to install FusionReactor into one or more server instances you need to tick the check boxes of the desired server instance or click the hyperlink Select All if you use the button in the column header IP Address Listen on all addresses Port Listen on external web server Administrator Manager Observer Adobe ColdFusion 6 C ColdFusiong coldfusion cfmxs intergra 6jsuuz The unigue name for fhe instance which musi nol confain any of the folowing characters Lai ng h F gt i 127 0 0 1 The P address used fo access fhe instance T if checked FusionReactors niemal webserver wil isien on all iP addresses 8089 The por number of ihe buli n web server of fhe instance Cy if checked FusionReactor wil be accessible from fhe JZEE axia mal web server Password Confirm A password fo profect ihe access fo fhe instance The password musi be af Joast ive characters long Use the same password for all users An empty password f
34. it The location where captured requests and responses are stored Description This value defines how many requests FusionReactor stores in memory Once the Request History reaches said number old requests will be removed when new ones arrive Stream Metrics Configuration Description Stream Metrics Specifies whether FusionReactor should track Statistics about how long it took to get a response back to the client Time to first byte time to completion bytes per second etc Request Log request log The Request Logs a set of rotating log files accessible over the Request Settings page are simple space separated files so they can be easily imported into database or spreadsheet applications Note that the amount of data stored in the log files is typically far greater than the number of requests shown on either the Request History or Request Log screens After a server restarts the Request Log screen will show the last entries on the Request Log even if these requests were run before the server restart You can change the amount of data shown on the Request Log screen by changing the View Size on the Request Settings page Refer to Log Settings to see where the logs are being stored The log file is formatted as follows Field Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The date on which this log entry was written Date Time ms 3 C This is the m
35. lt Back to go back to figure 2 or Cancefl to stop the installation Please wait while Setup installs FusionReactor Extensions for ColdFusion Setup on your computer nsions_windows_1 0 O exe Figure 4 Installation Once you have selected the values from the previous installer screens you will see the Progress page Figure 4 Setup FusionReactor Extensions for ColdFusion Setup 1 0 1 Ri Finished The FusionReactor Extensions for ColdFusion tool has been successfully installed Use this tool to install uninstall FusionReactor Extensions for ColdFusion on your ColdFusion servers Extensions for ColdFusion Figure 5 Finished Screen Once the installation is completed you will see the final screen By default you will be given the option to Start the ColdFusion Extensions Instance Installer as soon as the Installation is completed Uncheck this box if you don t want to run the application that installs FREC into coldfusion servers Click the Finish button to complete the installation and start installing FREC into FusionReactor instances Installing FREC into FusionReactor Instances Once you have installed the Manage Instances application run the manage instances application to install the actual plugin into your ColdFusion Instances in which FusionReactor has been installed Once you have run it eg FusionReactorColdFusionExtensions gt Manage from the Windows Start Menu you will see the following screen
36. run on Unix platforms and those which will run on Windows platforms You are free to run these scripts from this location but we would recommend you copy these templates before editing them You will then always have a pristine copy available for new scripts Worked Example Controlling Windows ColdFusion 8 from Windows In order to get you started we ve provided you with a worked example In our example scenario we will use a FusionReactor Enterprise Edition instance on a ColdFusion 7 instance to monitor a ColdFusion 8 installation also on Windows and running FusionReactor Enterprise Edition Enterprise Dashboard The first stage in preparing the environments is to ensure that both systems are running smoothly and the monitor is able to poll the target system for enterprise data Add the remote system to the monitor and check that Enterprise Dashboard is retrieving information from it Script Preparation For this example we ll be using the restart Coldfusion8 OnWindows bat script from the FusionReactor etc cp windows folder For our example we copy the example script to a temporary folder from where we can work on it copy restart Coldfusion8 OnWindows bat c tmp In order to customize the script we open it in an editor All provided example scripts are commented extensively There are a couple of variables we must customize in the script e We set the LOGFILE line 43 to c tmp script log e We change the USER and PWD lines 5
37. without the necessity for a reboot OSGi Bundle Inventory Name Description Bundle Information Contains a link to a website which contains further information about the bundle a brief description of the plugin and the name of the jar file that is the bundle Version Contains the version of the bundle as well as the name of the bundle ID Contains the ID assigned to each bundle the number can vary from execution to execution Type Lists if the software is a bundle or a bundle anda plugin Start Level Status Actions OSGi Environment Name Framework Started Current Run Level Properties Status Log osgi log Each bundle is executed starting from the lowest value to the highest If the status reads ACTIVE then the plugin is running if it reads RESOLVED it isn t running however it has the necessary files to be able to run Stop Stops execution of the plugin Start Starts execution of the plugin Logfile Contains information about when the plugin was started up and shutdown Configuration Clicking this allows you to configure the plugin see the FusionReactor Plugins page fora guide on different plugin configurations Description The framework that the OSGi uses The date when the OSGi environment began execution The current run level Various properties about the OSGi environment this is mostly used for debugging amp NOTE When technical support is required this information m
38. 00 cee ee eee 218 1 2 4 3 Enterprise Dashboard Servers and GroupS 2 2 eee cde ee ane siete a ede wa wes bade ies bidaw ees 218 12 5 Using log tiles 10 1rOUDISSMOOUISSUCS sons iS ew atG eo ea E be eae eA eae ded PEND eA 219 De CS MING NaN NOS gsi ered ag geese cS tt gk cetera fh E Sek nl ca he ete sh ey Age eg ce a rt gah E Maca eg aD 219 Kr MOG Sis a E Gh artes certo ee aa ea ae ices Peer uct A eta ds ane acta ag hte ape eae aed yh 220 L271 Slack hace Log Slackwtace log wack de ema aeee th cote a E eed He we ha acted ee Manta eee 220 1 3 Crash Protection and Monitoring with FusionReactor 0 0 ccc ee eee eee teens 221 to Feras r Proteccion BASICS s acca a E icc een Tue D See Race ae at E Sees Mae et ee andar org piers Sign an Ce 222 koce NOS SIGI GAS aus ects Sao geek Sees cae appa eed Se ie Cotes Deere hs esis Boe cc an a goers E ed 223 kokie COMMON ZEE Problems 2 sara Ac cd ka ey ay Bote Aa E Leet E dee at te Mica Ded teed gn ca acs lhc ae clark ln 223 1 3 1 1 2 Types of FusionReactor Crash Protection 0 00 eee eee eens 223 uPeG a Paes he 16 aY Vc Siae zan re eae ae a eer ne ee eee ee reer ae een ee S E A ae eee 223 1 3 1 2 Crash Proteccion IMpPleMeMAlON gus cnceata nates Waa ee eee a duane Bee Ree we dee ee Che 224 V4 2251 MmMpoemnemalon ses oh Seaport Mocca eter ence ge wi dione tes ca are enact ai a E Be Mean a cht ats hina Gaara eee een 224 ko lige POO UL OU ALS OS EXPaNEd rosdan pap ce cages N A AE Seek c
39. 17 58 15 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel Request Time Graph The Request Average Execution Time Graph is a graph of the request performance samples currently stored in memory by FusionReactor The time span of these samples will depend upon your history size and interval time see Resource Settings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data sampled every 5 seconds The graphs shows two independent values overlaid transparent the average execution time of the completed requests since the previous sample on the graph Blue and the average execution time of active requests at the point that the sample is taken Gray This graph gives you insight into the server Request performan
40. 25 ca orie noide thee ac tan E Gon eaten aw Gales dala ener tee a 344 10 0 2 Updating FUSIONMEACIOl OXON Solaris serias saa tend c aoctw ane areata a Sen he Gear ee aa ata a ea Ae ea 355 1010 3 Updating F sionReactor 2 0 0n SOlANS x ekck5 car erie Karae thereat diet Gets Bod aaa oe an dana egal a 366 1 0 64 Updating F sionReactor 1 0 ON Solaris sce a 22 0 vitor Qed caw kane A teh a ed Soha ate eee 367 GGO Console Installation On SOlANS ere ceeded caer ees ee ek teeta EN ee a Dee eta 367 12627 Installing FUSIOMREACIOrOAIMAGC 2 cer dts Meera hae ode Seo aoa ane ort Spe ace a oh oa aes en eae he 374 120 7 psialliig FUSIOnReAaCIOnAS x 0n Mag oc dauta nat dased Wak an tek paca dutee arated ead bee een depen ee ee 374 t67 2Updating FUSIONMEAClON aux On MAC serenisan siea tone arctw thane areata a ee ae wae aah bata AeA ea 385 126 8 Uninstalling FusionReactor on Mat a vcaaci daiwa tooo iwted date tok ta dates wade E adaware PENS eee ta 396 16 9 Uninstalling Fusion heactor on Solais lt c25 4ca fo ae ee ie Ne wee cE ee tM aati eee ha aad teed 400 1 6 10 Where are FusionReactor 4 s Manual Installer Packages 0 00 cee 404 1 6 041 Mantal Instance Installation c cz o2cndetut peta oa pend ear ee att ane eet a a Meare orn taney or E ak wee eer 405 1 6 11 Installing FusionReactor in Locked Down Environments 000 0c cece tees 408 1 7 JOBS Driver Wrapper Ser Gui to tr erer aA ites deh ape tao Gee clear ete feta aster pede Aca at ch
41. 9 Total Memory KB ace o48 341 888 422 114 43 933 Time ms Memory KB 3 477 Cur 9 42 449 Free 4273 5938 Also See Metrics Settings Enable Metrics Metrics Settings The Metrics Settings page lets you modify various elements relating to Metrics The page has the following items Metrics Configuration Description Enable Metrics Enable Metrics in order to access the System Metrics Longest Requests Slow Requests and Longest JDBC pages You can reset all metrics by disabling and re enabling Metrics Slow and Longest Running Requests Configuration History Size Slow Request Threshold s Slow and Longest Running Requests Configuration History Size Resources Request Activity Graph Request Time Graph JDBC Activity Graph JDBC Time Graph Memory Graphs e Memory Heap e Heap and Non Heap e Types of Memory Graphs CPU Graph List All Threads Resource Settings Resource Log resource lo Description This is the number of requests which will be shown on the Longest Requests and Slow Requests pages If a request takes longer than this number of seconds then it is considered a slow running request It will be displayed on the Slow Requests page and the slow page count on the System Metrics page will be increased amp NOTE This value does NOT effect that used in Crash Protection to decide Runtime Timeout Description This is the number of JDBC requests which will be shown on t
42. Administration Manager Password Figure 7 Here you will be asked to specify a password for FRAM s Administrator account It must be longer than 5 Characters el File Edit Miew Terminal Tabs Help After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter Y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana ger 8087 The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password 1s required to Log in to the FusionReactor Administration Manager to manage your FusilonReactor instances Password Validate Password Figure 8 Administration Manager Password Figure 8 You will be asked to validate your password Terminal Eile Edit Miew Terminal Tabs Help The FusionReactor Administration Manager uses a second port to listen for shutdof wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password 1s required to log in to the FusionReactor Administration Manager to manage your FusilonReactor instances Password Validate Password Which
43. Administrators e Managers e Observers amp NOTE FusionReactor does not have individual users with user names and passwords but three fixed accounts each of which has its own password Administrators Administrator is the most powerful type of user account in FusionReactor They are able to access all of the functions available in FusionReactor Note some features are only available on Enterprise Versions Creating and Maintaining new instances of FusionReactor on a computer Configuring the FusionReactor instances visible to the Enterprise Dashboard Enterprise only Configure Crash Protection and all other settings for an instance of FusionReactor Managing All User Accounts Uploading and Activation of License Keys Examine All Request and Metric Data Kill Running Requests Who should use the Administrator Account The Administrator should be used by users who need to create and maintain the instances of FusionReactor on computer setup and manage the instances that are visible on any Enterprise Dashboard and maintain the user accounts For example in hosting environments this account might be used by the hosting company to configure FusionReactor for customers on their application server instances Managers Managers are Instance Administrators They Manage or Administer a single instance of FusionReactor They are able to Note some features are only available on Enterprise Versions e Configuring the FusionReactor in
44. Below is the standard layout for any kind of memory log file excluding Memory Heap Non Heap log Field Name Date Formatted Time Formatted Date Time ms Version Server Startup Time ms Name Log File Type Number 1 A 2 B 3 C 4 D 5 E 6 F 7 G Description The date on which this resource probe was triggered The time at which this resource probe was triggered This is the millisecond time at which at which this resource probe was triggered Version number of this log entry Start up time of the application server in milliseconds ms since epoch The name that represents the memory pool The types of memory that the log relates to heap or non heap Memory Collection Used Percent Memory Collection Usage Used Bytes Memory Collection Usage Committed Bytes Memory Collection Usage Requested Bytes Memory Collection Usage Allowance Bytes Collection Usage Threshold Count Collection Usage Threshold bytes Is Collection Threshold Exceeded Memory Usage Used Percent Memory Usage Used Bytes Memory Usage Committed Bytes Memory Usage Requested Bytes Memory Usage Allowance Bytes Usage Threshold Count Usage Threshold bytes 8 H 9 I 10 J 11 K 12 L 13 M 14 N 15 O 16 P 17 Q 18 R 19 S 20 T 21 U 22 V The amount of collection memory used The amoun
45. For more information about FR REST please see the FR REST section on the Settings page lf FR REST authentication has been enabled the FR REST password needs to be specified By default FR REST authentication is enabled locally with no authentication For more information about FR REST please see the FR REST section on the Settings page Tick the check box if FRAM is using a secure HTTPS connection instead of regular HTTP Please see Setti ng Up FRAM with HTTPS for more information on how to set up FRAM to use a secure connection By clicking the button Test Target the specified FRAM target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful For more information please see the online documentation covering FRAM Target FusionAnalytics Connector Manager r Fusion nalytics Settings stage 2 of 2 coldfusion cimxs INTOOSF FusionAnalytics Connector Connector Mode SenttotargetsbyFRAM Controls how the FusionAnalytics Gonnector wll handle log files for fransfer fo FRAM or FusionAnalytics Geo htte 127 0 0 1 8087 4fusionreactor frest ctm OK The URL of a single FusionReactor Adminisiration Manager sever which will handle log archiving and transfer for this instance FusionAnalytics Targets Geo http int0084 8400 fadeimport coldfusionS zebra 4
46. Notification threshold has been reached on the size of the result set and REMINDER specifies that a result set size reminder interval has been reached Execution Start Time Value long millisecond Source Wrapper The start time in milliseconds from the epoch datum see Epoch Time above at which the JDBC interaction began i e the time at which the statement was transferred to the database driver for execution Execution End Time Value long millisecond Source Wrapper The time at which the underlying database driver finished executing the statement Result Set Close Time Value long millisecond Source Wrapper The time at which the result set was closed by the J2EE application e g ColdFusion etc This interval between this time and the Execution Start Time is useful as the total processing time for the query including database execution time and the time taken for the J2EE application to fully read and process the result set Execution Elapsed Time Value long millisecond Source Wrapper The time taken to execute the statement on the database computed from Execution Start and End times Result Set Elapsed Time Value long millisecond Source Wrapper The time taken between sending the statement to the underlying driver for execution and the J2EE application actually closing the result set computed from the Execution Start time and the Result Set Close Time Rows Read Value long Source Wrapper Specif
47. OGM Anoalicaian installed in ire FusorAaraiviics Data Collector faDataCollector 1 fre vane of the Data Collector installed it tre abore aoolicaiar Hon rouig name my Agolicatons and Osta Collector Password Re usemame and Dasson of 2 uger hO has access fo he FusorAraiics OataCallector aoolcaianr e Grech this fox if your FastorAraiytics OatatColecior uses APS fo Secu communica ons Test Target Save Target Settings Figure 1 Adding a target Field Host Port Application Name DataCollector Description The machine where FusionAnalytics is installed This example uses the local machine so the IP address is 127 0 0 1 or localhost The machine port If you changed the default port during the installation use that instead if not use the default 8400 The name of the DataCollector Application that you want to collect the data The name of the actual DataCollector that you want to receive the data Each DataCollector application can have multiple DataCollectors that receive data The default setting is one DataCollector named faDataCollector 1 Username Password HTTPS Status The username for a user who has access to the DataCollector application This is only used if the DataCollector requires authentication If you are using the default setting this is not needed The password for the above username Check this box if your DataCollector uses HTTPS For more information on
48. OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN OO NWOT INSTALL COPY DOWNLOAD OR OTHERWISE ETO hel TON LOT stn OL Gin L Figure 3 License Agreement Figure 3 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard setup Fusionkeactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation ETO hel Ohhh LOT sn OL init i Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the sever ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 setup Fusionkeactor 4 5 0 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports ETO hel Ohi E i Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified
49. Packard E gt Intergral Information Solutions GmbH Product version 4 5 0 16 01 2012 10 05 2012 03 04 2012 04 08 2011 16 08 2011 09 08 2011 11 01 2010 28 11 2009 11 01 2010 11 01 2010 11 01 2010 11 01 2010 11 01 2010 11 01 2010 11 01 2010 11 01 2010 11 01 2010 28 11 2009 nn ma mnnn 15 101 101 18 0 1025 168 3 0 4811 4 0 0 2 4 0 3 1 3 3 9512 3162 1 0 0 71 6 2 1 500 3 1 3509 3 1 2125 3 1 2206 3 1 3405 3 1 01 1 00 0000 3 1 2207 6 50 7 1 anaren mamn Support link http www fusion reactor com home html Help link http www fusion reac Figure 1 Navigate through the Add or Remove Programs application and find FusionReactor 4 0 x If you are sure you want to uninstall FusionReactor right click the FusionReactor entry you found and right click uninstall change FusionReactor Uninstall Are you sure you want to completely remove FusionReactor and all of its components Click Next to continue or Cancel to exit Setup Figure 2 FusionReactor Uninstall Figure 2 Once the Uninstaller has been started read the text that asks you if you want to remove FusionReactor and all it s components Click Next to continue on with the uninstall or click Cancel to exit the uninstaller wizard FusionReactor 4 5 0 Uninstall Instances Detected Instances of FusionReactor are still installed Warning To completely remove FusionReactor all installed FusionReactor instances will be removed
50. Quantity ora Runtime Timeout ora Low Memory ora Server Uptime Current Request Count q 41 secs Total Request Count a Average Request Time Recent 34637 me 36673ma Used Memory 16 20 401KB b CRASH PROTECTION Allocated Memory 83 008KB Maximum Memory 126 912KB Average Instance CPL ow b COMPRESSION EEE E mE b CONTENT FILTERS Queue Size a b PLUGINS LOGGING Recent Slow Pages Notifications In FusionReactor 4 0 6 Enterprise Edition notification information is also sent to the Enterprise Dashboard The cube icon will display a red badge whenever any new notifications are available and the count of new and total notifications for each monitored server is displayed in the information block Notification Log The notification log is a rotating log file much like the other logs generated by the system Fields are Space separated and records are line separated Fields which may contain spaces origin title and message are enclosed by double quotes Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Date Time Milliseconds 3 C This is the millisecond time at which this request was started or finished depending upon the Request Status Version 4 D Version number of this log entry Server Startup Time ms 5 E Startup time of the application server in milliseconds ms since epoch Action 6
51. Request History Request Settings Request Log request lo Request Capture Enterprise e Enterprise Dashboard e Manage Servers e Manage Groups e Enterprise Settings e Using Monitored Server Scripts Metrics e System Metrics e Longest Requests e Slow Requests e Longest JDBC e Metrics Settings Resources Request Activity Graph Request Time Graph JDBC Activity Graph JDBC Time Graph Memory Graphs e Memory Heap e Heap and Non Heap e Types of Memory Graphs CPU Graph List All Threads Resource Settings Resource Log resource lo Memory Logs e Memory Heap and Non Heap Log memorysummary log e Types of Memory Logs e CPU Thread Log cputhread log Crash Protection e Crash Protection Restrictions e Crash Protection Settings e Crash Protection Log crashprotection log JDBC e JDBC Settings e JDBC Stack Trace Filter e JDBC Log jdbc log Compression e Compression Settings e MIME Type Restrictions e Exclude URLs Content Filters e Search and Replace e Content Filter Restrictions e Filter Settings Plugins e Active Plugins e Open Services Gateway initiative OSGI e Reactor Log reactor log Logging e Log Archive e Log Settings e Overview of FusionReactor Logs Analytics Connector Status FusionAnalytics Settings FusionAnalytics DataCollector Targets Locked Naming Applications and DataCollectors FRAM Target Fusion Reactor e Enabling and Disable Notifications Notif
52. Sea cetera A 438 1 8 2 FusionReactor Deadlock PIUGIA rore enra weaken iatee ie tek oa tles fade E E a dates PEAS ee ea 440 1 8 3 FusionReactor Extensions for ColdFusion PREC 00 ccc eee tenets 443 18 051 Pree IMStallationOQuide 5 6 84 abies Mice ee Soh oR ee ee ek Be held bate ad Bee hee Ge ee one ne ae ta Be 444 1 8 3 1 1 Installing FusionReactor Extensions for ColdFusion FREC 0 000 cee eee 445 1 8 3 1 2 Installing FREC into FusionReactor Instances 002s 449 1 8 3 1 3 Uninstalling FREC from FusionReactor Instances 0 ceca 454 1 8 3 1 4 Uninstalling FusionReactor Extensions for ColdFusion FREC 0 0 cece eee 457 go 6 7 FREGE FIGS Rei ce Re eer a ee ee ae O a eee a eee eee 461 1 8 3 2 1 CF Database Connection Statistics dbpoolstats log 0 0 0 eae 461 1 8 3 2 2 CF Hit Count Statistics hitcountstats log 1 6 ee eee eee ees 462 1 9 3 2 3 GF Log Entries i Colatusion l0G OG ser 6 02 ete dare where hatte Send dare E dhe be ee ee 464 1 8 3 2 4 CF Realtime and Request Stats realtimestats log 0 0 0 eens 465 1 8 3 3 Configure FusionReactor ColdFusion Plugin FREC cc eee eens 469 1 8 3 4 How to enable FREG i256 Sgt stds Ge id ee Pee ch phi e os cee Sesh eee pe ara seg Stee el oes Bae Rca 470 10 4 Fusionneactor Hearibeal PIUQINt nerea e E n tae at wed daa A theta tweak Boe tote Naa eta 471 4B Ss USIOM IAS AC ION REAL Mate CED esasda seeds E NE E E
53. String Return Status Code 200 CPU Time ms O0 JDBC Queries Run 0 JDBC Total Time 0 JDBC Total Execution Time 0 JDBC Total Row Count 0 AMF Request None Bytes Sent 0 Time to First Byte ms O Time to Last Byte ms O Note Data is still streaming Time to Stream Open ms 1 Time to Stream Close ms Note Data is still streaming User Agent Mozilla 5 0 Windows NT 6 1 WOW64 AppleWebKit 535 19 KHTML like Gecko Chrome 18 0 1025 168 Safari 535 19 This is for notification only No special action was taken on the request Running Requests 5 1337071199613 2012 05 15 10 39 59 613 1304ms 127 0 0 1 http 127 0 0 1 8500 cf sleep cfm Complete details for all running requests appear after the stack trace below No new alerts will be generated until Tue May 15 10 41 00 CEST 2012 Alert complete FusionReactor JVM Stack Trace JVM ID 2 Thread ID Reference Handler Priority 10 Hashcode 60543300 java lang Object wait Object java 77 Nat ive Method java lang Object wait Object java 485 java lang ref ReferenceS ReferenceHandler r un Reference java 116 JVM ID 3 Thread ID Finalizer Priority 8 Hashcode 1142635176 java lang Object wait Object java 77 Nat ive Method java lang ref ReferenceQueue remove Refere nceQueue java 118 java lang ref ReferenceQueue remove Refere nceQueue java 134 java lang ref FinalizerSFinalizerThread ru n Finalizer java 1
54. Time values which are Oms There are a couple of explanations for this 1 The query never actually ran against the database If the query has been run before and if there were no conditions which invalidated the underlying driver s cache the result set may be delivered without actually running the query on the database This can save a lot of time and yields an Exec Time of Oms 2 The query ran but ran very quickly In some operating systems notably the Windows Server line including Windows XP the highest resolution of a timer available to Java is 10ms If the query ran faster than 5ms the timer will return a rounded down value of Oms This is unfortunately unavoidable If you have more queries which run on a page they ll be listed in the order they complete Also See Basic Setup of the JDBC Wrapper JDBC Driver Wrapper User Guide Pathologically bad pages Let s have a quick look at a couple of pathologically bad queries designed to produce lots of data Here s our test query The engineer is trying to work out which user u owns which object o but has gone for his lunch and on his return forgets to add a constraining where clause This query is going to select a cross join cartesian product of all Users against all Objects The user table as we ve already seen contains 2595 rows and the object table contains 24799 rows This will yield a Cartesian product of 2595 x 24799 64 353 405 rows Oblivious t
55. UD FRAM WI PO seriaro a ie a Seah creat ate ted tee atu eee E N eee A 207 Wee MIG STASIS sirara fe Ae acdsee we es es icc eas deepen age a aie Chars Pike osha Gee tee Bey Sieber Dvee ss ash eke Ae ele he 208 112024 UplOading VOU License Fle aisec cde Mare ag Pome ae Don ar eer arts ane ards Sara Sen N EE epee dns Aca een era 208 AZO 2 ACV ALON PLO arraren E TEn Sep Meant der ascot Geant acto Sg Mackie Oh aoe Bee aoe a dhs Se Maite earls N aga See ee 209 IZ ZOO LICEMSOIACIVANOM ghar denature sus Moire wen a ton ear eet ane ore wie a Sen Macon aes wat eter d tes cee E 211 1 1 20 4 Activating Multi Key License Files s sciseucaaa tote Wid ew eke o ta dune Pade ehs bases dee betew aks 213 1120 5 License PONGCY r s cka huts Aone a adn hee hans be E ees oe eget d ete een Madea a haart ee Rae ee Ps 213 1 2 Quick Start to Troubleshooting Server Problems with FusionReactor 00 ccc eect eee teens 213 422 1 GSTING FUSION Realo exe feat ogee tte eesti en a ae gee ee Na ea A weaned aha aaa des earn ee 214 1 2 2 Configuration and Diagnosis in Emergencies 0 ees 214 1 2 3 Contiguration and Diagnosis for Production ecs roterer thaw kd eowiate sd tawia sea heiate shadow eee es 216 1 2 4 Configuration for Enterprise and High Availability Environments 000 00s 217 1 2 4 1 Setting Up A Separate Monitoring Instance 0 0 eee eens 218 1 2 4 2 FusionReactor in High Availability Environments HAE 00
56. a sqlserver localhost 1433 databaseName testdb name MyDataSource eee eT Also See Creating a New Wrapped Datasource in ColdFusion Creating a New Wrapped Datasource in ColdFusion This section shows you how to create a wrapped datasource from scratch It explains how to construct JDBC URLs for ColdFusion s builtin drivers called the Macromedia drivers since they were introduced by Macromedia in ColdFusion MX as well as for existing custom non Macromedia datasources About Wrapped Datasources Underlying all ColdFusion and indeed all Java database interaction is a configuration string called a JDBC URL This string tells ColdFusion almost everything it needs to connect to the database which driver to use which machine to connect to which port and sometimes also the database login and password too When using a standard ColdFusion driver the ColdFusion Administrator application constructs this URL behind the scenes using the details you enter into the form about your server The FusionReactor JDBC Driver Wrapper requires this URL in order to function Fortunately finding it is quite simple Using Macromedia s DataDirect ColdFusion Built in Drivers Constructing JDBC URLs for other DataDirect Drivers CFMX 7 8 9 10 Using a User Specified Driver other Driver Using Macromedia s DataDirect ColdFusion Built in Drivers This page walks you through locating your Macromedia DataDirect ColdFusion Drivers and w
57. about a request such as script name execution time memory levels and flags Headers The Headers tab shows the HTTP headers for the request and response objects Cookies The Cookies tab takes the Cookie string from the Headers tab and renders it in a more readable format along with other cookie information such as maximum age and whether is it secure JDBC The JDBC tab will show any queries which have been run by your page If you also have User Trace Markers on this page then you can click the Include Markers link to create a merged view of both markers and queries At the bottom of the JDBC tab you will find the total and average times for queries running on this page Markers The Markers tab shows all User Trace Markers which were called during this request along with the amount of time which elapsed between them AMF If Flash Remoting Support is enabled Request Settings then the AMF tab displays BOTH the REQUEST and the RESPONSE which came in AMF format This is an essential tool for debugging RIA s AME is typically used in Flash Remoting and in applications such as Flex For further information refer to the AMF Dissector Plugin Refreshing the Page You can refresh the page at any time by pressing the refresh button which is located at the top right corner of the Request Detail page Also See AME Dissector Plugin Analyzing Data FusionAnalytics Importing and Graphing Data in Excel FusionAnalytics FusionAna
58. and notify strategy Illustration 1 shows this setting save Crash Protection Setings Once this has been committed with the ee _ button the Timeout Protection becomes active We can then run the pause script to show the protection in action In our browser we use the url pause cfm timeout 10 to ensure that the script is still running at the timeout protection limit of 8 seconds In fact since this is the first time the page has been run ColdFusion will require a short period to compile it first This additional time is also counted and tracked as part of the 8 second protection limit The page would therefore run for longer than the 10 second pause time giving the Timeout Protection ample opportunity to activate When the protection activates the Display Message abort strategy is used and the user sees an appropriate message j Fusion Reactor coldius _ http nth Abbr im fumeout 10 Request aborted by FusionReactor due to heavy system load The abort strategy and the display message are both configurable using the Crash Protection Settings screen which we used earlier to set up the protection Our pause cfm script simply uses a Java Thread sleep call in order to go to sleep so it is easy for FusionReactor to wake up this thread prior to killing it As we noted earlier though if the request was performing socket I O FusionReactor would be forced to wait until the script returned from the socket operation before it
59. and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Broken Down Memory Logs The heap memory and non heap memory can be further broken down to specific areas Every server handles areas of memory differently and refers to them using terms other servers may not use FusionReactor recognizes this and creates logs for all the different areas of memory that particular server supports furthermore the logs are named after the area of memory that the server uses making it easier for you to locate your logs For more information on broken down memory logs see the Types of Memory Logs section Also See Log Settings Heap and Non Heap Graphs Types of Memory Logs amp NOTE For FusionReactor to be able to detect what areas of memory are referred to in your server you must have Java 1 5 or above installed NOTE Each server ColdFusion Tomcat Railo etc has their own naming conventions for areas in memory When an instance of FusionReactor is installed on a server you will be able to see detailed logs for certain areas of memory that the server has The naming conventions used by your server for areas of memory will be listed in FusionReactor meaning you won t have to translate them to terms that relate to your server For example an area in memory in ColdFusion 9 is PS Old Gen so there is a log and a graph for PS Old Gen This page lists some of
60. be specified separately during the connection process In ColdFusion for example the two fields can be entered in the DataSource Manager Here s an example where the username and password is specified in the URL jdbc fusionreactor wrapper jdbc sqlserver gt int00d0 1433 databaseName AdventureWork s user scott password tiger driver com mi crosoft sqlserver jdbc SOQLServerDriver nam e testdb cp c jdbc sqljdbc4 jar N b this example won t work in ColdFusion because the username and password must be separately specified You can see in these examples that we ve used the cp option to specify the jar where previously you would have had to use the split jar process Because the driver is no longer reliant on the system supplied classloader JDBC drivers can be loaded from anywhere and the split jar process is no longer required Derby Embedded Apache Derby The Apache Derby embedded database is an in process no separate server database When this database driver is loaded the database is started in the JVM process itself a procedure which may only occur one time until the database is subsequently stopped You should therefore only used this database with a wrapped datasource you should not mix wrapped and unwrapped access to this datasource If you do mix these datasources FusionReacior will attempt to share the connection with the wrapped and unwrapped datasource which works in most cases though this is an unsupporte
61. cep ene ee 69 116 2 Crash PYOteCllioOm Senos merae na a wi a teen Src ea ane areata a Gy here er ede aa eta de Aaa 71 1 1 6 3 Crash Protection Log crashprotection l0g 0 ccc ee eee eee eee ees 75 ERT IDB oh ap nce cece aiagh pel aM cg gestae te a E 0 aie eh anaes ct ceca Mc a ert sence E cca ers 79 DST Peed SES SUNS waaa Sect ou eel Sa acer ceri a ag Meta tata ta Ts ect Beg ata ee Eta ase ete ROE 79 VW Pe IO BC SACKA E LON ronet Aa ee Pays wv de barn tonne Src en ceed a adenine aot ety ohm bata sea Aa 81 TAS Fa JBB LODIG OOO 0 5 sh cate Goce tet ec tee Acca E E Sh A E esas dea chee Aig eed a oa gan Wah aan aga Ae ted ha 82 TIS GCOMDICSSION oc vires Moanin E ata E hie nha He CLE AG ae A ate EE tee Ait T 84 AASB COMPRESSION SETINGS 2x5 Sct dct E dh ee ced ayant E Sp E a A diet eds Ga cgay alas han eee ate TR tee 84 1126 2 MIME Type REStICIONS 7 sectste c ten Meare arn toe we en ear e mang ad hades ahaha a dete a Water eta 85 1126 S EXClUGeTURIGS thay date ee e S44 Sudan aa atae E Seah ein Cok area E Sea nw a aes Bea ae hte 87 TAD COMEMUCRINGIS soss te ree a tua haiti nha eaten caw than a Seah aii te E E tea Aiea 89 ASGOE 1 SAIC REDAC seks oa Soca soph cee Seis Acca her acc gence ag ees oe a Cartes dae aes oa cee ea al Pee eee Te Ne te 89 151 0 2 COMIEM PINESPIMNCSIICHONS nerees tue Mtn Ge et ee a Got aoe ket ane ate dst ca yt A chet head cape Scab an water ae hak Ace Sue ete la 90 CES Fer GUUS mereri ra e Gaces tot tec te
62. configuring instances Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 setup Fusionkeactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue inthe FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances Tou must use the Instance Manager to install or update your Instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Finish a Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some addi
63. ee ee ee eee Hy jdbc macromedia sqlserver host por t databaseName database SelectMethod selectmethod sendStringParametersAsUn icode sendStringParametersAsUnicode Lie ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee eee eee ee ee ee eee eee Using a User Specified Driver other Driver This guide walks you through locating the JDBC URL of your data source in ColdFusion and then wrapping them using the ColdFusion wrapper Locating your Macromedia s DataDirect ColdFusion Built in Drivers In the ColdFusion Administrator click on Server Settings in the table of contents then click on the Settings Summary link Locate the section with the heading Database amp Services and the table with the name Database Data Sources Locate the JDBC URL of the datasource that you want to wrap with a FusionReactor wrapper and then copy it or write it down Y SERVER SETTINGS Settings Request Tuning Caching Client Variables CF data source name cfartgallery Description Driver Apache Derby Embedded JDBC URL jdbe derby C ColdFusion9 db artgallery create false Wemory Vari B5 Me ory Variabl 5 Usemame Mappings Mail Login timeout 30 seconds Charting Long text buffer size 64000 Font Management Timeout 1200 seconds Document Maintain connections Yes Java and JVM Interval 420 seconds Settings Summary Restricted SQL operations Your JDBC URL will most likely be different the purpose of the scr
64. entries are updated every 5 seconds Below is a table explaining each of the attributes in the log Field Name Date Formatted Time Formatted Date Time Milliseconds Get Log Version Date Time that FusionReactor stated Milliseconds Active Session Count Application Scope Size bytes Average Response Time milliseconds Cached Query Count CFC Requests Queued CFC Requests Running CFC Requests Timed Out CF Thread Queued CF Thread Running Concurrent User Count Number 1 A 2 B 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K 12 L 13 M 14 N 15 O Description The date on which this log entry was written The time on which this log entry was written This is the millisecond time at which this request started This is the version of the log file The time that the instance of FusionReactor that is running the plugin started The current amount of sessions on the server The size of the application The average server response time The number of queries that are stored in cache The number of CFC requests Sent via HTTP that were queued and are waiting to run The number of CFC requests Sent via HTTP that are currently running The number of CFC requests Sent via HTTP that were timed out whilst waiting to run The number of CF threads that are queued NOTE Value currently set at ZERO The numbe
65. entry Startup time of the application server in milliseconds ms since epoch The type of Crash Protection which caused this log entry to be written The action which was carried out on this request by Crash Protection The percentage of free memory at the time of this log entry The threshold percentage of free memory set up in Crash Protection settings The number of currently running requests at the time of this log entry The threshold number of currently running requests set up in Crash Protection settings The current execution time of this request at the time of this log entry The threshold execution time set up in Crash Protection settings The ID of the server for Server Up Down notifications The script that you set up in the Crash Protection settings including passed parameters if available The date on which this request was started or finished depending upon the Request Status Time Formatted Date Time ms Version Server Startup Time ms Request ID Request Status CP Reason Thread ID Client IP Address Request Method Request URL Execution Time ms Used Memory percentage Max Memory KB 17 Q 18 R 19 S 20 T 21 U 22 V 23 W 24 X 25 Y 26 Z 27 AA 28 AB 29 AC 30 AD The time at which this request was started or finished depending upon the Request Status This is the millisecond ti
66. few minutes depending on the machine running the Setup Setup FusionReactor 4 5 0 You are now ready to start configuring instances Mi Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Start configuring instances J Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 Setup FusionReactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on
67. form for you to enter new filters and below this is a list of all existing filters for this feature New Search and Replace Filter To enter a Search and Replace filter you will need to fill the following fields Configuration Find What Replace With Replace Find What Find this Exact Text your text Replace With leave blank to Search and Remove Replace All Managing Existing Search and Replace Filters Description Firstly you should select if you want to search for an Exact String or if you want to use Regular Expressions to search for a pattern For examples of Regular expressions see Regular Expressions and Content Filters Once you have selected the search type you should enter the your search string in the text field provided This field contains the text you want to replace your search string with If you just want to search for a string and remove it from your page then simply leave this field blank This option lets you decide if you want to replace all instances of your search string All or just the first one found on the page First Below the Add Group form you will see a list of all existing filters Each group has two icons next to it Button Name Description Fe Modify Group Click this icon to change a group name or to change the servers which are currently a part of this group New Search and Replace Filter gt Delete Group Clicking on this icon will prompt you i
68. from an appropriate shell script On Windows systems anything that is runnable as a binary or can be run from the command prompt for instance e Binary programs e Batch files How Do I Configure an Enterprise Script Enterprise scripts are configured by editing the Script of the server s property page accessible in the Enterprise gt Manage Servers page then clicking on the Modify icon S of the required server Enterprise Modify Server Name Icfusion jrund myrtle This is URL This is the URL of an instance of FusionReacto http 1277 0 0 1 8088 Ausionreactor hipin 7 0 0 1 8089 tusionreactor Password anaes Enter i Script Usersihawksl eyimptestsh This s down ALT You should take care to ensure the full path and filename to the script are correct When Does FusionReactor Run Enterprise Scripts Enterprise Scripts are run whenever the Enterprise Monitor detects that a monitored instance has changed state e an instance which was previously available is no longer providing Enterprise data e an instance which was previously unavailable has begun to provide Enterprise data Scripts are run only if an instance changes state while it is being observed Additionally scripts are only run if e The Enterprise Server Alerting system is running e This is configured in Enterprise Settings gt Server Shutdown Start Up Alerts e Atleast On Shutdown must be selected If you wish to run scripts when an instance be
69. heap memory the method area may be of a fixed or variable size e Permanent Generation The pool containing all the reflective data of the virtual machine itself such as class and method objects With Java VMs that use class data sharing this generation is divided into read only and read write areas e Code Cache The HotSpot Java VM also includes a code cache containing memory that is used for compilation and storage of native code Resources Heap Non Heap Memory Graph P Heap Non Heap M Non Heap T T Ss z S a T T i T Z D 5 13 23 05 13 34 38 13 42 29 13 50 30 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data Why would want to see a Heap and Non Heap Memory This graph is very efficient as it allows you to quickly analyze non heap memory heap memory and a combination of both Not only that but because it can cover larger periods of time you can see if anything is becoming critical meaning you can act before it is to late This kind of trend is much more difficult to spot if you are only checking the system periodically and are only looking at the health of the system right at this point in time amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of d
70. hour system Choosing Enabled will rotate the logs after a crash has occurred also if FusionAnalytics is available it will queue them for transmission Choosing Disabled will mean that the logs aren t rotated after a crash Description You can choose to keep archives for a certain number of days or until they reach a certain size MB Input a value based on the Retention Strategy you choose If you choose to keep them for a certain number of days this value is that number If you wish to retain only a certain total size of archive enter the size in MB here Automatic Purge Set Don t Keep by default Archive Location Log Archive Monitor Settings Configuration Log Archive Mail Job Scheduled Time Warning Threshold If you set this option to Enabled then archives will be purged based on the Retention Strategy you choose if you choose Disabled then archives will never be purged WARNING Disabling this option will allow archives to grow without bounds however enabling it will cause unsecured not backed up archives to be removed Carefully consider what option you select here The archive is purged when you select the Purge Now button in the Connector Status or Log Status page and after a new archive zip is added to the archive The purge mechanism always considers oldest archives first deleting until the retention strategy sel ect above is satisfied Archives marked Keep in Connector
71. important information before continuing Please read the following License Agreement You must accept the terms of this agreement before continuing with the installation INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA T IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO hl INSTALL COPY DOWNLOAD OR OTHERWISE LE SF WARE SHA APPLY ONLY TO THE SOFTWARE O accept the agreement do not accept the agreement Intergral Information Solutions Se re EEE lt Back J Next gt Cancel Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard ANO Setup FusionReactor 4 5 0 Select Destination Directory Where should FusionReactor be installed Select the folder where you would like FusionReactor to be installed then click Next Destination directory Browse
72. in a deadlock as they cannot proceed until they get the resource they require and they cannot as the other Thread won t give up that resource until they have completed their operation Thread 1 may even have a hold on other resources for example Object3 Object4 and Object5 that other threads require causing further deadlocks Lalce o mm Thread 2 is holding wants is holding The diagram accompanies the text above There is no specific effect that a deadlock will have on your application as there are no two identical applications Some of the effects of deadlocks can include slow performance and high memory consumption in sever cases they can bring your application to a complete halt Reading the notifications this plugin generates can help you pinpoint where deadlocks are occurring in your application with this knowledge you can make a decision as to how to proceed amp NOTE To use this plugin you need to be using Java 1 5 or greater and FusionReactor 4 0 6 or above Notification If the plugin detects a deadlock a notification will be created The notification contains information about the deadlock this information can be used to determine how the deadlock occurred Origin Time Severity Plugin FusionReactor 30 Jan 12 09 42 30 100 Warning Deadlock Detector Plugin Plugin FusionReactor 30 Jan 12 09 42 30 120 Warning Deadlock Detector Plugin Log File deadlock log A Java Thread deadlock has occured A Java T
73. in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specif an Administrator password for FusionReactor Administration Manager ETO hell Ohi LOT rn OL inns L Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long Define user and group Which user and group should FusionReactor Administration Wanager run under Select or manually enter the owner and group of this installation The user and group selected here must have write prmaleges on your J2EE container s configuration files ff you unsure use the same user your J2EE container runs as or root User nobody Group bin r Mterateintmenmienai eE Back ext gt Cancel L Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM Please Note FusionReactor Administration Manager FRAM must be installed as a user who has a real shell and can log in to the system By default the installer will pick nobody root for
74. in which this statement is running Message Value String Source Wrapper For NOTIFICATION or REMINDER log messages this field contains the text of the notification or reminder Prepared Statement Positional Bind Parameters Replacement Strings During presentation of the statement text for Prepared Statements the FusionReactor JDBC Driver Wrapper attempts to replace the bind parameter placeholder with an appropriate representation of the bound value for that parameter This is not always possible for example with binary streams The following table details the replacement Textual replacements in italics have no feasible representation and are inserted as literals All other types are converted to their string representation for output Parameter Type PreparedStatement Method Text Representation SQL Array setArray SQL ARRAY ASCII Stream setAsciiStream ASCII STREAM Binary Stream setBinaryStream BINARY STREAM Big Decimal Blob Boolean Byte Bytes CharacterStream Clob Date Double Floating Point Number Integral Number Long Integral Number Null Object Reference Short Integral Number String Time Timestamp Unicode Stream Uniform Resource Locator New in FusionReactor 4 5 1 setBigDecimal setBlob setBoolean setByte setBytes setCharacterStream setClob setDate setDouble setFloat setint setLong setN
75. is the port that the FusionAnalytics Server is listening on This is specified in the FusionAnalytics installation By default the port for FusionAnalytics is 8400 Application name The name of the DataCollector Application that you want to collect the data DataCollector Username Password HTTPS Status The name of the actual DataCollector that you want to receive the data Each DataCollector application can have multiple DataCollectors that receive data The default setting is one DataCollector named faDataCollector 1 The username for a user who has access to the DataCollector application This is only used if the DataCollector requires authentication If you are using the default setting this is not needed The password for the above username Tick the check box if the FusionAnalytics DataCollector is using a secure HIT TPS connection instead of regular HTTP Please see Setting Up FusionAnalytics with HTTPS for more information on how to set up FusionAnalytics to use a secure connection By clicking the button Test Target the specified FusionAnalytics target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful For more information please see the online documentation covering FusionAnalytics DataCollector Targets coldtusion cfimxs JNTO
76. it They are Button Name Description Request Detail If you click this button then you will be taken to the Request Details page which gives you access to all information associated with a request eg Cookies JDBC Headers User Trace Markers and AMF data Add to CP Restrictions If you click this button then you will be taken to the Crash Protection Restrictions page which will be filled out for this request amp NOTE Over extended periods of time you may find that this list gets filled with very long running requests In order to see some of the medium running requests again you can empty the list by clicking on the Clear Longest Requests button Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh a are iSecond Lee ten eg Max Alloc Free Used 9 Total Memory KB 466 046 341 686 422 114 43 933 Time ms Memory KB 3 477 Cur 9 42 449 Free 473 598 Also See Metrics Settings Enable Metrics Slow Requests The Slow Requests page shows a list of currently running and completed requests which have taken longer to run than the current Slow Request Threshold which is defined on the Metrics Settings page To change the size o
77. jdbc sqljdb c4 jar Users of the Apache Derby database on ColdFusion must also use the autoCommit false option to prevent CF committing the transaction before all data has been read FRS 289 Using the JDBC Wrapper with Apache Derby Database on ColdFusion refers FusionReactor Plugins FusionReactor 4 introduces a new OSGi based plugin architecture to enable new features to be seamlessly deployed and ensuring we can enhance the monitor with additional functionality that you request in the future AMF Dissector Plugin FusionReactor Deadlock Plugin FusionReactor Extensions for ColdFusion FREC e FREC Installation Guide e Installing FusionReactor Extensions for ColdFusion FREC e Installing FREC into FusionReactor Instances e Uninstalling FREC from FusionReactor Instances e Uninstalling FusionReactor Extensions for ColdFusion FREC e FREC Log Files e CF Database Connection Statistics dbpoolstats log e CF Hit Count Statistics hitcountstats log e CF Log Entries fr coldfusion log log e CF Realtime and Request Stats realtimestats log e Configure FusionReactor ColdFusion Plugin FREC e How to enable FREC FusionReactor Heartbeat Plugin FusionReactor JRun Plugin FusionReactor Log Rotator Plugin FusionReactor Notification Generator Plugin AMF Dissector Plugin Description The Action Message Format AMF Dissector provides a means to see the AMF messages being sent to and from the server from within FusionReactor s Re
78. log information gathered since the previous archive was generated The archive will then be written to disk Purge Now To purge the logs click the button that says Purge Now Selecting this will purge remove archives based on rules that have be created by the user Information about purging can be found in the Log Settings section Clear All Archives To clear all the archives click on the button that says Clear All Archives Clicking this will ask you if you want to remove all archives clicking yes will remove them from the system WARNING Make sure you are 100 sure before removing all archives as doing so may compromise your system View Logs From a Different Date Clicking the lt symbol allows you to revert back to a previous date allowing you to view the details of older logs clicking the gt symbol advances the date allowing you to move through time and view more recent logs lt 2011 08 14 gt Log Settings This page is used to alter log engine settings log rotation settings lot archive settings and log archive monitor settings The page is broken up into sections each containing a table explaining the options that can be chosen in drop down boxes or input into text fields Locating Log Files The location of the FusionReactor logs will depend on the mode of logging you are using and how you have configured your Log Directory Below is a table covering the two types of log rotations that exist in Fus
79. many pages have been aborted due to each of the three types of Crash Protection Clicking on the various Crash Protection types will show you all requests from the current request history which were aborted for that reason Return Code This section lists all HTTP return codes which have been returned by this server Each return code is also a link which will show you all requests from the current request history which have that return code amp NOTE Many of the values shown on this page are counts based on all pages which have been run on this server If you see that the number of requests which returned 200 OK is in the thousands the number of requests actually listed will depend upon the Request History size which is defined in Request Settings It is quite possible that if enough requests have been processed since the last 500 Internal Server Error then clicking on that link may not show any requests at all Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh Also See Metrics Settings Enable Metrics Longest Requests The Longest Requests page shows a list of the longest running requests on this server To change the size of the Longest Request li
80. named as follows e DETECTION_METHOD One of timeout freemem or requests specifying the protection which fired e T HRESHOLD_VALUE The threshold value associated with this protection e ACTUAL VALUE The actual value which caused this rule to fire For the timeout method the threshold and actual values are specified in milliseconds For the freemem method the values are in megabytes Best Practices in Redirection We believe redirection is a great way to provided branded error output to clients but there are a couple of caveats to be aware of Making Marginal Situations Worse If you target a redirection to a page which resides within the J2EE container that FusionReactor is currently monitoring you may make a marginal situation worse by providing additional load Using a redirection target in the same container is possible indeed this may be your only option so try to design target pages which place low demands on the server e Few images Low memory demand from J2EE scripting languages JSP CF etc e Low processor demand no database work no CPU intensive computation Design of redirection targets should therefore be a compromise between corporate branding guidelines and server load Redirection Isn t Always Possible FusionReactor uses an HTTP Temporary Redirect to instruct the client to display the redirection target page This is the safest fastest way of sending a redirect It guarantees the returned page i
81. no longer possible for us to supply manual installs or updates The changes and customization required for each update would be too great to perform reliably by hand FusionReactor Administration Manager FRAM Instead of installing FusionReactor directly into your J2EE container e g ColdFusion you now use FRAM to do this FRAM the lightweight Administration Manager now takes care of individual installs in its Instance Manager which is now available to both Enterprise and Standard customers No GUI Most of our customers used the manual installer because they were running on Linux or Unix servers and didn t have X Windows available to provide a GUI Some customers used manual installs because our installer didn t recognize their J2EE server In the first case we ve added full command line capability to the installer just start it with the ec option in a terminal login no GUI required sudo FusionReactor linux 4 5 0 sh c In the second case try the following e In FRAM s Instance Manager have it scan exactly the folder in which your J2EE container is installed e If it s still not found try to add it as a supported server using the Add Server form at the top of the Instance Manager lf after that it s still not found Last Resort Manual Install Firstly please get in touch with us We d love to know what server you re having trouble with so we can add it to a future release of FusionReactor FusionReactor co
82. oePUSIOM Reactor Ar RIA trr e et crear E Bote enh Caan te de Seah og he hae aya date aya tee ere 135 111 8 PE RAPU EXAMpIOS AMC OlOEUSION kerar what ayer dunes Bon hae ewe tan det edie aed BRN oa nd aha dat ane eee tele Pea 135 11219 FR Administration Manager FRAM 2ccidatekhee ogres E EE EARE teed aie eek heed deat E he 151 ERIT ats tc levers Manag een ae ne ene eee ee ee eee ee aes eee ea eee eee eee ee ee eer ere tee ee er 152 TAOS AMA SEIVEE SCAN sorria Gare eee oiler To trie Leckie tee Ut Ets ae hls Sh N thee Ui alae Meh koe 156 Teds eer MAI DG ALG fait aes acter acerca as Guten aes Mate Moin aa acta ited gh ota 8 Sie de aad eee cee 160 TIS To Add oeme amp ocan oyst ayere n a om Alcea oltee artz candy cot Sage Suen ceca ey reg E Stel ape she Nee cee Geen 161 tell Oe 4 stall FUSIONIRGACIOR INSTANCE eaae Gens ay ee gua adopted Sn ade anno anew dae a ee Ch 162 1219 15 Uninstall Fusionmeacior metant Enee a eh EEEE E teh cate uae Sars dates teehee ees 169 TEISTO EGIGFUSIOMREACIOOINSIANCE cic cerita nar aiae Gog May Caesar Soph ened Sn Madar dette deena E ENA hs 174 1191 7 Edit PusiOnAnalvilcs COnneClOn semeia acces teh iether E tar cwkulema gated teehee wuts 177 1t 419 1 8 Update F usionReactor Instance scririst enis Koare AE EE Becta E A E ENEE E 196 TW Os OG OUI CG OMIIGUINAUONIS aes a a a Anse a Aa A E E E A E aha arp be he AA E 205 PeTo LAC MASUD POMS COME OULALLOMNS seriar a a A A A E E E E E E ENEE O 206 ERIS Setmo
83. of the Disable user type buttons Disable Manager The Manager User has been disabled Disable Observer The Observer User has been disabled You can reenable a login at any time by setting anew password above Enable a User Account To enable a user type which has been disabled just set a new password for that user type Change FR REST Password Change FR REST Password To change the FR REST password simply type in the old password Old FR REST password field then type in a new one below New FR REST Password and verify it below Confirm new FR REST password and click the button that says Save FR REST Password This page allows you to change the FR REST access password for FusionReactor Avalid password must be supplied by REST HTTP clients ifthe setting Enable FR REST API in FusionReactor Settings is setto require authentication Old FR REST password Enter the old FR REST password I New FR REST password Enter the new FR REST password Confirm new FR REST password Type the new FR REST password again Create FR REST Password If you have never created a FR REST password you will not be able to type anything into the Old FR REST Password field just proceed to filling in both the text fields below and click the button that says Save FR REST Password This page allows you to change the FR REST access password for FusionReactor Avalid password must be supplied by REST HTTP clients ifthe setting Enable F
84. on how to upgrade About page in FusionReactor Types of licenses For information on the different kinds of licenses you can purchase check out the comparison page on the website For information on how to purchase licenses check out the FusionReactor website Activation Period Once you upload your license you have 10 days to activate it for information on how to do so see the Activation Period section Activating Multiple Key License Files One license file can contain many keys meaning you don t need several license files if you intend to use FusionReactor on many machines for more information on this see the Activating Multi Key License Files sectio n and the License Policy section Also See Uploading your License File Activation Period License Activation Activating Multi Key License Files License Policy Install FusionReactor Instance License Purchase Page Help Clicking on this link will take you to the help system which you are reading right now Logout Click the Logout link to exit the FusionReactor Administrator and be returned to the login page Request Detail Stack Tracing Request Detail Page Stack Tracing Stack traces are split into two sections Firstly comes a set of information associated with this thread or request Please note that you will see more information here when Stack Tracing a request rather than a thread After these information fields you will see the Stack Trace itself No
85. on the Activate Current License link to activate it For information on activating a license whilst you are either online or offline please see License Activation to find out how to activate your license Activation Period Once you have uploaded a license key you have 10 days to activate that license It is recommended that you activate your license immediately after upload If you do not activate your license within 10 days you will be unable to use FusionReacior until you activate the license The next time you log into FRAM you will be shown the image below Figure 1 fusion ma reactor Administration Manager Your activation period has expired You can unlock this version at any time by activating the license as user Administrator Please note that if you have recently activated the license using another instance on this server this instance should unlock within the next few seconds User Role Administrator Password Login License Expiry Date Fri Aug 3 2012 INTER GRAL Revision 4 0 0 Build FusionReactor 505 721861 FusionReactor is a trademark of Intergral GmbH FusionReactor Copyright amp 2005 2011 Intergral GmbH All rights reserved Figure 1 Activation Expired To activate the license after the 10 days activation period has expired you must login as the Administrator and then click on Activate current license If your license has ran out of activations you will be shown Figure 2 Otherwise you
86. or more servers When you install an Enterprise version of FusionReactor on a server it can be queried for its current state The Enterprise Dashboard lets you instantly monitor the health of ALL of your server instances machines from a single window You immediately see the state of memory CPU DB load and average request time in an easy to read graphical dashboard display By default you will see your install server in the Enterprise Dashboard but using the Manage Servers page you can add any other server which is running FusionReactor Once you have your machines set up go to the Dashboard The default view when bringing up the Enterprise Dashboard is to show all groups which can be set up on the Manage Groups page along with any servers which are currently ungrouped Group Icons You can group machines together to help organize your dashboard see Manage Groups for more information Each machine and group is represented by an icon which will change color to indicate its current health As well as this clicking on a server or group will give you its most recent statistics The dashboard also provides links to each monitored instance so it is a simple job to investigate a server further Clicking on a group icon will display all servers within that group You will also see the Group Information Pane which will display statistics about the group and the servers within By default the group icon will be displayed in blue but if any grouped
87. refreshed and your new restriction will be listed at the bottom of the page Managing Content Filter Restrictions Below the Add Restriction form you will see a list of all existing restrictions Each restriction has two icons next to it Button Name Description P Modify Restriction Clicking on this icon will take you to the Modify Restriction page From this page you can change any of the information which is listed above New Content Filter Restrictions x Delete Restriction Clicking on this icon will prompt you if you are sure you want to delete this restriction If you OK the dialog then the restriction will be removed from the Existing Restrictions list and the page will be refreshed Request Params WEB myfolderimytile ctm No Filter Settings The Content Filter Settings page lets you turn on or off the Search and Replace feature as well as letting you define how the Filter Restrictions behave Content Filters Configuration Description Search and Replace When this option is Enabled FusionReactor will run responses through the Search and Replace feature unless otherwise instructed by the Filter Restrictions Content Filter Restrictions Configuration Description Filter Restrictions This value defines how Filter Restrictions behave e Filter requests that match the rules By default no requests will be run through the Search and Replace filters If a request matches one of the rules defined on the F
88. requested pages set in the CP Restrictions page Once you have added your scheduled tasks as restrictions the operational values for Timeout Memory and Request Protection can be adjusted since they will no longer apply to the exceptional cases Numeric Analysis The second method of setting Crash Protection values uses the log files generated by Crash Protection to generate a measure of the statistical soread of page runtimes Using this measure we can compute a statistical upper bound to the runtime which can serve as a starting point for further tuning Computing Standard Deviation of Page Runtime Computing the statistical standard deviation of page runtimes gives you a weighted measure of the spread of the values We can then use this measure to set the Timeout Protection The simplest method of computing this value is to take advantage of FusionReactor s Request Log You can get more information on how to use the logs in Overview of FusionReacior Logs Computing Standard Deviation of Page in OpenOffice 1 Ensure Requests gt Request Settings gt Request Logging is Enabled 2 Allow the system to run in its steady state for a while the longer the better 3 Load the request log FusionReactor instances NAME log request 0 log into OpenOffice Calc a Open the file as a Text CSV file with options Separated by Space Text delimiter 4 Create a new sheet Insert gt Sheet naming the new sheet Sheetz2 Switch back
89. rightto enable FusionReactor Enable FusionReactor Notifications This page allows you to see all the notifications that FusionReactor has raised Notifications are messages from FusionReactor s various subsystems that alert you to conditions which require attention or are otherwise abnormal You can navigate to this page by clicking on FusionReactor in the table of contents then clicking on Notificatio ns or clicking on the text in the table of contents that says New or Old Notification Figure 1 Notifications are presented in a table Figure 2 with the following headings Name Description Origin The subsystem or plugin which raised the notification Time The time the notification was created Title A succinct title usually containing a summary of the condition Message A more verbose message This may contain actions required to relieve the abnormality Actions e Mark Read marks this notification as having been read It won t appear as a New Notification in the table of contents or Enterprise Dashboard for customers with applicable licenses The row will be grayed out slightly to indicate this notification has been read The Mark Read button will change to Mark Unread which resets the notification back to its unread state e Remove removes this notification Some notifications usually serious issues can t be removed They will be removed by the originating system when the condition to which they pertain cl
90. select e Database transfers the complete result set back to the driver e Driver makes each row available to the application Cursor Selection Method Here is the same process when the driver operates in cursor selection mode Application performs an SQL select JDBC driver transfers the request to the database Database performs the select Database opens a cursor and sends the first batch of rows back Driver makes the first batch of rows available Application eventually requests a row which wasn t in the first batch Driver asks the database for more rows Database uses the cursor to see where it was in the results and transfers the next batch etc until the application closes the query or the database exhausts the cursor Pros and Cons Direct mode transfers all the data at once The data is then stored in the driver s memory space Pros e Very fast for the application to iterate through rows because all data is immediately available e Useful for fast batch work where speed is preferable over low memory usage Cons e Large result sets will consume a lot of memory You must account for this memory when configuring your J2EE ColdFusion application server You must provide enough margin for the size of the largest result set to be requested e Repeatedly opening large result sets may cause Java to perform major garbage collections often causing the application to become less responsive e Concurrently opening l
91. setfacl m dit trwx posto s29 x 0d or x dimsrwx dig fusronsrwx W JDBC Driver Wrapper User Guide JDBC Driver Wrapper Overview Installation in ColdFusion Creating a New Wrapped Datasource in ColdFusion e Using Macromedia s DataDirect ColdFusion Built in Drivers e Constructing JDBC URLs for other DataDirect Drivers CFMX 7 8 9 10 e Using a User Specified Driver other Driver Using the FusionReactor JDBC Wrapper Interpreting JDBC Log Data Prepared Statement Positional Bind Parameters Replacement Strings A Note On SQL Server Select Methods Exception Catalog FusionReactor 4 5 0 Upgrading to 4 5 0 from the Split Jar Procedure JDBC Driver Wrapper Overview The FusionReactor JDBC Driver Wrapper allows developers and administrators to control the interaction between Java and a database The driver wrapper allows fine grained metrics and reporting of database activity e Logging of statements which ran against a database This feature is useful to help detect deadlocks see exactly what Statements look like without resorting to manual log output and to see exactly how your Prepared Statements were bound before being run against the database e Row Limiting The integrated row limiter can automatically halt database read activity after a user specifiable number of rows is reached This can stop run away queries before they become a memory and resource problem e Notification and Reminders The driver can optionally n
92. the button on the right to activate your License Activate License Activate FusionReactor Activation To get your Activation Key please enter your Activation Input String and click the submit button This is where you input your Activation Input String See Also About Activating Multi Key License Files A single license file may contain multiple license keys one for each license you purchased The same license key file should be uploaded and activated on each server you have purchased a license for Each time you activate the license file the license activation count will increased until the total number of licenses that the key file contains has been activated If FusionReactor reports that you have no Activations remaining on this Multi Key file and you believe this to be an error please contact our support team Also See FusionReactor Purchase Page License Policy Each physical box server requires one FusionReactor license all of the instances which are installed on that server are covered by the one FusionReactor license Note that on a single box you may have multiple instances e g of ColdFusion Tomcat JBoss installed on it but you still only need 1 license for that physical box If you use Virtual Machines VM s then these are also classed as separate physical servers and therefore require 1 license per VM For a breakdown of the latest prices please refer to the buy page See Also Fusi
93. the options you choose for the Hostname and Parameters fields By default FusionReactor will ignore the hostname and simply match based on the web path of a given request but you can also opt to include it If you enable Hostname checking then the request field should also include a hostname and look something like productionMachine batchStats cfm You should NOT include HTTP or HTTPS at the start of this string Parameters By default FusionReactor will ignore any parameters passed to a page however as with the hostname you can also opt to include them in your restriction With parameter checking enabled the request field should include the necessary parameters For example batchStats cfm period YEAR Once again Regular Expressions and Restrictions can be useful here when specifying multiple possible parameter values or even specifying parameters where the order isn t fixed Request Exact Match imyfolderimyfile cfm eg imyfile ctm foldermyfile cim servercom myfile cim imyfile param value Hostname Check lw lf you enable Host Checking then the above path Should include the host that a page is running on eg mymachine main cim Parameters Check If Parameter Checking is enabled then you should a include the parameters of your page in the path above eg main cim mode batch Please Note You can use Regular Expressions as your exclusion rule An introduction to Restrictions and Reqular Exp
94. the thread one in front of the previous in the log entries Thread Blocked Time Delta milliseconds Lock Name Lock Owner ID Lock Owner Name Waited Count Waited Time milliseconds Waited Count Delta Waited Time Delta milliseconds Thread State Sample Period See also 15 O 16 P 17 Q 18 R 19 S 20 T 21 U 22 V 23 W 24 X The time difference between the time period the current thread has been in the blocked state and the previous thread has been in the blocked state Current being the thread one in front of the previous in the log entries Monitor lock that the thread is associated with The ID of the thread that holds the monitor lock The name of the thread that holds the monitor lock The number of times the thread has been in the waiting state The total amount of time the thread has been in the waiting State The difference between the amount of times the current thread has been in the waiting state and the previous thread has been in the waiting state Current being the thread one in front of the previous in the log entries The time difference between the time period the current thread has been in the waiting state and the previous thread has been in the waiting state Current being the thread one in front of the previous in the log entries The thread state States include new runnable blocked waiting timed_waiting and terminat
95. through the console installation Please follow the guide that covers Console Installation on Solaris setup FusionReactor 4 5 0 Welcome to the FusionReactor Setup Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Ne cancel 2 Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen Clicking the Next button will proceed with the installation and open the License Agreement as shown in Figure 2 Clicking Cancel will exit the Setup License Agreement Please read the following important information before continuing INTERGRAL SOF TAARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AM ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN OO NWOT INSTALL COPY DOWNLOAD OR OTHERWISE ETO hel TON LOT stn OL Gin L Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms
96. time every day or periodically Transfer of rotated log collection as a zip file to a central location Management of log files purge based on age or size target oldest first Integration with FusionAnalytics Connector Configuration This configuration page allows you to select if logs are archived and transferred to FusionAnalytics or just archived and kept in the archive directory in FusionReactor Logs that are just archived can be located at FusionReactor instance your_instance_name log The following data can be archived and transferred or just archived CPU Thread Log Memory Detailed Fine Memory Summary Coarse Reactor Log Request Log Resource Log Plugin Log Crash Protection Log JDBC Log System Heartbeat Default Log File No log files about captured data are generated from this plugin Status Log plugin fr logrotator log This plugin creates a log file called plugin fr logrotator log which contains information on the status of the plugin when it started stopped if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Number Date Formatted 1 A Time Formatted 2 B Level 3 C Log message 4 D Also See Log Settings FusionReactor Plugins FusionReactor Notification Generator Plugin Description The date on which this log entry was written The time on which this log entry was written Log Level basically means the natur
97. to solving many common server problems fusion reactor Getting Started Downloading and Installing FusionReactor We are assuming you ve downloaded and installed FusionReactor already if not go ahead and install it now The installation process is easy in almost every case the installer package will take care of all the details Read the installation guide for details on how to install FusionReactor if you haven t already installed FusionReactor Licensing After installing you will need to upload your license and activate it This is usually straight forward but if you re not connected to the Internet to automatically activate your license then click here to find out how to perform a manual activation Installing FusionReactor instances within FRAM When you install FusionReactor you will automatically get an instance of the FusionReactor Administration Manager FRAM installed The first time you access FRAM you will be prompted to scan for other servers into which new instances of FusionReactor can be installed Fk reactor Administration Manager Instance Instance Instance In the above image you can see a very general outline of how FusionReactor and FRAM work together After initially installing FusionReactor you will have FRAM installed and as mentioned above you will be given the opportunity to scan for servers After that point you can use the Instance Manager to install new FusionReactor instances
98. user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation Figure 9 Choose a User and a Group Figure 9 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM Terminal File Edit Miew Terminal Tabs Help Administration Manager to manage your FuslonReactor instances Password Validate Password Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation The wizard 1s ready to begin the installation The following daemon will be installed framd on port 8087 Start FuslonReactor Administration Manager Yes y Enter No n Figure 10 Ready to Install Figure 10 Here you will be given the choice of starting up the FRAM daemon Either entering y or pressing enter will start the daemon while entering n will not start the daemon FRAM can be started manually after the installation has finished Terminal File Edit Miew Terminal Tabs Help Start FuslonReactor Administration Manager Yes Ly Enter No n Extracting files Configuring FusionReactor Starting framd Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager
99. will either be DEADLOCK or DEADLOCKRESOLVED it describes the nature of the entry The thread name of the thread that has entered deadlock The thread ID of the thread that has entered deadlock The state of the thread that has entered deadlock Lock Identity Hash Code 10 J The identity hash code of the lock object For this field to be written to the log file you need to be using Java 1 6 or greater Lock Name 11 K The name of the lock Lock Owner Name 12 L The name of the lock owner Lock Owner ID 13 M The ID of the lock owner Is Native 14 N lf the thread that is in deadlock is running native code then this value is set to true otherwise it is set to false Is Suspended 15 O lf the thread that is in deadlock is suspended then this is set to true otherwise it is set to false Stack Trace 16 P This is a full stack trace of the thread that is in deadlock Threads Locked Monitors 17 Q This is a list of objects that are currently under lock by the thread Each entry in the list is separated by acomma The format for each entry is identity hash code string representation of the lock for example 675587393 java lang Object 28 44a541 For this field to be written to the log file you need to be using Java 1 6 or greater Threads Locked Synchronizers 18 R This is a list of locks that are currently under lock by the thread Each entry in the list is separated by a comma The format for each entr
100. will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Figure 1 Welcome Screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with the update FusionReactor already installed Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 3 5 6 is installed usionReactor will be updated to indude FusionReactor Administration Manager to manage your other instances of FusionReactor Configuration files will not be overwritten Setup has detected instances of FusionReactor with versions prior to version 4 These are not supported by FusionReactor 4 and will be updated during the initial update which After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you must update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup Intergral Information Solutions Figure 2 Update the Current Version Figure 2 If there is already a version of FusionReactor 3 x on your computer that has been installed with the FusionReactor 3 x Setup you will see a screen similar to the one shown Carefully read the information and click Next to proceed with the update Click Cancel to exit the installation wizard Plea
101. will not be able to abort the thread until it completes For this reason you may not see requests disappear immediately when aborted with Crash Protection or killed manually from the FusionReactor Administrator We re continuing to investigate this problem which is a restriction of the Java virtual machine and will release an updated version of FusionReactor when we have a solution J2EE Containers and Dead Threads After aborting a thread FusionReactor processes the requests for statistical and display purposes inside the FusionReactor Administrator then disposes of the original thread object by returning it to the J2EE engine Although the object no longer represents a valid thread some engines do not check this assuming the thread to still be runnable and return the object back to their internal thread pool In some cases this object can then be picked by the pool to run a new incoming request This will then fail immediately at which point the engine will remove the thread from the pool The client then sees an error message usually accompanied by a HTTP status 500 Internal Server Error Again this happens infrequently and is vastly preferable to a total outage The Crash Protection Restrictions Engine Crash Protection Restrictions Engine Customer Demographics Restrictions Engine Rules Crash Protection Restrictions Engine This section illustrates a brand new feature to FR3 Crash Protection Restrictions
102. x Setup you will see a screen similar to the one shown Carefully read the information and click Next to proceed with the update Click Cancel to exit the installation wizard aH Setup FusionReactor 4 5 0 License Agreement ED Please read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before continuing with the installation INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA T IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO hl INSTALL COPY DOWNLOAD OR OTHERWISE LE SF WARE SHA APPLY ONLY TO THE SOFTWARE O accept the agreement do not accept the agreement Intergral Information Solutions lt Back Next gt Cancel Figure 3 License Agreement Figure 3 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard ASO S
103. you make to these settings as well as any changes you make to individual rules become active immediately without necessitating any software restarts This allows you to test and tune rules on the fly Restrictions Enabled Behavior lgnore matching requests s The engine operates in one of three modes Mode Description Disabled in which the engine is completely bypassed In this mode all requests are monitored by Crash Protection if any protection is currently active Ignore matching requests in which the engine will by default protect all requests Any requests which match a rule are not monitored Protect matching requests in which the engine will by default ignore all requests Any requests which match a rule will be monitored Engine Overhead One of the chief design goals of the Restrictions Engine is that it demand very low overhead during the course of a request The engine is optimized for very low CPU and memory demand and is almost undetectable when active The Restrictions Engine can therefore be used even on very busy systems Rule Basics Rules for the Restrictions Engine are manipulated using the CP Restrictions item in the table of contents The settings page allows you to then add remove and change any rules currently entered into the engine Pug ures Exact latch py Poker iye ci Puree re karire Exclude From Timeout Prien Track Siia T Figure 1 Rule
104. you to limit the number of KB of log that is displayed in the FusionReactor Log For information on FusionReactor logs see the Log sectio n File Size The size in KB of each of the rotated log files used by FusionReactor File Count The number of rotated log files used by FusionReactor amp NOTE The File Size and File Count attributes are only available in FRAM FusionReactor Restrictions Configuration Description Restrictions Stack Trace Configuration Item only appears when Configuration Stack Trace Method FR REST API Access This value defines how FusionReactor Restrictions behave e Monitor requests that match the rules By default no requests will appear in FusionReactor If a request matches one of the rules defined on the Filter Restrictions page then it will appear e Ignore requests that match the rules By default all requests will appear in FusionReactor If a request matches one of the rules defined on the Filter Restrictions page then it will be invisible using a Java 1 5 or higher JVM Description Lets you select the method used by FusionReactor to generate and capture stack traces Older versions of Java before Java version 1 5 could not easily generate and capture stack traces of the running JVM but FusionReactor adds this functionality even on to such older versions It is recommended to use the Ja va s Stack Trace method on Java version 1 5 or higher On older versions of Java
105. you to use INTERGRAL s or its licensors names or any of their respective trademarks I accept the agreement Yes 1 No 2 1 Where should FusionReactor be installed opt fusionreactor Figure 3 Installation Directory Selection Figure 3 Now you have to select where FusionReactor is to be installed By default pressing enter directly FusionReactor will be installed into opt fusionreactor vmuser ubuntu Downloads their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices Legends symbols or labels in the Software This EULA does not authorize you to use INTERGRAL s or its licensors names or any of thelr respective trademarks I accept the agreement Yes 1 No 2 1 Where should FusionReactor be installed opt fusionreactor The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter Figure 4 FusionReactor Administration Manager FRAM Figure 4 You will now be asked if you want to configure the ports manually for FusionReactor Administration Manager FRAM Either enter y to configure them see Figure 5 onwards or ente
106. you want Below is an example of a log file as well as the table that would accompany it Example log file and table Below is an example log file SERVER1 70 5 21 This log file contains the attributes CPU 100 5 and 21 Below is the table that would explain the log file Field Name Number Description Server Name 1 A The servers name Efficiency percentage 2 B How efficient the server is Downtime hours 3 C The downtime of the server Uptime hours 4 D The up time of the server Exceptions to the rule There are several log files which also contain a plain text message eg reactor log In this case the normal rule applies for all the values up to the last message value but after that everything up to the end of the line is considered to be the value of the last field Also See Analytics Importing and Graphing Data in Excel Methodology in OpenOffice where we used the request log with standard deviation to derive a nominal page run time value Analytics The Analytics menu provides access to the configuration of the FusionAnalytics Connector a system which provides automatic log shipping between FusionReactor instances and FusionAnalytics FusionReactor logs very detailed metrics on various aspects of a J2EE container request runtimes memory loads CPU occupancy JDBC activity and CPU Thread usage to name but a few FusionReactor derives immediate value from this data by way of sophisticated chartin
107. 0 remindAfter 200 inh 1bitReformat true name DataWarehouse De el You can see that in this example the notifyAfter remindAfter inhibitReform and name options have all been specified The databaseName option pertains to the Macromedia driver and are therefore within the braced section Sample JDBC URLs Here are a few examples of URLs wrapped with the FusionReactor Driver Wrapper This section is not an exhaustive reference on the syntax of each URL you should check the documentation for each individual driver ColdFusion users in general we recommend downloading and using vendor specific drivers if possible Oracle Macromedia Using the Macromedia driver with the notifyAfter FusionReactor Driver Wrapper option p T e omo o e n a e a a a a a a a e jdbc fusionreactor wrapper jdbc macromedi a oracle int0234 1521 SID testdb notify After 10000 en eee ee eee eee eee ee eee ee ee eee eee ee ee eee eee ll MySQL Macromedia Using the MySQL GuT driver with the inhibitReformat FusionReactor Driver Wrapper option Potter ee y I jdbc fusionreactor wrapper jdbc mysql i nt0003 3306 webshopdb defaultFetchSize 400 inhibitReformat true driver org gjt mm m ysql Driver Lee ee eee ee a e l MySQL 4 5 MySQL Commercial Using the MySQL commercial driver for example supplied by Adobe in c ColdFusionl10 cfusion lib m ysql connector java commercial 5 1 17 bin jar Pe ee ee ee ee ee eee eee I jd
108. 0 0 Server Selection Select from list CF Directory C ColdFusion9 Figure 2 Custom Directory If you have a FusionReactor instance which isn t listed on this screen then you can select the Enter custom directory radio button Figure 2 and enter the directory path in manually Again once you have entered the path click the Next gt button oe Setup FusionReactor Extensions for ColdFusion 1 0 1 Installing Please wait while Setup installs FusionReactor Extensions for ColdFusion on your computer Fusion 3 Installing FREC into server instances The progress screen Figure 3 shows how long the installation process will take Finished The FusionReactor Extensions for ColdFusion have been installed Please restart the following servers to complete installation Adobe ColdFusion 9 C ColdFusion9 Extensions for ColdFusion Go Back to Server Selection Once the plugin has been successfully installed into your FusionReactor instance s you will see the screen shown in figure 4 Here you will be reminded that your instances will need to be restarted before the plugin will be loaded and become functional If you wish to install or uninstall other FusionReactor instances then click the Go Back to Server Selection link Otherwise click the Finish button to close the application If you want to check the status of the plugin or verify that it installed correctly navigate to your target
109. 07 38 de 10 1082 52 11 hp in H bbn iniorgral comm prs 1 howd cfm ATAT Cur eb TOT ap 3 cued ci Cur TEE ao 1 pape 102 108 074 10 ee meee nny ral come im pits ioed cfm 5 508 Cur Sas ape Using the load cfm load 4 amp timeout 120 script we load the system with 4 concurrent requests for 120 seconds visible in the Running Requests page above Running the system cfm page while this load exists causes the page to be rejected Ge ELTA alai _ napod da hie nl H bbn imkergral cam im jin e e 31 pa i Using the Queue Strategy We will also use this scenario to demonstrate the queue survival strategy Any requests which arrive are queued by FusionReactor to give the system time to recover The default queue period is 60 seconds which is usually ample time Use the Crash Protection Settings page to change the survival strategy for Request Protection to Queue and Notify We ll leave the queue timeout at 60 aquest Frois La He if Queue and Notify blar Firstly we ll show requests being queued and then completing Running the load cfm load 4 amp timeout 60 scri pt we increase the system request load to the Crash Protection limit of 4 Running the system cfm we see the page pause until the load pages complete and the total load reduces below the margin If a page remains in the queue longer than the Queue Timeout period it will be rejected by the protection We can illustrate this by running the load cfm load 4 amp timeout
110. 120 and then running the system cfm script The load will be applied for 120 seconds which is longer than the queue period The system cfm script will then be expired from the queue The page expired from the queue after 60 797ms EIA V2 200 Exped si hip indie W bbn intergmal com im pits insiem cfm an TW a cabal ii i m piik a F Using the Redirect Method Up to this point we have been using the abort strategy to return a short message to the client whenever a marginal situation arises While this is is usually sufficient to warn a client that the system is currently recovering there are cases where customers may want to return their own branded pages to the user The Crash Protection system therefore also allows an HTTP Temporary Redirect message to be sent to the client This is configured on the Crash Protection Settings page in the Survival Strategy section as shown in Figure 1 R jired io URL e Rapin St bin leer ral oom imps Le bord un potin l Emib Figure 1 When a marginal situation arises which would otherwise cause a page to be aborted or rejected FusionReactor will now attempt to send an HTTP redirect to the client If the Add Parameters setting is enabled FusionReactor will also supply some information as to the cause of the redirect This information can be used in customers own scripts to provide custom branded error messages If enabled parameters are passed as URL GET variables and are
111. 13 38 45 16 21 58 16 30 49 17 26 15 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel Memory Graphs Memory Heap Heap and Non Heap Types of Memory Graphs Memory Heap The Memory Heap Graph will show you a graph of the memory samples currently stored in memory by FusionReactor The time span of these samples will depend upon your history size and interval time see Resou rce Settings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data sampled every 5 seconds From this graph you can see the amount of unallocated memory the amount of allocated memory and the amount of memory actually being used when the sample was taken Resources Heap Memory Graph Max Allocated M Used DJ D D E S D cc
112. 2 Notify Crash Protection Running Request Quantity Alert Actual value 1 requests threshold value 1 requests Current Triggering Request Request ID 21 Request URL http 127 0 0 1 8500 cf sleep cfm Status PENDING Started Milliseconds 1337071655942 Started Date Time 2012 05 15 10 47 35 942 Thread ID web 5 Client IP Address 127 0 0 1 Request Method GET Execution Time ms 1 Used Memory percentage 65 Max Memory KB 466048 Used Memory KB 306378 Total Memory KB 396480 Free Memory KB 90101 Query String Return Status Code 200 CPU Time ms O0 JDBC Queries Run 0 JDBC Total Time 0 JDBC Total Execution Time 0 JDBC Total Row Count 0 AMF Request None Bytes Sent 0 Time to First Byte ms O Time to Last Byte ms O Note Data is still streaming Time to Stream Open ms O Time to Stream Close ms Note Data is still streaming User Agent Mozilla 5 0 Windows NT 6 1 WOW64 rv 11 0 Gecko 20100101 Firefox 11 0 This is for notification only No special action was taken on the request Running Requests 18 1337071445943 2012 05 15 10 44 05 943 210000ms 127 0 0 1 http 127 0 0 1 8500 cf sleep cfm Complete details for all running requests appear after the stack trace below No new alerts will be generated until Tue May 15 10 48 35 CEST 2012 Alert complete FusionReactor JVM Stack Trace JVM ID 2 Thread ID Reference Handler Priority 10
113. 27 0 0 1 8500 cf tightloop cfm Status PENDING Started Milliseconds 1337072847614 Started Date Time 2012 05 15 11 07 27 614 Thread ID web 5 Client IP Address 127 0 0 1 Request Method GET Execution Time ms 1 Used Memory percentage 64 Max Memory KB 466048 Used Memory KB 298498 Total Memory KB 396928 Free Memory KB 98429 Query String Return Status Code 200 CPU Time ms O0 JDBC Queries Run 0 JDBC Total Time 0 JDBC Total Execution Time 0 JDBC Total Row Count 0 AMF Request None Bytes Sent 0 Time to First Byte ms O Time to Last Byte ms O Note Data is still streaming Time to Stream Open ms O Time to Stream Close ms Note Data is still streaming User Agent Mozilla 5 0 Windows NT 6 1 WOW64 AppleWebKit 535 19 KHTML like Gecko Chrome 18 0 1025 168 Safari 535 19 This request was immediately rejected and did not run Running Requests None Complete details for all running requests appear after the stack trace below No new alerts will be generated until Tue May 15 11 08 27 CEST 2012 Alert complete FusionReactor JVM Stack Trace JVM ID 2 Thread ID Reference Handler Priority 10 Hashcode 60543300 java lang Object wait Object java 77 Nat ive Method java lang Object wait Object java 485 java lang ref Reference SReferenceHandler r un Reference java 116 JVM ID 3 Thread ID Finalizer Priority 8 Hashcode 11
114. 3 and 54 respectively to reflect the Windows user with permissions to restart ColdFusion Adding the Script to Manage Servers The final step in the configuration is to add the script to the monitored server s configuration We edit the server s Enterprise Dashboard configuration by clicking on Manage Servers then clicking the edit icon of the monitored server We enter the script location in the Script field Testing the Script The script can be tested by simply using the Windows Service control panel to stop the monitored ColdFusion 8 service Observing the script log file c tmp script log file shows the output of the script The ColdFusion 8 service can be observed restarting in the control panel Conclusion We ve shown you how to configure Enterprise Scripting to restart a ColdFusion 8 server The scope for what scripts can do is immense since there are no restrictions on what they may call It would be a simple task for example to integrate FusionReactor into an SNMP monitoring solution write custom log messages or send SMS text messages Local Monitoring Monitoring Instances on the same computer as the Enterprise Monitor Running all FusionReactor instances on the same computer makes it easy to develop scripts for use with Crash Protection Simple Watchdog Two instances run on the same computer One of the instances acts as an Enterprise Monitor Watchdog for the other monitored server The watchdog server has added the
115. 42635176 java lang Object wait Object java 77 Nat ive Method java lang ref ReferenceQueue remove Refere nceQueue java 118 java lang ref ReferenceQueue remove Refere nceQueue java 134 java lang ref FinalizerSFinalizerThread ru n Finalizer java 159 JVM ID 13 Thread ID RMI TCP Accept 0O Priority 5 Hashcode 513860152 java net PlainSocketImpl socketAccept Plai nSocketImpl java Native Method java net PlainSocketImpl accept PlainSocke tImpl java 390 java net ServerSocket implAccept ServerSoc ket java 453 java net ServerSocket accept ServerSocket java 421 sun rmi transport tcp TCPTransportS AcceptL oop executeAcceptLoop TCPTransport java 36 9 sun rmi transport tcp TCPTransport AcceptL oop run TCPTransport java 341 java lang Thread run Thread java 619 JVM ID 14 Thread ID RMI Reaper Priority 5 Hashcode 1535770241 java lang Object wait Object java 77 Nat ive Method java lang ref ReferenceQueue remove Refere nceQueue java 118 java lang ref ReferenceQueue remove Refere nceQueue java 134 sun rmi transport ObjectTableSReaper run O bjectTable java 333 java lang Thread run Thread java 619 JVM ID 15 Thread ID GC Daemon Priority 2 Hashcode 1650016544 java lang Object wait Object java 77 Nat ive Method sun misc GC Daemon run GC java 100 JVM ID 22 Thread ID RMI Scheduler 0 Priority 5 Hashcode 1282888134 sun mi
116. 59 Running Requests Full Details Request ID 5 Request URL http 127 0 0 1 8500 cf sleep cfm Status EXECUTING Started Milliseconds 1337071199613 Started Date Time 2012 05 15 10 39 59 613 Thread ID web 0O Client IP Address 127 0 0 1 Request Method GET Execution Time ms 1304 Used Memory percentage 61 Max Memory KB 466048 Used Memory KB 284520 Total Memory KB 417600 Free Memory KB 133079 Query String Return Status Code 200 CPU Time ms O0 JDBC Queries Run 0 JDBC Total Time 0 JDBC Total Execution Time 0 JDBC Total Row Count 0 AMF Request None Bytes Sent 0 Time to First Byte ms O Time to Last Byte ms O Note Data is still streaming Time to Stream Open ms 1 Time to Stream Close ms Note Data is still streaming User Agent Mozilla 5 0 Windows NT 6 1 WOW64 AppleWebKit 535 19 KHTML like Gecko Chrome 18 0 1025 168 Safari 535 19 Memory Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Hello this is the FusionReactor Crash Protection agent at HP Pdv6 Laptop instance coldfusion cfmx9 HP Pdv6 Laptop http HP Pdv6 Laptop 8088 fusionreactor f html cfim mode main The following alert was generated at Tue May 15 11 07 27 CEST 2012 Rejected Crash Protection Memory Shortage Alert Actual value 35 163MB Threshold value 100 455MB Current Triggering Request Request ID 39 Request URL http 1
117. 8 112325 SING Montored server SCIIDIS merear ena aN wi cyte eat cake keh anand wierd Gok A aac warn armardatad dea hai eta 32 TVS UPNC Scie h etc 8 ene aa whore eden a cag ea ca eye uses Mica heer eg ace a E ag te thio thee Sel Sat ead Na Oe 37 REA A SVS FSET MeS arere ee Sap N 2p ac eee A E hte at Pt an i ee gee Aa eee eg a A EA he 37 tiA 2 LORGCSUMECUCSIS areire ean e son Sadr wn toa eters Woah te eho So ee he nega E alae gas ok Anton ee a 38 TAA SIOW REGUGSIS 6 ue dsh cea ceca dos Ncaae ee evans wpe ea chee acuta ater toa hee warns arnar ated dea Nee ea 40 AAA EONGCSIIDBC garle cat ect cnt a E wha ayer autre Gen ae ewe ae ha nor datas oh ern E AA E Ba 43 HAS Mengs SCUINGS Satake keer speed tae here ete pete Goh ce rA coq Sapte r Pen R ce MeN anh abi ar E hark Ald Suede ela 44 Fe PROS OUNCOSS iata ina as A eel that hae Sek seks Min E E Se cca iw fe eae ce Ana gees Bee aie eda aaa eon anes POR te 45 ELST COUCST ACUVILY Grap eretier mea ue Paes a Aa och aha wee a Aa aoe way onan data AE ea 46 ATOZ ACQUESI NIMC Graph canta toe tpt end dus Sade eto E ees Boke in Sar eR es Be eS we Se Ee te 47 1A I DBC ACUMILY GALAN raran E ee marge a teu tc anced aha a dearer ton hn aoe way oat anata daa Ane R 48 1A IO BC ANIMSGIAO deire eaa ds ada drat aogteed Boke te Cs Seer e are a gh hogs Boe la ws hoe eee eee Ae ta 49 Al WIETIORY GVADINS 4 searen soreness ager Sich Meare E ao heer eens an eae ia di geen gee Rid are gt ae ad ts Nd eet 50 TSSA Meno TCAD S Go
118. A Separate Monitoring Instance FusionReactor in High Availability Environments HAE Enterprise Dashboard Servers and Groups Setting Up A Separate Monitoring Instance By default FusionReactor Enterprise Edition is configured to monitor itself You ll see the local instance in the E nterprise Dashboard We don t recommend running any scripts or using the Server Shutdown StartUp Alerts functionality in this mode since we can t guarantee the behavior of a system monitoring itself In Enterprise or High Availability Environments we recommend using the FusionReactor Administration Manager FRAM as a separate monitoring solution When you install FusionReactor you will automatically get a FRAM instance installed for you but in Enterprise or High Availability Environments you should create a separate J2EE container containing only the FusionReactor Administration Manager whose sole purpose is to monitor other instances This solution isolates FRAM from problems occurring in other J2EE ColdFusion instances Because FusionReacior is licensed on a per machine basis no extra licenses are required in this scenario We recommend installing a new Tomcat instance for this solution Simply add the monitored machines to the M anage Servers page and use the Enterprise Dashboard to monitor the status If more detailed information is required click on the small arrow icons on the dials or the server cube see figure 1 you ll be logged into the remote server a
119. Aborts Name Request Quantity Runtime Timeout Description This is the full ID of the instance of FusionReactor running on this server This shows the type of FusionReactor license running on this server This shows you if the license on this machine has been activated or not Description This shows the number of pages which triggered Crash Protection due to request quantity in the last 60 seconds and in total This shows the number of pages which triggered Crash Protection due to runtime timeout in the last 60 seconds and in total Low Memory Overview Name Server Uptime Current Request Count Total Request Count Average Request Time Used Memory Allocated Memory Maximum Memory Average Instance CPU Average DB Time Queue Size Recent Name Recent Slow Pages This shows the number of pages which triggered Crash Protection due to low memory in the last 60 seconds and in total Description This shows how long this server has been up This is the number of requests currently running on this server This is the total number of requests which have run on this server This shows the average request time on this server over the last 60 seconds and for the complete duration of it s request history This is the amount of memory currently used by this server not the amount currently allocated This is the amount of memory that has been allocated to the server This is the tota
120. Array frapi getRunningRequests writeoutput lt h2 gt Current Request lt h2 gt myThreadName createObject java java lang Thread cu rrentThread getName for i 1 i LTE ArrayLen requestArray i i 1 if requestArray 1 getThread eq myThreadName writeoutput ID requestArray i getFusionRequestId lt br gt lt cfscript gt Summary As we hope you can see the FRAPI is a very powerful new tool which has a lot of potential As ever if you have any feedback or suggestions for this or any other feature within FusionReactor please let us know and we will try our best to include them in upcoming builds FR Administration Manager FRAM FRAM provides a completely isolated instance of FusionReactor which is just for monitoring and instance management it will continue running even following a JVM crash FRAM manages and keeps track of all servers and instances so you can quickly and easily install FusionReactor across your environment Instance Manager e Initial Server Scan Initial Update Add Server amp Scan System Install FusionReactor Instance Uninstall FusionReactor Instance Edit FusionReactor Instance Edit FusionAnalytics Connector Update FusionReactor Instance Corrupt Configurations Unsupported Configurations Setting Up FRAM with HTTPS Instance Manager The Instance Manager in versions prior to 4 0 only available in the Enterprise Edition is now a
121. B The time the log was written Date Time ms 3 C The number of seconds since epoch Version 4 D Version number of this log entry Server Start up Time ms 5 E Start up time of the application server in milliseconds ms since epoch Beat 6 F If the server is up the value is 1 if not it will be 0 When your server Starts up it read read 1 any other entry after that will read 0 Up 7 G If the server has started up this value will be 1 if not it it will be O Down 8 H lf the server is shutdown this value will be 1 if not it will be O Dirty Shutdown Start up 9 I lf a dirty shutdown or start up occurred in a server this value will be 1 when the server next starts Date Time 9 J The date and time the entry was written according to ISO 8601 standards Status Log plugin fr heartbeat plugin log The Heartbeat plugin creates a log file called plugin fr heartbeat plugin log which contains information on the status of the plugin when it started stopped if there were any problems which contains information on the status of the plugin when it started stopped if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example IN
122. Ba NOUNNG 2 iceediesecs cele pcan oh ay ca a a eee G A E Shahn Peep Sec ade Waleed 2h epee aD pte A TAN giana Glee Siete 5 As I AUISIOMERG ACTOR Usors Gude veriri renea ae th erg the ce Su ce aa a Pe tee ae ogee A ct anh ie a pended Mee eee Bes 6 PEMD STING otated rrasa Mccabe cs arsenal aoa eke a cea eae nese ap ees Site cca at ah sae Sh de ec doe nO en A ae A eee ea 9 Vel ae PROCS OUS meed an reaa E E E E A E Soh cae E tc E a a eres a nina E E AE A 10 MST 2260 PALIN ls FOCI SUS arene os ogee Sic Mace ar Wh ter Paci E NEE E aha tates A E eg TE OEE 10 STZ AePACQUCSURISIOLY seceer ee Saris shoe gt ene Seog nda ta Rapa agers ae he cartes A gee BS a eee Gene ek A eed 14 WAZ OC OUGSI SOUS rara da Porscnces acter ts pe S caisarta er eedani a Septem eva cachet een seated Sb he nig sehen dpa da eee ea 15 t2 A Request LOG CEGUCSHIOG nated ea easton bees was eke ced eee Oke oie eed ee ee ee 17 TED Redet Capre icici Site a E N a a A E Sapa Mca T E dade da E 20 Eo EMEDISE oeus anaa ete oleae E E E Dawe E SRW etre ene ed E E A E E NE 20 BLS LENEpISe Dashboard 5 2 ecc a ctdsc dies a aN a diopters tea E carck A E Sa Ae A EE dade de aaa 20 TAS Ste Mana OCIVGNS sete cue cite dat Set a ee agnas ates Gon ate ew aan aetna aA eS wn aanda as acetal ha 26 tho Manage VOIDS seneden aeea See Shad ar Wt duc wh Agee eS ar eerste age ah op tates oe nd US a TE de caer E 28 TMS ENEI SEUNS 8 Sekt 6 wide E T outers Wen ae ew ahaa ear EE teh A us wk aandatas acetals ha 2
123. Check Figure 11 Y and Remove Figure 12 a Fu sionAnalytics DataCollector Target coldtusion cfmxs JNTO05F 127 0 0 1 Port 8087 The hosiname and pot number of the machine on which the Fusionfeactor Adminisiration Manager is manning Username restuser Password esses The uvzemame and password of the FA REST API user This is only required if the FRAM instance requires REST authentication lal Check this box if your FusionResactor Administration Manager uses HITPS fo secure communications Status OK Test Target Save FRAM Settings Figure 5 Edit FRAM target Figure 5 On this screen you have the opportunity to modify the current FusionReactor Administration Manager FRAM target Click Save FRAM Seitings to save the configured settings and go back to the FusionAnalytics Settings screen Figure 4 Click Back to return to the previous screen without saving the FRAM target Figure 4 Configuration Description Host This is the host running the FusionReactor Administration Manager By default this is set to the local FRAM Service 127 0 0 1 Port This is the port that the FRAM Service is listening on This is specified in the FusionReactor 4 0 x installation By default the port for FRAM is 8087 Username Password HTTPS Status lf FR REST authentication has been enabled the FR REST username needs to be specified By default FR REST authentication is enabled locally with no authentication
124. Cm a A lt Back C Next gt Cancel Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM AAO Setup FusionReactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation The following daemon will be installed framd on port 8087 w Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions lt Back Cancel Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard AHO Setup FusionReactor 4 5 0 Installing Please wait while Setup installs FusionReactor on your computer Extracting files Intergral Information Solutions Cancel Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a
125. DBC requests that have been called since the last restart Total Finished JDBC Count 25 Y The total number of JDBC requests that have been completed since the last restart JDBC Count 26 Z The number of JDBC requests that were running at the time of this log message JDBC Finished 27 AA The number of JDBC requests that were completed since the last log message JDBC Requests per second 28 AB The number of JDBC requests per second that where being served at the time of this log message Average JDBC time 29 AC The average JDBC request execution time at the time of this log message Deleting the Resource Log Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the Resource Log will be emptied and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Also See Log Settings Importing and Graphing Data in Excel Memory Logs The Memory Logs section contains two pages One explains the memorysummary log which is a basically a log containing heap and non heap memory information The other page talk about how every server references memory in different ways and how FusionReactor handles this and manages to create a logs that match the types of memory used by that server see the Types of Memory Logs page for more information amp NOTE Logs can be located one of two pla
126. Data Source If you are using a wrapped data source and have named it Refer to the JOBC Driver Wrapper User Guide then that name will appear here Start Time This is the time at which this JDBC query began Total Time ms This is the amount of time it took CF to complete the query DB Time ms This is the amount of time the database actually spent processing the query Row Count This is the number of rows which was returned by the query Managing Requests Each JDBC request listed on this page has an icon next to it Button Name Description AE Request Detail If you click this button then you will be taken to the Request Details page for the page which ran this JDBC request This will give you access to all information associated with that request eg Cookies JDBC Headers User Trace Markers and AMF data amp NOTE Over extended periods of time you may find that this list gets filled with very long running JDBC requests In order to see some of the medium running requests again you can empty the list by clicking on the Clear Longest JDBC button Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh eee a ee aro Max Alloc Free Used
127. E E T ice cee gh a tars Bo E A gt E SOR eee we ea 474 1 8 6 F usionkeactor Log ROIGIOM PIUGIN ctxsuatoaNccerkace E eee T egtnd tua Mb Raed wa anna eaten tear nee 475 1 8 7 FusionReactor Notification Generator Plugin 0 0 eens 476 Za MEMON PROLOG feo ances cos Peserchecgice on ar iarae Pm pacer ahead Mc Ren rps ih wh Ria aes tea ce aoe tea Pha eect g tee ana a ok ae le encarap arpa aad garg Oe 478 Su Methodolog r IM ODEN OMICS siera hats pte steers og cede ed er Pach See agitate an hcg de ace ance aged Seok cht ane Poke a epee ee Ace eter 479 AeA SLIGO NY oct scar chee der oh ay Gah ect vest scene Doyen Pe ee a Secs Rhy A aah a De ae Ate ee AS cl Saad ten aA ogee aera Byes Mecha Bee T 479 5 Timeout Protection and Request Protection 0 ccc ee eee eee eee eee eens 479 Home Introducing FusionReactor 4 5 x FusionReactor is a professional server monitor designed for production environments and supporting a range of J2EE servers and Adobe servers ColdFusion 6 7 8 9 and 10 LiveCycle and BlazeDS As a pro active monitor it increases server stability and performance by continuously examining applications servers and databases to identify highlight and address issues before they impact critical processes FusionReactor allows you to discover visualize and protect against common web application performance problems through graphs and logs Whether used for production monitoring or as a developer a tool like FusionReactor is key
128. EE TO BE BOUND BY THESE TERMS THEN DO NOT INSTALL COPY DOWNLOAD OR OTHERWISE USE THE SOFTWARE THIS EULA SHALL APPLY ONLY TO THE SOFTWARE RED TO OR DESCRIBED HEREIN I accept the agreement I do not accept the agreement Intergral Information Solutions Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard _ Setup FusionReactor 4 5 0 FusionReactor already installed Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 4 0 10 is installed By running this installer FusionReactor will be updated This may indude an update to the FusionReactor Administration Manager Configuration files will not be overwritten After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you can update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup Intergral Information Solutions Figure 3 Update the Current Version Figure 3 If there is already a version of FusionReactor 4 0 x on your computer that has been installed with the FusionReactor 4 0 x Setup you will see a screen similar to the one shown Carefully read the information and click Next to
129. EEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO NOT INSTALL COPY DOWNLOAD OR OTHERWISE USE THE SOFTWARE THIS EULA SHALL APPLY ONLY TO THE SOFTWARE SUPPLIED BY INTERGRAL HEREWITH REGARDLESS OF WHETHER OTHER O accept the agreement do not accept the agreement Intergral Information Solutions Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard Setup FusionReactor 4 5 0 FusionReactor already installed ED Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 4 0 10 is installed By running this installer FusionReactor will be updated This may include an update to the FusionReactor Administration Manager Configuration files will not be overwritten After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you can update your other instances of FusionReactor Click Next to continue the update of Fu
130. Eee eee eee eee Soe ee eee 110 1 1 12 5 Naming Applications and DataCollectors 2 25 00 nectar tek tnt eeee ON A wha dels PAN ee a 111 kel 0 VAIN MAO reeda mee ce et E os Dee ce arc et A as he nce cee ag Mc E A E Gale is Acca ers ae 113 Teed Sr CISION TAC ACLU areren cs dene a steeds Sct res hee cca dh cae ares veep agers oe aie Chars Pern pace Ge eds Bh an Serdar deepen ag en RA Sl Ree 114 ELS CENNE Ang DISA Ox Asc area Ses ore en Pong wetness ayer a a Aces Bad Gi ene ete ds tea Nee eer 115 AAT OZ IN OUMGANOIS serae utta tear tosh eek Ses hada darn aha acters aed Nae ao Peco gh eed Sd Se aon De de ee a He 115 TAP Ss NOUPICAUIOMVALSOC irste sco cepacia ster ere Pines aerate Atari ces aera PS ces E Mesa tn ert ad er i Oa Mca A 117 MST lee LUIS ge crete hey eee a Sct a ee tpt eid ue Bes dt area ae th ha ac aetna Macht th ocean nel Bat cic bals Mca ROE Be 119 TSS SO IO PROS UGE ONS ct race rasoi na Sees Sse a ih ap Seber Aca arate anaes ge we ager oon Na E a ea a Gea ate eee he 122 TAA Ghange PassWord 2 6 5 Gate cid au aoe ett ea ease NN Ata Brett hah eta Sega N Gated ine tte tee a 124 tL Change FARES TRASS WO ocreata canine op Sahara Neo dene eee es Re ee aa eed eee eRe 125 MSSM Ut MAO 22 Seyler a ha Shh oe cS cesta Reset Pgh Dal eet rica ce Bao eR Ac nel EE ase E ae a eae ee aiate 125 MTs NOON anran Meg earache aa caylee Guten Bg Recaee coats cee ag Meee eee E Rcd ROE the 126 ges Nas FL a orare E WORN A On PER ene Dm wm Me ee Mee ae ae See N
131. Enterprise Monitoring in some detail We ll show you how to use FusionReactor to cross monitor a cluster of machines such as is typically found within companies with fail over solutions or in hosting providers running large farms of machines We ll illustrate in detail using worked examples how FusionReactor s sophisticated Crash Protection works to keep your system up and alive even in the face of an onslaught of requests bad queries pages that take too long and memory which is approaching upper margins Although every installation of FusionReactor is different and we re constantly amazed at the diverse and interesting environments FusionReactor is deployed within we ll also show you how you might tune Crash Protection to optimize your production environments Finally we hope you are happy with FusionReactor We re convinced it will provide a significant return on your investment maybe in some cases even paying for itself by preventing one outage Over multiple version releases we have made significant advances in enterprise monitoring protection and visualization but a lot of it would not have been possible without feedback from our customers We re always grateful for comments on our products if you have any criticisms or ideas please send them to support fusion reactor com Crash Protection Basics e Design Goals e Common J2EE Problems e Types of FusionReactor Crash Protection e Survival Strategy e Crash Protection Implemen
132. F A string describing the action associated with this log entry one of e CREATED the notification was created and registered with the system e MARKED READ the notification was marked as read e MARKED UNREAD the notification was marked as unread e DELETED USER the notification was deleted by the user e DELETED INTERNAL the notification was deleted by the system Severity 7 G The Severity text of the notification Origin 8 H The name of the creator of this notification Title 9 I The title of the notification Message 10 J The message of the notification Notification ID 11 K The FusionReactor Notification ID This is a UUID string assigned to the notification throughout its life Exmaple Date Time Date Ti Versio Server Action Severit Origin Title Messa Notific Forma Forma me n Startu y ge ation tted tted Millise p Time ID conds ms 2012 0 1 25 Settings 11 44 2 0 221 132748 4 826022 0 1382748 CREAT Info frapi n FRAPI This 5dc51a 650852 ED otificati Gener notifica 0e 32b 9 on jsp ated tion 4 4a63 Notifica was b101 tion O generat 2fela7 ed by cf3c87 frapi no tificatio n jsp a FRAPI test script The Request Settings page lets you modify email server settings FusionReactor web root log file settings restrictions stack trace and FR REST API access Email Server Configuration From Address To Address Mail Server CP Email Interval mins De
133. FO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Log Settings FusionReactor Plugins FusionReactor JRun Plugin Description This plugin allows you to access the JRun log files Configuration This page allows you to enable or disabled the creation of JRun Event Log Entries Enabling this will allow the plugin to log JRun server events which are then included in the FusionReactor Centralized Log Rotation when it occurs The logs can also be used by FusionAnalytics to analyze the server The option you choose does not alter the JRun Log Directory setting This section controls the configuration of the FusionReactor JRun Plugin Create a copy of JRun Event Log Entries Enabled Click the button on the right to update FusionReactor JRun Plugin Configuration Log File fr jrun event log This log is called fr jrun event log Don t confuse this with that status log the status log displays the state of the plugin on off and error where as this describes what the plugin is doing starting applications etc Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Date
134. FRAM Target Figure 8 On this screen you have the opportunity to add a new FusionReactor Administration Manager FRAM target Click Save FRAM Seitings to save the configured settings and go back to the FusionAnalytics Settings screen Figure 4 Click Back to return to the previous screen without saving the FRAM target Figure 4 Configuration Host Port Description This is the host running the FusionReactor Administration Manager By default this is set to the local FRAM Service 127 0 0 1 This is the port that the FRAM Service is listening on This is specified in the FusionReactor 4 0 x installation By default the port for FRAM is 8087 Username Password HTTPS Status lf FR REST authentication has been enabled the FR REST username needs to be specified By default FR REST authentication is enabled locally with no authentication For more information about FR REST please see the FR REST section on the Settings page lf FR REST authentication has been enabled the FR REST password needs to be specified By default FR REST authentication is enabled locally with no authentication For more information about FR REST please see the FR REST section on the Settings page Tick the check box if FRAM is using a secure HTTPS connection instead of regular HTTP Please see Setti ng Up FRAM with HTTPS for more information on how to set up FRAM to use a secure connection By clicking the button Test Tar
135. Format value on the Request Settings page The number of milliseconds that the request has been running so far A snapshot of the state of system memory at the time the request was started The following values are shown Used memory as a percentage of the total available to the JVM the actual used memory value in KB and the margin of free memory available before the JVM must extend its own heap if it has not already reached its limit The Running Requests page lists all currently running pages as well as showing the current memory values The amount of memory available to the JVM this is a hard upper limit The amount of memory currently allocated by the JVM for its heap this may grow until the Max value is reached The amount of free memory from the currently allocated heap The amount of memory which is actually in use This is expressed as a percentage as well as in KB lf there are requests queued due to Crash Protection then they will be listed below the currently running requests The queued requests are listed in the same format as the running requests See above but there is an extra column giving you the reason that the request was queued Sorting Requests You can change the order in which requests are displayed on this page by clicking on any of the column titles Clicking on a title for a second time will reverse the order on that column Managing Requests Each request listed on this page has four icons
136. From this screen you can add new servers to the Enterprise Console or manage existing servers It is also possible to directly add local instances to the Enterprise Dashboard from the Instance Manager The form to add a new server has the following fields Field Name Description Name This is the name which will appear in the Enterprise Dashboard under your server icon URL This is the location of FusionReactor on the target server An example URL will look something like this http 127 0 0 1 8088 fusionreactor Password This is the password of FusionReactor on the target server Script If you specify the path to a script on your server then it will be called when the server goes down or comes up See the script section below for more information or check out Using FusionReactor Enterprise Scripting Status You can choose if this new server is online or offline An online server will collect statistics and display them in the Enterprise Dashboard and if there are any problems then you will see warnings If a machine is offline then no information will be gathered and the icon will be displayed in gray If you are adding a server which is currently turned off then you should set it s status to offline You can change it s status later by returning to the Manage Servers page clicking the green button or by clicking the status button top right hand corner of a server icon directly within the Enterprise Dashboard Groups If yo
137. FusionReactor Using our frtest database we can easily write a ColdFusion query using our new datasource As you can see this code simply reads all the rows from our users table a fairly small dataset Running this page which I ve called tutorial1 cfm gives the following output If we go to FusionReactor s Request History screen we can see this request as the most recent TSE Ss a H i ia 212 Cunt Sib 264 3 7 gt hip Mocalhost gattutornialtutoria tl efm E DADAAN Fipe S03 271 Clicking on the blue data icon at the very left of the request brings up the Request Details page When that page has displayed click on the JDBC tab heading to bring up the JDBC Details page which looks something like this Total Exec Row Statement Query Time Time Time Count 1 select from usr 15 06 02 506 297 O 2595 Total Total Total Exec Total Row Statments Time Time Count l 297 I 2595 This page tells us the query text that ran if you were using CFQUERYPARAM the actual real values would be displayed in the statement the exact time the statement ran the total time from running the query to finishing with the data the exec time the actual time the database took to run the query in this case Oms and the number of rows read out by your query The final block contains the totals for all the queries which ran on the page Why did the query run in Oms You may occasionally see Total Time and Exec
138. FusionReactor Instance Install FusionReactor Instance Unavailable oo ar C Select this Instance This button will be disabled if there is already a FusionReactor instance installed into the selected server instance See the below section for actions available for each FusionReactor instance Tick this check box if you wish to perform any of the actions located on the table header See the above section Instance Information on all of the selected instances All of the server instances listed can be selected by clicking the hyperlink Select All For each FusionReactor instance listed in the Instance Manager the following actions are available Button Name Uninstall FusionReactor Instance P Edit FusionReactor Instance amp Add to Dashboard Description If FusionReactor has been installed into a server instance clicking this button will uninstall FusionReactor from the selected instance The Uninstall FusionReactor Instance document ation covers this in more detail Clicking this button will enable you to edit the web server properties of the selected FusionReactor instance See the online documentation on Edit FusionReactor Instance for more detailed information The selected FusionReactor instance can be easily monitored by the Enterprise Dashboard ava ilable in the FusionReactor Administration Manager FRAM if you have installed an Enterprise License Clicking this button will add the selected
139. FusionReactor Administration Manage P The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Figure 8 Administration Manager Password Figure 8 Here you will be asked to specify a password for FRAM s Administrator account It must be longer than 5 characters Co Users qnourton Down loads gt y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana qer L36087 Co Users qnourton Down loads gt The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function L004 Co Users qnourton Down loads gt Please specify an Administrator password for FusionReactor Administration F The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Co Users qnourton Down loads gt Walidate Password Figure 9 Administration Manager Password Figure 9 You will be asked to validate your password ch Administrator CAWi dows system32 o Co Users qnourton Down loads gt The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8664 Co Users qnourton Down loads g
140. FusionReactor from this server instance press Skip If you have selected to remove more than one FusionReactor Instance the wizard will advance to next FusionReactor instance if not the finish screen will be displayed See Figure 7 coldfusion cfmxs JNTOO5F Attempt to start the server instance coldfusion in Adobe ColdFusion 6 C ColdFusion6 automaticaly Figure 4 Restart in Progress Figure 4 By Clicking Start the Instance Manager will attempt to automatically start the server instance again See Figure 5 If you wish to start the server at another point or wish to manually start it click Skip See Figure 6 coldfusion cfmxs INTO05F Attempting to start server instance coldfusion in Adobe ColdFusion 6 C ColdFusions Figure 5 Restart in Progress Figure 5 FusionReactor is attempting to start the server instance Please note that starting the server may take several minutes depending on your system configuration coldfusion cfmxs INTO05F FusionReactor was successfully removed from server instance coldfusion Figure 6 FusionReactor Instance Removed Figure 6 Once the FusionReactor instance has been removed you will see a confirmation screen where you will be told whether the removal was successful If you have selected to only uninstall one FusionReactor instance click Finish to return to the Instance Manager If you have selected to remove more than one FusionReactor ins
141. In order to receive notification email you must set up your Email Server on the FusionReactor Settings page You can also change the behavior of the Request Abort and Request Queue in the Survival Strategy part of this page Crash Protection Restrictions Configuration Restrictions Behavior What is a Survival Strategy and Self healing Description From here you can enable or disable the Crash Protection Restrictions feature When restrictions are enabled you can define which pages will be run through the Crash Protection system and which will be left to run normally You can define individual restrictions on the CP Restrictions page This value defines how Crash Protection Restrictions behave e Protect Matching Requests No requests will be subject to protection they will never be aborted or timed out unless they are matched by a Restriction rule as defined on the CP Resirictions page e Exclude Ignore Requests All requests will be subject to protection they may be aborted or timed out unless they are matched by a Restriction rule in which case they will not be touched by Crash Protection under any circumstances as defined on the CP Restrictions page The survival strategy is how FusionReactor will attempt to self heal the situation if crash protection is triggered It can be configured to kill problem requests and queue new requests until the situation is stabilized It will also alert you so that you have time
142. O5F int0O64 Port S400 The hosiname and port number of the machine on which fhe FusionAnalytices DataGolector is manning Application name coldfusion The name of the DCML Application installed in the FusionAnalytics DataCollector DataCollector 7ebra 4 The name of the DateCollector installed in the abow application How should i name my A Usermame Password The usemame and password of a user who has access fo fhe FusionAnalytics DataCollector application E Check this box if your FusionAnalytics DatatCollector uses ATIPS fo secure communications Status OK Test Target save Target Settings Figure 10 Edit a FusionAnalytics target Figure 9 On the above screen you have the opportunity to modify the selected FusionAnalytics DataCollector Target Click Save Target Settings to save the configured settings and go back to the FusionAnalytics Settings screen Figure 4 Click Back to return to the previous screen without saving the FusionAnalytics target Figure 4 Configuration Description Host This is the host running the FusionAnalytics Server Port This is the port that the FusionAnalytics Server is listening on This is specified in the FusionAnalytics installation By default the port for FusionAnalytics is 8400 Application name The name of the DataCollector Application that you want to collect the data DataCollector Username Password HTTPS Status The name of the actu
143. ON FusionReactor will log the message associated with the exception to the FusionReactor log Operational Impacts of Scripting There are a few points which should be borne in mind when configuring scripting System Restarts and Self Monitoring If FusionReactor is configured to monitor itself i e is monitoring the same instance in which it is configured scripting should not be used for operations which affect this instance Because the order in which FusionReactor s subsystems start up FusionReactor may prematurely fire a script while the self instance is still starting up In these circumstances we recommend transitioning your environment to a High Availability monitoring solution This entails installing a new J2EE server Tomcat for instance and installing FusionReactor into that This container will be used purely as a FusionReactor host and will be used to monitor other containers lt may be necessary to create scripts which perform system reboots Again we recommend a careful evaluation of the impacts of this type of script before implementation A script which restarts a system should not attempt to restart the system on which the monitoring solution runs Manual Restarts If a script is configured for a given instance it will be fired when that instance becomes unavailable FusionReactor does not differentiate between overloaded or failing instances and instances which have been deliberately stopped Therefore if you s
144. PS protocol accessible on port 8443 You should be able to access FRAM on a URL similar to https 127 0 0 1 8443 fusionreactor Licensing Uploading your License File Activation Period License Activation Activating Multi Key License Files License Policy Uploading your License File To upload a license file go to the About page under FusionReactor in the Table of Contents within either FRAM or an instance of FusionReactor and you will see a form with a file upload button Figure 1 i Tusion 2 lt t actor Administration Manager BP eee oe jaw lire epred be mpre arr bre el ir innn Ts ia ee ee ES Ta IPE WE ee E HECHE ERIE uid Q Figure 1 License Upload Figure 1 Click the Browse button and locate the license file The license has the file extension lic for example it may be called FR3Y1ENT FR 0013284 lic Once entered click the Upload New License File button to upload to the license to FusionReactor fusion amp lt t actor Administration Manager Be We ee ee ed ee Figure 2 License Upload Figure 2 After submitting you will need to login again You will see your new license details on the middle of the screen straight away when you log in and you will be able to find the same details on the About page under FusionReactor in the Table of Contents You will then be given 10 days to activate the license If the computer with FusionReactor is connected to the internet you can click
145. Protection Restrictions 066s 232 GEES Fe MOES enee ee eae Pac oe ne E ee ee ae Cee eee ee eer Re eee ee Ree ee oe eee 232 149 Ose Rule BASICS wisn dete taare a Ieee woe E hk Arh Pee her Eee tee AE wha Shee E ete he 232 129 020 E XAMES Ol TRESHICHONS tacos cnt tes Madre eed ade bomcien A ear ee ae ated Sea er tee ed Sr oma aetna tee Nee 234 13 0 0 1 EXCIUdING Balch OS Area tre knees deka ema E A E whata hatte Senay ht eo a E Oe ce ah 234 1255050 MEUNI Spe GC HOSTE credete wha o E E E eae ated Sheek hey mead ae AE ees 235 19 Os3 0 AMCIUGING a Specific Action Fage enit resini pote case senda ae hal Sgt dead bee add eed eter R E E germ eee ees 235 V4 ASH E LOLCCUOMAAIGIUS erae cate jes e eae ees tha E Se ch hatha Sa ceases Mar ah tele SR eel ae Chon ghana Soo ch bart 236 Al ESIMIGIVICINS sees ssccers ci seids ania pi Sioa ee aus cet Oe atone gates ove Neale fe anaes ata aaa Nad E et Sag oct Spe A ate 236 1 4 Using the FusionReactor JDBC Driver Wrapper 0 00 ccc ete e teen eens 251 141 Basie Setup ol the dD BG Wrapper ai tari haat eae tend awk EE E Wad iad aad aha ated eee ee ea 251 1 4 2 Gathering metrics from ColdFusion pages s vvickieariwedaaN det wia detuned Ae whoa tee PN ek ee 254 124 34P athOlOgiCallY Dadi PAGS mesie e neha A R nee E E ation taney eed ahaa eae Sea eae 255 1 lt 5 Using Fusionheactor Enterprise SCnpinG eer toart an NE EE E etek te baatee Salad ekki bates PEN tek Ba 257 1 5 1 FusionReactor Enterp
146. R REST API in FusionReactor Settings is setto require authentication Old FR REST password Enter the old FR REST password Disabled you cannot enter anything in this field as no initial FR REST password has been set yet I New FR REST password Enter the new FR REST password Confirm new FR REST password Type the new FR REST password again See Also Settings FR REST API Log The FusionReactor Log page is a simple display page which shows the contents of the FusionReactor Log file The file contains information about FusionReactors configurations and activity The FusionReactor Logs are a set of rotating files which you can configure from the FusionReactor Settings page By default these files are located in the FusionReactor instance your_instance_namel log directory Deleting the FusionReactor Log Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the FusionReactor Log will be emptied and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries About In the About page in FRAM you can do the following Upload a license Activate a license Activate a license offline Check for updates by clicking on the link titled check For FusionReactor updates this takes you to a webpage that tells you if your version is up to date If it is outdated you will be given information
147. Reactor The time span of these samples will depend upon your history size and interval time see Resou rce Settings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data sampled every 5 seconds From this graph you can see the amount of unallocated memory the amount of allocated memory and the amount of memory actually being used when the sample was taken Heap memory The heap memory is the runtime data area from which the Java VM allocates memory for all class instances and arrays The heap may be of a fixed or variable size The garbage collector is an automatic memory management system that reclaims heap memory for objects e Eden Space The pool from which memory is initially allocated for most objects e Survivor Space The pool containing objects that have survived the garbage collection of the Eden space e Tenured Generation The pool containing objects that have existed for some time in the survivor space Non heap memory Non heap memory includes a method area shared among all threads and memory required for the internal processing or optimization for the Java VM It stores per class structures such as a runtime constant pool field and method data and the code for methods and constructors The method area is logically part of the heap but depending on the implementation a Java VM may not garbage collect or compact it Like the
148. Required disk space 44 1 MB Free disk space 139 262 MB Intergral Information Solutions 1 1 l 1 lt Back Next gt Cancel Figure 3 Installation Directory Selection Figure 3 Now you have to select the directory in which FusionReactor should be installed By default FusionReactor will be installed into Applications FusionReactor ASO Setup FusionReactor 4 5 0 FusionReactor Administration Manager ED The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 _ Configure ports manually fusion m A kre ctor Administration Manager Intergral Information Solutions ri a i once a e lt Back Next gt J __ Cancel Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the server ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 AAO Setup FusionReactor 4 5 0 FusionReactor Administration Manager Ports ED Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number fo
149. Select other type driver Click on the Add button you will be presented with more text input fields In the field titted CF Data Source Name enter a name for your data source In the JDBC URL text field simply enclose the existing JOBC URL within the FusionReactor syntax ote YS jdbc fusionreactor wrapper JDBC URL You can also give the data source a name If you name the data source in this way FusionReactor will display this name in the Data Source column of the JDBC tab in the Request Details page This is useful if you re using multiple data sources Below is an example jdbc fusionreactor wrapper JDBC URL name TestName 7 Inthe JDBC Driver Class field enter the name of the FusionReactor JDBC Driver Wrapper class com intergral fusionreactor jdbc Wrapper 8 Enter FusionReactor in the Driver Name field 9 Select an appropriate username and password values in their respective fields 10 Click Submit ColdFusion will immediately test the driver and provide feedback if necessary When the FusionReactor driver is loaded it will report FusionReactor JDBC Driver loaded to the standard output stream usually logged to coldfusion out log or default out log within cfmx runtime logs Below are two screen shots figure 1 covers stages 1 to 4 and figure 2 covers stages 5 to 11 Java and JVM Add New Data Source Settings Summary Data Source Name DATA amp SERVICES Driver select a valid driver type
150. This powerful filter is used to configure exactly which requests will benefit from Crash Protection There are certain classes of request batch jobs database update data warehousing which are known to consume time and resources and which could be safely ignored by Crash Protection so called false positives Customer Demographics During the design of this feature we identified two key demographics for whom this would be an important technology e The small homepage or small company site which is agile and which will protect all requests except its long running updates e The large enterprise site possibly with many web services and non interactive services which will be default not protect requests preferring to define small groups of interactive pages which will be protected Instead of attempting to aggregate these groups into those who would and those who wouldn t use the feature we made the Restrictions Engine reversible The engine which is totally optional can be run in two distinct modes e All requests are protected except those matched by a filter rule exclude mode e All requests are ignored except those matched by a filter rule protect mode We feel these two modes accurately reflect the needs of the two demographics above Restrictions Engine Rules In order to decide whether a given request will or will not be protected the Restrictions Engine evaluates a number of user defined rules Each r
151. Ttfb gt Ttfb lt td gt lt td title getTtlb gt Ttlb lt td gt lt td title isImmortal gt I lt td gt lt td title jdbcGetRunningStatement gt JRS lt td gt lt td title j dbcGetRunningStatementDatasource gt JDS lt td gt lt td title j dbcGetRunningStatementStartTimeMil lis gt JRST lt td gt lt td title jdbcTotalExecutionTime gt TET lt td gt lt td title jdbcTotalQueryCount gt TOQOC lt td gt lt td title jdbcTotalRows gt TR lt td gt lt td title jJdbcTotalTime gt RR lt td gt lt td title wasQueued gt Q lt td gt lt tr gt lt cfset requestArray frapi getRunningRequests gt lt cfloop index i from 1 to ArrayLen requestArray gt lt cfoutput gt lt tr gt lt td gt requestArray i getBytes lt td gt lt td gt requestArray i getCfid lt td gt lt td gt requestArray i getCftoken lt td gt lt td gt requestArray i getCrashProtection lt td gt lt td gt requestArray i getCrashProtectionSta tus lt td gt lt td gt requestArray i getExecutionTime lt td gt lt td gt requestArray i getFusionRequestId lt td gt lt td gt requestArray i lt td gt requestArray i td gt lt td gt requestArray i lt td gt requestArray i ate lt td gt lt td gt requestArray i gt lt td gt requestArray i lt td gt req
152. Windows Installing FusionReactor on Linux e Installing FusionReactor 4 5 x on Linux Updating FusionReactor 3 x on Linux Updating FusionReactor 2 0 on Linux Updating FusionReactor 1 0 on Linux Console Installation on Linux Updating FusionReactor 4 0 x on Linux Uninstalling FusionReactor on Linux Overview Installing FusionReactor on Solaris e Installing FusionReactor 4 5 x on Solaris Updating FusionReactor 3 x on Solaris Updating FusionReactor 2 0 on Solaris Updating FusionReactor 1 0 on Solaris Console Installation on Solaris Installing FusionReactor on Mac e Installing FusionReactor 4 5 x on Mac e Updating FusionReactor 3 x on Mac Uninstalling FusionReactor on Mac Uninstalling FusionReactor on Solaris Where are FusionReactor 4 s Manual Installer Packages e Manual Instance Installation Installing FusionReactor in Locked Down Environments Installing FusionReactor on Windows Installing FusionReactor 4 5 x on Windows Updating FusionReactor 3 x on Windows Updating FusionReactor 2 0 on Windows Updating FusionReactor 1 0 on Windows Console Installation on Windows Updating FusionReactor 4 0 x on Windows Installing FusionReactor 4 5 x on Windows Executables Executable System Architecture FusionReactor_windows 4 5 0 exe 32 bit FusionReactor_windows 4 5 0 x64 exe 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executab
153. a es ee _ i D a me ch fa ih a f D z LF co Lami 13 39 13 41 13 42 13 43 13 44 13 45 Time 13 23 05 13 37 25 13 46 58 13 50 50 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data Why would I want to see a memory heap Because of its visual nature the memory heap graph can very quickly give you a good idea how the system is performing Not only that but because it can cover larger periods of time it can warn you of trends which could become a problem in the future Trends are much more difficult to spot if you are only checking the system periodically and are only looking at the health of the system right at this point in time amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel Resource Settings Heap and Non Heap The Heap and Non Heap Graph will show you a graph of the memory samples currently stored in memory by Fusion
154. a feed oobi Gp ie AE Ree 411 177 JD BG Driver Wrapper OVEIVIEW oreet ated dake ha tuted tad ee hake ta hatte Gone dee ba nha Satna PYRO a ee eo 411 127 2 Installavlon Im COIOEUSION rhea tater ee Seas oo eee As ote eee aw es Cee taeda Ma eee E Seq hee 412 1 7 3 Creating a New Wrapped Datasource in ColdFusion 0 ee 415 1 7 3 1 Using Macromedia s DataDirect ColdFusion Built in Drivers 0 0 0 eee eens 415 1 7 3 2 Constructing JDBC URLs for other DataDirect Drivers CFMX 7 8 9 10 0 eee 417 1 7 3 3 Using a User Specified Driver other Driver 0 00 419 1 7 4 Using the FusionReactor JDBC Wrapper cictienctawciots piaiy deka ta tons ete ks bbei es den Pee eS 421 Tto Interpreting JO BG LOG Dale a2 25 6 0 cme eehn ete ne Shares Aaa hanna ented ween Makar enka ahead tea eee 427 1 7 6 Prepared Statement Positional Bind Parameters Replacement Strings 0 0c cece eee 430 1247 ANole OmesGk Server Select VEINOdS 24 Sc decte na theta See eee ne oe et pelea eta ee eee 432 120 8 EXCepuon Catalog rrene i Shaner a a Mca a ah oe ON ee ha aa tee A ln E aaa dates REA tee a 435 1 7 9 FusionReactor 4 5 0 Upgrading to 4 5 0 from the Split Jar Procedure 2 0 00 cee 436 UB RUSIOMENSACLOR PUOIS epee at cp tee rhe E oe eg on es eee apenas aa eet ghee as nee gen TS Na oda Goer Heap eee Asean 437 1 831 AMIE DISSCCIOMPIGOIM seretsresse cen a e e ee he gh oe agen tee Ace BD anit A pare ae ae ae ee ani a E
155. a later time via the FusionReactor interface a Configure FusionAnalytics Connector Figure 5 Instance Installation Successful Figure 5 Once the installation is complete you will have the choice to configure the FusionAnalytics Connector Tick the check box Configure FusionAnalytics Connector and click Next if you wish to configure log transfer to FusionAnalytics now Otherwise leave the check box unticked If you have selected to install multiple FusionReactor instances clicking Next will advance the wizard to install the next instance Go back to Figure 1 If only one instance was selected you have finished the Installation wizard as displayed by Figure 6 Finished Finish Figure 6 Instance installation finished Figure 6 FusionReactor has been installed into the selected server instances Click Finish to return to the Instance Manager Uninstall FusionReactor Instance Inside the Instance Manager you will be able to uninstall FusionReactor from any server instance listed To do this click on the i button next to the desired FusionReactor instance or click the button in the far right column header you need to tick the check boxes of the desired server instances or click the hyperlink Select All if you use the button in the column header coldfusion cfmx JNTOO5F This instance is running Attempt to stop the server instance coldfusion in Adobe ColdFusion 6 C ColdFusions automatically
156. a unique name This is the the instance name e In our case we re going to rename it to cf9 Customizing the Instance Within the opt fusionreactor instance cf9 conf folder you will see two subfolders unix and windo Ws e Copy either the contents of the unix or the contents of the windows folder to c 9 conf You should now have a reactor conf anda filter def xml file in the conf folder e Open the reactor conf file with an editor e Search for all occurences of the string _ INSTANCENAME _and replace them with the name you chose above e In our case this is cf9 e lf you have installed FusionReactor in a location other than the standard opt fusionreactor C Fu sionReactor e Search for all occurences of the installation folder opt fusionreactor and change them to your install location The internal web server is configured in the file fram conf e Open the fram conf file with an editor e The internal webserver allowing access to FusionReactor over a port independent of your main webserver is controlled using the webserver keys Key Meaning WeOServer active Whether the internal webserver is made available If not FusionReactor will be available over your main webserver under http localhost fusionrea OLOF webserver address The IP address to which the internal webserver should bind webserver all Whether the webserver should bind to all addresses webserver port The port on which the webserver listens
157. abels in the Software This EULA does not authorize you to use INTERGRAL s or its licensors names or any of their respective trademarks I accept the agreement Yes 1 Mo 2 Co wWsers gqmourton Down loads gt 1 Where should FusionReactor be installed C Fus ionkReactor Co WNsers gqmourton Down loads gt Where should Setup place FusionReactor s shortcuts Fus ionKReactor Figure 4 Shortcuts Figure 4 You will now be asked where you want to install FusionReactors shortcuts system32 crr fe 4dministrator CAWindows licensors names or any of their respective trademarks I accept the agreement Yes 1 Mo 2 JC Users qnmourton Down loads 1 Where should FusionReactor be installed C Fus ionKReactor Co NWsers qmourton Down loads gt Where should Setup place FusionReactor s shortcuts LFusionReactor Co Users qmourton Down loads gt The FusionReactor Administration Manager will be installed The FusionKeactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes Cyl Mo n Enter Figure 5 FusionReactor Administration Manager FRAM Figure 5 You will now be asked if you want to configure the ports manually for FusionReactor Administration Manager FRAM Either enter
158. able the process ID of the J2EE application server on the remote machine If the FusionReactor native library is not available or FusionReactor could not read this value this field will be 1 Last Seen Time The time measured in milliseconds from midnight on January 1st 1970 which the server was last successfully polled for Enterprise data If the server has not been observed as running during this session this field will be 1 Logging Scripts When FusionReactor fires a script an appropriate message is written to the Crash Protection log located in FusionReactor instance lt instance_name gt log crashproteciton 0 log This log is shared with other CrashProtection messages and not all fields are used by Enterprise scripting Field Name Description Date Formatted date Time Formatted time to millisecond precision Time Epoch Absolute time measured in milliseconds from midnight on January 1st 1970 ServerUP or ServerDOWN The triggering state for this script invocation One of RUNSCRIPT Script successfully called SCRIPTREADFAILED Script not found or not readable SCRIPTEXCEPTION Script found and readable but an exception occurred during run 6 Unused Fields Server ID Server ID of the affected instance configured within Server Manager Script Full command and arguments launched by FusionReactor Unused Fields The remainder of the log string is unused For the exceptional cases SCRIPTREADFAILED and SCRIPTEXCEPTI
159. actor Uninstall Are you sure you want to completely remove FusionReactor and all of its components Click Next to continue or Cancel to exit Setup Cancel_ Figure 1 FusionReactor Uninstall Figure 1 Once the Uninstaller has been started read the text that asks you if you want to remove FusionReactor and all it s components Click Next to continue on with the uninstall or click Cancel to exit the uninstaller wizard ASGC FusionReactor 4 5 0 Uninstall Instances Detected Instances of FusionReactor are still installed Warning To completely remove FusionReactor all installed FusionReactor instances will be removed The corresponding target server will need to be stopped to delete the FusionReactor instances successfully Setup will guide you through the uninstallation process and you will be prompted if any instances are running before Setup will automatically try to restart them Instances that have not been correctly removed will remain installed on the corresponding target server and will cause issues a EEE SS Back Next gt Cancel Figure 2 Uninstall FusionReactor Instances Warning Figure 2 If you have other FusionReactor instances installed a warning message will be displayed to highlight the effects of removing FusionReactor Carefully read through this Once you have read it and you have understood it please click Next to uninstall all of the installed FusionReactor instances as well as Fu
160. actor correctly rejected the system cfm request during the marginal situation and that it s been tagged with a rejected flag Lino cated Memory Aled Fine lemony i Used Mamory Figure 3 Exercising Request Quantity Protection The Request Quantity Protection rejects incoming requests when the total request load on the system exceeds a certain value This protection is completely independent of any values defined by your web server or J2EE container Like other FusionReactor protections this value can be changed without causing a restart of any other software components minimizing outage time To exercise this protection access the Crash Protection Settings page using the table of contents and remove any other protections which may be left over from previous tests save Crash Protection Setings Set a Request Protection value of 4 and commit the changes using the p utton When the number of running requests rises to 4 FusionReactor will control the load by rejecting any incoming requests Request Running Request 4 F i i e T ewe Frese Lias 14 ick race ALL Kill ALL Hik heme i ag 580 z E 17 j i f F UR L Paraometers Time ms Memory KB 3 170600 545 102 1082 8 13 hitpoints H bbn integral com im gts ibosi cim gt ani Cur 14 28 8 R j Fes 174 001 G 17 0 30 5 A 12 hip ii A bbn bn erg na comin pits 1 hod cfm Cur 14 28 468 Q TE Se 3 065 Free 174 000 ji ir i I j Li r ok 29 17
161. actor you will want to access the FusionReactor Administrator FRAM There are two ways to do this e The simplest method is to use the desktop or Start Menu icons which were created during installation e Alternatively you can call the FusionReactor Administrator FRAM directly from a web browser with a URL like this http 127 0 0 1 8087 fusionreactor amp NOTE If you are using FusionReactor with Adobe ColdFusion we recommend that you install FusionReactor Extensions for ColdFusion FREC The first page you will see when you access FusionReactor Administration Manager FRAM will be a login page Enter the password fpr the Administrator user which you entered during installation and click on the Lo gin button Note that if you did not specify passwords for the Manager or Observer users these accounts are disabled and you will be unable to login as these types of users Once you are logged in you will notice that you have a 10 day trial to use FusionReactor Please check the licen se guide for a detailed guide on how to acquire and activate your license Instance Manager The Instance Manager is used to keep track of the FusionReactor instances you may have monitoring your servers Once you have installed a FusionReactor instance into a server instance you are able to add that instance to the Enterprise Dashboard where you have an overview page of different metrics The enterprise dashboard is only available with ente
162. ain page requests Parameters This setting specifies whether FusionReactor will differentiate pages based on their URL GET parameters A common design pattern is to change the behavior of a request based on the information provided as URL variables An example of this might be a doAction jsp page whose action is specified as a parameter Some behaviors of this page should be exempt from protection doAction jsp action PopulateDataWarehouse for example while some should be observed and tracked doAction jsp action ServeFile This setting allows FusionReactor to treat the two requests separately and decide whether to protect them based on the URL parameters Exclude From in Protect mode this field is called Protection Type Specifies which specific protection is affected by this rule If the engine is in Exclude mode this field specifies which protections any matching requests will be exempt from either Timeout Protection or All Crash Protection If exempt from only Timeout Protection a matching requests will still be protected by Request Quantity Protection i e will be rejected if the request load is too high and Memory Protection i e will be rejected if the memory demand is too high If exempt from Timeout Protection requests will be allowed to run to completion provided neither the Memory nor Request Quantity protections are activate If the engine is in Protect mode this field specifies which protections will appl
163. ak amount of memory Bytes initially requested from the OS by the JVM Peak Memory Usage Allowance 28 AB The peak amount of memory that Bytes has been used for memory management What is the difference between Usage and Collection Usage The table contains two terms that are commonly used one being called Usage and the other Collection Usage Usage is basically the amount of memory that has been allocated this can be heap memory or non heap memory Collection Usage relates to the garbage collector Whenever it runs and cleans up memory some of that memory will still be in use and that s the memory that the table refers to when it talks about Collecti on Usage Summary As you can see every server has different names for areas of memory so there is no hard rule about what logs will be displayed in FusionReactor There will be logs available for areas of memory in your server Also See Log Settings CPU Thread Log cputhread log To enable CPU Thread logs enable the option on the Resource Settings page The log allows you to view information about threads that ran on the servers CPU Each log entry occupies one line and contains various pieces of useful information Below is a table explaining each element in the log Elements are separated with a white space character Field Name Number Description Date Formatted 1 A The date on which this resource probe was triggered Time Formatted 2 B The time at which
164. al DataCollector that you want to receive the data Each DataCollector application can have multiple DataCollectors that receive data The default setting is one DataCollector named faDataCollector 1 The username for a user who has access to the DataCollector application This is only used if the DataCollector requires authentication If you are using the default setting this is not needed The password for the above username Tick the check box if the FusionAnalytics DataCollector is using a secure HIT TPS connection instead of regular HTTP Please see Setting Up FusionAnalytics with HTTPS for more information on how to set up FusionAnalytics to use a secure connection By clicking the button Test Target the specified FusionAnalytics target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful For more information please see the online documentation covering FusionAnalytics DataCollector Targets FusionAnalytics Connector Manager FusionAnalytics Settings stage 2 of 2 coldfusion cimxs NTOOSF FusionAnalytics Connector Connector Mode Sent to targets by FRAM Controls how the FustonAnalytics Connector will handle log files for fransfer fo FRAM or FusionAnalyties Data Gollector 4 e x htte 127 0 0 1 8087 fusionreactorfrest cfm OK The URL of a sing
165. all SQL Exceptions upwards allowing them to be transparently handled by an application In certain cases FusionReactor JDBC Driver Wrapper can originate its own exceptions These exceptions have an ID number placed in square brackets within the message string This ID number can be used to locate more information in the following table ID Example Explanation 1 Driver options must be pairs Indicates an error with the wrapper driver parameters Check all options have values 2 value for driver option option The valid values for this option are was neither true nor false value either true or false The actual read value is provided in the message Check the option specified has a valid value 4 driver option option is unknown The supplied option was not known The rogue option is given in the message Check the option for typographical errors 5 couldn t parse value for driver The given driver option requires a option option value as a number as its value and number FusionReactor couldn t parse the given value as a number The option and the rogue value are given in the message Check the value to make sure it can be parsed as a number and has no alphabetic characters driver class classname could not be found and loaded Could not find a wrapped JDBC URL within the passed string The wrapped URL must be within braces Soft kill active for this thread URL supplied did not con
166. am was opened Time to Stream Close ms 49 AW The number of milliseconds until the completed data stream was closed Deleting the Crash Protection Log Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the Crash Protection Log will be emptied and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Also See Log Settings Importing and Graphing Data in Excel JDBC JDBC Settings JDBC Stack Trace Filter JDBC Log jdbc log JDBC Settings The JDBC Settings page lets you modify various elements relating to JDBC The page has the following items SQL Statement Recording Request Detail Page Configuration Description Record SQL Specifies how SQL is stored along with each request You can either store queries in slowest first order Slowest default or in the order that they are run In Order Alternatively you can just get a summary of run queries Summary Only Record up to queries Only queries slower than ms Additional Information Configuration Query Location JDBC Logging Log Files Configuration JDBC Logging Only queries slower than ms This limits the number of queries stored for each request If you are storing them in order then you will see the first queries which are run The number of SQL statements recorded on the request affects the
167. an J2EE applications If the database is running on a dedicated machine the memory requirement is then transferred to that machine leaving the J2EE ColdFusion server with more memory to allocate to the application e Result set processing can begin much more quickly since there is a much smaller initial delay before the driver makes rows available e Repeatedly opening large queries running large concurrent queries or only processing the first few rows of a large result set is comparatively cheap since only the first batch will be transferred and stored in the client Concurrently running queries may be interleaved over the same connection Cons e Total time taken to retrieve an entire result set is slightly higher than in direct mode since the driver must retrieve several batches of rows Caveats for non ColdFusion JDBC Environments This section is for engineers using SQL Server JDBC drivers in a J2SE J2EE environment which is not ColdFusion e g where the driver connection etc is obtained manually using Java code This caveat applies only to MS SQL Server 2000 JDBC Driver and DataDirect Macromedia SQL Server Drivers This problem does not occur with the MS SQL Server 2005 JDBC Driver Connection Commit Status Restrictions in Direct Mode You may see the following JDBC exception Can t start a cloned connection while in manual transaction mode When operating in direct mode only one active SQL statement including s
168. anager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Figure 10 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 10 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 7 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 2 0 on Windows Upgrade Not Possible FusionReactor 4 x x does not support upgrades from FusionReactor 2 x If you currently have FusionReactor 2 x installed it is not possible to upgrade to FusionReactor 4 x x When running the FusionReactor 4 x x setup you will be presented with a screen similar to that shown in Figure 1 below oe Setup FusionReactor 4 5 0 FusionReactor already installed Setup has detected a previous version of FusionReactor Setup has detected that an older version of FusionReactor 2 0 4 is installed in C FusionReactor The FusionReactor 4 0 0 installer does not support updating that version You must uninstall the older version of FusionReactor before restarting this installer Intergral Information Solutions Finish Figure 1 Update Not Supported To install Fus
169. ances of FusionReactor Enterprise are R EQUIRED It is important to understand this limitation of scripting A script should not be configured to run against the same server instance that FusionReactor is running in If the server instance fails then the FusionReactor running in this server instance may not be able to run the script meaning it may not be able to restart itself for example What Are Enterprise Scripts FusionReactor Enterprise Edition can trigger a script when a server becomes unresponsive and when it becomes responsive again This mechanism might allow you to pro actively attempt to restart a failed server or instance integrate FusionReactor into an existing monitoring environment or provide custom logging or reporting Any program which is runnable on your FusionReactor monitoring system may be used by an Enterprise Script target Enterprise scripts on Windows systems are anything that is runnable as a binary or can be run from the command prompt for instance e Binary programs e Batch files Enterprise scripts on Unix and Unix based systems this includes everything you can start from a command line for instance e Binary programs e Shell scripts including Bash Ruby Python and Perl e Java programs when launched from an appropriate shell script How Do Configure an Enterprise Script Enterprise scripts are configured by editing the Script of the server s property page accessible in the Enterprise g
170. and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard setup Fusionkeactor 4 5 0 Select Destination Directory Where should FusionReactor be installed foptfusionreactor ETO hell Ohi LOT rn OL inns l Figure 3 Installation Directory Selection Figure 3 Now you have to select the directory in which FusionReactor should be installed By default FusionReactor will be installed into opt FusionReactor setup Fusionkeactor 4 5 0 FusionReactor Administration Manager The FusionReactor Administration Manager will be installed Administration Manager ETO hel ae E OL init i Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the sever ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 setup Fusionkeactor 4 5 0 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports ETO hel Ohi E i Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already
171. and other trademarks contained in the Software are rademarks or registered trademarks of INTERGRAL Information Solutions GmbH Third party trademarks trade names product names and logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any rademark trade names product names logo copyright or other proprietary notices legends symbols or Labels in the Software his EULA does not authorize you to use INTERGRAL s or its Licensors names or any of their respective trademarks I accept the agreement es 1 No 2 Figure 2 License Agreement Figure 2 After starting the install you will be shown the license agreement Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions by entering 1 7 vmuser ubuntu Downloads Enter other written notification or document issued by you in relation to the Software Licensed hereunder shall be of no effect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of INTERGRAL Information Solutions GmbH Third party trademarks trade names product names and Logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices legends symbols or Labels in the Software This EULA does not authorize
172. arge result sets may cause memory to be exhausted leading to continuous garbage collection as Java attempts to reclaim memory and possible crashes e Be aware that the total memory requirement for a given result set is twice the size of the result set When the database runs the query it must first buffer the results in its own memory space before transferring all the data to the client e Long network delay when query is run while all data is transferred For databases running on the same server this delay is shorter but not insignificant since the TCP IP transport is still used e Large time and memory overhead if not all rows are processed by the application e Ifthe application only processes the first few rows the transfer and storage of the entire result set is very inefficient e Concurrent requests for result sets from the database will cause separate connections to be opened to the database Cursor mode transfers data in batches transparently to the application The complete resulting row set for each query is stored in the database The J2EE ColdFusion application which uses the JDBC driver only stores one batch typically a small fraction of rows The driver takes care of requesting new batches from the database as they are needed Pros e Small memory requirement in the client application since only one batch of rows is stored e Memory demand burden is placed on the database which can typically manage it more efficiently th
173. ase you might try adding the jar containing your driver to the cp pro perty Users who previously used the split jar procedure to work around this issue should read the section FusionRea ctor 4 5 0 Upgrading to 4 5 0 from the Split Jar Procedure autoCommit Value Boolean Default true If specified the JDBC wrapper will turn off autocommit for all statements regardless of the current status of autocommit or the existence of any transactions This option must be used with extreme caution as it alters the default behaviour of the JDBC system and is provided as a workaround to J2EE servers which require it to be disabled We do not recommend using this option to defeat autocommit After enabling this option you must verify the atomicity and transactional integrity of your application s JDBC statements How To Specify These Options These options pertain to the FusionReactor JDBC Driver Wrapper and should therefore be specified outside of the curly braces used to wrap the original JDBC URL Any options which are required by the original JDBC URL should remain within the braced section Here s an example of a wrapped SQL Server JDBC URL using the Macromedia driver to which a couple of FusionReactor JDBC Driver Wrapper options have been added The material in bold illustrates the additional wrapper syntax elit ltt tt jdbc fusionreactor wrapper jdbc macromedi a sgqlserver int0007 1433 databaseName fr test notifyAfter 100
174. at you save any files you want to keep before running the uninstaller The uninstaller will also remove any installed FusionReactor instances during this process you will be asked to restart any running servers Please note that not stopping the servers means that FusionReactor and all of its components will not be completely removed This may cause issues on these servers FusionReactor 4 5 0 Uninstall Lat FusionReactor Uninstall Are you sure you want to completely remove FusionReactor and all of its components Click Next to continue or Cancel to exit Setup Next gt Cancel Figure 1 FusionReactor Uninstall Figure 1 Once the Uninstaller has been started read the text that asks you if you want to remove FusionReactor and all it s components Click Next to continue on with the uninstall or click Cancel to exit the uninstaller wizard FusionReactor 4 5 0 Uninstall Instances Detected Instances of FusionReactor are still installed Warning To completely remove FusionReactor all installed FusionReactor instances will be removed The corresponding target server will need to be stopped to delete the FusionReactor instances successfully Setup will guide you through the uninstallation process and you will be prompted if any instances are running before Setup will automatically try to restart them Instances that have not been correctly removed will remain installed on the corresponding target server and will caus
175. ata stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel Resource Settings Types of Memory Graphs Each server ColdFusion Tomcat Railo etc has their own naming conventions for areas in memory When an instance of FusionReactor is installed on a server you will be able to see detailed graphs for certain areas of memory that the server has The naming conventions used by your server for areas of memory will be listed in FusionReactor meaning you won t have to translate them to terms that relate to your server For example an area in memory in ColdFusion 9 is PS Eden Space so there is a graph and a log for PS Eden Space amp NOTE For FusionReactor to be able to detect some of the memory spaces this will only be available on JMX architectures you must have Java 1 5 or above installed This page lists some of the naming conventions used be a couple of servers to give you an understanding of how it works Server s Log Image ColdFusion 10 e Code Cache non hea l p w RESOURCES memory ColdFusion 9 e PS Eden Space heap memory Request Activity Graph e PS Old Gen heap memory Request Time Graph ColdFusion 8 e PS Perm Gen non heap JDBC Activity Graph mem
176. ated FusionReactor tracked request Calendar Date Value YYYY MM DD Source Wrapper Specifies the calendar date on which the log message was raised Time Value HH MM SS Source Wrapper Specifies the 24 hour time at which the log message was raised Epoch time Value long millisecond Source Wrapper Specifies the exact epoch time millisecond offset from midnight on January 15t 1970 UTC at which the log message was raised Fusion Request ID Value long integer Source FusionReactor Specifies the FusionReactor request ID within whose execution this JDBC interaction occurred Thread Value String Source Wrapper Specifies the name of the thread in which this JDBC interaction occurred Client IP Value dotted quad IP address Source FusionReactor Specifies the IP of the client for whom this request is running HTTP Method Value HTTP 1 X Method GET POST HEAD etc Source FusionReactor Specifies the HTTP method of the request which caused this JDBC interaction URL Value Full or Partial URL Source FusionReactor Specifies the URL which caused this request to run If FusionReactor is tracking complete URLs which machine name this will be a full URL If not this will be the path element Log Message Type Value One of METRIC NOTIFICATION or REMINDER Source Wrapper Specifies the type of this message METRIC reports the completion of a JDBC interaction NOTIFICATION specifies that a
177. ation Description Request This is the document type that you want to restrict Firstly select if you are creating an Exact Match or Regular Expression Next enter your MIME Type For examples of Regular Expressions please see Re gular Expressions and Content Filters Text or Regular Expression The text input here depends on the option you choose for Request The options are Exact Match or Regular Expression Request Exact Match text plain These restrictions control which MIME Types FusionReactor will compress You can change the behavior of the rules Ignore or Protect on the Compression Settings page To filter or exclude requests ofa certain type simply add a pattern that matches the request name Please Note You can use Regular Expressions as your filter rule An introduction to Restrictions and Regular Expressions For more technical information on Regular Expressions please refer to the online Java documentation Add Restriction Once you submit the form the page will be refreshed and your new restriction will be listed at the bottom of the page Managing Existing Restrictions Below the Add Restriction form you will see a list of all existing restrictions Each restriction has two icons next to it Button Name Description P Modify Restriction Clicking on this icon will take you to the Modify Restriction page From this page you can change any of the information which is listed above New MIME Type Restric
178. avallable on port 8087 which manages your FuslonReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager The FusionReactor Administration Manager URL http 127 0 0 1 8087 fusionreactor thtml ctm mode main Finishing installation Figure 11 Finish Screen Figure 11 You have successfully installed FusionReactor Open the URL to go to FRAM Installing FusionReactor on Mac Installing FusionReactor 4 5 x on Mac Updating FusionReactor 3 x on Mac Installing FusionReactor 4 5 x on Mac Executables Executable System Architecture FusionReactor_macos 4 5 0 dmg 32 bit FusionReactor_macos 4 5 0 dmg 64 bit A Setup 10 8 Setup FusionReactor 4 5 0 lt t actor Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation fusion Welcome to the FusionReactor Setup vA Click Next to continue or Cancel to exit Setup S Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen Clicking the Next button will proceed with the installation and open the License Agreement as shown in Figure 2 Clicking Cancel will exit the Setup aH Setup FusionReactor 4 5 0 License Agreement ED Please read the following
179. ay be requested from you As OSGi is responsible for the deployment of plugins this log contains information relating to that as well as the state of OSGi itself Below is a table describing what all the attributes mean in the log file osgi log Field Name Number Date Formatted 1 A Time Formatted 2 B Description The date on which this log entry was written The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Log Settings FusionReactor Plugins Reactor Log reactor log A log will be generated reactor log The log contains information about FusionReactor as whole typical it contains information on settings that have been changed as well as information critical to it Below is a table explaining what all the attributes in the log file mean Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is b
180. ayed in the Enterprise Dashboard If the average request time over the past 60 seconds exceeds the Warn value then it will appear in orange If it exceeds the Critical value then it will appear in red This number will be used as the maximum value on the average request time graphs and bars within the Enterprise Dashboard amp NOTE This value is only used for display purposes Entering a number here will NOT limit the amount of time requests can run on a server JDBC Configuration JDBC Status ms Graph Y Scale ms Crash Protection Configuration CP Status Slow Requests Configuration Description These two numbers Warn and Critical are used as threshold values to work out if a server should be put into a warning or critical mode when it is displayed in the Enterprise Dashboard If the average DB time exceeds the Warn value then it will appear in orange If it exceeds the Critical value then it will appear in red This number will be used as the maximum value on the average DB time graphs and bars within the Enterprise Dashboard amp NOTE This value is only used for display purposes Entering a number here will NOT limit the amount of time database requests can run ona server Description These two numbers Warn and Critical are used as threshold values to work out if a server should be put into a warning or critical mode when it is displayed in the Enterprise Dashboard If the nu
181. bc fusionreactor wrapper jdbc mysql i nt00d6 bbn intergral com 3306 TestApp tiny IntlisBit false amp driver com mysql jdbc Dr iver name mysqldb cp c ColdFusion1l10 cfusi on 1ib mysql connector java commercial 5 1 17 bin jar MySQL 5 Connector J MySQL Here s an example using the MySQL Connector J driver downloadable from mysql com It s installed in c mys gql mysql connector java 5 1 20 bin Jar Py I jdbc fusionreactor wrapper jdbc mysql i nt00d6 bbn intergral com 3306 TestApp dri ver com mysql jdbc Driver name mysqlj cp c mysql mysql connector Jjava 5 1 20 bin ja Microsoft SQL Server Macromedia Using the Macromedia driver with the remindAfter FusionReactor Driver Wrapper option we ve named this data source too lel err jdbc fusionreactor wrapper jdbc macromedi a sgqlserver int0007 1433 DatabaseName fr test remindAfter 500 name SOLServerDataSo urce Lee ee eee ee a e l Microsoft JDBC Driver 4 0 for SQL Server Microsoft Here s a URL using the Microsoft SQL Server 2005 JDBC Driver which is not supplied by Macromedia and so must therefore be explicitly specified as the driver together with its jar which we ve placed in c jdbc jdbc fusionreactor wrapper jdbc sqlserver gt int00d0 1433 databaseName AdventureWork s driver com microsoft sqlserver jdbc SQL ServerDriver name testdb cp c jdbc sqljdb c4 jar In this example the username and password must
182. bled then JDBC information will be written to the JDBC log Only log queries that run longer than this time will be written to the log files Optional View Size KB This value indicates how much of the log file should be displayed when you view the JDBC log from inside FusionReactor amp NOTE These settings pertain only to DSNs wrapped with the FusionReactor JDBC Driver Wrapper For more information please see the JDBC Driver Wrapper User Guide JDBC Stack Trace Filter The JDBC Stack Trace Filter page lets you set up various filters which are used to make the Java Stack Trace more manageable The complete Java Stack Trace contains far more information than you are likely to need so this page has been added to let you tailor it to your own preferences By default FusionReactor will show you any Stack Trace rows which contain references to cfm cfc or jsp pages To add a new filter just type a string into the field provided and click the Add Filter Pattern button Any lines in the stack trace which contain that string will be stored along with the JDBC request Filter Pattern Managing Existing Filters Below the Add Filter Pattern form you will see a list of all existing filter patterns Each pattern has two icons next to it Button Name Description Fe Modify Pattern Clicking on this icon will take you to the Modify JDBC Java Stack Trace Filter page From this page you can change the filter pattern Described i
183. bove eg main cim mode batch Once you submit the form the page will be refreshed and your new restriction will be listed at the bottom of the page Managing Existing Restrictions Below the Add Restriction form you will see a list of all existing restrictions Each restriction has two icons next to it Button Name Description Fe Modify Restriction Clicking on this icon will take you to the Modify Restriction page From this page you can change any of the information which is listed above 3 Delete Restriction Clicking on this icon will prompt you if you are sure you want to delete this restriction If you OK the dialog then the restriction will be removed from the Existing Restrictions list and the page will be refreshed Request Params EB imyfolderimyfile cim No Change Password Change Password From this page you can change the password for the various users within the system To change a password select the user type and enter a new password plus verification Administrator Select which user password you wish to change Old password Enter the old password I New password Enter the new password Confirm new password Type the new password again NOTE Ifyou change your FusionReactor password then you must change the Enterprise Dashboard password for this server both on this server and any servers monitoring it Disable a User Account If you want to disable a user type then click on one
184. bug files on your server FRAPI Examples in ColdFusion FRAPI Examples in ColdFusion The FRAPI lets you call FusionReactor methods directly from your ColdFusion pages JavaDocs are available for the FRAPI and are available from the FusionReactor site Click here to view the FRAPI JavaDocs Lets first start with some simple examples though This is one of the simplest FRAPI calls lt cfset frapiClass createObject java com intergral fusionreactor api FRAPI gt lt cfset frapi frapiClass getInstance gt lt cfoutput gt Is FR Running frapi isFusionReactorRunning lt cfoutput This page simply outputs a YES NO value depending on the running state of FusionReactor Mozilla Firefox File Edit View Go Bookmarks Tools Help a hi Is FR Running YES Using FRAPI to look at running requests Now for something a little more interesting lt cfset frapiClass createObject java com intergral fusionreactor api FRAPI gt lt cfset frapi frapiClass getInstance gt lt cfset dateClass createObject Jjava Java util Date gt lt Loop over each running request gt lt cfset requestArray frapi getRunningRequests gt lt hr gt lt cfloop index i from 1 to ArrayLen requestArray gt lt cfset dateObject dateClass init requestArray i getStartTim eMillis gt lt cfoutput gt ID requestArray i getFusionRequestId lt br gt URL requestArray i
185. button to close the application Uninstalling FusionReactor Extensions for ColdFusion FREC The FusionReactor Extensions for ColdFusion Instance Installer is completely responsible for the adding or removing of the FREC plugin to from your FusionReactor instances If you uninstall the Instance Installer without first uninstalling all plugins then you will no longer be able to administer those plugins To uninstall the FusionReactor Extensions for ColdFusion Instance Installer select the menu item from the Start Menu or use Add Remove Programs Windows platforms FusionReactor Extensions for ColdFusion Setup Uninstall Are you sure you want to completely remove FusionReactor Extensions for ColdFusion Setup and all of its components Click Next to continue or Cancel to exit Setup Extensions for ColdFusion Figure 1 Uninstall Welcome Screen The first screen in the uninstaller is just the Welcome page Click Next gt to continue FusionReactor Extensions for ColdFusion Setup 1 0 1 Uninstall Uninstall FusionReactor ColdFusion Extensions Are the extentions installed on any ColdFusion Instances Before uninstalling the FusionReactor ColdFusion Extensions tool make sure that you have uninstalled the extensions from all of your instances You will be unable to manage your FusionReactor ColdFusion Extensions instances once the tool has been uninstalled To manage any installed instances re install the FusionReac
186. can NOT be disabled FR REST User You can input the name of the FR REST User here you can change it as you please It is also recommended that you also set a password for help doing this see the Change FR REST Password secti on Filter Restrictions FusionReactor restrictions are set up so that FusionReactor can ignore certain requests or alternatively you can specify a set of pages which you want to monitor with FusionReactor while all others are ignored To select which mode the Restrictions page works in change the Restrictions option on the FusionReactor Settings page The FusionReactor Restrictions page has two main areas At the top of the page there is a form for you to enter new restrictions and below this is a list of all existing restrictions for the application New FusionReactor Restrictions To enter a restriction you will need to fill the following fields Configuration Description Request This is the page you want to exclude Firstly select if you are creating an Exact Match or Regular Expression Exact Match Next enter the location of your page By default the request will be an exact match and should look something like batchStats cfm or batch dailyStats cfm beginning with a and without parameters The text you input here will depend on the options you choose for the Hostname and Parameters fields Regular Expressions A good use of Regular Expressions here would be to restrict everythin
187. ce if the average execution time of the active requests is continuing to increase it could be that some requests are hanging Placing your mouse pointer on a data point will show a tooltip with details about that sample Resources Request Average Execution Time Graph D Average Execution Time of Completed Requests Average Execution Time of Active Requests at sample 20000 7 SU aw Jeenbay seang 13 38 45 14 35 07 14 40 02 17 37 40 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel JDBC Activity Graph The JDBC Request Activity Graph is a graph of all the JDBC request activity samples currently stored by FusionReactor The time span of these samples will depend upon your history size and interval time see Resou rce Settings You can zoom into the graph and scroll through it in order to get a be
188. ce of all the Threads that were running in the JVM that your server runs on when Crash Protection was fired A detailed description of all requests that were running on your server when Crash Protection was fired such as request URL return status code and client IP address Examples of Crash Protection Emails Below are some examples of what Crash Protection emails looks like to make them easier for you to read they have been shortened mostly the JVM Stack Trace Simple click the email title to view the email and click the email title again to hide the email Timeout Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Hello this is the FusionReactor Crash Protection agent at HP Pdv6 Laptop instance coldfusion cfimx9 HP Pdv6 Laptop http HP Pdv6 Laptop 8088 fusionreactor f html cfim mode main The following alert was generated at Tue May 15 10 40 00 CEST 2012 Notify Crash Protection Request Run Time Alert Actual value at detection 1297ms threshold value 1000ms Current Triggering Request Request ID 5 Request URL http 127 0 0 1 8500 cf sleep cfm Status EXECUTING Started Milliseconds 1337071199613 Started Date Time 2012 05 15 10 39 59 613 Thread ID web 0 Client IP Address 127 0 0 1 Request Method GET Execution Time ms 1301 Used Memory percentage 61 Max Memory KB 466048 Used Memory KB 284520 Total Memory KB 417600 Free Memory KB 133079 Query
189. ces depending on what configuration you choose in Log Settings Both places are as follows 1 If you choose Use Centralized Archive and Rotation Use Centralized Archive and Rotation it is located C FusionReactor instance FRAM log archive_name 2 If you choose Use Traditional Per Log Rotation it is located C FusionReactor instance FRAM Iog Notice these logs aren t archived Memory Heap and Non Heap Log memorysummary log Types of Memory Logs Memory Heap and Non Heap Log memorysummary log For information on changing log settings see the Log Seitings page This log displays information about the memory heap and non heap memory Each log entry occupies one line and contains various pieces of useful information separated with a white space character Below is a table explaining each element in the log Elements are separated with a white space character The log is called memorysummary log Field Name Number Description Date Formatted 1 A The date on which this resource probe was triggered Time Formatted 2 B The time at which this resource probe was triggered Date Time ms 3 C This is the millisecond time at which at which this resource probe was triggered Version 4 D Version number of this log entry Server Startup Time ms 5 E Startup time of the application server in milliseconds ms since epoch Heap Memory Allowance Percentage Heap Memory Used Bytes Heap Memory Committed Bytes H
190. cess and close the window FREC Log Files When FREC is enabled See How to enable FREC it will generate extra logs every time FusionReactor performs a Centralized Log Rotation The following files generated by FREC are as follows e dbpoolstats log hitcountstats log e realtimestats log plugin fr logrotator plugin log Click one of the above links to see a page dedicated to each log file explaining what each of the attributes mean CF Database Connection Statistics dbpoolstats log amp NOTE It is important that you enable Monitoring and Profiling in ColdFusion to do this check out ColdFusion Settings Section in How to enable FREC guide This log dbpoolstats log lists the data sources whether an application on the ColdFusion server is using the data source and the number of connections The information can be fed through to FusionAnalytics to produce detailed graphical representations of the data Below is a table explaining each of the attributes in the log For further information on what FusionAnalytics is and how it can benefit you click here Field Name Date Formatted Time Formatted Date Time that the request was made Milliseconds Get Log Version Date Time that FusionReactor stated Milliseconds Average Open Connection Count Average Total Connection Count DNS Data Source Name Maximum Number of Connections Number of open Connections Total Connection Count Also See Log Settin
191. ck Install to begin installing FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Intergral Information Solutions Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup You are now ready to start configuring instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your Fus
192. comes available On Shutdown and Start Up must be selected e f you do not wish to additionally receive email for these events disable notification in FusionReactor gt Settings gt Email Server gt Notification How Does FusionReactor Run These Scripts Launch Mechanism FusionReactor runs these scripts by spawning them using Java system commands The scripts will be run in the context of the user under which your J2EE ColdFusion server runs This user must have at least read execute access to these scripts Any files or other executables called by the script must also be accessible by this user The script will be run with the current working directory CWD of the J2EE application server Because of the variety of platforms available this may be unpredictable Any scripts you write should therefore not use the current directory notation usually a single dot to address files If you plan to access files within the script their paths should be specified completely Script Arguments FusionReactor supplies several command line arguments to the script These arguments may be used by the script to perform logging or restart operations The supplied arguments are in order Argument Description UP or DOWN Reflecting the instance status instance name As registered in the Manage Servers screen IP Address As returned from a DNS lookup of the machine name part of the URL used to monitor this instance Process ID If avail
193. corator plugin log which contains information on the status of the plugin when it started stopped if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Date Formatted Time Formatted Number 1 A 2 B Description The date on which this log entry was written The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as that logging has started Also See Log Settings FusionReactor Plugins FusionReactor Deadlock Plugin Description The FusionReactor Deadlock plugin polls all Java threads running in the JVM that your server is running on every 30 seconds Any Java thread deadlocks detected are written to a log file deadlock log see below anda n otification see below is created for that particular deadlock A deadlock occurs when two or more threads are waiting for each other to finish For example Thread 1 may have a hold on Objecti Thread 2 may have a hold on Object2 In order for Thread 1 to complete it s operation it needs to access Object2 for Thread 2 to complete it s operation it needs to access Object1 Both threads are
194. could terminate it Most operations can be terminated immediately though The Request History page shows the abort by annotating it with a timeout flag as illustrated X Ge a Se a a E EOD Tor T bee re J bts irre rad cem im pe pee eee 0274 Cur 2 1B OF 1 i ma Fros 184 468 Exercising Memory Protection Exercising memory protection is a little more difficult due to the disparate memory configurations in use but here s how we use FusionReactor to show it in action in our test environment The first step is to work out how much memory is available to us Instead of hunting through J2EE configurations we can use FusionReactor to tell us Resum ces Memory Graph Ton ul Fe oo ME Boo 11 57 48 400 0 5 sai i Figure 1 Access the Memory Graph accessible from the table of contents under the Resources section and have a look at the figure at the top left of the Y axis see Figure 1 for our value about 759 MB Memory Protection uses a percentage value as the upper limit to ensure a marginal situation does not become critical If we define a Memory Protection of 10 this translates to about 76 MB The actual effect of this protection will be to reject new requests when the quantity of free memory drops below 76 MB During this test we ll be using the Memory Graph to observe the situation In the Crash Protection Settings page we set up the Memory Protection to activate at 10 and make sure any value in the T
195. cure HTTPS connections however you need to setup configure the server to use HTTPS for this to work Tomcat You must install a Certificate into Tomcat to enable HTTPS HTTPS then runs on a different port to the HTTP port typically 8087 e Modify the server xml file located under FusionReactor tomcat conf lel eer lt Connector port 8443 protocol HTTP 1 1 SSLEnabled true maxThreads 150 scheme https secure true keystoreFile C keys keystore jks keystorePass changeit clientAuth false sslProtocol TLS gt ee l e This is using port 8443 and assuming the keystore password is changeit Make any modifications as necessary e Restart the server start it using catalina bat on Windows catalina sh on Linux to make sure no errors are being displayed e For more information on how to configure a tomcat server to use SSL see http tomcat apache org tomc at 6 0 doc ssl howto html Creating a Self Signed Certificate e You need to have Java installed and access to the keytool java bin e Run the following statement from the command line keytool genkey keyalg RSA alias selfsigned keystore keystore jks storepass changeit validity 360 keysize 2048 e When prompted enter localhost as the first and last name e Use the generated keystore in your tomcat installation Accessing FusionReactor Administration Manager FRAM If you have followed the above guide FRAM should now be available on the HTT
196. d configuration See Technote FRS 289 Using the JOBC Wrapper with Apache Derby Database on ColdFusion for more information This URL explicitly specifies the driver together with its jar and the autocommit option also explained at the link above elation jdbc fusionreactor wrapper jdbc derby C ColdFusion10 cfusion db bookclub create f alse MaxPooledStatements 300 driver org a pache derby jdbc EmbeddedDriver name bookc lubdb cp c ColdFusion10 cfusion 1lib derby Jar autocommit false And Finally and as a quick reminder the FusionReactor Driver Wrapper driver class is com intergral fusionreactor jdbc Wrapper Interpreting JDBC Log Data When outputting data to the JDBC log file which can be found in FusionReactor s instance log directory the FusionReactor JDBC Driver Wrapper outputs a number of fields which can be used to debug JDBC transactions and derive statistics about how the system is using database resources The JDBC log file is soace delimited with text fields which may contain spaces enclosed with double quotes We have had no trouble importing this data into Microsoft Excel and OpenOffice Calc as well as Microsoft SQL Server using Data Transformation Packages The following list describes the meaning of each field The list describes the fields in left to right order For field sources listed as FusionReactor this field may be empty if the request in which the query ran has no associ
197. d using the Mark Read or Mark All Read buttons Mark All Read Marks all notifications read They will not appear as New Notifications in the TOC indicator nor will they appear in the Enterprise Dashboard for customers with applicable licenses Mark All Unread Marks all notifications as unread They will appear as New Notifications in the TOC indicator and will appear in Enterprise Dashboard Remove All Removes all notifications completely All buttons will be disabled when they have no logical function for example if all notifications are unread Mark All Unread will be disabled Updating Since the Notifications list updates dynamically there will be a short delay on average 2 5s until the page updates after a button press In the meantime the button text is changed to Wait to indicate that FusionReactor has received and processed the request but that the effect hasn t been reflected in the page yet Enterprise Dashboard New in 4 0 6 Fk reactor default tomcat Lik Administrator Q 4 New Notifications w REQUESTS Running Requests Request History Request Settings Request Log w ENTERPRISE Enterprise Dashboard Manage Servers Manage Groups Enterprise Settings METRICS system Metrics Longest Requests slow Requests Longest JOBC Metrics Settings b RESOURCES Enterprise Enterprise Dashboard FusionReactor Instance Local License FR4S2ENT S 0000052 FRASZENT Activation Status OK Request
198. dFusion log files and Serer Monitoring API Logfile Configuration fecoldfusion olugin 7 0 0far Figure 1 FusionReactor ColdFusion Plugin in Active Plugins Figure 1 To Configure the FREC plugin click the button Configuration A new page will be displayed Figure 2 Click the button on the right to update FusionReactor ColdFusion Plugin Configuration Save FusionReactor ColdFusion Plugin Configuration This section controls the configuration of the FusionReactor ColdFusion Plugin Create a copy of ColdFusion Log Entries Enabled w When enabled the ColdFusion Plugin will log the ColdFusion Log entries into its own log file which will be included in the FusionReactor Centralized Log Rotation when it occurs These logs can also be used by FusionAnalytics to analyze the server Create a log of the ColdFusion Server Monitor Data Enabled v When enabled the ColdFusion Plugin will log selected ColdFusion Server Monitor Data into its own log files which will be included in the FusionReactor Centralized Log Rotation when it occurs These logs can also be used by FusionAnalytics to analyze the server Click the button on the right to update FusionReactor ColdFusion Plugin Configuration Save FusionReactor ColdFusion Plugin Configuration Figure 2 Configure FusionReactor ColdFusion Plugin Figure 2 The following configurations options are available to Enable or Disable Configuration Description Create a copy of ColdFusion Log En
199. default port configuration click Back and uncheck the Configure ports manually option FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administration Manager Validate Password Intergral Information Solutions Figure 7 Administration Manager Password Figure 7 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long Ready to Install FusionReactor The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service on port 6067 Create a Desktop Shortcut to FusionReactor Administration Manager Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions Figure 8 Ready to Install Figure 8 The FusionReactor Setup can create a shortcut on the Desktop to FRAM if you do not want Setup to perform this action uncheck the option Create Desktop Shortcut to FusionReactor Administration Manager Setup can also automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Cli
200. dminapi servermonitoring serviceMethod getRealtimesStats response M8 Figure 1 Decoded AMF details Configuration The AMF Dissector Plugin Configuration accessible from the Active Plugins page allows you to alter the following Field Name Description Dissector Mode Buffer Size bytes Number of Messages Streaming Message Store Mode Message Display Ordering Log File This allows you to record either Inout AMF Output AMF Both or None Decoded AMF data can be viewed by going on Request History and clicking the detail button and then clicking on the tab that is named AMF as seen in Figure 1 This is the buffer size you can allocate to each message It is advisable that you select a reasonable size otherwise data may get rejected by the dissector This is the number of messages in an AMF stream that can be stored per transaction Store First Messages When the buffer is full the most recent messages will be discarded Store Latest Messages When the buffer is full the older messages will be discarded This allows you too choose the order that messages are displayed choosing Newest First means that the most recent messages are displayed first Choosing Oldest First means that the oldest messages will be displayed first No log files about captured data are generated from this plugin Status Log plugin fr amf decorator plugin log This plugin creates a log file called plugin fr amf de
201. during the request This will usually be GET or POST Request URL 10 J This is the requested URL The format of this column will change depending on URL Format setting which can be found on the Reques t Settings page Log Type DB Start Time DB End Time Total End Time DB Time Total Time Row Count Prepared Statement Row Limited DataSource Statement Stack Trace 11 K 12 L 13 M 14 N 15 O 16 P 17 Q 18 R 19 S 20 T 21 U 22 V One of METRIC NOTIFICATION or REMINDER The time in milliseconds at which the JDBC query began The time in milliseconds at which the DB finished with the query The time in milliseconds at which the query was completely finished after results were transferred back etc The amount of time in milliseconds this JDBC query spent in the DB The total amount of time in milliseconds it took to complete this query The number of rows returned by this query This is a simple TRUE FALSE value to tell you if this statement had already been prepared prior to its execution This is a simple TRUE FALSE value to tell you if this query was row limited If you have assigned a name to your data source wrapper then it will appear here To find out how to name your data sources please refer to page 14 of the JDBC Driver Wrapper User Guide The actual statement which was run This is the stack
202. e FusionReactor 4 x x does not support upgrading from FusionReactor 1 x If you currently have FusionReactor 1 x installed it is not possible to upgrade to FusionReactor 4 x x To install FusionReactor 4 5 x you must first uninstall FusionReactor 1 x and then run the FusionReactor 4 5 x Setup again Console Installation on Linux Executables Executable System Architecture FusionReactor_linux_4 5 0 sh 32 bit FusionReactor_linux_4 5 0 x64 sh 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup The setup needs to be run as root vmuser ubuntu Downloads ivmuser ubuntu Downloads sudo FusionReactor Linux 4 sh c sudo password for vmuser Unpacking JRE Preparing JRE Starting Installer This will install FusionReactor on your computer r o Enter Cancel c Figure 1 Start the Installation Figure 1 To run the FusionReactor 4 5 x installation in console mode you need to add the c switch For example sudo FusionReactor_linux_4_5_0 sh c vmuser ubuntu Downloads this EULA or upon any breach of this EULA shall not be deemed a alver of those rights or of the breach You agree that any arying or additional terms contained in any purchase order or Enter other written notification or document issued by you in relation to the Software Licensed hereunder shall be of no effect INTERGRAL
203. e Connector Settings Effects of the Lock Once placed some settings detailed below are no longer editable from within the FusionReactor Instance The locked settings will have a lock icon aj next to them and they will be editing of these fields is disabled Log Settings e Log Engine e Rotation Modee e Rotate Every At FusionAnalytics Settings e FusionAnalytics Connector Mode FusionAnalytics Targets e No targets may be edited added or deleted Naming Applications and DataCollectors When adding a FusionAnalytics target to FusionReactor s Analytics gt FusionAnalytics Targets normal instance or within the FusionAnalytics Connector Manager FRAM Instance Manager you ll be asked for some information about the FusionAnalytics DataCollector target An in depth explanation of FusionAnalytics targets and the FusionAnalytics DataCollector which defines them is out of the scope of this article however it is possible to show you where the data for each field in the wizard comes from Here s a capture of a blank form ready to be filled in coldfusion cfimx9 w 7k3 rh vbox Port o400 The hosiname and pon number of the machine on which the FusionAnalytics DataCollector fs manning Application name coidfusion cimx9 w2k3 jrh vbox The name of the DCML Application installed in the FusionAnalytics DataCollector DatalCollector faDatatCollector 1 The name of the DateaCollector installed in the above application H
204. e Brace heh Aap analy OR ee ke Ba 224 1 3 1 2 3 Risks and Restrictions of Request Abort 0 0c eens 225 1 3 1 3 The Crash Protection Restrictions Engine sasssa crre 446 dee ee id deen ead enia ee a aa 6 ee Ped ees 225 1 9 1 031 Grash Protection Restrictions ENGINE siri vincageicaeekwtneadgtac ted ali aa ead aa bate oe tee ees 226 ka k32 CUSIOMEer DEINOGKADIIGS se raren imane Greed Gea hai ee ta ha toga Sen adden Ok E eee eee 226 Lo koo OSU ICHOMS Engine RUGS weie Yene A ge widerreraraus are ean ata gar E N E ity Ghia date twa aes eS 226 toZ Gl ASHE FOLSOM IY PAC TO UN sest worst ce ae ak dy Geena tae Gah teed Sa cakes Ow Se eae ae Ag Geto cae aed ern dae oe apenas a 226 koa tes PAGOS e ee ee ee a Oe ee ee ee ae ee eee eee ee eee eee eee er eae ee eee nee 227 1952 2 EXOrCISING TIMGCOUL FEOLSCU OI ca cet raneren spe og ees Do ie Chama R ees Sve Bo Ra we ieee Beane Ae ete a 227 1 3 2 9 EXECS INO Memo Proteco cccream ad vee en care ceeute ade a Seed Ua ate eee Nera 228 1 3 2 4 Exercising Request Quantity Protection 2 0 66 bee cede eee de ee Pena eddie dee Pee ee es 229 To zA Using ANS Queue SUAB0y rossana a Aca ar ghee att can E caneg ite gee od E E ape he Mee eee eee 230 t325 Using he Redirect Method sereni rare riaren deters Ss Maia Ohare Praga teat tears dard ea aed EE PAA tee a 230 Tiel BESE PFaCuGes in FOCIRe CE OMe srereriran ws tose coca Bom Ad ca r att can arog ge E cae nee rad E A Me cee eee 231 1 3 3 Understanding Crash
205. e Instance Manager by providing the server root directory Manage Instances This section of the Instance Manager list all of the servers and FusionReactor instances known to the Administration Manager The Instance Manager displays information as well as provide management actions for each FusionReactor instance listed in the table of server instances that the Instance Manager knows of Instance Information Figure 1 Table Headers Figure 1 The information available for each FusionReactor instance Field Name Description Instance This column will display the actions available for each instance see below section Available Actions for more information on the actions available for the server instances Instance Link If FusionReactor has been installed into this instance this column contains a link to that instance If not this column contains a character Port If FusionReactor has been installed into this instance this column contains the port of the installed FusionReactor instance If not this column will contain a character Version If FusionReactor has been installed into this instance this column contains the version of FusionReactor currently installed into the server instance If not this column will contain a character E ET This column contains actions to be performed on multiple instances The action will be performed on every instance that is selected by checking the box in this column for eac
206. e Logging is enabled then resource information will be written to the Resource Log View Size KB This value indicates how much of the log file should be displayed when you view the Resource Log from inside FusionReactor Resource Log resource log The Resource Logs a set of rotating log files accessible over the Resource Settings page are simple space separated files so they can be easily imported into database or spreadsheet applications The file is called resource log the bottom part of the page tells you where you can locate this file on your hard drive The log file is formatted as follows Field Name Number Description Date Formatted 1 A The date on which this resource probe was triggered Time Formatted Date Time ms Version Server Startup Time ms MEM Used Memory percentage Max Memory KB Used Memory KB Total Memory KB Free Memory KB CPU CPU Time percentage Total CPU percentage REQ Total Request Count 2 B 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K 12 L 13 M 14 N 15 O 16 P The time at which this resource probe was triggered This is the millisecond time at which at which this resource probe was triggered Version number of this log entry Startup time of the application server in milliseconds ms since epoch Fixed Separator The amount of used memory expressed as a percentage Th
207. e agreement I do not accept the agreement Intergral Information Solutions Figure 2 License Agreement Figure 2 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard Select Destination Directory Where should FusionReactor be installed Select the folder where you would like FusionReactor to be installed then dick Next Destination directory E FusionReactor Required disk space 138 9 MB Free disk space 261 985 MB Intergral Information Solutions Figure 3 Installation Directory Selection Figure 3 Now you have to select the directory in which FusionReactor should be installed By default FusionReactor will be installed into C FusionReactor Select Start Menu Folder Where should Setup place FusionReactor s shortcuts Select the Start Menu folder in which you would like Setup to create FusionReactor s shortcuts then dick Next ACCESSOres Administrative Tools AOE Apache Tomcat 5 0 Apache Tomcat 7 0 Tomcat A goUML CCleaner CutePDF CyberLink DVD Suite DAEMON Tools Lite wamDift FileZilla FTP Client sionAnalytics Intergral Information Solutions Figure 4 Start Menu Folder Figure 4 Select the Start Menu folder in which FusionReactor shortcuts will be placed
208. e are becoming more common as the complexity of J2EE applications increases lf the used memory blue graph is growing rapidly you can try to ask Java to perform garbage collection yourself by clicking on the trash can icon on the Memory Usage graph However Java s memory algorithm is very sophisticated and it s unlikely a manual collection will have any significant effect CPU Observation CPU Usage is another useful metric If the instance is consistently busy see the blue line on the Memory Usage chart with low load see Request Activity graph this might indicate a problem with the pages being run see Request History such as infinite loops or runaway queries consider using the FusionReactor JDBC Driver Wrapper to analyze and prevent JDBC problems The Metrics gt Longest Requests page shows the longest running requests FusionReactor also flags long running requests with an appropriate label in the Request History table You can configure what FusionReactor considers a long running request and how many to store in the Longest Requests table in the M etrics Settings page Configuration and Diagnosis for Production When we say Production we mean a stable system which is serving live requests These systems aren t used to test new applications and they usually settle into a steady state over time Once they stabilize we can perform some simple analysis to tune FusionReactor The principal of tuning a production system is to watch f
209. e design In interactive systems like the web requests must run in as short a time as possible It s often preferable to receive an error message rather than continue waiting for a request which may never complete e Too many requests running simultaneously often leads to resource starvation and although it s usually possible to tune this using the J2EE engine itself the system must usually be restarted for it to take effect and the option is usually well hidden The majority of J2EE engines including Adobe s JRun control resource access using thread pools and having too many requests running at once can reduce or exhaust these pools to the state where it s no longer possible to recover the system leading to a costly restart e Exhausted memory occurs very frequently in production environments On shared installations as well as dedicated servers there never seems to be enough memory Approaching memory margins is a sign that the server is overloaded or one or more requests are creating a lot of objects and using more than their fair share of storage Types of FusionReactor Crash Protection We designed three crash protection rules to counter these common situations There s no need to alter any J2EE engine settings to take advantage of these rules and no container restart is required for them to take effect e Timeout Protection Any request which runs longer than a given threshold causes this rule to fire e Request Quantity P
210. e finished Figure 9 The selected FusionReactor Instances have been updated Click Finish to return to the Instance Manager Corrupt Configurations Identifying Corrupt Configurations FusionReactor s Instance Manager available in the FusionReactor Administration Manager sometimes needs to manipulate the configurations of the individual instances it s monitoring To make this operation as safe as possible some checks are done prior to any edit operation If any of these checks fail FRAM refuses to perform the edits and displays a warning like the following Corrupt Configuration The configuration of instance s coldfusion ctmx9 int0060 appears to be 4 corupt Please reinstall this instance and restart its ioe at the earliest opportunity i ations Because this is an exceptional potentially unsafe situation you ll also get a non dismissable notification flagged in the table contents tector Administration Manager Administration Manager Administrator p 1 Notification 1 new Clicking on this notification will take you to a page which details the error Time Title Message Actions Z2 Jul11 Warning Instances FusionReactor Administration Manager has 13 53 55 805 d a a e a aed LEISS configurations Please use the Instance Manager to reinstall this instance and restart its container at the Corrupt configurations can be detected for a number of reasons e Completely missing configurati
211. e issues Figure 2 Uninstall FusionReactor Instances Warning Figure 2 If you have other FusionReactor instances installed a warning message will be displayed to highlight the effects of removing FusionReactor Carefully read through this Once you have read it and you have understood it please click Next to uninstall all of the installed FusionReactor instances as well as FusionReactor Otherwise click Cancel to stop the uninstall FusionReactor 4 5 0 Uninstall FusionReactor Uninstall Please wait while FusionReactor is removed from your computer Uninstalling FusionReactor 4 0 0 Loo E Figure 3 Uninstall Progress Bar Figure 3 Once you have clicked Next the FusionReactor uninstaller will begin to uninstall FusionReactor and all of the installed FusionReactor instances i The instance coldfusion of Adobe ColdFusion 9 opt coldfusion9 needs to be manually stopped to completely remove FusionReactor Please shut the instance down and press Continue once you have ensured the server is stopped Figure 4 Stopping a Server Instance Figure 4 If there is a FusionReactor instance that is running the server container for this needs to be stopped in order to successfully remove the FusionReactor Instance Stop the server on which the FusionReactor instance is installed and press Continue once ensured the server is shut down or press Continue if you do not wish to stop the server As stated at the t
212. e listed below in a table Configuration Description Sent to targets by FRAM Log files are compressed by FRAM and sent to FusionAnalytics If FRAM is not available then the option is set to Sent by this instance see below Sent to targets by this instance Log files will be compressed and sent locally this mode does not require FRAM Sent by this instance uncompressed This sends each log file to FRAM or FusionAnalytics directly and uncompressed After rotation if this mode is active the original folder is not deleted No archives are created Disabled This disables FusionAnalytics Connector meaning no log files will be sent to FusionAnalytics After you have selected your option click Save FusionAnalytics Settings N b Since FRAM itself has no FusionAnalytics targets the targets to which logs are sent are always those of the local instance regardless of which Connector mode is active FusionAnalytics DataCollector Targets Add FusionAnalytics Targets Here you can configure your FusionAnalytics targets e Adding a New target e Editing Verifying and Deleting targets Adding a new target Click the Add New Target button and you will be presented with the Add FusionAnalytics Target dialog Host Application name DataCollector Username HTTPS Status Port S400 The fosivave aad pont rniger oy ite machine or which He FustiorAraiics Dala Collegio is mimmin coldfusion cfm IM TOOSE fre name of ite
213. e of a Thread Resources List All JVM Threads Refresh every pi O Stack Trace ALL Group Name DE system Reference Handler CO E system Finalizer CO ED system Signal Dispatcher DE system Attach Listener OO E system RMI TCP Acoept 0 Managing Threads Each thread listed on this page has two icons next to it They are Button Name Description e Stack Trace If you click this button then you will be taken to the Stack Trace page which lets you see exactly what is currently going on inside a thread 3 Kill Thread Clicking on this link will prompt you if you are sure OK the dialog to kill the thread WARNING All JVM threads are listed in this page including those pertaining to JVM system and J2EE container functions Killing a thread is a last resort to solving problems and we must caution you that while FusionReactor does allows you to stop any thread it is highly inadvisable to stop any threads in the system thread group or any threads integral to the running of your J2EE container Refreshing the Page At the top right of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh second lole Resource Settings The Resource Settings page lets you modify vari
214. e of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Contains a message of an event that occurred such as logging that has started Description The Notification Generator plugin allows you to create notifications whilst logged into FusionReactor The notification is only available in the instance in which it was created in For example if you created a notification inside an instance called cfusion cfmx10 then the notification would only be available inside that instance and no other instances i e default tomcat See the Notifications page for information on what a notification is Usage To create a notification navigate to FusionReactor gt Create Notification You will be presented with three fields these fields are described below Field Description Notification Title The notification title for example it might be The server is being shutdown Notification Type The type of notification Types include Information Warning or Error This allows you to communicate the intent of the notification to observers For example if you were restarting your server you would set the Notification Type to Information Notification Message The notification message for example it might be The server is being shutdown for maintenance Once you are satisfied click the button
215. e of time dependent fluctuations such as peak load and scheduled tasks Using the data on the Memory Usage graph we can see that the steady state for our test is around 40MB Allowing a 100MB overhead for scheduled tasks and peak time usage this would give an acceptable operational peak of 140MB with a remaining emergency margin of 60MB We might then set Crash Protection Memory Protection to 30 60MB margin 30 of the total memory The system should then be left in Notify mode for a period of time While running in this mode adjustments can be made to the protection value based on the notification email When you are satisfied that the value you have represents the upper margin for the system change the notify mode to Abort and Notify or Queue and Notify In the detailed example above we ve allowed a margin in the operational memory estimation to account for periodic rises in website usage and scheduled tasks Scheduled tasks often run at periods of low demand and are typically resource intensive Search indexing reporting and cleanup operations often run in this batch mode and often consume memory and CPU cycles These tasks also tend to run for long periods of time Once you have a picture of these tasks you can add them as CP Restrictions Crash Protection gt CP Restrictions Ensure that CP Settings gt CP Restrictions gt Restrictions is Enabled and the mode is Ignore Matching Requests CP will then ignore any
216. e running JDBC queries at the time of this log The total number of rows returned by JDBC queries at the time of this log The amount of data which was sent back to the client The number of milliseconds it took to deliver the first bit of data The number of milliseconds it took to deliver the complete content The number of milliseconds before the data stream was opened The number of milliseconds until the completed data stream was closed Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the Request Log will be emptied and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Also See Log Settings Importing and Graphing Data in Excel Request Capture Request Capture is the ability to store incoming requests and their associated responses to the file system When request capture is set to requests and responses you will end up with three files for each request A request file a body file and a response file The header XML file holds all information sent to server by the client The response XML file holds everything sent back besides body and the body file holds the actual returned content WARNING Turning on Request Content Capture will create multiple XML files for every request run ona server This may use very large quantities of disk space quickly Plea
217. e see Regular Expressions and Content Filters The text you input here will depend on the options you choose for the Hostname and Parameters fields Hostname By default FusionReactor will ignore the hostname and simply match based on the web path of a given request but you can also opt to include it If you enable Hostname checking then the request field should also include a hostname and look something like productionMachine batchStats cfm You should NOT include HTTP or HTTPS at the start of this string Parameters By default FusionReactor will ignore any parameters passed to a page however as with the Hostname you can also opt to include them in your restriction With parameter checking enabled the request field should include the necessary parameters For example batchStats cfm period YEAR Once again Regular Expressions can be useful here when specifying multiple possible parameter values or even specifying parameters where the order isn t fixed Request Exact Match Imyfolderimytile ctm eg myfile ctm folderimyfile ctn servercom myfile ctm imyfile param value Hostname lanore a Ifyou enable Host Checking then the above path as should include the host that a page is running on eg mymachine main cfm Parameters lanore s f Parameter Checking is enabled then you should B include the parameters of your page in the path above eg main cim mode batch Once you submit the form the page will be
218. e selection method Hold Ctrl to select multiple servers FusionReactor Extensions for ColdFusion 1 0 0 Server Selection Select from list CF Directory C ColdFusion9 Figure 2 Uninstall Custom Directory If you have a FusionReactor instance which isn t listed on this screen then you can select the Enter custom directory radio button Figure 2 and enter the directory path in manually Again once you have entered the path click the Next gt button G Setup FusionReactor Extensions for ColdFusion 1 0 1 Validation Validating ColdFusion server Validating Adobe ColdFusion 9 C ColdFusion9 Figure 3 Uninstall Progress The progress screen Figure 3 shows how long the uninstall process will take g Setup FusionReactor Extensions for ColdFusion 1 0 1 Finished The FusionReactor Extensions for ColdFusion have been uninstalled Please restart the following servers to complete uninstallation Adobe ColdFusion 9 C ColdFusion9 Extensions for ColdFusion Go Back to Server Selection Figure 4 Finished Screen Once the plugin has been successfully uninstalled from your FusionReactor instance s you will see the screen shown in figure 4 Here you will be reminded that your instances will need to be restarted before the plugin actually stops running If you wish in install or uninstall other FusionReactor instances then click the Go Back to Server Selection link Otherwise click the Finish
219. e task of Enterprise Monitor to monitor the other Operational servers Every operational server is added to the Enterprise Monitor s list of managed servers in the Enterprise Dashboard of FusionReactor For every server a script is configured that will be executed when the server becomes unavailable or available again The script is used to login to the remote computer and restart the operational server automatically if it becomes unavailable One of the operational servers is also configured to monitor the Enterprise Monitor and a script is configured to login to the Enterprise Monitor computer and restart the Enterprise Monitor instance should it become unavailable If this way the Enterprise Monitor watches over all of the operational servers and one of the operational Servers watches other the Enterprise Monitor Alternatively a second Enterprise monitor could be configured with the task of watching over the first Enterprise monitor if you do not want operational servers to perform monitoring tasks Summary FusionReactor Crash Protection Scripts are powerful functionality that can lead to an increase of server availability in local as well as distributed server environments You must however be aware of that a script that is executed by a Crash Protection rule is executed by the server instance that is monitoring the problem server and not by the problem server itself If this is not the same computer remote scripting has to be used to react to t
220. e to have monitored by FusionReactor Adobe ColdFusion 10 C ColdFusion10 efusion E ctusion Solr E Adobe ColdFusion 9 C ColdFusion9 admin C coldfusion E Apache Tomcat C FusionAnalytics Server default E Apache Tomcat C apache tomcat 0 27 default E Apache Tomcat C railos tomcat Install Instances Figure 4 Select Server Instances Figure 4 Select the server instances into which you wish to install FusionReactor by ticking the check box associated with each server instance Clicking Install Instances with one or more servers instances checked will install FusionReactor into each one of the selected instances More detailed information is available on the subject of installing FusionReactor Instances If you do not wish to install FusionReactor into any server instances at this point then either click the X button at the top right of the dialog box or click Install Instances with no check boxes selected This will take you back to the Instance Manager where you also have the opportunity to add FusionReactor instances by following the online guide Install FusionReactor Instance Initial Update After using the FusionReactor 4 0 x setup to perform an update from FusionReactor 3 x you will by default be taken to the FusionReactor Administration Manager FRAM and the Initial Update wizard will pop up 2 instances must be updated FusionReactor Administration Manager does not support ins
221. e total amount of physical memory available to this instance The amount of used memory The amount of allocated memory The amount of free memory within the allocated block Fixed Separator This is the amount of CPU time used by CF since the last CPU value was measured It is expressed as a percentage of the total CPU time across all CPU cores that was available during that period This is the amount of CPU time used as a whole all running applications by the server since the last CPU value was measured It is expressed as a percentage of the total CPU time across all CPU cores that was available during that period Fixed Separator The total number of requests that have been called since the last restart Total Finished Request Count 17 Q The total number of requests that have been completed since the last restart Request Count 18 R The number of requests that were running at the time of this log message Queued Request Count 19 S The number of requests that were queued at the time of this log message Finished Request Count 20 T The number of requests that were completed since the last log message Requests per second 21 U The number of requests per second that where being served at the time of this log message Average Request time ms 22 V The average request execution time at the time of this log message JDBC 23 W Fixed Separator Total JDBC Count 24 X The total number of J
222. e update Setup FusionReactor 4 0 6 FusionReactor already installed ED Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 3 5 6 is installed FusionReactor will be updated to include FusionReactor Administration Manager to manage your other instances of FusionReactor Configuration files will not be overwritten Setup has detected instances of FusionReactor with versions prior to version 4 These are not supported by FusionReactor 4 and will be updated during the initial update which is performed by the FusionReactor Administration Manager after the installation After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you must update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup Intergral Information Solutions Figure 2 Update the Current Version Figure 2 If there is already a version of FusionReactor 3 x on your computer that has been installed with the FusionReactor 3 x Setup you will see a screen similar to the one shown Carefully read the information and click Next to proceed with the update Click Cancel to exit the installation wizard 2 Setup FusionReactor 4 5 0 FusionReactor already installed ED Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 3 5 6 is installed FusionReact
223. e you are 100 sure before removing all archives as they will be deleted from your hard drive For a more detailed overview please go to the Connector Status page Requests Running Requests Request History Request Settings Request Log request lo Request Capture Running Requests Running Requests give you the ability to view and administer running requests on your server From the FusionReactor Administrator click Requests gt Running Requests and you will see the Running Requests screen At the top of the screen you will see the refresh bar You can use this to manually or automatically update the running requests listed below For each request shown you will see the time at which it began the IP address of the machine which created it the page which was actually requested the amount of time it has been running and the state of the memory when this request entered the system Above the running requests you will also see the state of the memory right now The request table has the following columns Name Started IP ID URL Parameters Time ms Memory KB Max Alloc Free Used Queued Requests due to Crash Protection Description The time at which the request was received The IP address of the caller The request ID and the name of the thread which is servicing the request The URL path and parameters passed to the request You can turn on or off the hostname in the URL by modifying the URL
224. eactor Enterprise Dashboard This document will guide the administrator through the new functionality illustrating how and when FusionReactor runs scripts and the best practices and caveats involved with automated scripting FusionReactor Enterprise Scripting in a Nutshell e What Are Enterprise Scripts How Do Configure an Enterprise Script When Does FusionReactor Run Enterprise Scripts How Does FusionReactor Run These Scripts Logging Scripts Operational Impacts of Scripting Using the Example Scripts FusionReactor Enterprise Scripting in a Nutshell What Are Enterprise Scripts How Do Configure an Enterprise Script When Does FusionReactor Run Enterprise Scripts How Does FusionReactor Run These Scripts Logging Scripts Operational Impacts of Scripting What Are Enterprise Scripts FusionReactor Enterprise Edition can trigger a script when a server becomes unresponsive and when it becomes responsive again This mechanism might allow you to pro actively attempt to restart a failed server or instance integrate FusionReactor into an existing monitoring environment or provide custom logging or reporting Any program which is runnable on your FusionReactor monitoring system may be used an Enterprise Script target On Unix and Unix based systems this includes everything you can start from a command line for instance e Binary programs e Shell scripts including Bash Ruby Python and Perl e Java programs when launched
225. eactor instances Tou must use the Instance Manager to install or update your Instances You may need to install a license beforehand Start configuring instances Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 setup FusionReactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue inthe FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances Tou must use the Instance Manager to install or update your Instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Finish Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11
226. eap Memory Requested Bytes Heap Memory Allowance Bytes Non Heap Memory Allowance Percentage Non Heap Memory Used Bytes Non Heap Memory Committed Bytes Non Heap Memory Requested Bytes Non Heap Memory Allowance Bytes Object Finalization Count Deleting the Log 6 F 7 G 8 H 9 I 10 J 11 K 12 L 13 M 14 N 15 O 16 P The amount of heap memory that can be used for memory management The amount of heap memory used The amount of memory that can be used for the heap by the Java Virtual Machine The amount of heap memory that the Java Virtual Machine initially requests from the operating system The amount of heap memory that can be used for the heap by the Java Virtual Machine The amount of non heap memory that can be used for memory management The amount of non heap memory used The amount of non heap memory that can be used for the heap by the Java Virtual Machine The amount of non heap memory that the Java Virtual Machine initially requests from the operating system The amount of non heap memory that can be used for memory management The number of objects waiting to have their finalize method called This is the method that is called before the object is destroyed Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the Memory Heap and Non Heap Log will be emptied
227. ears Here are some examples of notifications appearing in the table of contents default tomcat Lity This notification shows that there is one new unread ee ae notification requiring attention The number of old read notifications is not displayed in this case Click on the red text to view the complete list of notifications default tomeat Lily This notification shows there is one old read Paaa notification There are no new unread notifications in this case Origin Time Severity Title Message Actions Resource 16 Decl11 Waming Warning CPU Thread CPUW Thread Status Logging is enabled This Settings 15 35 34 584 Status Legging is Enabled functionality will consume disk resources quickly and should be tumed off in Resource Settings as soon as Mark Unread possible Request 16 Dec11 Warming Warning Request Capture Request Capture to Disk is enabled This functionality Settings 15 56 23 703 is Enabled will consume disk resources quickly and should be tumed off in Request Settings as soon as possible Mark Read Remove Figure 1 Notification table with one read and one unread notification both with non removable notifications Global Functions There are three global functions in the notifications page represented by three buttons Changed in 4 0 6 In FusionReactor 4 0 6 notifications are no longer automatically marked as read when you use the Notifications page You must now explicitly mark them as rea
228. ection i e define how you want Crash Protection to work The Settings page explains how to configure your Email Server so that Crash Protection can send you emails What should I expect to see from a Crash Protection email Email Title The email title contains the nature of the Crash Protection followed by a title to indicate that the email was sent from Crash Protection and finally the FusionReactor instance in which Crash Protection was fired in Below is a list of all the types of Crash Protection emails that you will ever see m Timeout Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Memory Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Request Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Email Body The email body gives you an insight into what was happening in your server when Crash Protection was fired This information will help you diagnose what happened In order the information in the email body includes A brief message explaining what triggered Crash Protection and why Information on the request that triggered Crash Protection such as request URL return status code and client IP address Any action that was taken on the request that triggered Crash Protection for example you may have configured Crash Protection to abort the request A brief description of all requests that were running on your server when Crash Protection was fired A Stack Tra
229. ed The difference in time between the current resource probe being triggered and the previous resource probe being triggered Current being the thread one in front of the previous in the log entries Log Settings CPU Graph CF Realtime and Request Stats realtimestats log Crash Protection Crash Protection Restrictions Crash Protection Settings Crash Protection Log crashprotection log Crash Protection Restrictions Crash Protection restrictions are designed to let you specify which pages you want to be monitored by the Crash Protection system or alternatively which pages you do not wish to be monitored To select which mode the Restrictions page works in change the Restrictions option on the Crash Protection Settings page The Crash Protection Restrictions page has two main areas At the top of the page there is a form for you to enter new restrictions and below this is a list of all existing restrictions for this feature New Crash Protection Restriction To enter a restriction you will need to fill the following fields Configuration Request Hostname Description Firstly select if you are creating an Exact Match or Regular Expression Exact Match Next enter the location of your page By default the request will be an exact match and should look something like batchStats cfm or batch dailyStats cfm beginning with a and without parameters The text you input here will depend on the options yo
230. ee eee eee eee eee eee eee eee ee eee ell If you want to change FRAM s configuration you will need to look at FRAM s reactor conf FusionReactor instance FRAM conf reactor conf to get the remoting server number Then place the following JSP in FusionReactor tomcat webapps ROOT and run it as http localhost 8087 enterprise toggle jsp Pee eee ee ee ee eee eee lt page import com intergral fusionreactor api O 5 gt oe lt FRAPI frapi FRAPI getInstance ConfigurationSurrogate configuration frapi getRunningConfiguration 1f configuration getStringValue remoting server 0 online equals true configuration setValue remoting server 0 online false else configuration setValue remoting server 0 online true frapi setRunningConfiguration configuration Q 5 gt Getting the FusionReactor Request ID for the current request It s possible using FRAPI to get the FusionReactor Request ID of the current running page or request This can be done by looping over the list of current tracked requests and matching the thread name of the request thread with the thread name on tracked of the FusionReactor request surrogate The following code example is written in cfscript Pee eee ee ee ee eee eee lt cfscript gt frapiClass createObject java com intergral fusionr eactor api FRAPI frapi frapiClass getInstance requestArray frapi getRunningRe
231. een shot is to give you an idea of what to expect in the ColdFusion User Interface For the purpose of this example our JOBC URL will read jdbc sqlserver 127 0 0 1 1433 DatabaseNa me testdb Wrapping your JDBC URL with FusionReactor 1 2 Oo O1 A Click Data and Services and then click on the Data Sources link Add a data source name This page walks you through locating your Macromedia DataDirect ColdFusion Drivers and wrapping them in the FusionReactor wrapper The page is broken down into 3 sections the first walks you through finding your JDBC URL for the data source the second walks you through wrapping it and the last one gives you an example Select other type driver Click on the Add button you will be presented with more text input fields In the field titled CF Data Source Name enter a name for your data source In the JDBC URL text field enclosure the JDBC URL in the FusionReactor wrapped and append the JDBCs Driver Class see below jdbc fusionreactor wrapper jdbc sqlserver 127 0 0 1 1433 DatabaseNam e testdb driver com microsoft sqlserver jdbc SQLServerDriver In the JDBC Driver Class field enter the name of the FusionReactor JDBC Driver Wrapper class com intergral fusionreactor jdbc Wrapper Enter FusionReactor in the Driver Name field Select an appropriate username and password values in their respective fields Click Submit ColdFusion will immediately t
232. eing logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Log Settings FusionReactor Plugins Logging This section contains information on logs archives and log settings Both are pages you can visit in FusionReactor by clicking Logging Both pages talk about the settings you can configure in those pages within FusionReactor Log Archive Log Settings Overview of FusionReactor Logs Log Archive This page is used to view information on the log archives that are generated by FusionReactor as well as perform some functionality on the logs Table Column Headings Name Description Archive File The name of the archive file stored on disk Size The size of the archive file measured in megabytes Created The date when the archive file was created Source The name of the server that the logs are based on Archive Comment If the text reads Don t Keep then that archive will be removed after a purge has taken place If it reads Keep then the archive will remain on the drive after a purge has taken place Simply click the text to change between the two Keep If the text reads Don t Keep the archived will be removed from disk after the purge if it reads Keep it will remain on disk after the purge has taken place To change it click on the text and will will c
233. elect statements can be open over a java sql Connection If a second or subsequent statement is opened while any result sets or statements are still active on the first connection the connection is transparently cloned by the driver and the statement is run over the new connection If the auto commit status of the connection has been changed from the default auto commit true to auto commit false that is all transactions will be explicitly committed or rolled back the cloned connection may have uncommitted dirty data present In this case it is not safe to start a new statement and the driver issues the exception above To alleviate this situation one or more the following measures may be taken 1 Switch to cursor mode by appending selectMethod cursor to your JDBC URL 2 Switch to auto commit mode 3 Ensure that only one statement is active on a connection by closing all statements and result sets prior to opening new ones 4 Ensure that all connection operations are synchronized against multiple access in a multi threaded environment Furthermore several operations may cause the driver to internally create a second statement and attempt to run iton the same connection e g updating certain types of result set producing the same exception References Microsoft KB article 313181 refers http support microsoft com kb 313181 Exception Catalog In almost all cases the FusionReactor JDBC Driver Wrapper will propagate
234. entry was written Time Formatted 2 B The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Notifications Memory Protection As an example we set up a load test to simulate a fairly constant load on the system You can see in the System Metrics page that the memory displayed in the Memory Usage graph is reasonably constant If we observe the system for an hour we would get an even better picture of how the memory is used For even longer periods we can set the Resource Settings gt Resource Sampling interval to 6 0000ms 1 minute with a long history size We can then view this data in the Resources gt Memory Graph page Using a longer time span allows us to get a picture of time dependent fluctuations such as peak load and scheduled tasks Using the data on the Memory Usage graph we can see that the steady state for our test is around 40MB Allowing a 100MB overhead for scheduled tasks and peak time usage this would give an acceptable operational peak of 140MB with a remaining emergency margin of 60MB We might then set Crash Protection Memory Protec
235. equest Protection CP Timeout Protection JDBC Slow Requests Please Activate License The average request time over the past 60 seconds has exceeded the Warn or Critical value configured on the Enterprise Settings page The used memory percentage exceeded the Warn or Critical value configured on the Enterprise Settings page The number of triggered crash protections for the request quantity limit exceeded the Warn or Critical value configured on the Enterprise Settings page The number of triggered crash protections for the request timeout limit exceeded the Warn or Critical value configured on the Enterprise Settings page The average JDBC request time over the past 60 seconds has exceeded the Warn or Critical value configured on the Enterprise Settings page You need to activate the license installed on the monitored server The number inside the red notification circle to the top right of the server icon represents the number of current Notifications messages from FusionReactor s various subsystems that alert you to conditions which require attention or are otherwise abnormal the server currently has To see the notifications in more detail simply click the number to go to the Notifications page See here for information on Notifications Group Information Pane The group information pane shows you how many servers are within this group as well as showing statistics for all grouped servers T
236. equest Protection using the Request Activity graph
237. equest started or finished The amount of memory which was allocated by the instance when this request started or finished The amount of free memory within the allocated block when this request started or finished If the URL has any parameters then they will appear here This is a HTTP return code such as 200 OK 404 Not found or 500 Internal Server Error For Started rows this column will be 200 This is the amount of actual CPU time which this request required For incomplete requests this column will be 0 If AMF decoding is enabled Requ est Settings page and there is AMF to decode then the method names will appear here The J2EE Session ld for this request The CF Id for this request The CFTOKEN for this request The number of JDBC queries run by this request at the time of this log The total amount of time spent running JDBC queries at the time of this log The total amount of time spent by the database running JDBC queries at the time of this log The total number of rows returned by JDBC queries at the time of this log Bytes Sent 45 AS The amount of data which was sent back to the client Time to First Byte ms 46 AT The number of milliseconds it took to deliver the first bit of data Time to Last Byte ms 47 AU The number of milliseconds it took to deliver the complete content Time to Stream Open ms 48 AV The number of milliseconds before the data stre
238. ere ee eee ere Ee eee ee eee ere S 127 PTO MOOOUIe erena e ett aie at epee Guten ass Mate toate wee Gated aah oe wee a Atanas 127 TVET ARS OUS SUS aU e nne r ee teac es oh kgs Mat E os Scenes en A eae ater da cat ce en eee Me rin eee aye hated dea te ee 127 TAA Len LAGHe ACID sai cea eh erie Coch at erg Saat acyl E E ads Miata thio eh end E A E ANE ROE Be 127 ikea ReGuest DetalI Page 5 Asnawagad tes Marie uta we en Sore peat wind WAN Nd We wae eel ere eee 127 TAS VS PAANY ZING Dala oraa Sea Ses ecde Sch sel Seta cl ar Pe eet aged hoe A cae Oh gp a Pee gr ae arta cae ec gh en ote Pe 128 y Ss Bea Fo yl eal Ko 6 72 r Gt ot en ee er er ee ee re eee eee ee ee eee eee ee eee eee ee 128 t1152 Imporing and Graphing Data im Excel 0 virscer deta ctwkte tardies Gade eee ok aaa eek ha 129 MVE MPS Ss aeons Sie ead ter ee ge Seen eS ee de uc A ar ete ory Sc eae eS rece tiara Sees aceasta os 129 AAG TF Y PCS OnUSeRACCOUME 5 5 decane acs cds hn E Sn Sate eh aretha tan deel aes So WIR Wala Sansa aha dat aerials Dea 130 Tete 2 Managing thie USCKACCOUMIS moderarea aN a eA AN uted Sed ae w wha aon ine dea Aaa een 131 AT AROOUIAN EXOICSSIONS dicate chee 2m Suv eeet earth E seat E Gn Maka ar nai pte ate em Make eres einen gente an tee la 132 eA Regular Expressions and Restrictions saisieudag vite teed corde oe cuted waa Bd ie eye E weedeat 132 1 1 17 2 Regular Expressions and Content Filters yinc25dat ed ed Gute a ha dutaa eke eee wate dete ee ees 134 Te
239. erver on the remote machine If the FusionReactor native library is not available or FusionReactor could not read this value this field will be 1 Last Seen Time The time measured in milliseconds from midnight on January 1st 1970 which the server was last successfully polled for Enterprise data If the server has not been observed as running during this session this field will be 1 Logging When FusionReactor fires a script an appropriate message is written to the Crash Protection log located in FusionReactor instance lt instance_name gt log crashproteciton 0 log This log is shared with other Crash Protection messages and not all fields are used by Enterprise scripting For the exceptional cases SCRIPTREADFAILED and SCRIPTEXCEPTION FusionReactor will log the message associated with the exception to the FusionReactor log Operational Impacts of Scripting There are a few points which you should bear in mind when configuring scripting System Restarts and Self Monitoring lf FusionReactor is configured to monitor itself i e it is monitoring the same instance in which it is configured scripting should not be used for operations In these circumstances we recommend transitioning your environment to a High Availability monitoring solution This entails installing a new J2EE server Tomcat for instance and installing FusionReactor into that This container will be used purely as a FusionReactor host and will be used to monito
240. ervices that are queued and waiting to run The number of Web Services requests that are currently running The number of Web Services that timed out whilst waiting to run If Memory Monitoring is enabled in ColdFusion then this value will be 1 if not it will be 0 To enable this check out How to enable FREC Profiling State 41 AO If Profiling is enabled in ColdFusion then this value will be 1 if not it will be 0 To enable this check out How to enable FREC More detailed information relating to these metrics can also be found within the Adobe ColdFusion documentation Also See Log Settings Installing FusionReactor Extensions for ColdFusion FREC Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC FREC Log Files Configure FusionReactor ColdFusion Plugin FREC The FusionReactor ColdFusion Plugin FREC plugin can be configured for each individual instance it has been installed into Navigate to the Active Plugins or All Plugins pages available in the Plugins menu item in the FusionReactor interface of the FusionReactor instance FREC has been installed into In the list of plugins locate the plugin named FusionReactor ColdFusion Plugin see Figure 1 FusionReactor ColdFusion Plugin 1 0 0 OSGi Bundle Intergral Information Solutions GmbH fr coldfusion plugin FR Plugin This plugin provides access to the Col
241. es a Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Figure 6 Configure Instances Screen Figure 6 After the update has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later You should now navigate to the Instance Manager located on FRAM to update your other instances of FusionReactor Launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Update Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 4 e Setup FusionReactor 4 5 0 k Fu i t Finally oo FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8037 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually dick on Instances gt Instance Manager while on the FusionReac
242. es Acca oh traced aepeneat E Sap cae a ee acted Da sakes in dae apa eee tele 92 He MINS Se chee rA E S E acs N tee x A oa ce sacs A ance a A ar hen ered ahha eed pe caer ea Pe 92 MTA PACU VS PUIN S cose rus odes a Sk scar haa pce payee og ees Sat ag iar gy Ss ace age De cal ws Gowen peeve ete 92 1 1 10 2 Open Services Gateway initiative OSGi 1 eee eens 93 TAS VOLS Salon LOG TEAClOIOG resres acted Som Mackie Gh are Peano Sok dee ten A ren agen avg eee hee Bo 95 Hee Mee WA cMOGIUNGE sect cc lace a day har Pte ase as ac Mace nce S Saree Sees Rca caer tet sept gee aoe AE N E agers Sees xmas th 95 MTA Vig LOS ACI cei cee das Pa Saat oh aS nae tegen essa ah aac gash tg eta eB cca E Gina np aes av in eter 96 kere OG SOUS mi E E cater E wi tine teres oon ce ache dat ane agter caso A a E E hat sha Ge a Ane aa 98 TTS OVENVICW or FUSIONFEACIOR LOGS gus tics oh arate pees dagen ie Char etn hg eas Sk cele nano Geese apa Ae tees Sh 100 DAs PAU LY NS aane ea ma et pp Pate eee She gk A cesta te ih E Rca ccd Se ter IE E E gah ag ata ies Mc eerie ae 104 alba CONNECIOF Olas 2cu 2e EE etude E Wed eee tat bob nd aaNet ek ea E Nee ROE Be 104 VAST2 2 FUSIONAMAIYIICS SELUNGS perorare huesarai ee Page a tone rete tt anata goer Sus A att nace Wa Rat aaa dea Ae ee 107 1 1 12 3 FusionAnalytics DataCollector Targets 0 25 00 eet de twktaadatne tad wate dea dela PAN ek a 107 ge le 220 ed ola lt lt 19 e aerogenes me aie Oo OL ane Rae RE a Renee Mie ae ce
243. est the driver and provide feedback if necessary When the FusionReactor driver is loaded it will report FusionReactor JDBC Driver loaded to the standard output stream usually logged to coldfusion out log or default out log within cfmx runtime logs Below are two screen shots figure 1 covers stages 1 to 4 and figure 2 covers stages 5 to 11 Java and JVM Add New Data Source Settings Summary DATA amp SERVICES Data Sources Data Source Name Driver select a valid driver type ColdFusion Collections Add Figure 1 CF Data Source Name JDBC URL Driver Class Driver Name User name Password 16 character limit Description Show Advanced Settings Submit Cancel Figure 2 After submitting this form ColdFusion will immediately test the connection and provide any necessary feedback in the ColdFusion Administrator If the FusionReactor JDBC Driver Wrapper detects any problems with the underlying wrapped driver or with its own options it will also provide feedback in the same way Any exceptions generated by the FusionReactor JDBC Driver Wrapper are prefixed with an exception ID number which may be used to look up more information When running as part of J2EE ColdFusion and if the FusionReactor JDBC Driver Wrapper detects a running FusionReactor application any queries run during the course of the request will be reported to FusionReactor for inclusion in the user interface where appropriate
244. estrictions or the URL Exclusions amp NOTE FusionReactor will only compress responses when the client request indicates that the client can support compression by sending a_ Accept Encoding gzip header MIME Type Restrictions Configuration Description MIME Type Restrictions This value defines how MIME Type Restrictions behave e Ignore requests that match the rules By default all requests will be compressed when compression is enabled unless the page s document mime type matches one of the rules defined on the MIME Type Restrictions page then it will NOT be compressed e Compress requests that match the rules no requests will be compressed unless the page s document mime type matches one of the rules defined on the MIME Type Restrictions page then it will be compressed MIME Type Restrictions MIME Type Restrictions are designed to let you specify which types of file you want to be compressed or alternatively which types you do NOT wish to be compressed leaving all other file types to be compressed To select which mode the Restrictions page works in change the Restrictions option on the Compression Settings p age The MIME Type Restrictions page has two main areas At the top of the page there is a form for you to enter new restrictions and below this is a list of all existing restrictions for this feature New MIME Type Restriction To enter a restriction you will need to fill the following fields Configur
245. et some examples of JDBC URLs for the Macromedia builtin drivers Here s the form with our previous connection wrapped with the FusionReactor JDBC Driver Wrapper Data amp Services gt Datasources gt Other fies wrapper CF Gata Source Mame frtastwrapper JOEL URL dbcctusionreactorarapperidbc macromediasalsene Chear Claas Jcom intergral fusionreactor jdbc Wrapper Driver Hama FusionReacor Onver Wrapper Urer Name fsa amand 18 chgrgedee lirit Peroiptican Show Advanced Satir Sukad Cancel The important things to note here are 1 Since we re using an other type driver we used the JDBC URL we copied out of the Settings Summary page Pt ee ee ee ee ee ee ee ee eee ee eee ee ee ee ee ee ee ee ee ee ee eee jdbc macromedia sqlserver int0006 1433 d atabaseName frtest SelectMethod direct sen dStringParametersAsUnicode false MaxPooled Statements 1000 Lie eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee eee eee ee ee ee ee ee eee eee Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy jdbc fusionreactor wrapper jdbc macromedia URL elt et 3 The username and password are unchanged Since we re using a builtin Macromedia driver there s no need to supply the driver argument to the FusionReactor JDBC URL CF will pre load this driver for us If we were using a third party driver we would simply add the classname to the JDBC URL like t
246. etup FusionReactor 4 5 0 FusionReactor Administration Manager ED The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 _ Configure ports manually fusion m A kre ctor Administration Manager Intergral Information Solutions ri a i once a e lt Back Next gt J __ Cancel Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the server ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 AAO Setup FusionReactor 4 5 0 FusionReactor Administration Manager Ports ED Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manager HTTP Port 8087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Control Port g004 Intergral Information Solutions ri l y i y if y Back Next gt Cancel Figure 5 Manually Configuring Po
247. f the Slow Request list change the History Size value on the Metrics Settings page The Slow Requests table has the following columns Name Description Started or Currently running requests show the time at which Finished the request was accepted Finished requests show the time at which the request completed IP or The final HTTP return code of the request is shown Ret Code IP for completed requests Both current and completed requests show the IP address of the caller If a completed request was killed or if it triggered Crash Protection then you will see a note here letting you know what happened ID The request ID and the name of the thread which is was servicing the request URL Parameters The URL path and parameters passed to the request You can turn on or off the hostname in the URL by modifying the URL Format value on the Request Settings page Time ms The number of milliseconds that the request has taken took to complete If available then you will also see the amount of actual CPU time that this request used below this Memory KB Sorting Requests A snapshot of the state of system memory at the time the request was started The following values are shown Used memory as a percentage of the total available to the JVM the actual used memory value in KB and the margin of free memory available before the JVM must extend its own heap if it has not already reached its limit You can change the order in which re
248. f you are sure OK the dialog box to delete the group Find What Replace With Replace G Fusion Reactor FusionReactor All Content Filter Restrictions Content Filter restrictions are designed to let you specify which pages you want run through the content filter system or alternatively which pages you do NOT wish to be filtered leaving all remaining pages to run through content filtering To select which mode the Restrictions page works in change the Restrictions option on the Co ntent Filter Settings page The Content Filter Restrictions page has two main areas At the top of the page there is a form for you to enter new restrictions and below this is a list of all existing restrictions for this feature New Content Filter Restriction To enter a restriction you will need to fill the following fields Configuration Description Request This is the page you want to exclude Firstly select if you are creating an Exact Match or Regular Expression Exact Match Next enter the location of your page By default the request will be an exact match and should look something like batchStats cfm or batch dailyStats cfm beginning with a and without parameters The text you input here will depend on the options you choose for the Hostname and Parameters fields Regular Expressions A good use of Regular Expressions here would be to restrict everything within a given folder For examples of Regular Expressions pleas
249. ffect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of INTERGRAL Information Solutions GmbH Third party trademarks trade names product names and Logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices legends symbols or Labels in the Software This EULA does not authorize you to use INTERGRAL s or its licensors names or any of their respective trademarks I accept the agreement Yes 1 No 2 Figure 2 License Agreement Figure 2 After starting the install you will be shown the license agreement Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions by entering 1 ie Terminal File Edit View Terminal Tabs Help varying or additional terms contained in any purchase order or Enter other written notification or document issued by you in relation to the Software licensed hereunder shall be of no effect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of INTERGRAL Information Solutions GmbH Third party trademarks trade names product names and Logos may be the trademarks or registered trademarks of thelr respective owners You may not remove or alter any trademark trade names product names Logo copyrigh
250. form to JDBC URL specification Please check the syntax The Java class specified with the driver option could not be found Check the class or jar is within the application classpath and the class name is fully qualified if required If you wish to extend the classpath use the cp driver option to specify further jars see Using the FusionReactor JDBC Wrapper for more information on the cp opti on The Driver Wrapper could not find a wrapped URL within the JDBC URL Check the syntax of the whole URL and make sure the original URL is specified within braces This thread has been marked for Soft Kill by FusionReactor The Driver Wrapper will not proceed with any further database activity The Driver Wrapper could not reliably decipher the supplied JDBC URL because it probably contained a syntax or typographical error Please check it carefully by hand FusionReactor 4 5 0 Upgrading to 4 5 0 from the Split Jar Procedure Background Because of the way J2EE classloaders are partitioned in some configurations FusionReactor s JDBC Wrapper was unable to wrap a driver because the classloader or JOBC Driver Manager forbade access to it The solution in all versions of FusionReactor prior to 4 5 0 is to apply Technote FRS 240 Standalone FR JDBC Wrapper Driver for MySQL Connector J etc commonly known as the split jar procedure This procedure split the FusionReactor system into two separate jars One jar fusi
251. g and tables Getting a longer perspective to allow resource planning trend discovery etc is outside the scope of FusionReactor but is well suited to the Fu sionAnalytics product FusionReactor using the FusionAnalytics Connector is able to ship logs automatically to a FusionAnalytics DataCollector where it can be easily stored in a database and made available for a comprehensive extensive set of analytics operations More information on FusionAnalytics is available here Connector Status FusionAnalytics Settings FusionAnalytics DataCollector Targets Locked Naming Applications and DataCollectors FRAM Target Connector Status This page contains a table listing all the archive files that are going to be transferred to FusionAnalytics There are also a few buttons on the page as well as a timeline which can be used to check the logs from a different date Table Column Headings Name Archive File Size Created Source Archive Comment Keep FusionAnalytics Connector Lifestyle FusionAnalytics Connector Status FusionAnalytics Connector Actions Table Buttons Button Name gt Show History Description This is the name of the archive This is the size in memory of the archive MB This displays the date and time the archive was created The name of the server that the logs are based on This is explanatory text created by the subsystem that created the archive If the text reads Don t Keep the
252. g tells FusionReactor how many times the heartbeat may fail on a monitored server instance before considering it to be DOWN FusionReactor will then report the server instance as CONN Connection lost on the Enterprise Dashboard and will run the self healing script for the instance if configured If you are receiving monitoring emails and log messages for instances known to be available try increasing this value A value of zero will cause the first missing heartbeat to signal the server instance is DOWN Description Graph Y Scale Memory Configuration Memory Status percent Average Request Time Configuration Average Request Time ms Graph Y Scale ms This number will be used as the maximum value on the request count graphs within the Enterprise Dashboard amp NOTE This value is only used for display purposes Entering a number here will NOT limit the number of requests a server will accept Description These two numbers Warn and Critical are used as threshold values to work out if a server should be put into a warning or critical mode when it is displayed in the Enterprise Dashboard If the used memory percentage exceeds the Warn value then it will appear in orange If it exceeds the Critical value then it will appear in red Description These two numbers Warn and Critical are used as threshold values to work out if a server should be put into a warning or critical mode when it is displ
253. g within a given folder For examples of Regular Expressions please see Regular Expressions and Content Filters The text you input here will depend on the options you choose for the Hostname and Parameters fields Hostname By default FusionReactor will ignore the hostname and simply match based on the web path of a given request but you can also opt to include it If you enable Hostname checking then the request field should also include a hostname and look something like productionMachine batchStats cfm You should NOT include HTTP or HTTPS at the start of this string Parameters By default FusionReactor will ignore any parameters passed to a page however as with the Hostname you can also opt to include them in your restriction With parameter checking enabled the request field should include the necessary parameters For example batchStats cfm period YEAR Once again Regular Expressions can be useful here when specifying multiple possible parameter values or even specifying parameters where the order isn t fixed Request Exact Match imyfolder mytfile ctm eg myfile ctm folderimyfile ctm server com myfile cim myfile param value Hostname lanore a If you enable Host Checking then the above path pape should include the host that a page is running on eg mymachine main ctm Parameters Ignore wt lf Parameter Checking is enabled then you should include the parameters of your page in the path a
254. ge loads the system by spawning itself to produce the required number of requests Each page then sleeps for the given number of seconds before completing It s used to exercise the Request Quantity Protection E g Calling load cfm load 5 amp timeout 10 would cause 4 requests to be spawned giving a total load of 5 and each one would sleep for 10 seconds e grow cfm takes a freemem parameter MB and allocates memory continually until that threshold is reached then sleep for 60 seconds E g Calling grow cfm freemem 10 would instruct the page to allocate memory until there was only 10 MB remaining then sleep for 60 seconds e system cfm simply outputs the version of Java in use This page is used as a hello world type request to see if the system will accept requests These pages are placed in a temporary folder in our test machine We use the following URL to access them http int0234 tmp ts1 pause cfm timeout 10 Exercising Timeout Protection In the FusionReactor Administrator access the CP Settings area by selecting it in the contents area You may need to open the Crash Protection section to see this Abat and oth Anor and Pacey Wears T Abotand Masiy Ta Dimbad Eadhra neque l mie a ai Once the crash protection settings page has loaded ensure the Restriction engine is disabled and timeout protection is set to 8 seconds with the abort
255. ges 5 to 11 Java and JVM Add New Data Source Settings Summary Data Source Name DATA amp SERVICES Driver Select a valid driver type Data Sources typ ColdFusion Collections Add Figure 1 CF Data Source Name JDBC URL Driver Class Driver Name User name Password 16 character limit Description Show Advanced Settings Submit Cancel Figure 2 After submitting this form ColdFusion will immediately test the connection and provide any necessary feedback in the ColdFusion Administrator If the FusionReactor JDBC Driver Wrapper detects any problems with the underlying wrapped driver or with its own options it will also provide feedback in the same way Any exceptions generated by the FusionReactor JDBC Driver Wrapper are prefixed with an exception ID number which may be used to look up more information When running as part of J2EE ColdFusion and if the FusionReactor JDBC Driver Wrapper detects a running FusionReactor application any queries run during the course of the request will be reported to FusionReactor for inclusion in the user interface where appropriate Examples The original data source was an MS SQL Server with the database database name testdb after being wrapped by the FusionReactor wrapped it is now called MyDataSource Original JDBC URL Slt ett jdbc macromedia sqlserver localhost 1433 databaseName testdb FusionReactor URL jdbc fusionreactor wrapper jdbc macromedi
256. get the specified FRAM target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful For more information please see the online documentation covering FRAM Target coldfusion cfimxs INTOO5F int00g Port 8400 The hosiname and port number of the machine on which fhe FusronAnalytics DataGollector is manning Application name coldfusion The name of the DCML Application installed in the FusionAnalytics DataCollector DataCollector 7ebra 4 The name of the DafaCollector installed in the above application How should i name my Appili Username Password The usemame and password of a user who has access fo fhe FusronAnalytics DataCollector application m Check this box if your FusionAnalytics Datattollecior uses HTTFS to secure communications Status Test Target save Target Settings Figure 9 Add a FusionAnalytics Target Figure 9 On this screen you have the opportunity to add a new FusionAnalytics DataCollector Target Click Save Target Settings to save the configured settings and go back to the FusionAnalytics Settings screen Figure 4 Click Back to return to the previous screen without saving the FusionAnalytics target Figure 4 Configuration Description Host This is the host running the FusionAnalytics Server Port This
257. gs Installing FusionReactor Extensions for ColdFusion FREC Number 1 A 2 B 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC FREC Log Files CF Hit Count Statistics hitcountstats log amp NOTE Description The date on which this log entry was written The time on which this log entry was written This is the millisecond time at which this request was made This is the version of the log file The time that the instance of FusionReactor that is running the plugin started The average number of open connections that are in the pool since it was last reset The average number of connections that are in the pool since it was last reset The name of the data source The max amount of connections that the pool may hold This value is 1 if not configured The amount of connections that are currently open The amount of connections that are currently in the pool It is important that you enable Monitoring and Profiling in ColdFusion to do this check out ColdFusion Settings Section in How to enable FREC guide Below is a table explaining each of the attributes in the log This log hitcountstats log stores hit count related information Below is a table explaining each of the attributes in the log The
258. gt Email Server gt Notification How Does FusionReactor Run These Scripts Launch Mechanism FusionReactor runs these scripts by spawning them using Java system commands The scripts will be run in the context of the user under which your J2EE ColdFusion server runs This user must have at least read execute access to these scripts Any files or other executables called by the script must also be accessible by this user The script will be run with the current working directory CWD of the J2EE application server Because of the variety of platforms available this may be unpredictable Any scripts you write should therefore not use the current directory notation usually a single dot to address files If you plan to access files within the script their paths should be specified completely Script Arguments FusionReactor supplies several command line arguments to the script These arguments may be used by the script to perform logging or restart operations Note that these arguments are supplied by FusionReactor and you do not need to enter them in the script field on the Managed Servers page The supplied arguments are in order Script Parameter Description UP or DOWN reflecting the instance status instance name as registered in the Manage Servers screen IP Address as returned from a DNS lookup of the machine name part of the URL used to monitor this instance Process ID If available the process ID of the J2EE application s
259. gure 4 You will now be asked if you want to configure the ports manually for FusionReactor Administration Manager FRAM Either enter y to configure them see Figure 5 onwards or enter n or just Enter on the keyboard see Figure 7 onwards Terminal File Edt View Jerminal Tabs Help I accept the agreement Yes 1 No 2 1 Where should FusionReactor be installed fopt tusionreactor The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM 1s being installed to manage individual instances of FuslonReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manaf Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port the port you use to view FusionReactor in a web browser It is important not to use ports that are already in use by other applications NOTE that the default port for FRAM is 8087 Terminal File Edit Miew Terminal Tabs Help 1 Where should FusionReactor be installed fopt tusionreactor The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM 1s being installed to manage individual instances of Fus
260. h instance or by clicking the hyperlink Select All to select all of the instances listed in the Instance Manager For a list of available actions see the below section Available Actions Available Actions For each server listed in the Instance Manager the following action is available Button Name Description ai r iT I For each server instance listed in the Instance Manager the following action is available Button Q Remove Server Remove Server Unavailable Name Install FusionReactor Instance If no instances within a server have FusionReactor installed you can remove it from the Instance Manager amp NOTE This option just removes it from FusionReactor It does not rem ove the server from the machine The server can be added again later using the scan form at the top of the page If there are at least one server instance with FusionReactor installed you cannot remove the server from the Instance Manager To do this firstly remove all of the FusionReactor instances installed on instances within this server Please read the Uninstall FusionReactor Instance Guide on how to remove a FusionReactor Instance Description Clicking this button will install FusionReactor into the selected server instance as well as creating a FusionReactor instance listed in the Instance Manager for easy access See the Install FusionReactor Instance document ation for more information on how to install a
261. hange to the other option Table Buttons Each row contains the following two buttons on the left hand side the effects of clicking them is described below Button Name Description amp Delete Archive Upon clicking this you will be asked if you remove the archive choosing yes will remove it from FusionReactor and the machine that it was stored on C Show History Clicking this will display additional information about the archive The page is split into two different sections one contains information about the archive file and the other contains information about how the file was created Below is two lists summarizing the key points from both sections of the page Top section e Archive Filename The absolute file path of the archive e Original File The name of the archive file e Timezone The timezone used by FusionReactor e FusionAnalytics Target Specif ies if the archive is to be used by FusionAnalytics if so the FusionAnalytics target is listed Bottom Section e Date Date the archive was created e Source System The software used to capture the files for the archive and to create tt e Subsystem The software component within the Source System FusionReactor used to perform an action e Message This is a brief description of the action that the Subsystem performed Rotate Logs To Rotate the logs click on the button that says Rotate Now This will generate a new archive based on the
262. he Longest JDBC page Memory Logs e Memory Heap and Non Heap Log memorysummary log e Types of Memory Logs CPU Thread Log cputhread log Request Activity Graph The Request Activity Graph is a graph of the request activity samples currently stored in memory by FusionReactor The time span of these samples will depend upon your history size and interval time see Resou rce Settings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data sampled every 5 seconds The graphs shows two independent values overlaid transparent the number of requests completed per second since the previous sample on the graph Blue and the number of requests running at the time that the sample is taken Gray This graph gives you insight into the server Request activity if the number of active requests stays high and constant then your server is under load It could be that the requests are taking too long to execute for the load being placed upon the server Placing your mouse pointer on a data point will show a tool tip with details about that sample Resources Request Activity Graph B Requests per second Completed Active Requests Load Ald EL AE 16 15 16 17 16 19 16 21 16 23 16 25 16 27 16 29 16 31 16 33 16 35 16 37 16 389 16 41 16 43 oo6 ebal AAI Yy senbay me ma Pa Ha o 13 38 45 16 14 01 16 44 48
263. he actual used memory value in KB and the margin of free memory available before the JVM must extend its own heap if it has not already reached its limit Sorting Requests You can change the order in which requests are displayed on this page by clicking on any of the column titles Clicking on a title for a second time will reverse the order on that column Below is a screen shot showing this Requests Request History Finished Ret Code IP Managing Requests Each request listed on this page has two icons next to it They are Button Name Request Detail Add to CP Restrictions Clear Description If you click this button then you will be taken to the Request Details page which gives you access to all information associated with a request eg Cookies JDBC Headers User Trace Markers and AMF data If you click this button then you will be taken to the Crash Protection Restrictions page which will be filled out for this request The Request History list can be cleared completely by clicking the Clear History button Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh Below is a screen shot showing this KB Max All
264. he installation Setup FusionReactor Extensions for ColdFusion Setup 1 0 1 Ri Select Destination Directory Where should FusionReactor Extensions for ColdFusion Setup be installed Select the folder where you would like FusionReactor Extensions for ColdFusion Setup to be installed then click Next Destination directory C Program Files FusionReactorColdFusionExtension Required disk space 3 0 MB Free disk space 50 211 MB Figure 2 Destination Directory Choice The second screen of the installer prompts you to select a destination directory for the Instance Installer A default directory will be preselected unless you modify the value if you wish Click the Next gt button to continue click the lt Back button to back to the previous screen or click Cancef to stop the installation g Setup FusionReactor Extensions for ColdFusion Setup 1 0 1 Select Start Menu Folder Where should Setup place shortcuts Select the Start Menu folder in which you would like Setup to create the shortcuts to the FusionReactor ColdFusion Extension tool then click Next FusionReactorColdFusionExtensions Accessories Administrative Tools Adobe Adobe Design Premium C53 Amazon Apache HTTP Server 2 0 54 G Data InternetSecurity 2011 Google Updater Figure 3 Select Start Menu Folder In the third screen you are prompted to select the Start Menu folder Just click Next gt if you want to use the default values
265. he memory CPU usage of the system and the running requests respectively They are potentially very useful in an unstable environment where restarts will cause FusionReactor to lose its in memory data All logging within FusionReactor is a computationally inexpensive operation the limiting factor being available disk space For detailed information about how the logging system works please read the Overview of FusionReactor Logs Memory Observation Memory should be your first observation If the blue chart of the Memory Usage bar is consistently near the top of the graph consider making more memory available to the J2EE ColdFusion process This can be altered within the ColdFusion Administrator in the section Server Settings gt Java and JVM gt Maximum JVM Heap Size If there is insufficient memory on the system to increase the JVM memory consider reducing the size of the Template Cache and Cached Queries A sawtooth pattern in the blue memory graph is normal This shows Java periodically garbage collecting objects When used memory begins to approach the allocated memory value you may see one or more sawtooth garbage collection patterns as Java attempts to reclaim memory before asking for more If insufficient memory is reclaimed you will see the white allocated memory bound increase as Java demands memory from the operating system If the blue portion steadily rises over the course of an hour this often indicates a memory leak Thes
266. he situation in an appropriate way Also note that you should not use scripting in a single instance self monitoring scenario because the script may not reliably start For more information on this topic please see Using FusionReactor Enterprise Scripting Metrics System Metrics Longest Requests Slow Requests Longest JDBC Metrics Settings System Metrics If Metrics are enabled see Metrics Settings then the Request Metrics page will display various statistics about this server These metrics are split into several sections Name Description Graphs Here you can see 6 graphs Request Load Request Time JDBC Load JDBC Request Time Memory Demand and CPU Click on any graph to maximize it and click on a maximized graph to return to the standard view You can also flip one or all of the graphs between the minute and hour view by selecting one of the options from the little clock menu at the top right corner of each graph You can click on the garbage can on the Memory Demand graph to request the system garbage collector Overview This section shows general statistics about this server Recent This section shows statistics about actions which have occurred on this server within the last 60 seconds The Recent Slow Pages link will show you all requests from the current request history which ran longer than the slow page threshold defined on the Metrics Settings page Crash Protection Page Aborts This section shows how
267. he task of watching over the first Enterprise monitor if you do not want operational servers to perform monitoring tasks Distributed Monitoring Running monitoring and restarting FusionReactor instances in a distributed environment requires remote connections between the different machines If a monitored server becomes unavailable this is monitored by a different machine on the network This machine then calls a script which has to connect to the remote machine and restart the remote server instance Depending on the operating system the participating machines use this can be done with SSH or some similar technology Simple Watchdog Two servers run on different machines that have a network connection One of the servers acts as the Enterprise Monitor watchdog for the other monitored server The watchdog server has the monitored server entered in it s list of managed servers in the Enterprise Dashboard of FusionReactor A script for the monitored server is configured that will be executed by the watchdog server if the monitored server becomes unavailable or available again The script is used to login to the remote computer and restart the server instance automatically after it becomes unavailable This approach can have the same drawbacks as mentioned in the Local Server Simple Watchdog section before Cross Monitoring All servers run on different machines that can reach each other over the network One instance server is created for th
268. here lt FusionReactor_Homes gt is the root directory of your FusionReactor installation The instance directory contains a list of directories named after your FusionReactor instances Navigate to the directory that is named after the instance that you are interested in and then navigate to the log directory The log directory contains a directory that is a series of numbers this is the epoch time that this directory will be subject to log rotation Navigate to this directory this is where the stacktrace log file can be found m gt Computer Local Disk C FusionReactor instance gt coldfusion cfmx9 HP Pdv6 Laptop log 20120515160000 Search 20120515160000 ev amp Open Burn New folder z M Name 5 Date modified Type Size _ reactor log lck 15 05 2012 16 26 LCK File 0 KB realtimestats log 15 05 2012 16 30 LOG File 54 KB _ realtimestats log lck 15 05 2012 16 26 LCK File 0 KB 8 request log 5 05 2012 16 02 LOG File 1 KB resource log 15 05 2012 16 30 LOG File 49 KB _ resource log lck 15 05 2012 16 26 LCK File 0 KB stacktrace log 15 05 2012 16 29 LOG File 981 KB _ stacktrace log Ick 15 05 2012 16 26 LCK File 0 KB stacktrace log Date modified 15 05 2012 16 29 Date created 15 05 2012 16 00 LOG File Size 980 KB Crash Protection and Monitoring with FusionReactor FusionReactor 4 encompasses several technologies designed to ease the burden of J2EE including ColdFusion su
269. hereunder shall be of no effect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of MTERGRAL Information Solutions GmbH Third party trademarks trade names product names and logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices legends symbols or labels in the Software This EULA does not authorize you to use IMTERGRAL s or its licensors names or any of their respective trademarks I accept the agreement Yes Lil Mo 2 Co wUsers qmourton Down loads gt 1 Where should FusionReactor be installed C Fus ionKReactor Figure 3 Installation Directory Selection Figure 3 Now you have to select where FusionReactor is to be installed By default pressing enter directly FusionReactor will be installed into C FusionReactor Es Administrator C Windows system32 cmd exe to the Software licensed hereunder shall be of no effect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of IMNTERGRAL Information Solutions GmbH Third party trademarks trade names product names and logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices legends symbols or l
270. hese statistics are Name Description Group Size Request Count Recent Slow Pages Average Request Time Average DB Time Average Memory This shows the number of servers within this group This shows you how many requests are running on all grouped servers along with the total number of requests which have been run This shows how many requests within the last 60 seconds have run longer than the Slow Page Threshold value This is the average request time for all grouped servers for the last 60 seconds and for the complete history size This is the average time spent on database operations for all grouped servers This is the average used and total allocated memory for all grouped servers Additionally you will see two graphs Average Used Memory and Request Count These graphs show the same information displayed in the statistics section but they are presented visually for ease of use Server Information Pane The server information pane shows you various statistics about your selected server Statistics which are listed with blue titles are links Click on one of these titles to be taken to a more detailed page within the instance of FusionReactor running on that server If a server is currently having problems then the appropriate statistic will be highlighted to indicate where the problem is The displayed statistics are Name FusionReactor Instance License Activation Status Crash Protection Page
271. his lel err jdbc fusionreactor wrapper jdbc mysql URL driver com somecompany Driver en ee ee ee ee eee eee eee eee ee ee eee eee eee eee eee ll When you submit this form ColdFusion will load our driver and make sure it can access the wrapped database G O ftestwrappei FusionReactor Driver Wrapper OK If all goes well you ll see an OK in the status column If something goes wrong you ll get plenty of information to help you fix it If FusionReactor can t access the wrapped driver it will give you a helpful message indicating where the problem lies If the wrapped driver has problems accessing the database FusionReactor will relay its message so you can fix the problem Here s an example of a problem we got the name of the FusionReactor driver class wrong You can see that ColdFusion couldn t load a suitable driver Here s an example showing an incorrect database username Simply click on the datasource name to go back to the form and fix the problems Once the datasource is ready you can begin using it to gather metrics Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy lt cfquery datasource frtest wrapper gt select from usr lt cfquery gt lt cfoutput gt Read getusers recordCount users lt cfoutput gt Gathering metrics from ColdFusion pages Once you ve set up the frtest wrapper datasource and verified it we can begin to explore the metric gathering abilities of
272. his value below 5 seconds Configuration This plugin can be configured in Enterprise Settings Configuration Description Heartbeat Metrics Fetch Interval seconds This interval tells FusionReactor how long to wait between each fetch of a monitored instance s metric data its heartbeat The heartbeat contains the data that is shown on the Enterprise Dashboard Heartbeat Timeout Seconds This timeout governs how long FusionReactor will wait for a heartbeat from a monitored server instance If no heartbeat is received within this time or a network connection failure occurs FusionReactor will count it as a heartbeat failure Heartbeat Failure Threshold This setting tells FusionReactor how many times the heartbeat may fail on a monitored server instance before considering it to be DOWN FusionReactor will then report the server instance as CONN on the Enterprise Dashboard and will run the self healing script for the instance if configured If you are receiving monitoring emails and log messages for instances known to be available try increasing this value A value of zero will cause the first missing heartbeat to signal the server instance is DOWN Log File heartbeat log The plugin generates a log file called heartbeat log this contains heartbeat information that could be very useful when diagnosing server problems Field Name Number Description Date Formatted 1 A The date the log was written Time Formatted 2
273. his will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup ME Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with the update ASO Setup FusionReactor 4 5 0 FusionReactor already installed E gt Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 3 5 6 is installed FusionReactor will be updated to include FusionReactor Administration Manager to manage your other instances of FusionReactor Configuration files will not be overwritten Setup has detected instances of FusionReactor with versions prior to version 4 These are not supported by FusionReactor 4 and will be updated during the initial update which is performed by the FusionReactor Administration Manager after the installation After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you must update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup Intergral Information Solutions a a C ranra lt Back Next gt Cancel Figure 2 Update the Current Version Figure 2 If there is already a version of FusionReactor 3 x on your computer that has been installed with the FusionReactor 3
274. hitp fint00d0 3400 fadciimportlapple mac click to copy to cdipboarnd i Active ready for E i i DataCallector Detail oto solaris imports p http int00d0 3 400 fadc importapple solaris click to copy to dipboard 4 7 DataCoallector Detail oto soar Imports Stop http int00d0 8400 adclimport apple wind click to copy to clipboard show Hide DataCollectors Pick the one you want to send logfiles to and enter it s name into the DataCollector box in the FusionReactor Connector Manager Wizard Username and Password These are the credentials used to log in automatically to the FusionAnalytics DataCollector The default username is admin and the password is that used to log in to the FusionAnalytics DataCollector Administrator HTTPS Check this box if your FusionAnalytics installation is configured to use HTTPS transports Test Target When the box is complete click Test Target to attempt a test connection If all is well OK appears If an error occurs Error appears Clicking on the Error opens a window in which diagnostic information can be used to locate the error When correct advance the wizard to the next stage by clicking Save Target Settings FRAM Target The FusionReactor Administration Manager FRAM installed as part of FusionReactor 4 0 x acts as a vital part in the transfer of logs from individual FusionReactor instances FRAM provides a completely isolated instance of FusionReactor which is just f
275. hread deadlock has occured Message Actions Thread 46 at DeadLock dl DeadLock java 38 waiting to lock 1431908901 a Mark Read java lang es is held by Thread 45 locked lt 243643589 a java lang Object e cep locked lt 1391150825 a java lang Object 52eb46e9 locked lt 1813969141 gt a java util concurrentlocks Reentran ARA nfairSync 6c1ef8f5 Remove Thread 45 at DeadLoc cae adLock java 38 waiting to lock lt 1391150825 a Mark Read java lang Object 52eb46e9 which is held is esata locked lt 1540334770 a java lan vile ac locked lt 491114805 gt a java lang Object 1d45d135 locked lt 1431908901 a java lang Object 55593225 locked 1386872214 Remove java util secs aa ReentrantLock NonfairSync 52a9fd96 The image shows what a typical deadlock notification looks like When a deadlock occurs the plugin generates a file called deadlock log and populates it with information which can be used to determine how the deadlock occurred Field Name Date Formatted Time Formatted Date Time ms Version Server Start up Time ms Log Type Thread Name Thread ID Thread State Number 1 A 2 B 3 C 4 D 5 E 6 F 7 G 8 H 9 I Description The date the log was written The time the log was written The number of seconds since epoch Version number of this log entry Start up time of the application server in milliseconds ms since epoch This
276. ia the FusionReactor interface E Configure FusionAnalytics Connector Figure 7 Update Status Figure 7 Once the update is complete you will have the choice to configure the FusionAnalytics Connector Tick the check box Configure FusionAnalytics Connector and click Next if you wish to configure log transfer to Fusio nAnalytics now Otherwise leave the check box unticked If you have selected to update multiple FusionReactor instances clicking Next will advance the wizard to install the next instance Go back to Figure 1 If only one instance was selected you have finished the Installation wizard as displayed by Figure 9 The update did not complete and some or all instances of FusionReactor remain at versions prior to 4 Although these instances will continue to run this is an unsupported configuration and these instances may not behave correctly They must be updated at the earliest opportunity by clicking the update link next to each instance Figure 8 Finished Updates Figure 8 If the following screen is displayed you have instances that are still on aversion prior to FusionReactor 4 Any instances running a version of FusionReactor lt 4 0 0 must be updated at the earliest opportunity as this is an unsupported configuration Please see the following page for more information on Unsupported Configurations Click Finish to return to the Instance Manager Finished Figure 9 FusionReactor updat
277. ically or once a day af a given time Rotate Every At 60 A numeric or time value used by the retention sirategy Penodic the penod between rotations in minutes Fixed the time fof the fom AACMM in the 24 hour system fo perfor rotation daily Locked F Check ihis box fo prevent users of individual instances changing FusronAnalytics Gonenctor and Log Rotation settings Get help on locked configurations save Log Settings Figure 3 Log Settings Figure 3 In this screen you are able to configure the Log rotation and Locked settings Click Save Log Settings to save the configured settings and move on to Figure 4 Click Back to return to the previous screen Figure 1 Log Rotation Settings Configuration Description Rotation Mode Select whether the logs should be rotated periodically or once a day at a specified time For more information see the online documentation for Log Settings Rotate Every At Lock Settings Configuration Locked A numeric or time value used by the above Rotation Mode Periodic the period between rotations in minutes Fixed the time of the form HH MM in the 24 hour system to perform rotation daily For more information see the online documentation for Log Settings Description Checking this box will prevent users of the FusionReactor Instance modifying vital FusionAnalytics Connector settings This means that these settings can only be configured from the Fu
278. ication Log Settings Filter Restrictions Change Password Change FR REST Password Se bout Logout 5 Request Detail e Stack Tracin e Request Detail Page Analyzing Data e FusionAnalytics e Importing and Graphing Data in Excel Users e Types Of User Account e Managing The User Accounts Regular Expressions e Regular Expressions and Restrictions e Regular Expressions and Content Filters FusionReactor API FRAPI e FRAPI Examples in ColdFusion FR Administration Manager FRAM e Instance Manager e Initial Server Scan Initial Update Add Server amp Scan System Install FusionReactor Instance Uninstall FusionReactor Instance Edit FusionReactor Instance Edit FusionAnalytics Connector e Update FusionReactor Instance e Corrupt Configurations e Unsupported Configurations e Setting Up FRAM with HTTPS Licensing Uploading your License File Activation Period License Activation Activating Multi Key License Files License Policy Getting Started FusionReactor is a professional server monitor designed for production environments and supporting a range of J2EE servers and Adobe servers ColdFusion 6 7 8 9 and 10 LiveCycle and Flex Data Services As a pro active monitor it increases server stability and performance by continuously examining applications servers and databases to identify highlight and address issues before they impact critical processes Once you have installed FusionRe
279. ies the maximum number of rows read by the J2EE application If the statement is not a DQL command select etc but rather is DML DDL RIGHTS insert update drop alter create revoke grant etc this value will be 0 Is Prepared Statement Value boolean Source Wrapper Specifies whether this statement was prepared in advance of its execution Is Row Limited Value boolean Source Wrapper Specifies whether the Row Limiter activated to stop the query Datasource Name Value String Source Wrapper Specifies the name of the datasource specified by the JDBC name parameter Blank if the name was not specified Statement Value SQL String Source Wrapper Specifies the statement which was run during this interaction Any whitespace formatting in the original statement is flattened to allow the statement to appear on one line If the interaction was a batch execution individual statements are delimited by and strings Stack Elements Value Comma separated list of Strings Source Wrapper If FusionReactor is configured to record stack traces this field contains a comma separated list of stack frames recorded when the query completed If the debug information is available this field can be used to locate the exact line in a script or Java program which caused the interaction URL Parameters Value String Source FusionReactor Contains the parameters which were present on the URL associated with the request
280. ilable to this instance The amount of memory which was used when this request started or finished The amount of memory which was allocated by the instance when this request started or finished The amount of free memory within the allocated block when this request started or finished If the URL has any parameters then they will appear here This is a HTTP return code such as 200 OK 404 Not found or 500 Internal Server Error For Started rows this column will be 200 This is the amount of actual CPU time which this request required For incomplete requests this column will be 0 AMF Request JSESSIONID CFID CFTOKEN JDBC Query Count JDBC Total Time ms JDBC Total Execution Time ms JDBC Total Rows Bytes Sent Time to First Byte ms Time to Last Byte ms Time to Stream Open ms Time to Stream Close ms Deleting the Request Log 22 V 23 W 24 X 25 Y 26 Z 27 AA 28 AB 29 AC 30 AD 31 AE 32 AF 33 AG 34 AH lf AMF decoding is enabled Requ est Settings and there is AMF to decode then the method names will appear here The J2EE Session ld for this request The CF Id for this request The CFTOKEN for this request The number of JDBC queries run by this request at the time of this log The total amount of time spent running JDBC queries at the time of this log The total amount of time spent by the databas
281. ill explain each attribute in the log as well as provide you with useful additional information Log Name Log Type Created By request log DATA SYSTEM resource log DATA SYSTEM idbc log DATA SYSTEM crashprotection log DATA SYSTEM stacktrace log DATA SYSTEM heartbeat log DATA PLUGIN deadlock log DATA PLUGIN dbpoolstats log DATA PLUGIN hitcountstats log DATA PLUGIN realtimestats log DATA PLUGIN memorysummary log DATA SYSTEM memory_name log DATA SYSTEM cputhread log DATA SYSTEM fr jrun event log reactor log notification log osgi log plugin fr amf decorator plugin l og plugin fr fa connector plugin lo g plugin fr heartbeat plugin log plugin fr logrotator plugin log plugin fr jrun plugin log plugin fr deadlock plugin log Key Word DATA STATUS SYSTEM PLUGIN Log File Format DATA STATUS STATUS STATUS STATUS STATUS STATUS STATUS STATUS STATUS PLUGIN SYSTEM SYSTEM SYSTEM PLUGIN PLUGIN PLUGIN PLUGIN PLUGIN PLUGIN Definition Data related to the server memory CPU response time etc Data related to a PLUGIN or the SYSTEM The information is brief and only covers the state of the PLUGIN or SYSTEM This is FusionReactor A plugin that is connected to FusionReactor All log spaces are space deliminated This allows you to easily import the files into spread sheets such as Microsoft excel and openoffice as well as databases this allows you to view the logs how
282. illisecond time at which this request was started or finished depending upon the Request Status Version 4 D Version number of this log entry Server Startup Time ms 5 E Startup time of the application server in milliseconds ms since epoch Request ID 6 F The FusionReactor Request ID Request Status 7 G The current state of the request This will tell you if a request has started finished was killed queued etc CP Reason 8 H The reason given by Crash Protection for the current action Thread ID 9 I The name of the thread responsible for responding to this request Client IP Address Request Method Request URL Execution Time ms Used Memory percentage Max Memory KB Used Memory KB Total Memory KB Free Memory KB Query String Return Status Code CPU Time ms 10 J 11 K 12 L 13 M 14 N 15 O 16 P 17 Q 18 R 19 S 20 T 21 U The IP address of the machine making the request This will usually be GET or POST This is the requested URL The format of this column will change depending on URL Format key which can be found on the Reques t Settings page The amount of milliseconds it took to complete the request For incomplete requests this column will be O The amount of memory expressed as a percentage which was used when this request started or finished The total amount of physical memory ava
283. ilter Restrictions page then it will be filtered e Ignore requests that match the rules By default all requests will be run through the Search and Replace filters If a request matches one of the rules defined on the Filter Restrictions page then it will not be filtered Plugins Active Plugins Open Services Gateway initiative OSGi Reactor Log reactor lo Active Plugins The table lists all plugins that are active and currently running on FusionReactor Name Description Plugin Information This contains a brief description of the plugin as well as the name of the jar file that is the plugin Version The version of the plugin as well as the name of the plugin Type Lists the bundle framework OSGi and the type of plugin Actions Logfile Contains information about when the plugin was started up and shutdown Configuration Clicking this allows you to configure the plugin Refer to the individual plugin definitions for details regarding Plugin configuration Also See Overview of FusionReactor Logs FusionReactor Plugins Open Services Gateway initiative OSGi Open Services Gateway initiative OSGi FusionReactor 4 0 introduces a new Open Services Gateway initiative OSGi based plugin architecture to enable new features to be seamlessly deployed This architecture allows us to deploy plugins coming in the form of bundles for deployment which can be remotely installed started stopped updated and uninstalled
284. imeout Protection box is removed We commit the change using the save Crash Protection Setings button as before The system is now primed for the test We use the grow cfm freemem 8 script to run the system to 700 MB total memory demand about 60 MB free memory a value which is well within the 76 MB margin which occurs at 686 MB aa 4 5 a q Curig eo 4s a MAME Sunen x WipinE bie integral comm pis tnam cim T a gpm per i me 1 Figure 2 Any requests which occur while the system is in this marginal situation will be rejected by the Memory Protection We can watch the Memory Graph to observe the memory load during the test When the grow cf m page reports it has exhausted memory to the required limit we run the system cfm script which is immediately rejected See Figure 2 Figure 3 below shows the memory graph during the test Shows the memory load during the test including the calm period before the test and the demand peak caused by grow cf m The sawtooth pattern before and after the test is a classic example of Java s periodic garbage collection in action The memory demand caused by grow cfm isn t actually released back to the system until a few seconds after the request completes again this is normal since Java only reclaims this memory when it s urgently required or in this case when system activity declines to a calm level By observing the Request History page Illustration 6 below we can see that FusionRe
285. imply start it with something like FusionReactor linux 4 5 0 sh c e Unix users with a GUI available and Windows users can proceed through the graphical install wizard After the wizard completes and assuming default answers the FusionReactor Administration Manager will be installed into opt fusionreactor c FusionReactor on Windows lt is not strictly necessary to start FRAM but if you wish to do so it can be started using the shell script opt f usionreactor tomcat bin framd start or by starting the FusionReactor AM service on Windows If you picked the default port the service will be available in your browser at http localhost 8087 Installing a Manual Instance FusionReactor Administration Manager includes a template instance which you can customize The three main steps are e Creating a new instance folder and customizing the configuration e Inserting the filter definition a small snippet of XML into your J2EE container s web xml or default w eb xm1 file e Copying the fusionreactor jar file to a location accessible by your J2EE container instance Creating a New Instance Folder For the purposes of illustration we will be installing a manual instance into Adobe s ColdFusion server located In opt coldfusion9 e Locate the supplied instance template folder This willbe in opt fusionreactor etc and is called i nstance template e Copy this template to opt fusionreactor instance and rename it to
286. information can be fed through to FusionAnalytics to produce detailed graphical representations of the data For further information on what FusionAnalytics is and how it can benefit you click here Field Name Date Formatted Time Formatted Date Time Milliseconds Get Log Version Date Time that FusionReactor stated Milliseconds Template Hit Count Delta Template Hit Count Gateway Hit Count Delta Gateway Hit Count Flash Hit Count Delta Flash Hit Count RCFC Hit Count Number 1 A 2 B 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K 12 L Description The date on which this log entry was written The time on which this log entry was written This is the millisecond time at which this request was started This is the version of the log file The time that the instance of FusionReactor that is running the plugin started The number of hits by a regular HTTP template request The difference between the current template hit count and the previous template hit count The number of hits by a gateway The difference between the current gateway hit count and the previous gateway hit count The number of hits by Flash Remoting The difference between the current flash hit count and the previous flash hit count The number of hits from HTTP calls to CFC functions Delta RCFC Hit Count WS Hit Count Delta WS Hit Count T
287. ing amp Analytics Connector Status Archiving and ad hoc rotation is not oe ee log g 19 S 1g mode ro Ea Menaul 30 to Log Settings to enable it z Archive File Size Created Source Archive FusionAnalytics Connector FusionAnalytics FusionAnalytics Comment Lifecycle Connector Status Connector Actions IC Was tx 20110805165057 zip 0 01MB Fri Aug 05 16 50 57 coldfusion cfmx9 int005a Log Archive on Source Injected via FR REST No Exception Transfer chedule 347af635 01c0 426a 12 0388 CEST 2011 bbfS 2a865ce6cd3f zip d by FRAM 1 http localhost 8400 adcfimport bapple faD ataCollector1 EC Was tx 20110805165052 zip 0 01MB Fri Aug 05 16 50 52 co chive on Source Injected via FR REST No Exception Transfer caaiba02 10 6488 CEST 2011 cheduler Keep P d by FRAM cb75 4661 9826 12785b38e78a zip 1 http 127 0 0 1 8400Aadcfimport bapple faDataCollector2 Total 0 02MB Archived Files 0 00MB Housekeeping 0 02MB Total Transfer All 2 archives Figure 1 FRAM s Connector Status Figure 1 FRAM will handle the log transfer and archiving of log files generated by individual FusionReactor instances Each FusionReactor Instance specifies the FusionAnalytics DataCollector Targets it wishes to send log files to FRAM will process the log files and send the compressed log files to the specified FusionAnalytics targets FRAM will also create a local archive of the log files generated by the instance and save this in its archive f
288. ing a number in seconds in this field you will enable Timeout Crash Protection from that point on any request which takes longer to execute than this time will trigger Crash Protection To turn this feature off again simply remove any value from the field You can specify what should occur when Timeout Crash Protection is triggered e Abort and Notify The request will be aborted and a notification email will be sent e Notify The request is left running and a warning email is sent Requests that are aborted by crash protection can also optionally be excluded from calculation of some metrics by setting the When Triggered actio n e Continue Tracking Request default the request will continue to be tracked and incorporated in subsequent calculations Stop Tracking Request the request will not be incorporated in subsequent calculations Requests which are not tracked won t be counted when calculating long running requests or average runtimes Any JDBC statements run by these requests will also be ignored by tracking The tracking policy set here will apply whether or not the request kill was successful Such requests will be labelled as Untracked in the user interface and will not cause a red cube condition on the Enterp rise Dashboard for users with applicable licenses By entering a number percentage in this field you will enable Memory Crash Protection From that point on if the amount of free memory on the ser
289. ings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data Sampled every 5 seconds The System CPU is presented in Gray and the Instance CPU is presented in blue Resources CPU Graph system CPU ij Instance CPU z w F G SR RS Ta RT aR RT a a 13 25 06 13 25 13 13 25 20 13 25 47 13 25 44 13 25 41 13 25 48 13 25 55 13 26 02 13 26 09 13 26 16 13 26 23 13 26 30 Time 13 29 05 13 26 34 13 50 30 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel List All Threads The List All Threads page shows all threads running within the JVM The threads table has the following columns Name Description Group This is how Threads are organized within the JVM Name This is the nam
290. inish to exit Setup Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 3 x on Linux Executables Executable System Architecture FusionReactor_linux_4 5 0 sh 32 bit FusionReactor_linux_4 5 0 x64 sh 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 3 x To start the update login as user root and run the appropriate executable as described in the above section Exe cutables Setup FusionReactor 4 5 0 Welcome to the FusionReactor Setup Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Next gt Cancel Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with th
291. instance to FRAM s Enterprise Dashboard PI ease note that the Enterprise Dashboard is only available in the Enterprise version of FusionReactor For more information see the Enterprise doc umentation re TEA Edit FusionAnalytics Connector F Update FusionReactor Instance Initial Server Scan Clicking this button will allow you to set up the selected instance to transfer logs to FusionAnalytics as well as modify the logging settings for this instance The Edit FusionAnalytics Connector docum entation covers setting up an instance for log transfer in more detail If the server instance has an older version of FusionReactor installed than that installed on the FusionReactor Administration Manager FRAM the instance can be easily updated to run the same FusionReactor version as FRAM directly from the Instance Manager See the online documentation Update FusionReactor Instance on how to update an outdated FusionReactor Instance After using the FusionReactor 4 0 x setup to perform a fresh install of FusionReactor you will oy default be taken to the FusionReactor Administration Manager FRAM and the Initial Server Scan wizard will pop up CA The FusionReactor Instance Manager can scan your environment and assist you by automatically detecting and configuring server instances to be monitored by Fusion Reactor We recommend running this server scan Would you like to run a server scan to detect installed servers o
292. integral ColdFusion Settings In the ColdFusion contents page click Server Monitoring gt Server Monitor You will be presented with a page with some graphs and 3 buttons at the top their names being START MONITORING START PROFILING and START MEMORY TRACKING Below is a screen shot that shows this r ro ra o P START MONITORING P START PROFILING P START MEMORY TRACKING Requests Per Second s All Data Using the reference pages for each FREC produced log file select one or more levels to turn on by clicking the button Once enabled the button will turn red FusionReactor Settings In a FusionReactor instance go to Plugins gt Active Plugins gt FusionReactor ColdFusion Plugin gt Configuration FusionReactor ColdFusion Plugin 1 0 0 Intergral Information Solutions GmbH fr coldfusion plugin This plugin provides access to the ColdFusion log files and Server Monitoring API Logfile Configuration fr coldfusion plugin 1 0 0 jar You will be presented with a few settings below is a table explaining them This section controls the configuration of the FusionReactor ColdFusion Plugin Create a copy of ColdFusion Log Entries Enabled Create a log of the ColdFusion Server Monitor Data Enabled Configuration Description Create a copy of ColdFusion Log Entries Available When enabled this the plugin will log ColdFusion Log in ColdFusion 7 8 9 and 10 entries and include them in the FusionReactor Cen
293. ionReactor Rotation Mode Description Centralized Archive and Rotation mode The current log directory will be in a time stamped folder beneath the path specified in Log Directory FusionReactor Instance your_instance_na me log time stamped folder In order to have logs zipped and archived automatically and to ship them using the FusionAnalytics Connector to a FusionAnalytics instance you must choose this option Traditional Per Log Rotation mode Logs are written directly to the path specified in Log Directory Changing this setting will cause new log entries to be written to the new location You can find FusionReactor s logs in the FusionRe actor Instance your_instance_name log dir ectory These are rotating files the newest having the suffix 0 log the next oldest 1 log etc Log Rotation Settings Configuration Description Rotation Mode Rotate Every At Rotate After Crash Log Archive Settings Configuration Retention Strategy Retention Value Periodic This will update the Log Archive every n minutes where ncan be specified in the text field below Fixed This will update the Log Archive daily using a time that can be specified in the text field below HH MM in the 24 hour system If you choose Periodic as the rotation mode then you input here how often you want to rotate the log in minutes If you choose Fixed then enter here at what time of the day you want the logs to be rotated HH MM in the 24
294. ionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter Y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FuslonReactor Administration Mana The FusionReactor Administration Manager uses a second port to Listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Figure 6 Manually Configuring Ports Figure 6 You must also configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Terminal File Edit View Jerminal Tabs Help for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FuslonReactor instances Password Figure 7
295. ionReactor 4 5 x you must first uninstall FusionReactor 2 x and then run the FusionReactor 4 5 x Setup again Please follow the guide on how to Uninstall FusionReactor 2 x on Windows Updating FusionReactor 1 0 on Windows Upgrade Not Possible FusionReactor 4 x x does not support upgrading from FusionReactor 1 x If you currently have FusionReactor 1 x installed it is not possible to upgrade to FusionReactor 4 x x To install FusionReactor 4 5 x you must first uninstall FusionReactor 1 x and then run the FusionReactor 4 5 x Setup again Console Installation on Windows Executables Executable System Architecture FusionReactor_windows 4 5 0 exe 32 bit FusionReactor_windows 4 5 0 x64 exe 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Es Administrator C Windows system32 cmd exe Microsoft Windows Version 6 1 7681 Copyright tc 2609 Microsoft Corporation All rights reserved Co Users qmourton cd Downloads Co wUsers qmourton Down loads Fus ionReactor_windows_4_ 6_6_x64 exe c Co wUsers qnourton Downloads This will install FusionReactor on your computer OK Co Enter Cancel c Figure 1 Start the Installation Figure 1 To run the FusionReactor 4 5 x installation in console mode you need to add the c switch For example FusionReactor_windows_4_5_0_x64 exe c fs Administrator C Windows system32 cmd exe fail
296. ionReactor administrator as if the application had called a setString method If the object does not override the default toString method the default behavior is to return the hash code of the object If this parameter is false the wrapper will use the format Pt eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy where xyz is the toString representation This makes it clear that the parameter is of type Object but is perhaps less easy to read in the log and the Administrator name Value string Default empty If specified the driver wrapper will report metrics to FusionReactor with the given name These names will be reported in the JDBC logfile or as an empty value if not set The name will also be reflected in the JDBC tab of the Request Details page allowing the user to differentiate queries which ran against more than one datasource This is useful when multiple databases are being used to aggregate results or when different drivers are being tested cp Value comma delimited list of strings pointing to jar files Default empty If specified the driver wrapper will extend the search for the specified driver class to the jars pointed to by the files of this property By default the driver wrapper relies on the J2EE engine to locate individual driver classes but if they are not visible to FusionReactor you may receive the exception message driver class classname could not be found and loaded In this c
297. ionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 3 x on Windows Executables Executable System Architecture FusionReactor_windows 4 5 0 exe 32 bit FusionReactor_ windows 4 5 0 x64 exe 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 3 x To start the update login as user Administrator and run the appropriate executable as described in the above section Executables fusion Welcome to the FusionReactor Setup Wizard s lt reactor This
298. istration Manager run under Select or manually enter the owner and group of this installation The user and group selected here must have write privileges on your JZEE container s configuration files If you unsure use the same user your JZEE container runs as or root User nobody M Group bin M Intergral Information Solutions EEE ann peel Cm a A lt Back C Next gt Cancel Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM AAO Setup FusionReactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation The following daemon will be installed framd on port 8087 w Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions lt Back Cancel Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin installing FusionReactor 4 5 x Back to revie
299. ixed message is applied prior to the abort action When used with the Timeout Protection FusionReactor uses strong thread manipulation techniques to make sure requests are stopped In all abort actions FusionReactor will process the terminating requests for statistical and tracking purposes Risks and Restrictions of Request Abort JVM Thread Aborts Because a request abort is a last ditch effort to prevent a marginal situation become critical FusionReactor attempts to use a rather strong method to halt processing In the vast majority of these cases the thread stops immediately and FusionReactor is able to recover the system However in a very small set of theoretical cases and we must emphasize we ve never seen this happen during innumerable test runs the JVM could be restarted Most J2EE service wrappers will automatically restart it in this case causing a minor outage which would in any case be less serious than a hung system which would otherwise occur In the light of our test results and the use of request abort in our own production environments we are still utterly convinced that the benefits of this strategy far outweigh the infinite simally small risk Native Bound Threads Due to restrictions in the JVM it is not always possible to immediately stop a thread If a thread is currently engaged in a blocking native operation i e performing I O in a JNI method sockets are a good example of this then the JVM
300. izard Y i Setup FusionReactor 45 0 Instances Detected Instances of Fusion Reactor are still installed Warning To completely remove FusionReactor all installed FusionReactor instances will be removed The corresponding target server will need to be stopped to delete the FusionReactor Instances successfully Setup will guide you through the uninstallation process and you will be prompted if any Instances are running before Setup will automatically try to restart them Instances that have not been correctly removed will remain installed on the corresponding target server and will cause issues Figure 2 Uninstall FusionReactor Instances Warning Figure 2 If you have other FusionReactor instances installed a warning message will be displayed to highlight the effects of removing FusionReactor Carefully read through this Once you have read it and you have understood it please click Next to uninstall all of the installed FusionReactor instances as well as FusionReactor Otherwise click Cancel to stop the uninstall Setup FusionReactor 450 FusionReactor Uninstall Please wait while FusionReactor is removed fram your computer Uninstalling FusionReactor 4 0 0 Cancel Figure 3 Uninstall Progress Bar Figure 3 Once you have clicked Next the FusionReactor uninstaller will begin to uninstall FusionReactor and all of the installed FusionReactor instances VY The instance coldfusion of Adobe ColdFusio
301. java com intergral fusionreactor api FRAPI frapi frapiClass getInstance lt cfscript gt lt table border 1 gt lt tr gt lt td title getBytes gt Bytes lt td gt lt td title getCfid gt Cfid lt td gt lt td title getCftoken gt Cftoken lt td gt lt td title getCpuUsage gt CPU lt td gt lt td title getCrashProtection gt CP lt td gt lt td title getCrashProtectionStatus gt CPStat lt td gt lt td title getExecutionTime gt ETime lt td gt lt td title getFusionRequestIid gt FRid lt td gt lt td title getIpAddress gt IP lt td gt lt td title getJavaSessionId gt JSid lt td gt lt td title getMethod gt Met lt td gt lt td title getOutputCompressorState gt OCS lt td gt lt td title getQueryString gt OS lt td gt lt td title getRequestId gt Rid lt td gt lt td title getRequestStatus gt RS lt td gt lt td title getRequestUrl gt RURL lt td gt lt td title getRuntime gt RTIME lt td gt lt td title getStartTimeMillis gt STM lt td gt lt td title getStatusCode gt SC lt td gt lt td title getThread gt Tid lt td gt lt td title getThreadCpuTime gt TCPU lt td gt lt td title getTimeClosed gt CLOSE lt td gt lt td title getTimeOfDeath gt Dead lt td gt lt td title getTimeOpened gt OPEN lt td gt lt td title get
302. l Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the sever ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 Setup FusionReactor 4 5 0 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manager HTTP Port s087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Control Port 3004 Intergral Information Solutions lt Back Next gt Cancel Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option Setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administra
303. l memory that the server has This shows the amount of CPU time used by this instance since the last CPU value was measured It is expressed as a percentage of the total CPU time across all CPU cores that was available during that period This shows the amount of time spent on database operations on this server This is the number of requests currently queued due to Crash Protection Description This shows how many requests within the last 60 seconds have run longer than the Slow Page Threshold value Additionally you will see seven graphs Req Activity Av Request Time Req Count JDBC Activity JDBC Time Memory and CPU These graphs show the same information displayed in the statistics section but they are presented visually for ease of use All graphs except Req Count have an arrow on the top right of them Clicking this will take you to a more detailed graph with additional functionality time lines within the instance of FusionReactor which is running on this server Configuring the Enterprise Dashboard Many elements within the Enterprise Dashboard can be modified In order to make changes please refer to the Enterprise Settings page From there you can e Specify whether you should receive an email when servers start up and shut down e Specify what the maximum values should be on graphs and bars e Specify the warning and critical state threshold values for various statistics Warn and Critical Manage Servers
304. le J To start the installation login as user Administrator and run the appropriate executable as described in the Setup above section Executables fusion Welcome to the FusionReactor Setup Wizard Jk reactor This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen Clicking the Next button will proceed with the installation and open the License Agreement as shown in Figure 2 Clicking Cancel will exit the Setup Please read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT ON OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO NOT INSTALL COPY DOWNLOAD OR OTHERWISE USE THE SOFTWARE THIS EULA SHALL APPLY ONLY TO THE SOFTWARE I accept th
305. le FusionReactor Adminisiration Manager sever which will handie log archiving and frenefer for this instance FusionAnalytics Targets Te TX http int008 8 400 fadceimport coldfusionS OK izebwra 4 2ero or more URLs which point to FustonAnalytics DataCollectors These will be the recipients of archives processed by the FusionAnalytics Connector We recommend all targets are tested before proceeding save Connector Settings Figure 11 Check a FusionAnalytics Target After clicking the test g button on a listed FusionAnalytics target will be tested The status of this test will be displayed in the Status column This can either be OK or Error Clicking the status will provide you with more information about the test such as why the test was unsuccessful coldfusion cimxs JNTOO5F Are you sure you want to delete target http int0061 6400 fadc import coldtusion9 zebra 4 Figure 12 Removing a FusionAnalytics Target Figure 12 By clicking the remove for a listed FusionAnalytics target you will see a confirmation screen Click Delete if you are sure you wish to delete the specified FusionAnalytics target Click Cancel to go back to the FusionAnalytics Settings sreen Figure 4 coldfusion cfmxs JNTO05F You are now ready to use FusionAnalytics with FusionReactor Please ensure your FusionAnalytics server is correctly configured These settings can be changed at any time via the Instance Manager or on the Fu
306. lease wait while Setup installs FusionReactor on your computer Extracting files lib zi Australia Sydney Intergral Information Solutions Figure 5 Installation Progress Figure 5 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup Setup FusionReactor 4 5 0 hasi _ You are now ready to start configuring eqctor instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Start configuring instances Figure 6 Configure Instances Screen Figure 6 After the update has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later You should now navigate to the Instance Manager located on FRAM to update your other instances of FusionReactor Launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Update Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 4 Setup FusionReactor 4 5 0 Finall
307. led FusionReactor Open the URL to go to FRAM Updating FusionReactor 4 0 x on Linux Executables Executable System Architecture FusionReactor_linux_4 5 0 sh 32 bit FusionReactor_linux_4 5 0 x64 sh 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 4 0 x To start the update login as user Administrator and run the appropriate executable as described in the above section Executables Setup FusionReactor 4 5 0 Welcome to the FusionReactor Setup Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Next gt Cancel Figure 1 Welcome Screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with the update x Setup FusionReactor 4 5 0 License Agreement Please read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before continuing with the installation INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGR
308. ler eg FusionReactorColdFusionExtensions gt Manage from the Windows Start Menu Once you have run it you will see the following page FusionReactor Extensions for ColdFusion 1 0 1 _ Select ColdFusion Servers What ColdFusion servers should the extensions be installed uninstalled into Choose an action to perform and select servers from the list or enter a server directory by changing the selection method Hold Ctrl to select multiple servers actioni neta O FusionReactor Extensions for ColdFusion 1 0 0 Figure 1 Uninstall List The main screen for the Instance Installer Figure 1 shows a list of the FusionReactor instances which it has found by scanning the system Any instances which have already had the FREC plugin installed into them will include text to indicate this eg FREC 1 0 0 currently installed In order to uninstall the FREC plugin from a FusionReactor instance select the instance from the list box and make sure that the Uninstall option is selected from the drop down list then click the Next gt button amp NOTE Hold down Ctrl and click on the instances you want to uninstall if you wish to uninstall multiple instances g Setup FusionReactor Extensions for ColdFusion 1 0 1 lt Select ColdFusion Servers What ColdFusion servers should the extensions be installed uninstalled into Choose an action to perform and select servers from the list or enter a server directory by changing th
309. lication To be able to do this you must add a FusionAnalytics target For a more detailed overview on FusionReactor s logging please go the Overview of FusionReactor Logs guide FusionAnalytics Connector The Analytics menu provides access to the current status between your instance of FusionReactor and FusionAnalytics FusionAnalytics is a ColdFusion Application and server analysis tool which integrates seamlessly with FusionReactor FusionAnalytics is all about Making IT Better and giving you the information and data to help you make better business decisions improve application performance and quality of your applications as well as measure exactly how your applications are performing on a continuous day to day basis The FusionAnalytics Connector Status page will show details such as the size of the archive the source of the archive which instance it came from any exceptions and what target the archive has been set You can also see all of the archive files which include the log files that are going to be transferred to FusionAnalytics You are able to rotate to have FRAM generate new archives based on the log information gathered since the previous archives was generated The archived files are sorted by date making finding archives easy You can also delete archives where you can either delete them individually or you can delete all of the stored archived in one go by clicking on Clear all Archives WARNING Make sur
310. lication developers to examine how well the application performs in production Enterprise Dashboard When a user clicks on a link on the Enterprise Dashboard for a monitored server they are transferred to that server instance of FusionReactor with the same level of user account that they are logged in as For example this means that a Manager on an instance that is monitoring another instance of FusionReactor will be granted Manager level access to the other instance of FusionReactor Managing The User Accounts FusionReactor has three user accounts Administrator Manager and Observer Enabling a User Account The user accounts are enabled by entering a password for the account amp NOTE The Administrator account is always enabled and must have a password assigned Note that when you enter a password and click on the Save Password button the account becomes active immediately Disabling a User Account The Manager and Observer accounts can be disabled using the Disable Manager and Disable Observer buttons the Change Password screen An account will be disabled immediately after clicking on the Disable button for the account To enable an account again you must enter a password for the account Enabling Accounts Setting Passwords During Installation During the installation process you must enter a password for the Administrator account but you can also enter a password for the Manager and Observer accounts If you do no
311. ll Complete Figure 5 When FusionReactor has finished uninstalling you will be presented with the Finish screen shown in Figure 6 Click on Finish to exit Uninstalling FusionReactor on Solaris To completely remove FusionReactor from your system you can either double click on the FusionReactor Uninstaller icon in the FusionReactor directory or you can run the uninstall command located in the FusionReactor directory in a shell window Both methods require you to be logged in as the root user The Uninstaller will completely remove the FusionReactor directory including all of the generated data please take care that you save any files you want to keep before running the uninstaller The uninstaller will also remove any installed FusionReactor instances during this process you will be asked to restart any running servers Please note that not stopping the servers means that FusionReactor and all of its components will not be completely removed This may cause issues on these servers Setup FusionReactor 4 FusionReactor Uninstall Are you sure you want to completely remove FusionReactor and all of ts components Click Next to continue or Cancel to exit Setup Figure 1 FusionReactor Uninstall Figure 1 Once the Uninstaller has been started read the text that asks you if you want to remove FusionReactor and all it s components Click Next to continue on with the uninstall or click Cancel to exit the uninstaller w
312. ll take you to the Modify Restriction page From this page you can change any of the information which is listed above 3 Delete Restriction Clicking on this icon will prompt you if you are sure you want to delete this restriction If you OK the dialog then the restriction will be removed from the Existing Restrictions list and the page will be refreshed Request Params Exclude From RegEx Statistics WED imyfolderimytile cim No Timeout No Tracked Crash Protection Settings Unattended Monitoring via Crash Protection is a way to protect your server from various types of load You can protect from excessive numbers of requests all being run at the same time You can protect from individual requests running for long periods of time and you can protect from requests running when the server is low on memory FusionReactor can notify you when any of these situations occur The Crash Protection Settings page lets you modify various elements relating to the different forms of Crash Protection How do I set up Unattended Monitoring with Crash Protection From the FusionReactor Administrator click CP Settings from the table of contents Crash Protection section and you will see the Crash Protection Settings screen From here you can activate any of the crash protection triggers and set up what action should be taken if they trigger Crash Protection Configuration Description Timeout Protection s Memory Protection By enter
313. logically related FusionReactor datasources For example all FusionReactor instances on a single machine could feed the same Application but must feed different DataCollectors You must not point two different FusionReactor instances at the same DataCollector as this will make the analytics invalid since there is no differentiating field for the different sources By using a different DataCollector FusionAnalytics is able to correctly partition the data by including a uniquely named field the name of the DataCollector If you accepted the default DataCollector name or you haven t customized your FusionAnalytics DataCollector Application yet the default DataCollector name will have been set up for you This is faDataCollector 1 If you re unsure of which names are already in use you can see which DataCollectors are installed as follows Log in to the FusionAnalytics DataCollector Administrator and on the Application Summary page click the Application Detail button for your application On the page which appears click Show Hide DataCollectors to reveal the names of the data collector in use In the figure below we ve defined four lin1 mac solaris and win 1 Data Input DataCollector Status Stop All DataCollectors Active ready for za DataCallector Detail Sto lint es p http int00d0 3400 adc import apple lind click to copy to clipboard Active ready for i DataCoallector Detail Sto e Imports Stop
314. lutions eal Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the server ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 Setup FusionReactor 4 5 0 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manager HTTP Port s087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Control Port 3004 Intergral Information Solutions Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option Setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administration Manager
315. ly rotated Additionally you can specify how much log data you want to save either by amount of disk space used or period of time covered or you can save all the logs if you have a big enough hard drive The main advantage to this logging method over the older Traditional method is that is is a lot easier to batch up a complete set of log files covering a distinct period of time which is very useful when trying to compare values between log files or when importing them into something like FusionAnalytics All of these log settings are available on the Log Settings page ECU iog iam Mibe log etc ete cic kay Monday An guest log i jibe iog E An Logs Tuesday etc etc micha f am Tequest log jibeg ete ele etrog Wednesday Traditional Per Log Rotation If you upgrade an older version of FusionReactor to 4 0 then this will be the default logging mechanism you will be using It is the logging mechanism used by all versions of FusionReactor prior to 4 0 The idea behind this logging mechanism is that for each log file in the system you can specify how big that file is allowed to become and how many log files you want to keep If you specify a log size of 10MB and say that you want a history of 5 log files then you will have a maximum of 50MB of logs available to you at any time With Traditional Per Log Rotation all the log files are stored in the Log Directory specified on the Log Settings page For each t
316. lytics The best and most efficient way to analyze FusionReactor data is to use FusionAnalytics FusionAnalytics is a ColdFusion Application and server analysis tool which integrates seamlessly with FusionReactor FusionAnalytics is all about Making IT Better and giving you the information and data to help you make better business decisions improve application performance and quality of your applications as well as measure exactly how your applications are performing on a continuous day to day basis For more information about analyzing FusionReactor data using FusionAnalytics see the Analytics menu item providing the current status between your instance of FusionReactor and FusionAnalytics Importing and Graphing Data in Excel Most FusionReactor Log files can be easily imported into Excel and other tools that can import delimited files in order to analyze them or create graphs There are 4 major log files that you can import request log resource log e jdbc log e crashprotection log If you are using the FusionReactor Extensions for ColdFusion FREC plugin then you will also have access to the following log files e dbpoolstats log e hitcountstats log plugin fr logrotator plugin log e realtimestats log amp NOTE All of the log file information can be imported and analyzed directly into FusionAnalytics How Do I import a FusionReactor Log File into Excel 1 Make a copy of the log file you want to i
317. mber of triggered crash protections for a given type request quantity request timeout or low memory exceeds the Warn value then it will appear in orange If it exceeds the Critical value then it will appear in red Description Slow Page Status These two numbers Warn and Critical are used as threshold values to work out if a server should be put into a warning or critical mode when it is displayed in the Enterprise Dashboard If the number of requests running longer than the slow page threshold within the last 60 seconds exceeds then the Warn value will appear in orange If it exceeds the Critical value then it will appear in red You can change the slow page threshold from the Metrics Setting page Using Monitored Server Scripts FusionReactor Enterprise Scripting enhances FusionReactor s Enterprise Monitoring to trigger configurable self healing scripts when a server s responsiveness status changes This feature can be used to perform any task which can be launched from a platform script Examples might include e Interacting with SNMP or enterprise monitoring reporting systems e Performing automated restarts of affected instances e Sending custom email messages e Writing custom log messages Since FusionReactor Enterprise Scripting is able to launch any platform executable shell script executable binary etc it may be tailored to virtually any environment amp NOTE To use this functionality AT LEAST two different inst
318. me at which this request was started or finished depending upon the Request Status Version number of this log entry Startup time of the application server in milliseconds ms since epoch The FusionReactor Request ID The current state of the request This will tell you if a request has started finished was killed queued etc The reason given by Crash Protection for the current action The name of the thread responsible for responding to this request The IP address of the machine making the request This will usually be GET or POST This is the requested URL The format of this column will change depending on URL Format key which can be found on the Reques t Settings page The amount of milliseconds it took to complete the request For incomplete requests this column will be O The amount of memory expressed as a percentage which was used when this request Started or finished The total amount of physical memory available to this instance Used Memory KB Total Memory KB Free Memory KB Query String Return Status Code CPU Time ms AMF Request JSESSIONID CFID CFTOKEN JDBC Query Count JDBC Total Time ms JDBC Total Execution Time ms JDBC Total Rows 31 AE 32 AF 33 AG 34 AH 35 AI 36 Au 37 AK 38 AL 39 AM 40 AN 41 AO 42 AP 43 AQ 44 AR The amount of memory which was used when this r
319. mn will display the results gt Delete Target Deletes the target from FusionReactor Seeing your data in FusionAnalytics When you connect FusionReactor to FusionAnalytics the data will not instantly appear You will need wait for a transfer to occur If you want to force a transfer in FusionReactor go to Analytics Connector Status Click Tr ansfer to send the logs to FusionAnalytics You will need to wait for each log to be processed by FADC before the data will be available in the Client Locked The FRAM Administrator has the ability to lock various aspect of the individual instance s configuration This feature was introduced to allow FusionAnalytics settings to be controlled by the FRAM Administrator rather than the instance administrator and provides an additional level of access control With a locked configuration an instance administrator or manager can t change the FusionAnalytics Connector targets and related settings Placing the Lock The lock can only be placed in the Instance Manager of FRAM Connect to FRAM and open the Instance Manager Click the Edit FusionAnalytics Connector button to open the FusionAnalytics Connector Manager wizard Hit Next to advance to the Log Settings page At the bottom of this page you ll see a Lock Settings section Check Locked to place the lock on the configuration Make any other changes you need and advance to the second page Again make any changes and click Sav
320. monitored server to the list of managed servers in the Enterprise Dashboard of FusionReactor A script for the monitored server is configured that will be executed by the watchdog server if the monitored server is unavailable or becomes available again The script is used to restart the monitored server automatically after it became unavailable However if the watchdog server itself becomes unavailable the server is not longer monitored and can not be restarted automatically any more To get around this the monitored server could also monitor the watchdog server which is described in the next section Cross Monitoring One instance server is created for the task of Enterprise Monitor to monitor the other Operational servers Every operational server is added to the Enterprise Monitor s list of managed servers in the Enterprise Dashboard of FusionReactor For every server a script is configured that will be executed when the server becomes unavailable or available again The script is used to restart the operational server automatically if it becomes unavailable One of the operational servers is also configured to monitor the Enterprise Monitor and a script is configured to restart the Enterprise Monitor should it become unavailable If this way the Enterprise Monitor watches over all of the operational servers and one of the operational Servers watches other the Enterprise Monitor Alternatively a second Enterprise monitor could be configured with t
321. mport It s better to work on copies than the live log files otherwise you may stop them from being written to 2 Start Excel and from the File menu select Open and then the log file You may have to select Files of type All files to see the log files in the file picker The Text Import Wizard dialog will appear For the Original data type choose Delimited and then press Next gt at the bottom of the dialog Select Space as the Delimiter and then press Finish at the bottom of the dialog The Spreadsheet should now be filled with data in separate columns Click on top of one or more columns that you wish to graph to highlight the entire column and then click on the small graph icon Chart Wizard in the toolbar or from the menu Insert gt Chart Note you can find out what data the Excel columns contain by using the field number letter in the descriptions of the log files above 8 Choose the graph style e g line graph scatter graph or bar graph and then click finish NO Of W amp NOTE You can find out what data is stored in the columns using the descriptions of the log files above or by looking into the request headers txt resource headers txt jdbc headers txt or crashprotection headers txt files stored in the folder with the log files Users Types Of User Account Managing The User Accounts Types Of User Account FusionReactor supports three different types or levels of user account e
322. n 3 Add file Access Control Entries to both FusionReactor and ColdFusion substitute your J2EE server directories setfacl R m g fusion rwx opt coldfusion9 opt fusionreactor 4 Add default file Access Control Entries to the same directories This allows either system to create new directories and have the entries propagate setfacl R m d g fusion rwx opt coldfusion9 opt fusionreactor Windows Requires Windows Server 2003 Service Pack 2 Windows Vista Windows Server 2008 or Windows 7 On Windows FusionReactor is installed as the Local System user Running as another user is currently unsupported In our test environment we are running ColdFusion our J2EE server as user coldfusion The following commands should be run in a cmd window as a user who has Administrator rights to the system If you cannot log in as an Administrator a command window may be opened from a normal cmd session using the following command runas user Administrator cmd FusionReactor and your J2EE server should be stopped 1 Add the group fusion net localgroup add fusion 2 Add ColdFusion s substitute your J2EE server s runtime user to the group net localgroup fusion add coldfusion 3 Add a default file Access Control Entry to the ColdFusion substitute your J2EE server directory this will propagate down automatically L Caclhs or Colorusi10on grant Tusion OF CL F 4 Add a default file Access Control En
323. n even if you only require a notification and no explicit survival action The Memory Protection rule is evaluated before the Request Quantity rule If a situation exists in which both rules should logically fire the Memory Protection rule often the more dangerous of marginal situations is given preference to deal with the situation Abort Strategies Explained Apart from the Notify action which sends a detailed email during Crash Protection interventions there are two other major strategies for dealing with requests Abort and Queue Queue This strategy attempts to alleviate the marginal situation by temporarily pausing incoming requests until the condition which caused the rule to fire no longer exists The length of the queue can be specified after which requests will be terminated regardless of the survival strategy There is no limit on the size of the queue so if a large quantity of requests are present they will consume tracking resources inside FusionReactor albeit temporarily This strategy is therefore best used on systems with sufficient memory or on systems where the volume of requests is Known and not expected to become prohibitive Abort This strategy aborts requests When used with the Memory or Request Quantity rules it is best imagined as a reject rather than an abort The request is summarily rejected and not allowed to proceed inside the J2EE engine The abort strategy redirect to URL or display of f
324. n 9 opt coldfusion9 needs to be manually stopped to completely remove FusionReactor Please shut the instance down and press Continue once you have ensured the server is stopped Figure 4 Stopping a Server Instance Figure 4 If there is a FusionReactor instance that is running the server container for this needs to be stopped in order to successfully remove the FusionReactor Instance Stop the server on which the FusionReactor instance is installed and press Continue once ensured the server is shut down or press Continue if you do not wish to stop the server As stated at the top of this page not stopping the server container means that FusionReactor and all of its components will not be completely removed from the target server This may cause issues on the corresponding server Setup FusionReactor 450 FusionReactor Uninstall FusionReactor was successfully removed fram your computer Figure 5 FusionReactor Uninstall Complete Figure 5 When FusionReactor has finished uninstalling you will be presented with the Finish screen shown in Figure 6 Click on Finish to exit Where are FusionReactor 4 s Manual Installer Packages The manual install packages Linux RPM Windows ZIP Generic Manual Installer and Generic Update have been discontinued Because of the changes in structure with FusionReactor 4 including an extended folder structure for instances and more comprehensive configuration it s
325. n Manager FRAM must be installed as a user who has a real shell and can log in to the system By default the installer will pick nobody root for this purpose but can t presently check that this user can actually log in If your nobody user does not have a shell please change their shell to bin sh or your preferred shell or select another user setup Fusionkeactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation ETO hel Ohhh LOT sn OL init i Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Setup Fusionkeactor 4 5 0 Installing Please waitwhile Setup installs FusionReactor on your computer ETO hel Ohhh DOT sith UL Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup rc Setup Fusionkeactor 4 5 0 You are now ready to start configuring instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionR
326. n logs as well as real time stats The real time stats consist of 40 new metrics including Active Sessions of current sessions App Scope Size hit counts breakdown of hits per request type and DB Pool Stats detailed metrics for DSN s which increase the amount of information that FusionReactor generates when dealing specifically with ColdFusion servers This information is delivered to you via log files which can be used to create detailed analysis of your server by using software such as FusionAnalytics In order to use this plugin you will have to first install the FusionReactor ColdFusion Extensions Instance Installer Once that is installed you need to run it and it will allow you to install the FREC plugin into any available FusionReactor Instances The following log files are captured by FREC dbpoolstats log e hitcountstats log e realtimestats log e plugin fr logrotator plugin log Downloading FREC You can download FREC for free by visiting the plugins page on the FusionReactor website Clicking this link will take you there Installing FREC In order to install FREC you first need to download it Make sure to download the correct version for your operating system Once you ve downloaded the installer run it and follow the installation page for a more detailed guide on the installation When you have installed FREC you will want to install it into an instance of FusionReactor You will need to run the Manage Instances ap
327. n that archive will be removed after a purge has taken place If it reads Keep then the archive will remain on the drive after a purge has taken place Simply click the text to change between the two Lists where the logs are generated as well as what they were processed by This will show the status of the connection No Exception means everything is OK Clicking this will transfer the archive from FusionReactor to FusionAnalytics Description Upon clicking this you will be asked if you want to remove the archive choosing yes will remove it from FusionReactor and the machine that it was stored on Delete Archive Clicking this will display additional information about the archive The page is split into two different sections one contains information about the archive file and the other contains information about how the file was created Below is two lists summarizing the key points from both sections of the page Top section e Archive Filename The absolute file path of the archive e Original File The name of the archive file e Timezone The timezone used by FusionReactor e FusionAnalytics Target Specif ies if the archive is to be used by FusionAnalytics if so the FusionAnalytics target is listed Bottom Section e Date Date the archive was created e Source System The software used to capture the files for the archive and to create tt e Subsystem The software component within the Source
328. n the following filesystems CA Figure 1 Server Scan Information Figure 1 Clicking Run Scan will search your system for servers to monitor The initial server scan will only search 2 sub directories deep from the displayed filesystem root If you click Skip the scan will not run and no servers will be discovered by the FusionReactor Administration Manager Clicking Skip will take you back to the Instance Manager You can manually run the server scan with provided parameters from the Instance Manager Follow the online guide Add Server amp Scan System on how to do this Scanning MB Figure 2 Scanning Figure 2 The scan is searching the local filesystem for servers that can be monitored by FusionReactor This scan may take several minutes to complete depending on the size of your hard drive and the number of files stored on it CA FusionReactor Instance Manager has completed the scan and has detected 24 servers containing instance s which may be monitored by FusionReactor In the next step you may select which instances should be monitored by FusionReactor Next Figure 3 Server Scan Finished Figure 3 Once the scan has completed all detected servers that can be monitored by FusionReactor will be displayed Click Next to see a complete list of the servers which were discovered Ci FusionReactor Instance Manager has detected the following instances Please select the instances which you would lik
329. n the paragraph at the top of the page gt Delete Pattern Clicking on this icon will prompt you if you are sure you want to delete this filter pattern If you OK the dialog then the filter pattern will be removed from the Existing JDBC Java Stack Trace Filters list and the page will be refreshed 4 3 cfm BO inp G ic JDBC Log jdbc log The JDBC Logs which are a set of rotating files which you can configure from the JDBC Settings page are simple space separated files so they can be easily imported into database or spreadsheet applications The log is called jdbc log the bottom part of the page tells you where you can locate this file on your hard drive The log file is formatted as follows Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Date Time Milliseconds 3 C This is the millisecond time at which this request was started or finished depending upon the Request Status Version 4 D Version number of this log entry Server Startup Time ms 5 E Startup time of the application server in milliseconds ms since epoch Request ID 6 F The FusionReactor Request ID Thread ID 7 G The name of the thread responsible for responding to this request Client IP Address 8 H The IP address of the person making the request Request Method 9 I Specifies the HTTP method used
330. nces You must use the Instance Manager to install or update your instances You may need to install a license beforehand Start configuring instances Figure 10 Configure Instances Screen Figure 10 After the update has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later You should now navigate to the Instance Manager located on FRAM to update your other instances of FusionReactor Launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Update Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 Setup FusionReactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to installa license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Figure 11 Final Screen If you did not choo
331. nd email once in a given period by default one minute All three survival strategies are available for each of the three rules except Timeout Protection which can t use the Queue rule since the requests it monitors can t be queued once they ve started Crash Protection Implementation Implementation Abort Strategies Explained Risks and Restrictions of Request Abort Implementation FusionReactor is implemented as a J2EE Filter and if installed correctly should be the very first filter in the J2EE chain this is how the install package installs it and how our manual installation guide explains it too Being the first filter in the chain allows FusionReactor to control exactly what runs within a given J2EE server and provides the maximum control during marginal situations FusionReactor uses its own web server and threading pools to ensure that it does not use J2EE container resources and therefore also does not rely on an external web server to be available something that is often one of the first things to become unavailable when resources get tight We explicitly designed all aspects of FusionReactor to consume as little time as possible Turning FusionReactor on should have very little impact on your J2EE application Part of the product QA cycle involves a multi day run test under very strenuous conditions to check there are no performance or memory problems Activating Crash Protection rules therefore can be a routine actio
332. ndard error logs If anything is misconfigured you should be able to start debugging the problem from the output presented there Installing FusionReactor in Locked Down Environments Introduction This page shows you how to get FusionReactor up and running in environments where your J2EE server is running as a different user than FusionReactor s FRAM service The procedure is different depending on your operating system so we ve split it into sections What does locked down mean In order to help secure their production operating systems many people choose to run their J2EE server not as root or Local System on windows but as a normal user locking down the application This is done to limit the effects of an attacker using malicious exploit to gain access to the server An attacker who exploits a weakness in a running server usually attempts to have that server run his arbitrary code essentially gaining access to the system By running the server under a normal user account rather than root or Local System the attacker can only gain the privileges associated with the normal user rather than those of the superuser lt is considered good practice to separate the privileges of servers and daemons by running them as normal users in this way thereby granting only the minimum privilege needed to operate correctly How does this affect FusionReactor While we encourage users to lock down their J2EE systems this causes two issue
333. nector the log mode must be changed from the Traditional Per Log Rotation Mode its current setting to Centralized Archive and Rotation lf you click Next this change will be made automatically Alternatively click Cancel to remain in Traditional Per Log Rotation mode for this instance Figure 2 Incorrect log rotation mode Figure 2 If you have updated a FusionReactor 3 x instance or you have changed the log rotation mode this is running in the Traditional Per Log Rotation mode To enable log file transfer to FusionAnalytics this mode needs to be changed to the new mode introduced in FusionReactor 4 0 0 Centralized Archive and Rotation mode For more information on log rotation modes please see the online documentation covering the Log Settings By clicking Next the log rotation mode will be automatically changed to Centralized Archive and Rotation and the wizard will continue on to Figure 3 If you do not wish to change the log rotation mode of this FusionReactor Instance at this moment press Cancel t o return to the Instance Manager coldfusion cfmxs JNTOO5F These settings control the metric log transfer frequency between FusionReactor and FusionAnalytics Note FusionReactor only supports log transfers based on time not on size Changing these settings will affect the log rotation strategy in FusionReactor Rotation Mode Periodic Rotate every n minutes Selects whether the logs will be rotated penod
334. next to it They are Button Name Description Stack Trace Clicking this button will take you to the Stack Trace page allowing you to see the current Java stack trace of the request Request Detail Clicking this button will take you to the Request Details page allowing you to access all information associated with a request e g cookies JDBC headers User Trace Markers and AMF information 3 Kill Request Clicking this button allows you to manually kill any tracked request You will be asked if you are sure Click on OK to kill the request The system will try for up to 60 seconds to kill the request the Soft Kill phase cleanly If the request is not producing output this method may be unsuccessful You may also click Force Thread Death to perform a hard kill action on the request If Stop Tracking This Request is checked the request will be exempt from metric tracking see Stop Tracking below Add to CP Restrictions If you click this button then you will be taken to the Crash Protection Restrictions page which will be filled out for this request There are two overall options Button Stack Trace ALL Kill ALL Warning Kill Instability Stop Tracking Clicking this button will cause FusionReactor to stop tracking this request for certain metrics slowest requests request runtime request activity Any JDBC statements currently running will be logged and visible in Request Details bu
335. nfiguring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Start configuring instances Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 8 Setup FusionReactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to installa license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click F
336. nforms to the J2EE Servlet Filter specification so it can be made to run on almost all J2EE containers we just have to add the right code to the Instance Manager to detect them Secondly there is a procedure for performing a manual install If you are trying to update a pre 4 0 manually installed version of FusionReactor you ll have to uninstall it first then get started with the procedure Manual Instance Installation Manual Instance Installation Introduction The normal method for installing FusionReactor into a J2EE container is to use the FusionReactor Administration Manager s Instance Manager This page located in Instances gt Instance Manager allows you to easily administer all instances present on a single machine If FusionReactor doesn t detect your instance you may have to install it manually There are some caveats to this process e The instance will not be displayed within the Instance Manager IM e You won t be able to use the IM to administer it Internal webserver port IP address and the Bind to all interfaces flag will only be changed by editing the fram conf file more on that later e The instance will be unable to use the FusionReactor Administration Manager to offload the zipping of logfiles or the shipping of logfiles to FusionAnalytics Procedure This procedure has been developed for Unix type operating systems including Linux FusionReactor may be installed manually on windows by changing the c
337. ng on the machine running the Setup You are now ready to start configuring instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Figure 9 Configure Instances Screen Figure 9 After the update has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later You should now navigate to the Instance Manager located on FRAM to update your other instances of FusionReactor Launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Update Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Figure 7 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance M
338. nput fields In the field titled CF Data Source Name enter a name for your data source In the JDBC URL text field simply enclose the existing JDBC URL within the FusionReactor syntax Oo 0O A O jdbc fusionreactor wrapper jdboc macromedia sqlserver int0006 1433 da tabaseName frtest sendStringParametersAsUnicode false MaxPooledStatemen ts 1000 You can also give the data source a name If you name the data source in this way FusionReactor will display this name in the Data Source column of the JDBC tab in the Request Details page This is useful if you re using multiple data sources Below is an example jdbc fusionreactor wrapper jdbc macromedia sqlserver int0006 1433 da tabaseName frtest sendStringParametersAsUnicode false MaxPooledStatemen ts 1000 name TestName 7 Inthe JDBC Driver Class field enter the name of the FusionReactor JDBC Driver Wrapper class com intergral fusionreactor jdbc Wrapper 8 Enter FusionReactor in the Driver Name field 9 Select an appropriate username and password values in their respective fields 10 Click Submit ColdFusion will immediately test the driver and provide feedback if necessary When the FusionReactor driver is loaded it will report FusionReactor JDBC Driver loaded to the standard output stream usually logged to coldfusion out log or default out log within cfmx runtime logs Below are two screen shots figure 1 covers stages 1 to 4 and figure 2 covers sta
339. nstall FusionReactor The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service on port 8087 Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Setup FusionReactor 4 5 0 Installing ED Please wait while Setup installs FusionReactor on your computer Extracting files lib fontconfig RedHat properties src Intergral Information Solutions Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup Setup FusionReactor 4 5 0 aged _ You are now ready to start configuring eqctor instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor insta
340. nstallation Oni WIndows s2 ccoke nee eee teh corte E argue cde eed el wena R a ea Ade ee 286 1 6 1 6 Updating FusionReactor 4 0 x on Windows i i5 00 once sete otto ta dwiee peta kee dens PAN ee Ra 292 1 6 2 Uninstalling FusionReactor On WINdOWS 4 restars i es dated etc tiwkteea yee ed a Mek obs eae ate dwl ee es 299 1 673 Installing FUSIONREACIOr OFEINUX 2zcsut sander e anh E Soa cde he Ra Agta GaN eee cena ee depen BUR a a 303 126 351 installing FusionReactor 45 Oni LINUX serides vaca iid yian eoa ewe ahaa td een a eee E EE A 303 t632 Updating FUSIONMEACLON s LOEN widrirint cee teres Sei cake AE og Mca N nin a aga eee tele a 314 1 0 3 0 Updating F sionReactor 2 0 GN ENUS ears ea to 8 saa tend c aoctw ane areata a Gyn ere er nding haat ate we Aaa 325 1 06 34 Updating FUSIONMEACION LOGNLINUX acces star rias Ss Mca there ea cron dee ems Bon eater deena end an aap Pe tee a 326 TESS GONSOleINStallatiOn on LINUX veme ccc eee a etre teh ear hae eta ata See RE tomas T a des Made en 326 1073 6 Updating F sionReactor4 Oxon ENMUX fc ek aca orie Sa cee twee EE E E A data PAA tee a 332 COA Wainstalling FUSION RE aCIOr on LINUX sxx terina dent hcaiwk tenet ood ached epee haan s tae se 339 LOS OVEN riede rrenean ak eds ak dy arse nee ree We Cie BS de ae Gta BR Sie Pisa E N de he 343 1 6 6 Installing FUSIONMEACIOr OM SOlANS sceshae iw ie uae Vent da elton IAA aah e now he tates eae ee ea 344 10 651 Installing Fu sionReactor 4 5 on Solaris dak
341. o restart ColdFusion Adding the Script to Manage Servers The final step in the configuration is to add the script to the monitored server s configuration We edit the server s Enterprise Dashboard configuraiton by clicking on Manage Servers then clicking the edit icon of the monitored server We enter the script location in the Script field Script ic tmp Restart Coldfusion8 OnWin Testing the Script The script can be tested by simply using the Windows Service control panel to stop the monitored ColdFusion 8 service Observing the script log file c tmp script log file shows the output of the script The ColdFusion 8 service can be observed restarting in the control panel 8 Application Ser The man C Starting m m m IdFusion Conclusion We ve shown you how to configure Enterprise Scripting to restart a ColdFusion 8 server The scope for what scripts can do is immense since there are no restrictions on what they may call It would be a simple task for example to integrate FusionReactor into an SNMP monitoring solution write custom log messages or send SMS text messages FusionReactor 4 5 x Installation Guide Installing FusionReactor on Windows e Installing FusionReactor 4 5 x on Windows Updating FusionReactor 3 x on Windows Updating FusionReactor 2 0 on Windows Updating FusionReactor 1 0 on Windows Console Installation on Windows Updating FusionReactor 4 0 x on Windows Uninstalling FusionReactor on
342. o the error we run the page and notice it s taking a long time to complete In the FusionReactor Administrator we can find the currently running request OG 152414287 iooi F hitp Wlocalhostga tutorialftutoriat cfm agar ESEA hl ay i Free 507 703 and click on the blue data icon top right of the icon block to bring up the Request Details page for this request Once that page has appeared we can click on the JDBC tab to bring up the JDBC Details page which looks like this Currently Running Statement Query Date Query Time select from usr u obj oll 15 24 15 18 138734 It s now clear that our statement is causing the problem since it s listed as the Currently Running Statement We can then use the red X icon on the Running Requests page to kill this request But what if we wanted to limit the number of rows retrieved to some hard value to prevent runaway queries in production Using the Row Limiter The FusionReactor JDBC Driver Wrapper has a builtin Row Limiter which is configured on the Data Sources page of the CF Administrator In the CF Administrator edit the frtest wrapper data source and append Pt ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee M Pt ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee Hy jdbc fusionreactor wrapper jdbc macromedi a sqlserver int0006 1433 databaseName fr test SelectMethod direct sendStringParamet ersAsUnicode false MaxPooledS
343. obody on Linux and the J2EE server user coldfusion 2 Add both users to this group 3 Sets file ACLs and Default ACLs so new files and directories inherit the ACL rights on the J2EE server and FusionReactor The procedure uses Adobe s ColdFusion JRun J2EE server for its examples with FusionReactor running as nobody on Linux Solaris If you have multiple J2EE servers their users must also be added to the common group and their Access Control Entries ACE and default ACEs must also be set If you later add new users and J2EE servers simply add their users to the common group and add Access Control Entries as detailed in each procedure Linux Requires kernel 2 6 or later with a filesystem supporting ACLs ReiserFS ext2 ext3 JFS XFS mounted with ACL support default On Linux FusionReactor is typically installed as nobody In our test environment ColdFusion is installed as the coldfusion user If your users differ substitute them in the commands below The following commands should be run as root with FusionReactor framd and your J2EE server stopped If your nobody user has a shell which prevents login e g sbin nologin you may need firs t apply technote FRS 284 to resolve this issue 1 Add the common group fusion groupadd fusion 2 Add FusionReactor s runtime user and ColdFusion s substitute your J2EE server s runtime user to the common group gpasswd fusion members nobody coldfusio
344. oc Free Used 9 ae 466 046 341 666 422 114 43 933 Total Memory Time ms Memory KB 3 407 Cur 9 42 449 Free 473 598 Request Settings The Request Settings page lets you modify various elements relating to the capture storage and display of Request information The page has the following items Request Formatting Configuration URL Format Request Logging Configuration Request Logging View Size KB Request Content Capture Configuration Request Capture Capture Path History Configuration History Size Description This option changes how URLs are displayed throughout FusionReactor Full includes the hostname while Short just shows the path Select Full if you are dealing with servers which host multiple websites Description If Request Logging is enabled then requests will be written to the request log as they arrive and complete If you disable it then it won t This value indicates how much of the log file should be displayed when you view the Request Log from inside FusionReactor Description Activating this option instructs FusionReactor to store the complete Request and Response objects to disk WARNING Turning on Request Content Capture will create multiple XML files for every request run ona server This may use very large quantities of disk space quickly Please be careful when enabling this feature and do not leave it enabled if you are not monitoring
345. oduce too many false positives for Crash Protection so we may want to use 2 3 or even 4 standard deviations a AVERAGE L1 L65535 4 STDEV L1 L65535 O1 As with the gut feeling approach this number can only ever be a starting point for tuning you are bound to get some exceptions and these should help you decide how to adjust this value Restriction In the detailed example above we ve allowed a margin in the operational memory estimation to account for periodic rises in website usage and scheduled tasks Scheduled tasks often run at periods of low demand and are typically resource intensive Search indexing reporting and cleanup operations often run in this batch mode and often consume memory and CPU cycles These tasks also tend to run for long periods of time Once you have a picture of these tasks you can add them as CP Restrictions Crash Protection gt CP Restrictions Ensure that CP Settings gt CP Restrictions gt Restrictions is Enabled and the mode is Ignore Matching Requests CP will then ignore any requested pages set in the CP Restrictions page Once you have added your scheduled tasks as restrictions the operational values for Timeout Memory and Re quest Protection can be adjusted since they will no longer apply to the exceptional cases Timeout Protection and Request Protection The System Metrics charts may also be used to generate values for Timeout Protection using the Average Request Time graph and R
346. of line end of line turn on case insensitive matching Description This will match any URL which contains mytolder mytile cfm This will match anything within myfolder This will match any files named myfile jso which are inside a directory This will match any cfm or jsp file This expects parameter checking to be enabled It will match any file named myfile cfm which has the string mode ada as part of it s parameters Note This will also match mymode add This will match files names batchO cfm batch1 cfm batch9 cfm This will match files names BatchO cfm BATCH1 cfm batch9 cfm When using Regex Expressions with FusionReactor there are a few common problems FusionReactor allows you to perform matches with or without the Hostname by setting the Hostname field to Check or Ignore respectively When the Hostname field is set to Check you should include the hostname but not the protocol e g http or the leading If you set the Hostname flag to Ignore then you typically need to start the Regex Expression with a to match the whole URL from the root Generally it is recommended to set the Hostname to Ignore and remove the hostname and protocol from the Regex because request could be made against IP addresses as well as hostnames RegEx my host com myfolder myfile jsp mytolder myfile jsp Hostname Checked Ignore Description This will match the file myfolder myfile jso when the request
347. oldFusionExtensions Linux opt FusionReactorColdFusionExtensions Solaris opt FusionReactorColdFusionExtensions Mac OS Applications FRECF FREC Installation Guide Installing FusionReactor Extensions for ColdFusion FREC Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC Installing FusionReactor Extensions for ColdFusion FREC In order to install the FusionReactor Extensions for ColdFusion FREC plugin into an instance of FusionReactor you will need to first need to install the FREC Instance Installer In order to do this run the installer eg Fusion ReactorColdFusionExtensionsSetup_windows_1_0_0 exe on Windows Setup FusionReactor Extensions for ColdFusion Setup 1 0 1 n f Welcome to the FusionReactor Extensions for ColdFusion Setup Wizard This will install the FusionReactor Extensions for ColdFusion tool Click Next to continue or Cancel to exit Setup Extensions for ColdFusion ColdFusion and Adobe ColdFusion are trademarks of registered trademarks of Adobe Systems Incorporated in the United States and or other counties All other trademarks are the property of their respective Owners Figure 1 FREC Welcome Screen The first screen in the installer is just the Welcome screen Click the Next gt button to continue on or click on Ca nce to stop t
348. older available at instance FRAM archive By doing this FRAM generates a central storage of files More information about each archive can be provided by clicking the Archive History e button next to each listed archive This will provide information on the life cycle of the archive all the way from the instance that generated the logs to FusionAnalytics By having FRAM performing this action the transfer to FusionAnalytics can be easily tracked and maintained by the user of the FusionReactor Administration Manager For more information about FRAM please see the online documentation for the FusionReactor Administration Manager FRAM Fusion Reactor Enabling and Disable Notifications Notification Log Settings Filter Restrictions Change Password Change FR REST Password Log About Help Logout Enabling and Disable This page lets you completely enable or disable FusionReactor Simply click on the Disable FusionReactor or Enable FusionReactor button to change the state of the system The current state of the system can be seen from the status icon which is displayed at the bottom of the table of contents Green means enabled Click the button on the right to disable FusionReactor Disable FusionReactor Click the button on the right to disable FusionReactor Disable FusionReactor and red means disabled Click the button on the right to enable FusionReactor Enable FusionReactor Click the button on the
349. olutions Figure 4 FusionReactor Administration Manager FRAM Figure 4 The default HTTP port for FRAM is 8087 If you wish to manually specify the ports used by FRAM select the Configure ports manually option then click Next to configure the server ports See Figure 5 If you wish to use the default port settings leave the box unchecked and click Next See Figure 6 FusionReactor Administration Manager Ports Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Manager HTTP Port 8087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Contral Port 3004 Intergral Information Solutions Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administration Manager Validate Password Intergral Informati
350. on Solutions Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long Ready to Install FusionReactor The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service on port 6067 Create a Desktop Shortcut to FusionReactor Administration Manager Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions Figure 7 Ready to Install Figure 7 The FusionReactor Setup can create a shortcut on the Desktop to FRAM if you do not want Setup to perform this action uncheck the option Create Desktop Shortcut to FusionReactor Administration Manager Setup can also automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Intergral Information Solutions Figure 8 Installation Progress Figure 8 The installation of FusionReactor 4 5 x may take a few minutes dependi
351. on data reactor conf and fram conf files e Or the files are empty e The version of FusionReactor recorded in the configuration is different to that of FRAM FRAM must be used to update these instances to the new current version of FusionReactor e Certain keys required for the operation of FRAM are missing Remedying Corrupt Instances The most failsafe way to remedy corrupt instances is to have Instance Manager remove them then add them again fresh The J2EE container should be restarted as part of this process You ll lose any configuration you ve made up to that point but the configuration will once again be usable by FRAM Also See Uninstall FusionReactor Instance Unsupported Configurations What are Unsupported Configurations FusionReactor 4 has to impose some constraints on the overall configuration of instances within a FRAM administered server This was an unavoidable limitation and is a side effect of the highly diverse nature of FusionReactor installations An unsupported configuration is reported in the table of contents with a system notification tector Administration Manager Administration Manager Administrator p 1 Notification 1 new and in the Instance Manager with a warning box Unsupported Configuration FusionReactor Administration Manager has detected instances of FusionReactor with versions prior to 4 This is an unsupported configuration Please use the Update links provided bel
352. onReactor Instance the wizard will advance to next FusionReactor instance if not the finish screen will be displayed See Figure 7 coldtusion cfmxs INTOO5F Updating Figure 4 Update Progress Figure 4 FusionReactor is updating the selected FusionReactor Instance Updating the FusionReactor Instance should only take a couple of seconds please note that the time may vary depending on your system coldfusion cimxs JNTO045F Attempt to start the server instance coldfusion in Adobe ColdFusion 6 C ColdFusion automaticaly Figure 5 Server Start Figure 5 By Clicking Start the Instance Manager can attempt to automatically start the server instance again See Figure 6 If you wish to start the server at another point or wish to manually start it click Skip See Figure 7 coldfusion cimxs JNTOO5F Attempting to start server instance coldfusion in Adobe ColdFusion 6 C ColdFusions Figure 6 Server Instance Starting Figure 6 FusionReactor is attempting to start the server instance Please note that starting the server may take several minutes depending on your system and server coldfusion cfimxs JNTOO5F Update was successful Instance coldfusion cimxs_INTOO5F Y Connect to FusionAnalytics lf you hawe FusionAnalytics installed you may now configure the FusionAnahytics Connector in order to load metric data directh from this instance Settings may be changed at a later time v
353. onReactor Purchase Page Quick Start to Troubleshooting Server Problems with FusionReactor This document helps you configure FusionReactor There are many different scenarios in which FusionReactor is used each with its own conditions and each requiring a different configuration What we aim to do in this document is cover sample configuration for short term immediate troubleshooting and longer term production monitoring It s not possible to come up with a universally perfect configuration because every scenario is different What we ve tried to do in this document is cover the most important points to consider when configuring FusionReactor for different scenarios Getting FusionReactor Configuration and Diagnosis in Emergencies Configuration and Diagnosis for Production Configuration for Enterprise and High Availability Environments e Setting Up A Separate Monitoring Instance e FusionReactor in High Availability Environments HAE e Enterprise Dashboard Servers and Groups Using log files to troubleshoot issues Getting Help Logs e Stack Trace Log stacktrace log Getting FusionReactor We are assuming you ve installed FusionReactor already if not go ahead and install it now The installation process is easy in almost every case the installer package will take care of all the details We ve prepared a comprehensive Installation Guide which covers all the details http www fusion reactor com fr downloads ctm This sec
354. onreactor jdbc jar was placed with the underlying JDBC driver jar The second jar fusionreactor core jar replaced the monolithic fusionreactor jar which was deleted Because the jdbc component could locate the underlying driver and the two components could communicate JDBC wrapper functionality was restored FusionReactor 4 5 0 FusionReactor 4 5 0 introduces a new option to the JDBC driver cp which is a comma separated list of file paths pointing to jar files which contain the underlying driver to be wrapped lt is no longer necessary to split the jar and the FusionReactor 4 5 0 instance updater will in fact restore the monolithic FusionReactor jar file fusionreactor jar and remove the core and JDBC split jars from the system You must then modify your datasource to add the cp option to point to the actual JAR which contains the driver you re wrapping ColdFusion users for example can do this using the Data amp Services gt Data Sources tool within the CF Administrator Many examples are provided in the JDBC Wrapper User Manual see here for some examples For instance if you were previously using a wrapped Microsoft SQL Server Driver you must append a CP option which points to the jar In this example the jar has been installed to c jdbc sqljdbc4 jar jdbc fusionreactor wrapper jdbc sqlserver gt int00d0 1433 databaseName AdventureWork s driver com microsoft sqlserver jdbc SQOL ServerDriver name testdb cp c
355. op of this page not stopping the server container means that FusionReactor and all of its components will not be completely removed from the target server This may cause issues on the corresponding server FusionReactor 4 5 0 Uninstall FusionReactor Uninstall FusionReactor was successfully removed from your computer Figure 5 FusionReactor Uninstall Complete Figure 5 When FusionReactor has finished uninstalling you will be presented with the Finish screen shown in Figure 6 Click on Finish to exit Overview Welcome to the FusionReactor Installation Guide Thank you for choosing FusionReactor to monitor your ColdFusion or J2EE server You have reached the Intergral Documentation Center which contains all the information you will need to get up and running with FusionReactor and other Intergral products If you are looking for another page you can use our search feature located to the top right of every page These pages will describe how to use the FusionReactor Setup to install FusionReactor on Windows Linux Mac and Solaris If you have not already done so you can download FusionReactor by clicking the download link to the right if you are unsure if you can run the latest version on your server or would like to Know if your operating system is supported please visit our requirements page Please continue to select the appropriate platform and we will guide you through the installation process Please Select Your Pla
356. or anomalies in the performance of the system in essence defining exactly what constitutes an exception case Once we ve identified this Crash Protection rules can be defined to report when this case occurs There are essentially two methods of defining these cases gut feeling and numerical analysis We ll give an example of both and how they apply to each of the Crash Protection settings Gut Feeling The gut feeling principal is best supported by the System Metrics graphs With the system running steadily for at least an hour the graphs when switched to Hour mode clearly show how the system is being used Timeout Protection and Request Protection You can use the system metrics graph to check the following e Timeout Protection using the Average Request Time Graph e Request Protection using the Request Activity Graph Memory Protection Example As an example we set up a load test to simulate a fairly constant load on the system You can see in the System Metrics page that the memory displayed in the Memory Usage graph is reasonably constant If we observe the system for an hour we would get an even better picture of how the memory is used For even longer periods we can set the Resource Settings gt Resource Sampling interval to 60000ms 1 minute with a long history size We can then view this data in the Resources gt Memory Graphs gt Memory Heap page Using a longer time span allows us to get a pictur
357. or fhe Observer or Manager disables that user from fogging in leam about the Mulfiugser feature Skip This Instance Install Instance Figure 1 Configure the FusionReactor Instance Figure 1 For each server instance you will need to provide configuration information used to set up FusionReactor Configuration Name Description This is the unique name of the FusionReactor instance to be installed The name must not contain any non latin characters or any of the following gt lt IP Address Listen on all addresses Port Listen on external web server Administrator Password Use the same password for all users Manager Password Observer Password This is the IP address used to access the FusionReactor instance on the internal web server provided by FusionReactor The addresses listed are the ones available on the machine local to the FusionReactor Administration Manager FRAM N b FusionReactor is also accessible using your external web server on the url http localhost fusionreactor Tick this box if the internal web server provided by FusionReactor should listen on all IP addresses on all interfaces not just that named in the previous input box This is the port number used to access the FusionReactor instance using FusionReactor s internal web server Tick this box if you want FusionReactor to also listen on your J2EE server s web server Provide a passw
358. or monitoring and instance management it will continue running even following a JVM crash FRAM will also perform process and transfer offloading making the log transfer to FusionAnalytics a central process performed by a single instance fusion reactor Administration Manager Log Transfer amp Archiving By selecting the FusionAnalytics Connector mode Sent to targets by FRAM See FusionAnalytics Settings for more information about log modes the individual FusionReactor instances the log archiving and transfer to FusionAnalytics will be performed by FRAM This mode optimizes transfer of archives by having FRAM compress and send files to the FusionAnalytics Targets offloading the processing power required to compress and transfer of log files onto FRAM This means that each individual FusionReactor instance will have to perform this costly action making FusionReactor more transparent on the target server The FusionReactor Administration Manager FRAM will also act as a central hub for log transfer where multiple instances can send their log files for archiving and transfer via FRAM By doing this a central archive will be maintained by FRAM containing the log files of all instances using the FusionAnalytics Connector mode Sent to targets by FRAM assuming their FRAM and FusionAnalytics targets are correctly set up See Edit FusionAnalytics Connector for more detailed information on how to set the FusionAnalytics Connector up Logg
359. or will be updated to include FusionReactor Administration Manager to manage your other instances of FusionReactor Configuration files will not be overwritten Setup has detected instances of FusionReactor with versions prior to version 4 These are not supported by FusionReactor 4 and will be updated during the initial update which is performed by the FusionReactor Administration Manager after the installation After Setup has finished you will be taken to your FusionReactor Administration Manager instance where you must update your other instances of FusionReactor Click Next to continue the update of FusionReactor Click Cancel to exit Setup Intergral Information Solutions Figure 3 License Agreement Figure 3 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard Setup FusionReactor 4 5 0 FusionReactor Administration Manager D The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 _ Configure ports manually fusion m 4 reactor Administration Manager Intergral Information So
360. ord for the Administrator user on the new instance For more information about the user roles in FusionReactor see Types Of User Account Tick this check box if you wish to use the Administrator password for all user roles Selecting this option will disable the Manager and Observer Password fields For more information about the user roles in FusionReactor see Types Of User Account Provide a password for the Manager user on the new instance For more information about the user roles in FusionReactor see Types Of User Account Provide a password for the Observer user on the new instance For more information about the user roles in FusionReactor see Types Of User Account The instance initially listens on the internal webserver this can be changed in XXX and optionally the external web server Once you have correctly provided all of the configuration details click Install Instance to install FusionReactor into the selected server instance and create a FusionReactor instance with the specified details Click Skip This Instance to cancel the installation of this FusionReactor instance If you have selected to install more than one instance clicking Skip This Instance will advance the wizard to the next instance Adobe ColdFusion 6 C ColdFusions The server instance coldfusion in Adobe ColdFusion 6 C ColdFusions will need to be restarted to activate the new FusionReactor Instance Should FusionReac
361. orresponding paths A Windows specific template configuration is available and this is noted later in this procedure Prerequisites The following list outlines the prerequisites which must be fulfilled prior to beginning this procedure e The target J2EE container must be installed and running e If you have previously installed FusionReactor 3 x manually this must be uninstalled e The FusionReactor filter definition which is inserted usually in a web xml or default web xm1 must be removed e The FusionReactor installation folder Unix opt fusionreactor Windows C FusionReac tor must be removed e You should know in which file your J2EE server defines its servlets and filters You ll need to know this in order to add the FusionReactor filter later This will give a clean environment in which FR4 can be installed Installing FusionReactor Administration Manager The FusionReactor Administration Manager or FRAM is a cut down version of FusionReactor which runs inside its own server and provides administrative and monitoring functionality for other FusionReactor instances Although as a manual install you won t be able to take advantage of these functions FRAM does contain an instance template which you can use to create a manually installed instance e Unix users who do not have X Windows or another GUI available to them can run the FusionReactor 4 installer in command line mode available in Windows Linux and Solaris S
362. ory JDBC Time Graph e PS Survivor Space heap memory Memory Graphs Memory Heap Memory Heap Non Heap Code Cache PS Eden Space PS Old Gen PS Perm Gen PS Sumwivor Space Server S Log Tomcat 7 e Code Cache w RESOURCES Si a Request sions Graph e Perm Gen shared ro aa e Perm Gen shared rw paein am e Survivor Space anne a e Tenured Gen sea aga eri li Memory Heap Memory Heap Non Heap Code Cache Fden Space Perm Gen Perm Gen shared ro Perm Gen shared nw Survivor Space Server s Log Image Server Names Railo 3 e Code Cache e Eden Space ae e Perm Gen Request Activity Graph e Survivor Space Request Time Graph e Tenured Gen JDBC Activity Graph JDBC Time Graph Memory Graphs Memory Heap Memory Heap Non Heap Code Cache Eden Space Perm Gen survivor Space Tenured Gen Will I still get detailed information in my logs and graphs As you can see every server has different names for areas of memory so there is no hard rule about what graphs will be displayed in FusionReactor There will be graphs and logs available for areas of memory in your server So the short answer to the question above is yes For further information on memory logs see the Ty pes of Memory Logs section CPU Graph The CPU Graph will show you a graph of the CPU samples currently stored in memory by FusionReactor The time span of these samples will depend upon your history size and interval time see Resource Sett
363. otal Hit Count Delta Total Hit Count Delta Capture Time milliseconds amp NOTE 13 M 14 N 15 O 16 P 17 Q 18 R The difference between the current RCFC hit count and the previous RCFC hit count The number of hits from web services The difference between the current web services hit count and the previous web services hit count The total hit count The difference between the current total hit count and the previous total hit count The difference between the current capture time and the previous capture time In the fields titled Delta the definition describes it as The difference between This means the difference between the current data sample and the previous for example if the current was 10 and the previous was 8 then the delta would be 2 10 8 This sort of information is useful for spotting trends Also See Log Settings Installing FusionReactor Extensions for ColdFusion FREC Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC FREC Log Files CF Log Entries fr coldfusion log log The fr coldfusion 1log will capture a copy of ColdFusion log entries for example when making a call to lt cf log gt This log file will be appened to every time a CF Log event occurs The following table describes the captured information Field Name Date Formatted
364. otify you when a certain number of rows has been read and periodically thereafter Using this feature you are able to keep a clear overview about the volume of data being processed by Java The driver wraps any existing JDBC driver and is able to communicate metric data to FusionReactor for easy perusal in the FusionReactor Administrator If the driver does not detect FusionReactor running for instance when running in a standalone Java application it reports metrics to the standard output stream Intended Audience This technical documentation is targeted at developers and administrators of standalone and J2EE ColdFusion applications It presents the procedure for installing and configuring the FusionReactor JDBC Driver Wrapper to run as a ColdFusion Data Source or as a standalone JDBC data source The administrator is expected to have experience with ColdFusion Data Sources and with how JDBC URLs are constructed Limitations The FusionReactor JDBC Driver Wrapper is intended to help you debug and manage J2EE JDBC queries It integrates tightly with FusionReactor to provide you with metrics and detailed information about your pages database activities Our JDBC Driver Wrapper can t optimize your queries and pages before they re run but it c an help you see where the time is being spent or to locate a stuck query The FusionReactor JDBC Driver Wrapper also can t totally insulate you from performance or stability issues with underlying driver
365. ous elements relating to resource sampling and logging The page has the following items Resource Sampling CPU Memory Configuration Description Initial Delay ms This value defines how long after startup FusionReactor will wait before starting to periodically gather resource information This is done so that the server can recover from the extra overhead of startup and your graphs will represent normal operating behavior Sample Interval ms Change this value to alter the amount of time between successive resource samples History Size This value defines the maximum number of resource samples stored in memory Once the history size reaches its maximum old values will be removed to make room for new ones Java 1 5 Logging CPU Thread Status Memory Spaces Configuration Description CPU Thread Status Setting this to Enabled will allow CPU Thread information to be logged setting it to disabled will not log the information WARNING Enabling this option will create very detailed log files please ensure sufficient disk space is available before doing so Memory Space When Enabled detailed sizing information about memory spaces will be logged amp NOTE To Enable the two options above you must be running Java 1 5 or above See the Sun Website for information on how to download the latest version of Java Resource Logging CPU Memory Request JDBC Configuration Description Resource Logging If Resourc
366. ow should name my Applications and DataCollectors Usemame Password The usemame and password of a user who has aocess fo the FusionAnalytics DataGollector application a Check this box if your FusionAnalytics Datatlollector Uses HTTPS fo secure communications Status Test Target Save Target Settings We ll go through each field and explain where to find it in FusionAnalytics Host and Port This is the hostname and port number of the FusionAnalytics DataCollector service If you used the default port the target will be available on 8400 The host must be either an IP address or a DNS resolvable name which points to a reachable interface located on the target system Application Name This refers to the name of the individual data collector app running within FusionAnalytics You can find it by logging into the FusionAnalytics DataCollector Administrator and looking at the Applicati on Summary page The application name is located in the Current Applications table in the column Name In the figure below the application apple has been defined Current Applications No Logs to Yo Import Complete Name Revision Status Job Manager Status Errors 0 paused 14 started 0 ane 23488 processing apple 1 0 5 Running 0 Application Detail Stop Upload logs DataCollector Each Application running in FusionAnalytics can define one or more DataCollectors These should be used to cluster together
367. ow to update these instances at the earliest opportunity Read more about unsupported configurations In this case FusionReactor Administration Manager is reporting that it has detected a version of FusionReactor prior to version 4 Prior Versions are Unsupported The structure of FusionReactor has been refined in version 4 More functionality has been introduced and the instance directory structure has been extended For this reason the installation and initial update process tries very hard to update prior 3 x version of FusionReactor to 4 0 0 If for whatever reason this process failed FusionReactor will warn you by displaying this dialogue on the Instance Manager The offending instances will be flagged and will have a blue Update button together with a link in the table Select All siano Dntancetine rot version tee EJ Adobe ColdFusion 9 D Servers ColdFusion9 OOGO amn i O O O OQ QQ ooldtusion coldfusion cfmx3 into060 2089 3 5 0 Update It s important to note that your original 3 x instances might continue to run but they should be updated as soon as possible using the link provided We don t support a mixed configuration of 4 x and pre 4 x instances The system notification associated with this condition is non dismissable but will be removed if the affected instances are updated See Also Update FusionReactor instance Setting Up FRAM with HTTPS FusionReactor Administration Manager FRAM supports se
368. pdate FusionReactor on is currently running it needs to be stopped in order to update the FusionReactor instance By clicking Stop the Instance Manager can attempt to stop the server instance automatically See Figure 2 If you wish to stop the server at another point or wish to update it at a later point click Skip If you have selected to update more than one FusionReactor instance the wizard will advance to the next FusionReactor instance Otherwise the Finish screen Figure 6 will be displayed To update the FusionReactor Instance the server instance must be completely shut down If the server instance you are updating FusionReactor on is not running Figure 3 will be displayed coldtusion cfimxs INTOO5F Attempting to stop server instance coldfusion in Adobe ColdFusion 6 C ColdFusions Figure 2 Server Instance Stopping Figure 2 FusionReactor is attempting to stop the server instance Please note that stopping the server may take several minutes depending on your system and server coldfusion cimxs JNTOO5F Are you sure you wish to update this instance Figure 3 Update Confirmation Figure 3 By clicking Update the FusionReactor Instance will be updated to the same version of FusionReactor as is running on the FusionReactor Administration Manager FRAM If you do not wish to update the FusionReactor Instance at this point press Skip If you have selected to update more than one Fusi
369. plication which can be found in the table below if you installed it to the default directory depending on your operating system Platform Default Location Windows C FusionReactorColdFusionExtensions Linux opt FusionReactorColdFusionExtensions Solaris opt FusionReactorColdFusionExtensions Mac OS Applications FRECF Please see Installing FREC into FusionReactor Instances for a detailed guide on how to install FREC into a FusionReactor Instance Once installed there are a few simple things that need to be enabled in order for FREC to work please see How to enable FREC This page goes through the things that must be enabled Uninstalling FREC In order to uninstall the FusionReactor Extensions for ColdFusion FREC plugin from an instance of FusionReactor you need to run the FREC Instance Installer which can be found in the table below depending on your operating system Once you run the Manage Instance application you will need to change the action to uninstall and click next to start the uninstall For a more detailed guide please see Uninstalling FREC from FusionReactor Instances To uninstall the manage instances application you will need to navigate to the directory in the table below if you installed it to the default directory depending on your operating system Run the uninstaller For a detailed guide on how to uninstall FREC completely please see Uninstalling FREC Platform Default Location Windows C FusionReactorC
370. pport organizations two of which are Enterprise Monitoring and Crash Protection Crash Protection is of course one of the important features of FusionReactor and has been present since the initial release FR4 builds on this technology and brings advances in Restrictions which requests will be subject to Crash Protection and we have also extensively reviewed the mechanisms FusionReactor uses to manage and control requests Server downtime is often measured in dollars not minutes and Crash Protection continues to be a focus of the FusionReactor team Enterprise Monitoring available to customers with enterprise licenses gives you the ability to visualize the state of a machine cluster together with behind the scenes uptime monitoring and the ability to send mail when a machine becomes unavailable Easy to read instrumentation including color coding realtime graphs and bars together with advanced grouping server offlining and user definable warning and critical thresholds make our E nterprise Dashboard an essential component for hosting providers or customers with a cluster of J2EE e g ColdFusion installations The Enterprise Dashboard is fully explained in its own section so we won t be covering it here except where necessary to illustrate how a particular issue is visualized Scenarios and Scope This documentation will cover the usage of FusionReactor to ensure the availability of your systems We ll cover Crash Protection and
371. preparing the environments is to ensure that both systems are running smoothly and the monitor is able to poll the target system for enterprise data We add the remote system to the monitor Enterprise Modify Server Name CFB Server This is the URL This i the URL of an instance of FusionRe actor htpanzr 00 1 B5086fusmontacior ntp192 168 1 64 8088 fusionreactor Password aaa Enter the FusionRe oCripl This scrip goes dow FR netwo Please re Using Sch Status Online ls this ser Modify Server and check that Enterprise Dashboard is retrieving information from it Enterprise Enterprise Dashboard i i CFESeever FusonReactor Instance CFASorvar Lic arise FRASS2ENT SO 6 FRESZENT ff Activation Statua w MS Raguta Guami org Pa Pusiiiene Timeout Org f Loa Momirg Oo o Script Preparation For this example we ll be using the restart Coldfusion8 OnWindows bat script from the FusionReactor etc cp windows folder For our example we copy the example script to a temporary folder from where we can work on it copy restart Coldfusion8 OnWindows bat c tmp In order to customize the script we open it in an editor All provided example scripts are commented extensively There are a couple of variables we must customize in the script e We set the LOGFILE line 43 to c tmp script log e We change the USER and PWD lines 53 and 54 respectively to reflect the Windows user with permissions t
372. problem is Server Icon Buttons Additionally there are two small buttons on the Server icon Button Name Stop monitoring Open FusionReactor in a new Window coldfusion cmx Warning Lights Description At the top right corner of the icon is a small button which can be used to flip a server between Online and Offline status An offline server will be displayed in gray and will not cause warnings to appear within the Enterprise Dashboard At the bottom right corner of the icon is a small arrow If you click on this arrow then you will be taken directly to the instance of FusionReactor running on this server When FusionReactor detects a problem on a monitored server it will light up one or more Warning Lights on the server cube You can move your mouse over a warning light to see a tool tip explaining the problem is in more detail The following table describes the warning lights and their meanings Message Meaning CONN Connection Lost SLOW Slow Requests Description The connection heartbeat has been lost to the monitored server The monitored server may be down The number of requests running longer than the slow page threshold within the last 60 seconds has exceeded the Warn or Critical values configured on the Enterprise Settings page LONG MEM QTY TIME DB ACT Notifications cfary 1 prom intt You have 2 notifications Long Running Requests Low Memory CP R
373. proceed with the update Click Cancel to exit the installation wizard _ Setup FusionReactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation Create a Desktop Shortcut to FusionReactor Administration Manager Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions Figure 4 Ready to Install The FusionReactor Setup can create a shortcut on the Desktop to FRAM if you do not want Setup to perform this action uncheck the option Create Desktop Shortcut to FusionReactor Administration Manager Setup can also automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Intergral Information Solutions Figure 5 Installation Progress Figure 5 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup Setup FusionReactor 4 5 0 reactor You are now ready to start configuring instanc
374. quest Detail page AMF is a binary format used to serialize ActionScript objects It is used primarily to exchange data between an Adobe Flash application and a remote service usually over the internet The AMF tab can be found under the Request Detail Page FusionReactor makes it easy by decoding your streaming AMF connections to help you debug your code Requests Request Detail Finished Ret Code IP URL Parameters Time ms Memory KB 13 07 13 848 200 http 27 00 Ve a0 tlex2geatewsy jsessionid 8 4307 10850461 460082 b3Tr028Ghl 2322092 51 Cun 1396764 198 03 Aug 2011 127 0 0 1 ColdFusion CFIDE adminapi sewermonitoring getMtonitorStatus 46 Free 401 849 ColdFusion CFIDE adminapisevermonitering getResltime Stats AMF Dissector Input messages available 1 Output messages available 0 input Messages EE e a n Aug 13 07 13 797 gt BAugit1 13 07 13 848 51ms Size 7468 destination ColdFusion senviceNiame CFIDE adminapi severmonitoring seniceMethod getMonitorstatus response HT value ARRAY CUSTOM CLASS flex messaging messages RemotingMessage timestamp o headers aiks e tales DSRequestTimeout op OSId FEESA 67 AB0E 6727 696F C4A563A49FE3 DSEndpoint iuti body operation getifonitorStatus SOLNCE CFIDE adminapi_servernnonitoring messageld 677 1A944 C3F4 C267 7450 8F536A019050 fimeToLive g clientid FEESAC69 ABOF DF2A E7B0 38C 72315DD65 destination ColdFusion AMF BODY destination ColdFusion serviceName CFIDE a
375. quests writeoutput lt h2 gt Current Request lt h2 gt myThreadName createObject java java lang Thread cu rrentThread getName for i 1 i LTE ArrayLen requestArray i i 1 if requestArray i getThread eq myThreadName writeoutput ID requestArray i getFusionRequestId lt br ST lt cfscript gt Pee eee ee ee ee eee eee lt page import com intergral fusionreactor api O 5 gt oe lt FRAPI frapi FRAPI getInstance ConfigurationSurrogate configuration frapi getRunningConfiguration 1f configuration getStringValue remoting server 0 online equals true configuration setValue remoting server 0 online false else configuration setValue remoting server 0 online true frapi setRunningConfiguration configuration Q 5 gt Getting the FusionReactor Request ID for the current request It s possible using FRAPI to get the FusionReactor Request ID of the current running page or request This can be done by looping over the list of current tracked requests and matching the thread name of the request thread with the thread name on tracked of the FusionReactor request surrogate The following code example is written in cfscript Pee eee ee ee ee eee eee lt cfiscript gt frapiClass createObject java com intergral fusionr eactor api FRAPI frapi frapiClass getiInstance request
376. quests are displayed on this page by clicking on any of the column titles Clicking on a title for a second time will reverse the order on that column Managing Requests Each currently running request listed on this page has four icons next to it They are Button Name Stack Trace Request Detail Description Clicking this button will take you to the Stack Trace page allowing you to see the current Java stack trace of the request The request must be being currently executed to be presented with this option Clicking this button will take you to the Request Details page allowing you to access all information associated with a request e g cookies JDBC headers User Trace Markers and AMF data gt Kill Request Clicking this button allows you to manually kill any tracked request You will be asked if you are sure Click on OK to kill the request WARNING Although FusionReactor first attempts to signal the request to let it exit safely if this times out or you skip the timeout then the request will be killed in a very abrupt manner Please be aware that in some very limited cases this can cause the JVM to become unstable Add to CP Restrictions If you click this button then you will be taken to the Crash Protection Restrictions page which will be filled out for this request A Stop Tracking Clicking this button will cause FusionReactor to stop tracking this request for certain met
377. r n or just Enter on the keyboard see Figure 7 onwards vmuser ubuntu Downloads I accept the agreement Yes 1 No 2 1 Where should FusionReactor be installed opt Tusionreactor The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port the port you use to view FusionReactor in a web browser It is important not to use ports that are already in use by other applications NOTE that the default port for FRAM is 8087 vmuser ubuntu Downloads where should FusionReactor be installed opt fusionreactor The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM 1s being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter Yy Manually configure the Fu
378. r more times grouping characters Example Search and Replace Filters RegEx Description FusionReactor This will match the exact string FusionReactor anywhere within a page Ff usion Re eactor This matches FusionReactor without needing to capitalize the F and the R Ff Uu Ss li Oo Nn This matches the word Fusion in any case lt a href http www machine com gt This will match any link to a specific machine which you could replace with a different link to a Not currently available page or something lt meta http equiv refresh gt This will match meta refresh tags which you could then remove FusionReactor API FRAPI What is FRAPI FRAPI is the FusionReactor API and it gives you the ability to access FusionReactor functionality from directly within your ColdFusion pages What can I do with FRAPI With FRAPI you can make your pages aware of what else is currently running on your server You can change FusionReactor settings and you can set user trace markers What is a User Trace Marker A user trace marker can be used for many purposes For example you could use it to debug a page and work out where the flow of execution goes or you could surround critical sections of your code and work out exactly how long they are taking to execute The main advantage of this mechanism is that you can implement it without having to display any debug information to end users or having to write to hard to read de
379. r of CF threads that are running The number of users that logged in using the CFLOGIN tag Flash Remoting Request Queued Flash Remoting Request Running Flash Remoting Request Time out JVM Free Memory bytes JVM Used Memory bytes Query Cache Hit Ratio Query Cache Size bytes Requests Queued Requests Running Requests Timed Out Request Load Server Scope Size bytes Session Scope Size bytes Template Cache Count 16 P 17 Q 18 R 19 S 20 T 21 U 22 V 23 W 24 X 25 Y 26 Z 27 AA 28 AB 29 AC The number of Flash Remoting Requests that are queued and waiting to run The number of Flash Remoting Requests that are running The number of Flash Remoting Requests that were timed out whilst waiting to run The free memory in the Java Virtual Machine The memory used by the Java Virtual Machine The query cache hit ratio The size of the cache The number of request threads queued JRun The number of requests that are running JRun The number of request timeouts JRun Request load of the server displayed as requests per a second The server scope size The size of the session scope The number of templates stored in the template cache The template cache is where ColdFusion stores compiled CFM and CFC templates in memory When a template is executed for the first time it is compiled to Java bytecode and then s
380. r other containers It may be necessary to create scripts which perform system reboots Again we recommend a careful evaluation of the impacts of this type of script before implementation A script which restarts a system should not attempt to restart the system on which the monitoring solution runs Manual Restarts If a script is configured for a given instance it will be fired when that instance becomes unavailable FusionReactor does not differentiate between overloaded or failing instances and instances which have been deliberately stopped Therefore if you stop an instance manually through Windows Services panel for instance FusionReactor will fire the configured script As an operational matter the affected instances should be offlined from FusionReactor before being shut down This can be done within the Enterprise Dashboard by clicking the button on the top right of server icon or from within Manage Servers by selecting the Modify icon for the affected server then changing its Status to Offline FusionReactor will not monitor these systems When maintenance is complete the servers should be onlined again by reversing the process Using the Example Scripts We have provided several restart scripts to get you started This section will help you understand how to install and configure them Installation The example scripts are provided in FusionReactor etc cp thereafter the structure is split into scripts which will
381. r the FusionReactor Administration Manager HTTP Port 8087 The FusionReactor Administration Manager uses a second port to listen for shutdown commands Setup has chosen a default port number for this function Control Port g004 Intergral Information Solutions ri l y i y if y Back Next gt Cancel Figure 5 Manually Configuring Ports Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option ASO Setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administration ED Manager The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances validate Password Intergral Information Solutions SS i lt Back Next gt Cancel ee a a Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long ANO Setup FusionReactor 4 5 0 Define user and group Which user and group should FusionReactor Admin
382. r to validate the server If the file directory entered contains a valid server the specified server will appear in the instance list under the Manage Instances section See Figure 2 along with any other identified servers and instances Select All instance instance Link 3 Adobe ColdFusion 10 C ColdFusion10 G O G O00 defaut E E Adobe ColdFusion 9 C CaldFusion9 O O G OG admin A O F 4 QO coldtusion coldfusion cimet int005f BO 3 5 5 Update l ix Apache Tomcat C apache tomecat 6 0 20 90 GOOG hetu 3 Apache Tomcat C apache tomcat 0 6 windows x 6 apache tomcat 7 0 6 GO 000 mai Figure 2 Manage Instances Scanning the System for New Servers Improved server detection Server detection for both Coldfusion and Railo Servers has been improved in 4 5 0 FRAM can scan the system for new servers and server instances You can specify a custom starting point by entering a full directory path into the starting from directory field or you can leave it with its default value which will search from the root of the filesystem the FusionReactor Administration Manager FRAM was installed into It will not scan multiple drives for example on Windows it will not scan cC then D and then E You can limit the search by specifying how many folders deep FusionReactor should search through See Figure 1 amp NOTE Please be aware that asking FusionReactor to search more than 3 or 4 levels deep on a
383. rapping them in the FusionReactor wrapper The page is broken down into 3 sections the first walks you through finding the JDBC URL for your target data source the second walks you through wrapping it and the last one gives you an example Locating your Macromedia s DataDirect ColdFusion Built in Drivers In the ColdFusion Administrator click on Server Settings in the table of contents then click on the Settings Summary link Locate the section with the heading Database amp Services and the table with the name Database Data Sources Locate the JDBC URL of the datasource that you want to wrap with a FusionReactor wrapper and then copy it or write it down SemvER SETTINGS Settings Request Tuning Caching Client Variables CF data source name cfartgallery Description Driver Apache Derby Embedded JDBC URL jdbe derby C ColdFusion9 db artgallery create false Usemame Memory Variables Mappings Mail Charting Long text buffer size 64000 Login timeout 30 seconds Font Management Timeout 1200 seconds Document Maintain connections Yes Java and JVM Interval 420 seconds Settings Summary Restricted SQL operations Your JDBC URL will most likely be different the purpose of the screen shot is to give you an idea of what to expect in the ColdFusion User Interface Wrapping your JDBC URL with FusionReactor Click Data and Services and then click on the Data Sources link Add a data source name
384. rce_method This is the HTTP method used on the original request e g GET POST since 3 0 1 e start_time This is the start time of the request from Epoch e g 1209376581900 since 3 0 1 If a request is queued due to Crash Protection this value represents the longest amount of time that the request will be held before FusionReactor abandons it The default value is 60 seconds Description CP Logging If Crash Protection Logging is enabled then Crash Protection information will be written to the Crash Protection Log If Disabled is chosen then Crash Protection information will not be written to the Crash Protection Log View Size KB This value indicates how much of the log file should be displayed when you view the Crash Protection Log from inside FusionReactor How do set up Notifications From the FusionReactor Administrator click Settings from the table of contents FusionReactor section and you will see the FusionReactor Settings screen The Email section of this screen deals with the notification Why would I want to enable Crash Protection There are many cases in which crash protection can be an invaluable tool These include Easing Support Crash Protection automates the manual process of checking each of your servers and verifying that they are operating within satisfactory parameters Instead of having to periodically go through each server you can have warnings sent directly to your inbox Request Bursts
385. ressions For more technical information on Regular Expressions please refer to the online Java documentation Add URL Exclusion Once you submit the form the page will be refreshed and your new exclusion will be listed at the bottom of the page Managing Existing Exclusions Below the Add Exclusion form you will see a list of all existing exclusions Each exclusion has two icons next to it Button Name Description P Modify Exclusion Clicking on this icon will take you to the Modify Exclusion page From this page you can change any of the information which is listed above New URL Exclusion gt Delete Exclusion Clicking on this icon will prompt you if you are sure you want to delete this exclusion If you OK the dialog then the exclusion will be removed from the Existing Exclusion list and the page will be refreshed Request Params imytoldermyfile cfm i Yes E imyioisenmys Content Filters Search and Replace Content Filter Restrictions Filter Settings Search and Replace The Search and Replace feature is arguably one of the most powerful features in FusionReactor It allows you to make temporary changes to your pages without having to modify source code Fix broken links spelling mistakes or html problems Search and Replace Filters enable you to change the content sent to the web browser by replacing or removing text on the fly The Search and Replace page has two main areas At the top of the page there is a
386. rics slowest requests request runtime request activity Once this button has been pressed it is grayed and disabled There is no way to reverse this operation Clear The Slow Requests list can be cleared completely by clicking the Clear History button Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh a are iSecond Lee ten eg Max Alloc Free Used 9 Total Memory KB 466 046 341 686 422 114 43 933 Time ms Memory KB 3 477 Cur 9 42 449 Free 473 598 Also See Metrics Settings Enable Metrics Longest JDBC The Longest JDBC page shows a list of the longest running JDBC requests on this server To change the size of the Longest Request list change the History Size value on the Metrics Settings page The Longest JDBC table has the following columns Name Description SQL This is the SQL which actually ran followed by a JDBC stack trace the list of CFCs and tags which were called to get to this query and finally you will see the URL which was called from the browser If the stack trace is longer than one line then it will be displayed collapsed Click on the line or the arrow to the left of the line to expand the stack trace
387. rise Scripting ina Nutshell 0 0 00 ec eens 257 Lok WWhEGATS EMC OnISG SCID ict aczen heen armen onan a gteea ak A Rie ee tca ha a a on Peete opened Mtn ete ga 257 1 5 1 2 How Do I Configure an Enterprise Script c2 25062pdedadeaiwah owe wted Na ewe Sha iad ae ea 258 1 5 1 3 When Does FusionReactor Run Enterprise Scripts 0 0 0 0 eee eee eens 258 1 5 1 4 How Does FusionReactor Run These Scripts 0 ccc eee eee eens 258 151 LOGGING SCKIDIS lt Seed oe te ate tease eh eee tees aon ae whee ated te E ie on T eee ated ha 259 1 5 1 6 Operational Impacts OF SCnpUNG sisia een vi dseuteat caulk owe ted ea aaa EE tnd Wad aarti ea 260 FSZ USIng ie Example Sorpe derde ae NE NE eda Ge wate batt E tae Gay hv Raketted bene eee te 261 126 FuSIOnReactor 4 5 xclInSiallavoOn Guide cernes tes Mca ete eh reese N care ae arduted Seg hehe ee Rea ated ge aa ene Pe 262 1 6 1 Installing FusionReactor on WINdOWS cc cceu rartenigedtad a eats tote tea bathe ttee tee es 263 1 6 1 1 Installing FusionReactor 4 5 x on Windows x 2 0c ip2cdcd dunwad poet as Sa toNG bee eda kates taka aees 264 1 6 1 2 Updating F sionReactor 3 xon Windows casacard ceca acatekets dargains faa ak Gath hatiatna aN ee Ra 275 10 10 Updating F sionReactor 2 0 0n Windows assess Sept Gok die eel no ae gee a SEA arn el Gh an yee hte Aca ee Pk 285 1 6 1 4 Updating FusionReactor 1 0 on Windows vic5 o0cceeta tee tek te taduies EIN oka dela PAN ek eA 286 126 125 GOnsole I
388. rotection once the number of simultaneous requests reaches this threshold further incoming requests cause this rule to fire e Memory Protection once memory has breached this threshold specified as a percentage of total further requests cause this rule to fire Using these rules either individually or in combination FusionReactor can keep a server alive in a marginal situation for much longer than it would otherwise be available In the vast majority of cases Crash Protection rules can keep a server up and responding long enough for the marginal situation to clear allowing processing to continue normally Survival Strategy Along with each rule it s possible to specify how FusionReactor will react when that rule fires the Survival Strategy The three available survival strategies are e Abort and notify once the rule fires mail is sent to the administrator and further incoming requests are aborted either with a fixed message or a URL redirect to a custom page e Notify once the rule fires mail is sent to the administrator and the request is allowed to continue normally e Queue and notify once the rule fires mail is sent to the administrator and the request enters a holding queue until the marginal situation is resolved The length of the queue by default 60 seconds can be configured To avoid a flood of email in marginal situations notification can be turned off completely or can be set to only se
389. rprise licenses If you start FRAM from the installer the Initial Server Scan wizard will pop up and the FusionReactor Administration Manager will attempt to scan for supported ColdFusion and J2EE servers For a detailed guide on this process please see Initial Server Scan If you go through the shortcut or direct URL the initial server scan wizard will not pop up and you will have to initiate the server scan yourself on the Instance Manager You are able to monitor any number of installed ColdFusion and J2EE servers To install a FusionReactor Instance click the Add Instance button next to the desired server instance you want to monitor Follow the Insta Il FusionReacior Instance guide for more detailed information Logging The logging functionality in FusionReactor is very powerful Lots of the data shown in the metrics within FusionReactor instances is stored in memory so it can be used to generate graphs and reports If a server was to crash or be shutdown this in memory data is lost however all of this data will have been captured to one of FusionReactor s extensive log files where you will be able to determine what went wrong On the Logging pages you are able to set up log rotation to send the logs to a FusionAnalytics Data Collector where you can have FusionAnalytics import the application log files into a SQL database The resulting data is processed by the FusionAnalytics Server and visualized by the FusionAnalytics Desktop app
390. rts Figure 5 Here you can configure the HTTP Port port to view FusionReactor in a web browser as well as configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications Click Next to use the port configuration you specified If you wish to use the default port configuration click Back and uncheck the Configure ports manually option ASO Setup FusionReactor 4 5 0 FusionReactor Administrator Password Please specify an Administrator password for FusionReactor Administration ED Manager The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances validate Password Intergral Information Solutions SS i lt Back Next gt Cancel ee a a Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long ASO Setup FusionReactor 4 5 0 Define user and group Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation The user and group selected here must have write privileges on your JZEE container s configuration files If you unsure use the same user your JZEE container runs as or root User nobody M Group bin M Intergral Information Solutions EEE ann peel
391. rts of the server process this in memory data is lost however all of this data will have been captured to one of FusionReactor s extensive log files This data can in almost all cases be used in a post mortem session to pinpoint the location of problems within a system In addition to immediate post mortem work the logs can also be used to analyze usage patterns trends and to derive longer term aggregate data As of FusionReactor 4 0 there are two styles of logging which is supported by FusionReactor You can change current logging method on the Log Seitings page If you wish to use the FusionAnalytics Connector then you must be using the Centralized Archive and Rotation logging method If you try to enable the FusionAnalytics Connector whilst in Traditional mode then you will be be notified that the logging method will need to change and be given the option of having FusionReactor automatically make that change for you Centralized Archive and Rotation If you install FusionReactor from scratch then this is the logging mechanism you will be using by default The idea behind Centralized Archive and Rotation is that you end up with a set of log folders named with a timestamp within the existing Log Directory specified on the Log Settings page that each contain a complete set of log files for a specified period of time You can choose whether a new folder be created every n minutes or you can specify a time at which the logs are dai
392. s Some of our customers have experienced stability issues with the standard drivers shipped with ColdFusion for example and while FusionReactor helped to pinpoint the problem it was ultimately resolved by trying an alternative driver For example many database vendors ship their own JDBC drivers and they are often very satisfactory for production use Installation in ColdFusion The FusionReactor JDBC Driver Wrapper is delivered as an integral part of the FusionReactor product and is located within the fusionreactor jar file which is installed during the FusionReactor setup process In order to use the driver with ColdFusion applications you need only to alter the Data Source definition within the ColdFusion administrator Wrapping or Adding a New Datasource If you are wrapping an existing datasource you should continue to follow the instructions in this section If you are starting from scratch skip ahead to Creating a New Wrapped Datasource in ColdFusion This guide walks you through locating the JDBC URL of your data source in ColdFusion and then wrapping them using the ColdFusion wrapper Locating your Macromedia s DataDirect ColdFusion Built in Drivers In the ColdFusion Administrator click on Server Settings in the table of contents then click on the Settings Summary link Locate the section with the heading Database amp Services and the table with the name Database Data Sources Locate the JDBC URL of the datasource
393. s Value Timeout Protection 8 seconds Exclude Regular Expression Timeout Protection scripts batchCleanUpDatabase js p db MyDatabase batch jsp Ignored If we wanted to include a specific host in Crash Protection only the following rule might suffice NB the alias testvm234 points to the same machine as the first URL Active Protections Timeout Protection 8 seconds Configuration Engine Mode Rule Protection Type Hostname Page Decisions Including a Specific Action Page Value Protect Regular Expression All Crash Protection Check http int0234 bbn intergral com tes tPage jsp http testvm234 bbn intergral com testPage jsp Int0234 bbn intergral com Protected Ignored The following rule specifies an action page with many parameters which normally takes a few minutes to complete when run in a certain mode We exclude it from Timeout Protection Active Protections Timeout Protection 8 seconds Configuration Value Engine Mode Exclude Rule Regular Expression mightyActionPage jsp action backupDb Protection Type Timeout Protection Parameters Check Page Decisions Protected Ignored Crash Protection Alerts Email Alerts How do I receive an email when Crash Protection is fired You can configure your FusionReactor instance to send you an email when Crash Protection is fired the Crash Protection Settings page explains how you can configure Crash Prot
394. s are evaluated from top to bottom and the first one which fires causes the engine to stop evaluating any further rules The Restrictions Engine matches each rule against components of the request URI The exact components used during the match are selectable using the fields on the rules form see Figure 1 The exact options available depend on the current mode of the engine in Protect mode the Statistics option is not available all requests which match a rule are tracked for timing statistics The labels used also change to reflect the mode of the system and the make the meaning of the rule easier to understand Request These two fields define the match mode of the rule and the actual match string The drop down box specifies whether the text field is an exact string match or whether the field contains a Java Regular Expression The remaining options tell the engine exactly which request fields to match against the entered string Hostname If enabled this field specifies that the string begins with a hostname This allows rules to target specific pages when addressed by multiple sites The value of this field should match the HTTP 1 1 Host header No scheme http or https should be applied This header is used by web servers browsers and J2EE containers to differentiate requests for multiple websites which may reside on the same physical system A later section will illustrate how to use this feature to protect only cert
395. s been reached E g notifyAfter 1000 remindAfter 100 actual rowcount 1350 Notification occurs at row 1000 reminders at 1100 1200 and 1300 inhibitReformat Value Boolean Default false When tracking queries the FusionReactor JDBC Driver Wrapper will reformat them for logging and presentation by attempting to make them fit on a single line This allows logs to be viewed more easily but may hinder developers who are used to seeing queries formatted a certain way as they are written in a ColdFusion page for example Setting this option to true stops FusionReactor JDBC Driver Wrapper reformatting statement text and allows multi line presentation in the FusionReactor interface and log logToFusionReactor Value Boolean Default true If set to true the default and the FusionReactor JDBC Driver Wrapper detects a running FusionReactor instance it will log the execution of a query to FusionReactors jdbc X log where X is the current rolling log number If this option is enabled and FusionReactor was not detected it has no effect interpretObjects Value Boolean Default true If set to true the default when a PreparedStatement attempts to bind an Object type to a positional parameter using one of the setObject methods the wrapper will attempt to interpret the data for logging and reporting purposes only by calling the toString method on the object This value will then be used in the log and Fus
396. s for FusionReactor 1 FusionReactor s Administration Manager FRAM usually on port 8087 requires write access to parts of the J2EE server in order to add itself as a monitoring element 2 Each FusionReactor instance in an installation requires read write access to the FusionReactor installat ion folder in order to for example serve HTML objects write persistent configuration and so on In a secure environment FusionReactor may be running as one user while the J2EE server runs as another This means that users may for instance see the following message when trying to install an instance Could not Update web descriptor opt coldtusion3 runtime servers coldfusion SERVER INF default web xml FusionReactor was not able to modify the J2EE web descriptor file because it s owned by a different user than that running the FusionReactor Administration Manager Solution The solution is to create a common group add both users to this group and use File Access Control Lists FACLs to grant access to both FusionReactor and the J2EE server to this group There is relatively low risk in this solution as it does not involve granting world Everybody permissions Only the two users will be able to access each others resources We have developed the following procedures for Linux Solaris and Windows The procedure does the following 1 Create a new group fusion to be a common group of both the FusionReactor runtime user n
397. s lost however all of this data will have been captured to one of FusionReactor s extensive log files This data can in almost all cases be used in a post mortem session to pinpoint the location of problems within a system In addition to immediate post mortem work the logs can also be used to analyze usage patterns trends and to derive longer term aggregate data Also See Importing and Graphing Data in Excel Methodology in OpenOffice where we used the request log with standard deviation to derive a nominal page run time value Getting Help Fusion Products Knowledge Base We provide a knowledge base full of technical articles and helpful hints at the following URL http Awww fusion reactor com fr support cfm From here you can search the support database see what s new what our hot issues are as well as finding online versions of our printed manuals Google Group We also provide a Google Group for the community to ask questions in http groups google com group fusionreactor We check and reply to this group regularly so it s also worth searching to see if your question has already been answered Support Mailbox You can also mail us FusionReactor questions at support fusion reactor com We can also provide software consulting services if you re having problems with your application http www fusion reactor com support supportservices cfm Logs Stack Trace Log stacktrace log About this log Every entry tha
398. s of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes Cy No n Enter Co NWsers qnourton Down loads gt y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionkKeactor Administration Mana ger L86087 G SUserssgmourton Doun loads gt The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function oHH4 J Figure 7 Manually Configuring Ports Figure 7 You must also configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications ch Administrator C Windows system32 cnn After install this will be available by default on port 6687 Configure ports manually Yes Cyl Mo En Enter gG SUsers gmourton Down loads y Manually configure the FusionKeactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana JEF L86087 Co NUsers qmourton Down loads gt The FusionkKeactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function HH4 Co NUsers qmourton Down loads gt Please specify an Administrator password for
399. s to the Macromedia Microsoft SQL Server driver option selectMethod This option controls how the driver and the database supply rows to your application and can have an impact on memory usage and JDBC processing speed We want you to make an informed decision about whether to apply this option and this section will provide an explanation about how this option works When You Can Use This Option This option is applied as a driver parameter in the JOBC URL for Microsoft SQL Server datasources It can be used with the Microsoft JDBC Driver 2000 and 2005 and the built in Macromedia driver Since itis a parameter to the underlying JDBC driver it must be supplied within the wrapped part of the URL Using the Macromedia Driver jdbc fusionreactor wrapper jdbc macromedi a sgqlserver int0007 1433 DatabaseName fr test SelectMethod cursor remindAfter 500 name SOLServerDataSource Using the Microsoft SQL Server 2005 JDBC Driver jdbc fusionreactor wrapper jdbc sqlserver gt int0007 1433 DatabaseName frtest Select Method cursor driver com microsoft jdbc s gqlserver SQLServerDriver Direct and Cursor Selection Modes If this option is not specified in the JDBC URL it defaults to direct Direct Selection Method When the driver is operating in direct mode select statements are processed like this e Application performs an SQL select e JDBC driver transfers the request to the database e Database performs the
400. s valid and produces low server overhead in memory and CPU cycles However this redirection method can only be used if the HTTP response headers have not yet been committed If a page has already begun streaming body data the thread will be aborted as normal but the redirection will not occur If page design takes this into account by performing business logic before display logic this is not likely to become a problem Stuck Threads If your redirection target lies within the same J2EE container which caused the redirection the problem outlined in J2EE Containers and Dead Threads see page 9 can occur If the J2EE container picks the newly stopped thread to serve your redirection target without first checking that the thread is runnable a 500 Server Error can occur Crash Protection Restrictions Finally you may like to add your redirection target as a rule in the Crash Protection Restrictions engine in order that it will be ignored by Crash Protection if it occurs Understanding Crash Protection Restrictions Modes Rule Basics Examples of Restrictions e Excluding Batch Jobs e Including Specific Hosts e Including a Specific Action Page Modes The Restrictions Engine decides which requests will be monitored by Crash Protection and which requests will be allowed to proceed unobserved The engine is configured in FusionReactor Administrator in the Crash Protection Restrictions section of the CP Settings page Any changes
401. sc Unsafe park Unsafe java Nati ve Method java util concurrent locks LockSupport par k LockSupport java 158 java util concurrent locks AbstractQueuedS ynchronizerSConditionObject await Abstract QueuedSynchronizer java 1925 java util concurrent DelayQueue take Delay Queue java 160 java util concurrent ScheduledThreadPoolEx ecutorSDelayedWorkQueue take ScheduledThre adPoolExecutor java 583 java util concurrent ScheduledThreadPoolEx ecutorSDelayedWorkQueue take ScheduledThre adPoolExecutor java 576 java util concurrent ThreadPoolExecutor ge tTask ThreadPoolExecutor java 947 java util concurrent ThreadPoolExecutorSWo rker run ThreadPoolExecutor java 907 java lang Thread run Thread java 619 Thread ID Java2D Disposer Priority 10 Hashcode 1785106435 java lang Object wait Object java 77 Nat ive Method java lang ref ReferenceQueue remove Refere nceQueue java 118 java lang ref ReferenceQueue remove Refere nceQueue java 134 sun java2d Disposer run Disposer java 125 java lang Thread run Thread java 619 Running Requests Full Details Request Protection FusionReactor Crash Protection Alert HP Pdv6 Laptop Hello this is the FusionReactor Crash Protection agent at HP Pdv6 Laptop instance coldfusion cfimx9 HP Pdv6 Laptop http HP Pdv6 Laptop 8088 fusionreactor f html cfim mode main The following alert was generated at Tue May 15 10 47 35 CEST 201
402. scription This will be the email address which notification emails will be sent from This is the email address which will receive FusionReactor notifications Enter your email server here This can be entered either as a machine name or an IP address A NOTE If your SMTP server does not use port 25 default you can specify a port number after the server address IP address for example mail company com 587 NOTE If your mail server requires authentication you can specify a user name and password in the format user password mail server This email interval specifies the minimum number of minutes between Crash Protection notification emails If you are experiencing regular difficulties with a server then use this option to avoid filling your email inbox Notification This lets you completely enable or disabled email notification FusionReactor Web Root Configuration Description Web Root This will be the prefix for FusionReactor requests If the web root was set to fusionreactor and you were accessing the internal web server on a local machine over port 8088 then your final URL would look like this http 127 0 0 1 8088 fusionreactor FusionReactor Log File Configuration Description Logging Choosing Enabled will allow FusionReactor logs to be written choosing Disabled will prevent them from being written For information on FusionReactor logs see the Log section View Size This option allows
403. se be careful when enabling this feature and do not leave it enabled if you are not monitoring it How do set up Request Capture From the FusionReactor Administrator click Request Settings from the table of contents Requests section and you will see the Request Settings page Scroll down until you reach a section named Request Content Capture From here you can control the request capture feature Request Capture can be in three states Disabled Capture Requests only or capture both requests and responses The Capture Path is the directory into which the captured requests will be stored Why would I want to Capture Requests Request capture can be useful for a variety of reasons from technical to legal these include Analysis The FusionReactor stored requests hold much more information than you would normally expect to find in web logs and as such they have a much higher value for analyzing your application traffic Development You could use stored requests in order to be able to reproduce specific load conditions or test cases Support Anyone who has had to have a user describe the contents of their screen will instantly realize how much easier life would be if you had an exact copy of their response in easy access Enterprise Enterprise Dashboard Manage Servers Manage Groups Enterprise Settings Using Monitored Server Scripts Enterprise Dashboard The Enterprise Dashboard lets you track the state of installations on one
404. se read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before INTERGRAL SOFTWARE END USER LICENSE AGREEMENT EULA IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT ON OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGREE TO BE BOUND BY THESE TERMS THEN DO NOT INSTALL COPY DOWNLOAD OR OTHERWISE USE THE SOFTWARE THIS EULA SHALL APPLY ONLY TO THE SOFTWARE I accept the agreement I do not accept the agreement Intergral Information Solutions Figure 3 License Agreement Figure 3 Please carefully review the license agreement then choose the accept the agreement option if you accept the terms and conditions click Next to proceed Press Cancel if you do not accept the license agreement to exit the setup wizard FusionReactor Administration Manager The FusionReactor Administration Manager will be installed enterprise edition After install this will be available by default on port 8087 F Configure ports manually fusion m A kredctor Administration Manager Intergral Information S
405. se to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 2 0 on Linux Upgrade Not Possible FusionReactor 4 x x does not support upgrades from FusionReactor 2 x If you currently have FusionReactor 2 x installed it is not possible to upgrade to FusionReactor 4 x x When running the FusionReactor 4 x x setup you will be presented with a screen similar to that shown in Figure 1 below Setup FusionReactor 4 5 0 FusionReactor already installed Setup has detected a previous version of FusionReactor Setup has detected that an older version of FusionReactor 2 0 4 Is installed in opt fusionreactor The FusionReactor 4 0 0 installer does not support updating that version You must uninstall the older version of FusionReactor before restarting this installer Figure 1 Update Not Supported To install FusionReactor 4 5 x you must first uninstall FusionReactor 2 x and then run the FusionReactor 4 5 x Setup again Please follow the guide on how to Uninstall FusionReactor 2 x on Linux Updating FusionReactor 1 0 on Linux Upgrade Not Possibl
406. sent to FusionAnalytics targets by FRAM If FRAM is not available falls back to Sent to targets by this instance Sent to targets by this instance Log files are compressed and sent locally Sent by this instance uncompressed No compression is performed Each log file is sent to FRAM or FusionAnalytics directly and uncompressed Disabled The FusionAnalytics Connector is disabled No log files are sent to FusionAnalytics The different modes are described in more details on the page covering the FusionAnalytics Settings FRAM Service If the above Connector mode is set to Sent to targets by FRAM the FRAM Service is responsible for compressing and sending the log files to the defined FusionAnalytics DataCollector targets This allows the processing to be offloaded from the instance onto FRAM The FRAM Service is by default set to the FusionReactor Administration Manager that created the FusionReactor Instance In the above screen you are able to Edit Figure 5 Check Figure 6 Remove Figure 7 and Add Figure 8 a FusionReactor Administration Manager target FusionAnalytics Targets A FusionAnalytics target is the final receiver of log files This is a FusionAnalytics DataCollector that processes the generated log files in FusionAnalytics To enable log files to be transferred from FusionReactor at least one FusionAnalytics DataCollector Target must be defined You are able to Add Figure 9 3 Edit Figure 10 6
407. server is having problems then the color of the icon will change and a small warning panel will be displayed to let you know what the problem is How Do I Add Machines There are three ways to add servers to your Enterprise Dashboard Firstly you can import servers from your Inst ance Manager Secondly you can get FusionReactor to scan its machine for servers or you can simply insert the URL of your server into the Manage Servers page Server Icons The server icon shows four bars These bars each have a letter above them to indicate what is being displayed coldfusion ctx These bars are Bar Name Description M Memory This represents the amount of memory currently being used by this server C CPU This represents the amount of CPU time used by this instance since the last CPU value was measured It is expressed as a percentage of the total CPU time across all CPU cores that was available during that period R Request Time D DB Time This represents the average request time on this server over the last 60 seconds This represents the average time spent on DB operations in the last 60 seconds Clicking on a server icon will display the Server Information Pane which will display statistics about the server By default the server icon will be displayed in blue but if there are any problems with the server then the color of the icon will change and a small warning panel will be displayed to let you know what the
408. sion Administrator s Data Sources section Here s ours Data amp Services gt Datasources gt Microsoft SOL Server bicos SOL Server Wien CF Data Spurga Name itest Database ite st Sarees fmo S Por 1433 Pitasoni oo i character limit D toipthi n You can see that the example will use a built in Macromedia driver to connect to the frtest SQL Server database on int0006 In order to have FusionReactor gather metrics for this connection we must wrap the driver This will involve converting it to an other type driver In order to wrap the driver you ll need to obtain the JDBC URL for your existing datasource The easiest way to do this is to click on Server Settings gt Settings Summary then scroll down until you find the existing datasource Copy the JDBC URL frtest CF data source name frtest Descrpiion Driver MSSOLServer JDBC URL jdbcomeacromediacsgiserver int0006 1433 databaseName f Usemame a Login timedcut 30 pecami Long text buffer size 64000 Tirmecut 1200 seconds Maintain connections Yas Interval 420 seconds Restricted SOL operations Disable connections Mo In ColdFusion Administrator add a new driver called frtest wrapper of type other In the JDBC URL field you will enter the JDBC URL you copied from the Settings Summary page earlier wrapped using FusionReactor s JDBC Wrapper syntax more details below You can refer to the FusionReactor JDBC Driver Wrapper User Guide to g
409. sionAnalytics Settings page for the instance coldfusion cimxs INTOOS5F Finish Figure 13 Configuration is complete Figure 13 The FusionAnalytics Connector has been configured for the specified FusionReactor Instance Make sure that the configured FusionAnalytics Server is running and correctly configured before transferring logs Click Finish to return to the Instance Manager Update FusionReactor Instance Inside the Instance Manager you will be able to update any FusionReactor Instance if it has a previous version of FusionReactor installed To do this click on the F button next to the desired FusionReactor instance or click the F button in the rightmost column header You need to tick the check boxes of the desired FusionReactor Instances or click the hyperlink Select All if you use the button in the column header You can also click the U pdate hyperlink next to the version number of an instance that can be updated If FusionReactor was installed on a server as a split jar install according to Technote FRS 240 it needs to be correctly updated Please follow the guide described in the following Technote FRS 258 to successfully update FusionReactor coldfusion cimxs INTOO45F This instance is running Attempt to stop the server instance coldfusion in Adobe ColdFusion 6 C ColdFusion automatically Figure 1 Server Instance Running Figure 1 If the server instance you are attempting to u
410. sionReactor Administration Manager For more information about locking the FusionAnalytics Connector Settings please see the information about Locked coldfusion cimxs INTOO5F Connector Mode Sent to targets by FRAM Controls how the FusionAnalytes Connector will handie log files for kansier to FRAM or FusionAnalytics DstaCollector ve kg x htte127 0 0 1 808 7 fusponreactorfrest cfm The URL of a single FusionReactor Adminisiration Manager server which will handle log archiving and transfer for this instance a No FusionAnalytics DataCollector defined Click the plus sign above to add a target Jern o more URLs which poini fo FusionAnalytes DateaCollectors These will be fhe recipients of archives processed by the FusionAnalytics Connector We recommend all targets are tested before proceeding Save Connector Settings Figure 4 FusionAnalytics Settings Figure 4 On this screen you have the opportunity to modify the different targets involved in transferring log files to FusionAnalytics as well as how the log files should be transferred Click Save Connector Settings to save the configured settings and finish the wizard Figure 13 Click Back to return to the previous screen Figure 3 FusionAnalytics Connector Configuration Description Connector Mode This mode controls how the log files are being transferred to the FusionAnalytics DataCollector Sent to targets by FRAM Log files are compressed and
411. sionReactor Click Cancel to exit Setup Intergral Information Solutions Figure 3 Update the Current Version Figure 3 If there is already a version of FusionReactor 4 0 x on your computer that has been installed with the FusionReactor 4 0 x Setup you will see a screen similar to the one shown Carefully read the information and click Next to proceed with the update Click Cancel to exit the installation wizard Setup FusionReactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions Figure 4 Ready to Install The FusionReactor Setup can create a shortcut on the Desktop to FRAM if you do not want Setup to perform this action uncheck the option Create Desktop Shortcut to FusionReactor Administration Manager Setup can also automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin updating to FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Setup FusionReactor 4 5 0 Installing ED P
412. sionReactor Otherwise click Cancel to stop the uninstall ANC FusionReactor 4 5 0 Uninstall FusionReactor Uninstall Please wait while FusionReactor is removed from your computer Uninstalling FusionReactor 4 0 0 Figure 3 Uninstall Progress Bar Figure 3 Once you have clicked Next the FusionReactor uninstaller will begin to uninstall FusionReactor and all of the installed FusionReactor instances D The instance coldfusion of Adobe ColdFusion 9 Applications ColdFusion9 needs to be manually stopped to completely remove FusionReactor Please shut the instance down and press Continue once you have ensured the server is stopped Continue Figure 4 Stopping a Server Instance Figure 4 If there is a FusionReactor instance that is running the server container for this needs to be stopped in order to successfully remove the FusionReactor Instance Stop the server on which the FusionReactor instance is installed and press Continue once ensured the server is shut down or press Continue if you do not wish to stop the server As stated at the top of this page not stopping the server container means that FusionReactor and all of its components will not be completely removed from the target server This may cause issues on the corresponding server FusionReactor 4 5 0 Uninstall FusionReactor Uninstall FusionReactor was successfully removed from your computer SS Finish Figure 5 FusionReactor Uninsta
413. sionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana ger 8087 The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Figure 6 Manually Configuring Ports Figure 6 You must also configure the Control Port used to listen for shutdown commands It is important not to use ports that are already in use by other applications vmuser ubuntu Downloads After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Figure 7 Administration Manager Password Figure 7 Here you will be asked to specify a password for FRAM s Administrator account It must be longer than 5 Characters vmuser ubuntu Downloads Configure ports manually Yes y No n Enter y Manuall
414. st change the History Size value on the Metrics Settings page The Longest Requests table has the following columns Name Description Finished The time at which the request was completed Ret Code IP The final HTTP return code of the request and the IP address of the caller If the request was killed or if it triggered Crash Protection then you will see a note here letting you know what happened ID The request ID and the name of the thread which is servicing the request URL Parameters The URL path and parameters passed to the request You can turn on or off the hostname in the URL by modifying the URL Format value on the Request Settings page Time ms The number of milliseconds that the request took to complete If available then you will also see the amount of actual CPU time that this request required below it Memory KB A snapshot of the state of system memory at the time the request was started The following values are shown Used memory as a percentage of the total available to the JVM the actual used memory value in KB and the margin of free memory available before the JVM must extend its own heap if it has not already reached its limit Sorting Requests You can change the order in which requests are displayed on this page by clicking on any of the column titles Clicking on a title for a second time will reverse the order on that column Managing Requests Each request listed on this page has two icons next to
415. stances visible on this instance s Enterprise Dashboard e Add instances visible on this instance s Enterprise Dashboard if they have the Administrator account password for the instance they wish to add Online and Offline Servers in the Enterprise Dashboard Configure Crash Protection and all other settings for this instance of FusionReactor Managing Their User Account and the Observer Account Examine All Request and Metric Data for this instance Kill Running Requests Who should use the Manager Account The Manager account should be used by users who need to manage or administer an application server For example in hosting environments this account might be used by the customer s application administrator Observers Observers are only able to view the following information on a specific instance Note some features are only available on Enterprise Versions View the Running Request View the Request History View the Request Log View the Enterprise Dashboard View the System Metrics View the Longest Requests Slow Request and Longest JDBC Request Reports View the Resource Reports and Graphs View the Resource Log Crash Protection Log and JDBC Log View the Help and About Information Who should use the Observer Account The Observer account should be used by users who need to examine the performance and metrics from an application server For example in hosting environments this account might be used by the customer s app
416. stration Manager Yes y Enter No n Figure 11 Ready to Install Figure 11 Here you will be given the choice of starting up the FRAM service Either entering y or pressing enter will start the service while entering n will not start the service FRAM can be started manually after the installation has finished E Administrator C Windows system32 cmd exe Yes y Enter Mo n Co Wsers qmourton sDown loads gt Extracting files Configuring FusionReactor Starting FusionReactor AM Service Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager Cavallable on port 86087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager The FusionkReactor Administration Manager URL http 7 127 60 6 1 560867 fusionreactor fhtml cfm mode main Finishing installation Co Users qmnourton Down loads gt Co Users qmourton Down loads gt _ Figure 11 Finish Screen Figure 11 You have successfully installed FusionReactor Open the URL to go to FRAM Updating FusionReactor 4 0 x on Windows Executables Executable System Architecture FusionReactor_windows 4 5 0 exe 32 bit FusionReactor_ windows 4 5 0 x64 e
417. t Please specify an Administrator password for FusionReactor Administration F The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Ci Users qmourton Down loads gt Walidate Password Co Users qnourton Down loads gt The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service Con port BAET Create a Desktop Shortcut to FusionReactor Administration Manager Yes y Enter No n Figure 10 Create Desktop Shortcut Figure 10 Here you will be asked whether or not you would like to create a Desktop shortcut Pressing enter or entering y will create the shortcut while pressing n will not Ee Administrator C Windows system32 cmd ex Co Users qmourton Down loads gt Please specify an Administrator password for FusionReactor Administration Manage F The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionkReactor instances Password C2 Users qmourton Down loads gt Validate Password C2 Users qmourton Down loads gt The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service Con port 8HBY gt Create a Desktop Shortcut to FusionReactor Administration Manager Yes Ly Enter Wo n Co wWsers gqmourton Down loads gt Start FusionReactor Admini
418. t Manage Servers page then clicking on the Modify icon of the required server You should take care to ensure the full path and filename to the script are correct Also note that it is recommended to only configure one script for a server If the same server has multiple scripts configured for example you have entered the server into the dashboard in multiple groups or you monitor the same server from different machines then more than one script may be launched at the same time if the server has problems The scripts may interfere with each other especially if they are trying to restart the same instance When Does FusionReactor Run Enterprise Scripts Enterprise Scripts are run whenever the Enterprise Monitor detects that a monitored instance has changed state e an instance which was previously available is no longer providing Enterprise data e an instance which was previously unavailable has begun to provide Enterprise data Scripts are run only if an instance changes state while it is being observed Additionally scripts are only run if e The Enterprise Server Alerting system is running e This is configured in Enterprise Settings gt Server Shutdown Start Up Alerts e At least On Shutdown must be selected e lf you wish to run scripts when an instance becomes available On Shutdown and Start Up must be selected e If you do not wish to additionally receive email for these events disable notification in FusionReactor gt Settings
419. t enter a password for an account during the installation process the account will be disabled You can enable the account at any moment by entering a password for the account on the Change Password screen amp NOTE When you enter password and click on the Save Password button the account becomes active immediately Regular Expressions Regular Expressions and Restrictions Regular Expressions and Content Filters Regular Expressions and Restrictions Regular Expression Restrictions for FusionReactor use the Java 1 4 RegEx language For more technical information on Regular Expressions please refer to the online Java documentation Quick Overview of RegEx Special Characters RegEx Description matches any character d matches any digit w matches any word character a zA Z_0 9 s matches any whitespace character contents define a character class abc matches a b or c abc matches anything except a b or c alternation operator or X Y matches X or Y X matches X once or not at all x matches X zero or more times matching as much as possible X matches X zero or more times matching as little as possible X matches X one or more times grouping characters 2i Example Restrictions RegEx myfolder myfile cfm myfolder myfile jsp cfm jsp myfile cfm mode add patch 0 9 cfm 2i batch 0 9 cfm Common Issues when using with FusionReactor start
420. t is written to this log file contains a Stack Trace of all running Threads on the JVM that your server is running on Each entry provides a very detailed snapshot of the state of your server at that specific time this information can be used to aid you diagnose issues that you are having with your server The log file is formatted as follows Field Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Date Time ms 3 C This is the millisecond time at which this entry was written Requester 4 D Whatever requested the log entry e g Crash Protection Stack Trace 5 E This is a Stack Trace of all running Threads on the JVM that your server is running on at the time this entry was written This field consumes a lot of space as the information here is typically used for diagnostic purposes When are entries added to this log file m When Crash Protection is triggered When you navigate to Resources gt List All Threads and then click on the button that contains the text Stack Trace ALL When you navigate to Requests gt Running Requests and click on the button that contains the text Stack Trace ALL When you navigate to Requests gt Running Requests navigate to a running request and click on the this 2 button D Where can I find my stacktrace log file Navigate to lt FusionReactor_Home gt instance w
421. t of collection memory used The amount of collection memory committed for the JVM to used The amount of collection memory initially requested from the OS by the JVM The total amount of collection memory that can be used for memory management The number of times that the JVM has detected that the memory usage has reached or exceeded the threshold The collection usage threshold value of the memory pool If the memory usage of the memory pool has reached or exceeded the threshold count If it has exceeded the value will be 1 otherwise it will be 0 The amount of memory used The amount of memory used The amount of memory committed for the JVM to used The amount of memory initially requested from the OS by the JVM The total amount of memory that can be used for memory management The number of times that the JVM has detected that the memory usage has reached or exceeded the threshold The usage threshold value of the memory pool Is Usage Threshold Exceeded 23 W If the memory usage of the memory pool has reached or exceeded its usage threshold value If it has exceeded the value will be 1 otherwise it will be O Peak Memory Usage Used 24 X The peak amount of memory Percent used Peak Memory Usage Used Bytes 25 Y The peak amount of memory used Peak Memory Usage Committed 26 Z The peak amount of memory Bytes committed for the JVM to use Peak Memory Usage Requested 27 AA The pe
422. t or other proprietary notices Legends symbols or Labels in the Software This EULA does not authorize you to use INTERGRAL s or its Llicensors names or any of their respective trademarks I accept the agreement Yes 1 No 2 l1 Where should FusionReactor be installed fopt fustonreactor Figure 3 Installation Directory Selection Figure 3 Now you have to select where FusionReactor is to be installed By default pressing enter directly FusionReactor will be installed into opt fusionreactor Jerminal File Edt Miew Terminal Tabs Help names and Logos may be the trademarks or registered trademarks of thelr respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices Legends symbols or Labels in the Software This EULA does not authorize you to use INTERGRAL s or its licensors names or any of their respective trademarks I accept the agreement Yes 1 No 2 1 Where should FusionReactor be installed fopt fusionreactor The FustonReactor Administration Manager will be installed The FusionReactor Administration Manager FRAM 1s being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 8087 Configure ports manually Yes y No n Enter Figure 4 FusionReactor Administration Manager FRAM Fi
423. t td gt requestArray i wasQueued lt td gt lt tr gt lt cfoutput gt lt cfloop gt lt table gt Setting a request s crash protection timeout The following code will change the timeout setting for Crash Protection for this request lt cfset frapiClass createObject java com intergral fusionreactor api FRAPI gt lt cfset frapi frapiClass getInstance gt lt Force Crash Protection to 10 seconds for this page gt lt cfset frapi setPageTimeout 10000 gt ee l Pe ee ee ee eee ee ee ee ee ee ee esse ee lt cfset frapiClass createObject java com intergral fusionreactor api FRAPI gt lt cfset frapi frapiClass getInstance gt lt Set a marker gt lt cfset frapi trace Hello World gt After this page has run if we go into FusionReactor and look at the request details for this request we fill see this marker listed along with the time at which it was set Requests Request Detail Finished Ret Code IP ID URL Parameters Time ms Memory KB 1836 28 50 5 109 Cur 24 858 l f 0 0 1 pi webi http 1 27 0 0 1 8500 markerTest cim J Free 158 701 User Trace Markers 0 FRAPI UserTrace Generationvime 16 38 28 427 28 Apr 2006 Message Hello World The ability to set markers within your pages has many useful purposes including following the path of execution measuring execution time or simply outputting debug information without changing the final outp
424. t tee eee tot cen ie Nate E Goreng Sua Mca Ces uate opt anaes Son oe ete oe ogee E AAA Ceeh 50 kkoo 2 HEAD and NOM TOAD oeeie e Mister crest a A are ean aati Sen Meet te ng a ate nae acerca as 51 tekaa oa FOES Ol WIGINOY GIADNS 2 2 5 adie deri E Gea Say Cees eat ae Soph anes Sn aad etute Oar nan diaper ee eee 53 RRO Os Cs GAP even cea ordered aes Sep E E E tines oem ce ch et ae siete d Sy hc nee ati nat aaa de a Ane 55 ERST WAST AW INC ACS sg dese erdatitcn Sot tet ec tees tice dr ced ayant eters Sa ca Oars eae dna enter Shan hn aon anata Ae tee a 56 LOO SS OUNCE SONOS mirar oe Gaus a pte E ah ee xargs a te Ace Sach eet a ued E ach hyn ae ait anata de aa Anata 57 Teo IROSO LOG FESOUCONOG orae dein cata wh ter siete EE N ah Cantar A eh deg ee Sm Me acetate var E ae dn tp eee 58 MT eed ORATION OSs a ese m Seige ec cast Sect cca dan cia ct cep Sia Otc 8S cave pha gah ca ape cc E a ge cg ae cine ces Maer eens th 61 1 1 5 10 1 Memory Heap and Non Heap Log memorysummary l0g 000 eee eee 61 Leto TYDES Or MEMO LOGS cszditus Masia tues E E EN wt ao ane gta e ae deh Manat carat ce hat ghee E E en 63 i541 eG PUstnread og Cputhread 0G 2c nese ea sete 275M hte thoes tue a Beted ao eda Gee Sow aaa ee Be end dn Me ta Po 66 TV OsGAShV PIOICCUON araara wi an eae oe eee teh aden Date wi anatase aa ow hah at Gate S Syn Wace wet anon aaa ka Ane 69 11 Ov Gras NOleCHON ROSMON 5 96 csi teis toca wh ar siete nee ogee te eas Ch pice ee aaa caer ad hae
425. t the JDBC Time and Activity graphs as well as Average DB Time will not reflect them Once this button has been pressed it is grayed and disabled There is no way to reverse this operation Displays a stack trace of all currently running requests The stack trace is colorized to ease recognition of each part Allows the user to kill all currently running requests There is an intermediate screen which allows the user to select whether the request are to be excluded from tracking default or not The Kill ALL and Kill Request buttons do not give requests the opportunity to complete in their own time Using this feature can theoretically cause your application to become unstable because all locks are immediately relinquished by the thread when it s killed Any data protected by these locks will retain the state it had when the thread was killed You might consider this a small price to pay to keep your server up though Refreshing the Page At the top of the page you will see the standard page header At any time you can click the refresh button to update the main content Alternatively you can select a time period from the drop down box to update the content automatically Selecting None from the drop down box will stop the automatic refresh Below is a screen shot showing this 1 Second it pan eo Max Alloc Free Used 9 Total Memory KB 466048 341 888 422 114 43 933 Time ms Memory KB 3 407 Cur 9
426. tance click Next to advance the wizard to the next FusionReactor instance See Figure 1 If this is the last instance to be removed clicking Next will display the finish screen as displayed in Figure 7 Remove FusionReactor Instances x Figure 7 FusionReactor Instance Removed Figure 7 FusionReactor has been uninstalled from the selected server instances Click Finish to return to the Instance Manager Edit FusionReactor Instance Inside the Instance Manager you will be able to edit any FusionReactor Instance listed To do this click on the a button next to the desired FusionReactor instance or click the 4 button in the rightmost column header You need to tick the check boxes of the desired FusionReactor Instances or click the hyperlink Select All if you use the button in the column header coldfusion cfmx9 intergra 6jsuuz IP Address lil ees The IP address used fo access fhe instance Listen on all mal addres ses if checked FusionReactor s niemal webserver wil isien on af IP addresses Port ROBB The pon number of the Bbulln web server of fhe instance This must be unused and between T and 32767 Enable Webserver Wf Enable fhe FusionReactor intemal web sener Listen on external web server if checked FusionReactor wil be accessible from the JZEE fextemal web server Skip Modify Instance Figure 1 Edit Instance Properties Figure 1 For each FusionReactor Instance you can edit
427. tances of FusionReactor with versions prior to 4 These must now be updated coldfusion ctmxS int0O45t coldfusion ctmxs INTOO5SF Update Instances Figure 1 Instances that can be updated Figure 1 You are shown a list of all the instances that can be updated to the latest version of FusionReactor This list contains the FusionReactor instance name and the version of FusionReactor currently installed into these instances Click Update Instances to continue and update all of the listed instances The Instance update process is covered by the online documentation Update FusionReactor Instance Click Cancel if you do not wish to update all of the listed instance at this point It s important to note that your original 3 x instances might continue to run but they should be updated as soon as possible FusionReactor doesn t support a mixed configuration of 4 x and pre 4 x instances Add Server amp Scan System Adding a Server Instances Instance Manager Add Sever Macromedia ColdFusion Mx 6 server Root Directory scan System starting from directory not exceeding 2 sub directory levels Figure 1 Add Servers To add a new server to the Instance Manager select the type of server you want to add from the drop down box and then enter the file path to the root directory of the server You must enter the full path for example Cc CFus i onMX Clicking the Add Server button will cause FusionReacto
428. tatements 100 O rowLimit 10000 Submitting that form will make sure the syntax is correct The Driver Wrapper will now limit the number of returned rows to 10 000 If we run our rogue page again we can see that it only reads 10 000 rows at which point the Row Limiter activates to prevent the query running away Total Exec Row Time Time Count Query Time 1 select from usr u obj l S 36 39 403 3391 31 10000 and the JDBC Details page for the request also reflects the limit Using FusionReactor Enterprise Scripting Introducing FusionReactor Enterprise Scripting FusionReactor Enterprise Scripting available as part of the FusionReactor Enterprise Edition enhances FusionReactor s Enterprise Monitoring to trigger configurable scripts when a server s responsiveness status changes This feature can be used to perform any task which can be launched from a platform script Examples might include e Interacting with SNMP or enterprise monitoring reporting systems e Performing automated restarts of affected instances e Sending custom email messages e Writing custom log messages Since FusionReactor Enterprise Scripting is able to launch any platform executable shell script executable binary etc it may be tailored to virtually any environment Intended Audience This technical document is targeted at FusionReactor administrators who are responsible for monitoring one or more FusionReactor servers using the FusionR
429. tation e Implementation e Abort Strategies Explained e Risks and Restrictions of Request Abort e The Crash Protection Restrictions Engine e Crash Protection Restrictions Engine e Customer Demographics e Restrictions Engine Rules Crash Protection In Action e Test Pages e Exercising Timeout Protection e Exercising Memory Protection e Exercising Request Quantity Protection e Using the Queue Strategy Using the Redirect Method e Best Practices in Redirection Understanding Crash Protection Restrictions e Modes e Rule Basics e Examples of Restrictions e Excluding Batch Jobs Including Specific Hosts e Including a Specific Action Page Crash Protection Alerts e Email Alerts Crash Protection Basics Design Goals e Common J2EE Problems e Types of FusionReactor Crash Protection e Survival Strategy Crash Protection Implementation Implementation e Abort Strategies Explained e Risks and Restrictions of Request Abort The Crash Protection Restrictions Engine e Crash Protection Restrictions Engine e Customer Demographics e Restrictions Engine Rules Design Goals Common J2EE Problems Types of FusionReactor Crash Protection Survival Strategy Common J2EE Problems Crash Protection attempts to keep your server alive by watching for and preventing or minimizing the effects of three scenarios which we identified as being common causes for outages e Requests taking too long are often an indicator of poor cod
430. te that the format of Stack Traces may alter depending on your operating system or Java version Generally you will see a list of class names method calls and line numbers The most current list item will be listed first Killing a Thread or Request If you click on the Kill button then you will see a prompt asking if you are sure Click the OK button in this dialog box to kill the request or thread WARNING The Kill button does not give a request the opportunity to complete in it s own time it forces the request to end immediately Using this feature can cause the JVM to become unstable Also while FusionReactor does allows you to stop any thread it is highly inadvisable to stop any threads in the system thread group or any threads integral to the running of your J2EE container Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Request Detail Page You can get to the Request Detail page from any page which lists requests Running Requests Request History Longest Requests Slow Requests and pages linked from Request Metrics Clicking the Request Details logo by a request will take you to a page which contains the following tabs AMF The Tabs At the top of the Request Details page you will see a copy of the request line from the page you came from Underneath that there are six tabs Name Description Main The Main tab shows general information
431. tform yee solaris The FusionReactor Setup will install the FusionReactor Administration Manager FRAM FRAM provides a completely isolated instance of FusionReactor which is just for monitoring and instance management it will continue running even following a JVM crash FRAM manages and keeps track of all servers and instances so you can quickly and easily install FusionReactor across your environment The Setup also allows you to update or reinstall an existing installation of FusionReactor 4 5 x as well as update an old version of FusionReactor that has been installed with the 3 x installer The FusionReactor 4 5 x Setup does not support updating previous installations of FusionReactor 2 or FusionReactor 1 Installing FusionReactor on Solaris Installing FusionReactor 4 5 x on Solaris Updating FusionReactor 3 x on Solaris Updating FusionReactor 2 0 on Solaris Updating FusionReactor 1 0 on Solaris Console Installation on Solaris Installing FusionReactor 4 5 x on Solaris Executables Executable System Architecture FusionReactor_solaris_sparc_4_5_0_x64 sh SPARC 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable yee solaris Setup To start the installation login as user root and run the appropriate executable as described in the above section Executables If you can not use an X Windows session you must install FusionReactor
432. that you want to wrap with a FusionReactor wrapper and then copy it or write it down cfartgallery Settings Request Tuning Caching Client Variables CF data source name cfartgallery Description Driver Apache Derby Embedded JDBC URL jdbe derby C ColdFusion9 db artgallery create false Usemame Memory Variables Mappings Mail Charting Long text buffer size 64000 Login timeout 30 seconds Font Management Timeout 1200 seconds Document Maintain connections Yes Java and JVM Interval 420 seconds Settings Summary Restricted SQL operations Your JDBC URL will most likely be different the purpose of the screen shot is to give you an idea of what to expect in the ColdFusion User Interface For the purpose of this example our JOBC URL will read jdbc macromedia sqlserver int0006 1433 d atabaseName frtest sendStringParametersAsU nicode false MaxPooledStatements 1000 Wrapping your JDBC URL with FusionReactor 1 Click Data and Services and then click on the Data Sources link 2 Add a data source name This page walks you through locating your Macromedia DataDirect ColdFusion Drivers and wrapping them in the FusionReactor wrapper The page is broken down into 3 sections the first walks you through finding your JDBC URL for the data source the second walks you through wrapping it and the last one gives you an example Select other type driver Click on the Add button you will be presented with more text i
433. the naming conventions used by a couple of servers to give you an understanding of how it works Log File Names The following tables contain the name of the server along with the log files and a screen shot showing how to view the log files in FusionReactor Server s Log Files Image ColdFusion 10 e memory Code Cache log Memory Logs P e memory PS Eden Space log Memory Heap Non Heap olarusion e memory PS Old Gen log Code Cache e memory PS Perm Gen log ColdFusion 8 PS Eden Space memory PS Survivor Space log PS Old Gen PS Perm Gen PS Sumwivor Space CPU Thread Log Server S Log Files Image Server Names Railo 3 Server s Server Names Railo 7 Log fields memory Code Cache log memory Eden Space log memory Perm Gen log memory Survivor Space log memory Tenured Gen log Log Files memory Code Cache log memory Eden Space log memory Perm Gen log memory Perm Gen shared ro og e memory Perm Gen shared rw og e memory Survivor Space log e memory Tenured Gen log Memory Logs Memory Heap Non Heap Code Cache Eden Space Perm Gen Survivor Space Tenured Gen CPU Thread Log Image Memory Logs Memory Heap Non Heap Code Cache Eden Space Perm Gen Perm Gen shared ro Perm Gen shared rw SUNViVOr Space Tenured Gen CPU Thread Log All areas of memory are stored in logs in a similar fashion to each other with the only difference being an attribute that identifies the log type
434. the period you wish to examine then you should analyze the Resource Log files Also See Importing and Graphing Data in Excel JDBC Time Graph The JDBC Request Average Execution Time Graph is a graph of all the JDBC request performance samples currently stored by FusionReactor The time span of these samples will depend upon your history size and interval time see Resource Settings You can zoom into the graph and scroll through it in order to get a better view of this data By default the Resource Settings store the last 12 hours of data Sampled every 5 seconds The graphs shows two independent values overlaid transparent the average execution time of the completed JDBC requests since the previous sample on the graph Blue and the average execution time of active JDBC requests at the point that the sample is taken Gray This graph gives you insight into the JDBC Request performance if the average execution time of the active JDBC requests is continuing to increase it could be that some JDBC requests are hanging Placing your mouse pointer on a data point will show a tooltip with details about that sample Resources JDBC Request Average Execution Time Graph Average Execution Time of Completed JOBC Requests Average Execution Time of Active JOBC Requests at sample h Rd i m oo om M _ _ i k F ib a fa i o 3 ib kd z o_o im A A A Foo 1 Cc gt 16 27 16 28 16 29 i M oe i
435. the web server configuration as displayed in Figure 1 Configuration Description IP Address This is the IP address used to access the FusionReactor instance on the internal web server provided by FusionReactor The addresses listed are the ones available on the machine local to the FusionReactor Administration Manager FRAM Listen on all addresses Tick this box if the internal web server provided by FusionReactor should listen on all of the IP addresses listed in the above field This makes the FusionReactor instance available on all of the listed addresses Port This is the port number used to access the FusionReactor instance using FusionReactor s internal web server Enable Webserver Tick this check box if you want to enable FusionReactor s internal webserver using the above properties Listen on external web server Tick this box if you want FusionReactor to also listen on your J2EE server s web server N b At least one web server channel must be enabled by ticking Enable Webserver or Listen on external web server or both Failing to ensure at least one box is ticked will produce a warning dialogue and the settings won t be submitted Once you have correctly provided all of the configuration details click Modify Instance to edit the FusionReactor Instance Click Skip to cancel the edit of this FusionReactor instance If you have selected to edit more than one instance clicking Skip will advance the wi
436. their shell to bin sh or your preferred shell or select another user Setup FusionReactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation The following service will be installed FusionReactor AM Service on port 8087 Start FusionReactor Administration Manager Click Install to begin installing FusionReactor To review or modify any of your installation settings press Back Click Cancel to exit the wizard without installing FusionReactor Intergral Information Solutions lt Back install Cancel Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin installing FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Setup FusionReactor 4 5 0 Installing ED Please wait while Setup installs FusionReactor on your computer Extracting files lib fontconfig RedHat properties src Intergral Information Solutions Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup w Setup FusionReactor 4 5 0 Fusion You are now ready to start configuring reactor instances Start co
437. this purpose but can t presently check that this user can actually log in If your nobody user does not have a shell please change their shell to bin sh or your preferred shell or select another user setup Fusionkeactor 4 5 0 Ready to Install FusionReactor The wizard is ready to begin the installation ETO hel Ohhh LOT sn OL init i Figure 8 Ready to Install Figure 8 Setup can automatically start FRAM as part of the installation procedure If you do not wish to start FRAM at this moment or wish to manually start FRAM uncheck the option Start FusionReactor Administration Manager Click Install to begin installing FusionReactor 4 5 x Back to review the installation configuration or Cancel to exit the installation wizard Setup Fusionkeactor 4 5 0 Installing Please waitwhile Setup installs FusionReactor on your computer ETO hel Ohhh DOT sith UL Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup rc Setup Fusionkeactor 4 5 0 You are now ready to start configuring instances Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances Tou must use the Instance Manager to install or update your Instances You may need to install a license beforehand Start
438. this configuration item does not appear because FusionReactor s default stack trace method is the only method that can be used to generate stack traces e Use Java s Stack Trace Use Java s built in implementation of generating stack traces e FusionReactor Default Use FusionReactor s default stack trace method This is a HTTP based API that is used to communicate commands and retrieve data from FusionReactor This API allows FusionAnalytics Connector system to send logs to FusionReactor Administration FRAM Configuration Description Enable FR REST API e Enable locally no authentication This enables the API to work on a local machine with no authentication For information on creating or changing a password see the Change FR REST Password section e Enable locally with authentication This enables the API to work on a local machine with authentication This option won t be presented until you create a FR REST password for information on how to do so see the Change FR REST Password section e Enable globally with authentication This enables the API to work on a global machine other machine in the network with authentication This option won t be presented until you create a FR REST password for information on how to do so see the Change FR REST Password section e Disable This disables the FR REST API from working amp NOTE In order for FusionAnalytics to be able to work alongside FusionReactor this option
439. this resource probe was triggered Date Time ms Version Server Startup Time ms Thread Name Thread ID CPU Time nanoseconds User Time nanoseconds CPU Time Delta nanoseconds User Time Delta nanoseconds Thread Blocked Count Thread Blocked Time milliseconds Thread Blocked Delta 3 C 4 D 5 E 6 F 7 G 8 H 9 I 10 J 11 K 12 L 13 M 14 N This is the millisecond time at which at which this resource probe was triggered Version number of this log entry Startup time of FusionReactor server in milliseconds ms since epoch The name of the thread The thread ID The amount of time a thread has been alive for A thread is alive if it s running and has not died The amount of time that a thread has executed in user mode The difference between the the current CPU Time and the previous CPU Time attributes Current being the thread one in front of the previous in the log entries The difference between the the current User Time and the previous User Time attributes Current being the thread one in front of the previous in the log entries The number of times that the thread has been in the blocked state The total amount of time the thread has been in the blocked state The difference between the amount of times the current thread has been in the blocked state and the previous thread has been in the blocked state Current being
440. this see Setting Up FusionAnalytics with HTTPS Once you have entered in the details click Test Targ et to check that you are connecting to a valid DataCollector Click Test Target If the connection was successful the status will display OK and you can continue to press Save Target Settings Hast Application name DataCollector Username HTTPS Status localhost Part 6401 ike kosiname and oot numerar ihe machine On which tre FusorAraiyiies Data Collector iS amming fa4fr Tre name olihe DWL Apoicahan installed in ite FustotAralytics Data Collector faDatalollector 1 The nane ofthe Data Collector installed in hare ahoe aoolicaton om Shogo name my AgOlicahons and Osta Collector Password Te USGTaTe FTO passam oF 2 user hko hes 200855 fo tre Fusoraraiyvics Data Collector aoolcatanr i Check his foxy your FasiorAralyiics QataiCollector uses ATIS fo secde coariticatiors OK Test Target Save Target Settings Figure 2 Target test successful Editing Verifying and Deleting targets On the FusionAnalytics Targets homepage you will see your targets listed URL Username Status Guo hitp localhost2404adcimportiadtitaDataCollector2 admin oK go hitp localhost3401adcimportiadtiitaD ataCallectort OK Figure 3 Modify targets Icon Name Description 2 Edit Target Allows you to modify the options you entered above be Test Target Tests the connection to the target The status colu
441. tion amp Delete Restriction Clicking on this icon will prompt you if you are sure you want to delete this restriction If you OK the dialog then the restriction will be removed from the Existing Restrictions list and the page will be refreshed Request RegEx GQ text plain No See Also Compression Settings Exclude URLs The Exclude URLs list lets you define a set of pages which will never be compressed The Exclude URLs page has two main areas At the top of the page there is a form for you to enter new exclusions and below this is a list of all existing exclusions for this feature which you can edit or delete New URL Exclusion To enter an exclusions you will need to fill the following fields Configuration Request Hostname Description This is the page you want to exclude Firstly select if you are creating an Exact Match or Regular Expression Exact Match Next enter the location of your page By default the request will be an exact match and should look something like batchStats cfm or batch dailyStats cfm beginning with a and without parameters The text you input here will depend on the options you choose for the Hostname and Parameters fields Regular Expressions A good use of Regular Expressions here would be to restrict everything within a given folder For examples of Regular Expressions please see Regular Expressions and Restrictions The text you input here will depend on
442. tion Figure 3 You have successfully activated your license License Activation License Activation Automatic You can activate in FRAM by clicking on FusionReactor in the table of contents and then clicking the page titled About Once on that page you will see a link titled Activate current license clicking this will activate your license fusion reactor Administration Manager Edition FusionReactor Enterprise Edition Subscription Updates for 2 year Maintenance Expiry Date Sat Aug 3 2013 Serial Number FR4AS2ENT FR 0000000 Licensee Intergral Intergral Intergral schickardstr 32 Boeblingen Germany Sales tusion reactorcom You have 10 days left to activate your FusionReactor license Once the activation period has expired FusionReactor will be disabled Activate current license Upload New License File Why not visit Tusion reactorcom or check for FusionReactor updates Revision 4 0 0 Build FusionReactor 805 21861 Uses JUG licensed under the Apache License 2 0 and INTER SRAL HTTP Client licensed under the LGPL FusionReactor is a trademark of Intergral GmbH FusionReactor Copyright 2005 2011 Intergral GmbH All rights reserved License Activation Manual If you do not have a direct internet connection on the computer you would like to install FusionReactor on you will have to manually activate your license Please follow the instructions below to manually activate your license
443. tion Manager The Administrator password is required to log into the FusionReactor Administration Manager to manage your FusionReactor instances Password po Validate Password Z Z O Intergral Information Solutions Figure 6 Administration Manager Password Figure 6 Specify the password to be used by the Administrator user on FRAM This password must be more than 5 characters long E Setup FusionReactor 4 5 0 Define user and group Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation The user and group selected here must have write privileges on your J2EE container s configuration files If you unsure use the same user your J2EE container runs as or root User jnobody Group Intergral Information Solutions lt Back Next gt Cancel Figure 7 Choose a User and a Group Figure 7 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM Please Note FusionReactor Administration Manager FRAM must be installed as a user who has a real shell and can log in to the system By default the installer will pick nobody root for this purpose but can t presently check that this user can actually log in If your nobody user does not have a shell please change
444. tion helps you configure FusionReactor to diagnose a crashing server Configuration and Diagnosis in Emergencies amp NOTE When a J2EE ColdFusion JBoss etc crash occurs before restarting create a log set If after restarting FusionReactor rotates the log files data may be lost The files in the FusionReactor log folder should be zipped up or at least copied and saved Your J2EE log files typically ColdFusion logs and container log files ColdFusion8 runtime logs should also be saved Configurations FusionReactor has several settings pages that allow you to do things from selecting how much metric data to view on the Y axis to defining what percentage of memory usage you consider critical Below is a list of configuration guides for all these types of settings that can help you diagnose problems Request Settings Enterprise Settings Metrics Settings Resource Settings Crash Protection Restrictions Crash Protection Settings JDBC Settings JDBC Stack Trace Filter Compression Settings MIME Type Restrictions Exclude URLs Log Settings Search and Replace Filter Restrictions Filter Settings Settings Filter Restrictions Instant Diagnosis FusionReactor stores a number of logs in memory in order to produce useful metrics and graphs These metrics will be your first point of observation to address issues on an ailing server The Resource and Request logs are important to diagnose server problems since they record t
445. tion to 30 60MB margin 30 of the total memory The system should then be left in Notify mode for a period of time While running in this mode adjustments can be made to the protection value based on the notification email When you are satisfied that the value you have represents the upper margin for the system change the notify mode to Abort and Notify or Queue and Notify Methodology in OpenOffice 1 Ensure Requests gt Request Settings gt Request Logging is Enabled 2 Allow the system to run in its steady state for a while the longer the better 3 Load the request log FusionReactor instances NAME log request 0 log into OpenOffice Calc a Open the file as a Text CSV file with options Separated by Space Text delimiter 4 Create a new sheet Insert gt Sheet naming the new sheet Sheetz2 Switch back to Sheet1 where the data is and select Edit gt Select All 6 Select Data gt Filter gt Standard Filter setting Column F equal to COMPLETED This will remove any other request statuses from the list Click the More button and select Copy Results To Enter Sheet 2 A 1 in the destination box and click OK 7 When the copy is complete you should have only the COMPLETED entries in Sheet 2 8 In a free cell which is not in column enter the formula AVERAGE L1 L65535 STDEV L1 L65535 a This value is the upper limit at one standard deviation away from the average 9 Statistically this may still pr
446. tional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 3 x on Solaris Executables Executable System Architecture FusionReactor_solaris_sparc_4 5 0 x64 sh SPARC 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable yd solaris You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 3 x To start the update login as user root and run the appropriate executable as described in the above section Exe cutables Setup FusionReactor 4 5 0 Welcome to the FusionReactor Setup Wizard This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Net gt Cancel Figure 1 Welcome screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with the update FusionReactor already installed Setup has detected a previous version of FusionReactor Setup has detected that FusionReactor version 3 5 6 is installed FusionReactor will be Updated to include FusionReactor Administration Manager to manage vour other instances of FusionReactor
447. tionality to partition the Dashboard into logical areas that fit your organisation There s no limit to the number of servers that can go into a group If you need an instance to be present in more than one group simply add it again using Manage Servers then put it in the second group Provided the URL used to access the monitored instance is the same FusionReactor will only poll the system once and make that data available in both Dashboard icons Once your servers have been organised into groups you can then simply monitor the group cube it will always reflect the worst status of the group See for figure 1 for an example of this GoldFusion Ser coldtusian ctmx coldfusion mz Group Size Request Count Recent Slow Pages Average Request Time Recent 0 0ms 0 0ms Average DB Time 0 0 Average bleno 123 07 1K68 of 349 536K8 Figure 1 Using log files to troubleshoot issues FusionReactor provides many helpful graphs and metrics to help you see how your system is performing These graphs are available in real time and will also show you a short history of what happened depending on the amount of data which has been generated but what happens when your server begins to crash Lots of this data is stored in memory so it can be used to generate reports and lists for the FusionReactor Administrator If you are having problems which cause or necessitate restarts of the server process this in memory data i
448. titled Create Notification and the notification will be created Scenario want to shutdown a server to apply a patch and quickly inform others of this To do this need to create a notification that notification will be pushed to users who are observing FusionReactor via the web browser AIR Enterprise Dashboard iOS App or the Android App FusionReactor Create Notification Figure 1 Notification Generator page Figure 1 The notification details have been input Mark All Read Mark All Unread Remove All el Title Message Plugin FusionReactor 29 Jun 12 14 45 45 860 Info The server is being shutdown The server is being shutdown to enable us to apply a patch Don t be alarmed when you see it go down rr Notification Generator Plugin Remove Mark Read Figure 2 Notifications page Figure 2 The notification has been created Users observing FusionReactor via the web browser AIR Enterprise Dashboard iOS App or the Android App will receive the notification Status Log plugin fr notification generator plugin log The Notification Generator plugin creates a log file called plugin fr notification generator plugin log which contains information on the status of the plugin when it started stopped and if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Number Description Date Formatted 1 A The date on which this log
449. to Sheet1 where the data is and select Edit gt Select All 6 Select Data gt Filter gt Standard Filter setting Column F equal to COMPLETED This will remove any other request statuses from the list Click the More button and select Copy Results To Enter Sheet 2 A 1 in the destination box and click OK 7 When the copy is complete you should have only the COMPLETED entries in Sheet 2 8 In a free cell which is not in column enter the formula AVERAGE L1 L65535 STDEV L1 L65535 a This value is the upper limit at one standard deviation away from the average 9 Statistically this may still produce too many false positives for Crash Protection so we may want to use 2 3 or even 4 standard deviations a AVERAGE L1 L65535 4 STDEV L1 L65535 O1 As with the gut feeling approach this number can only ever be a starting point for tuning you are bound to get some exceptions and these should help you decide how to adjust this value Configuration for Enterprise and High Availability Environments FusionReactor Enterprise Edition makes monitoring more than one server instance easy with the Enterprise Dashboard Any FusionReactor Enterprise Edition installation is able to report the state of the server remotely to any other FusionReactor Enterprise Edition server We are often asked about the best configuration for enterprise environments this section aims to provide some guidance about how best to set this up Setting Up
450. to resolve the problem if you need to take action Survival Strategy Configuration Abort Strategy Add Parameters Queue Timeout Request Abort seconds Crash Protection Logging Configuration Description When a request is aborted due to Crash Protection there are two possible behaviours e Display Message Enter your message in the text box provided and that message will be presented to the user who made the aborted request e Redirect to URL Enter a URL in the text box provided and the user who made the aborted request will instead be redirected to this URL amp NOTE Redirects may not work when a page has already sent data to the browser After an abort if you Redirect to URL then this option defines whether FusionReactor will add extra parameters to your URL so you can see exactly what happened If you enable parameters the URL will include the following e detection_method This is the type of Crash Protection which fired It will be one of freemem requests or timeout e threshold_value This is the threshold value associated with the type of Crash Protection as defined earlier on this page e actual_ value This is the actual value which caused the Crash Protection to fire e source_url Contains the URL sent on the original request e g http 127 0 0 1 test cfm since 3 0 1 e source_url_params Contains the URL parameters sent on the original request since 3 0 1 e sou
451. top an instance manually through Windows Services panel for instance FusionReactor will fire the configured script As an operational matter the affected instances should be offlined from FusionReactor before being shut down This can be done within the Enterprise Dashboard by clicking the button on the server icon Enterprise Enterprise or from within Enterprise gt Manage Servers by selecting the Modify icon for the affected server then changing its Status to Offline Status FusionReactor will not monitor these systems When maintenance is complete the servers should be onlined again by reversing the process Using the Example Scripts Install the Scripts The example scripts are provided in FusionReactor etc cp thereafter the structure is split into scripts which will run on Unix platforms and those which will run on Windows platforms You are free to run these scripts from this location but we would recommend you copy these templates before editing them You will then always have a pristine copy available for new scripts Worked Example Controlling Windows ColdFusion 8 from Windows In order to get you started we ve provided you with a worked example In our example scenario we will use a FusionReactor Enterprise Edition instance on a ColdFusionMxX 7 instance to monitor a ColdFusion 8 installation also on Windows also running FusionReactor Enterprise Edition Enterprise Dashboard The first stage in
452. tor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Figure 7 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 7 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 4 This is the last screen in the setup clicking Finish will close the window Uninstalling FusionReactor on Windows To completely remove FusionReactor from your system you can either use the FusionReactor Uninstaller Start Menu entry or you can use the Windows Control Panel to open the Add or Remove Programs application shown below The Uninstaller will completely remove the FusionReactor directory including all of the generated data p lease take care that you save any files you want to keep before running the uninstaller The uninstaller will also remove any installed FusionReactor instances during this process you will be asked to restart any running servers Please note that not stopping the servers means that FusionReactor and all of its components will not be completely removed This may cause issues on these servers wa F GJ fl gt Control Panel Programs Programs and Features Control Panel Home View installed updates
453. tor ColdFusion Extensions tool Start the ColdFusion Extensions Instance Installer The uninstallation will continue once the FusionReactor ColdFusion Extensions tool is dosed cad Figure 2 Uninstall Warning If you have installed the FREC plugin into any instances of FusionReactor then you will see the screen shown in Figure 2 Here you are told that you should make sure all FREC plugins have been removed from FusionReactor instances before continuing By default clicking the Next gt button will open the Instance Installer application where you should remove all of the plugins Once you have closed the Instance Installer application the uninstall process will continue FusionReactor Extensions for ColdFusion Setup 1 0 1 Uninstall FusionReactor Extensions for ColdFusion Setup Uninstall Please wait while FusionReactor Extensions for ColdFusion Setup is removed from your computer COO E Figure 3 Uninstalling The third page in the uninstall process is the Progress screen Figure 3 Wait for the uninstall process to complete FusionReactor Extensions for ColdFusion Setup 1 0 1 Uninstall ag O FusionReactor Extensions for ColdFusion Setup Uninstall FusionReactor Extensions for ColdFusion Setup was successfully removed from your computer Extensions for ColdFusion Figure 4 Finished Screen Finally you will see the screen shown in Figure 4 Click the Finish button to complete the uninstall pro
454. tor attempt to restart the server instance coldfusion in Adobe ColdFusion 8 C ColdFusions automatically Figure 2 Restart the Server Figure 2 To start FusionReactor on the server instance the server instance must be restarted By clicking Rest art The Instance Manager can attempt to restart the server instance automatically See Figure 3 If you wish to restart the server at another point or wish to manually restart it click Skip See Figure 5 Adobe ColdFusion 6 C ColdFusiong Attempting to stop server instance coldfusion in Adobe ColdFusion 8 C ColdFusions Figure 3 Restart in Progress Figure 3 FusionReactor is attempting to stop the server instance Please note that stopping the server may take several minutes depending on your system configuration Adobe ColdFusion 8 C ColdFusion Attempting to start server instance coldfusion in Adobe ColdFusion 6 C ColdFusions Figure 4 Restart in Progress Figure 4 FusionReactor is attempting to start the server instance Please note that starting the server may take several minutes depending on your system configuration Adobe ColdFusion 8 C ColdFusions Instance coldfusion cfmxs INTOO5F has been installed successfully v Connect to FusionAnalytics lf you have FusionAnalytics installed you may now configure the FusionAnahtics Connector in order to load metric data directly from this instance Settings may be changed at
455. tored in the template cache As long as the template is unchanged ColdFusion uses the compiled form of the template stored in the template cache Template Cache Hit Ratio Template Cache Size bytes Template Requests Queued Template Requests Running Template Requests Timed Out Throttle Queue Size Total Throttle Memory Used bytes Web Service Requests Queued Web Service Requests Running Web Service Requests Timed Out Memory Monitor State 30 AD 31 AE 32 AF 33 AG 34 AH 35 Al 36 Au 37 AK 38 AL 39 AM 40 AN The hit ratio of the template cache The cache hit ratio indicates the number of cache hits in relation to the number of cache misses The total size of the template cache The number of template requests that are queued and waiting to run The number of template requests that are running The number of template requests that have timed out The total number of requests queued in the request throttle Requests are throttled when ColdFusion queues them because not enough total memory is available to handle them Requests smaller than the specified limit are not queued or counted as part of the total memory Requests larger than the specified limit are counted as part of total memory and are queued if the request throttle memory size of the request is exceeded The total amount of memory that has been used by the throttle The number of Web S
456. trace which was stored when the query was run You can turn on or off this feature from the JDBC Settings page and alter the stack trace information from the JDBC Stack Trace Filter page Query String 23 W This is the query string from the request running the JDBC statement Message 23 X For Notifications and Reminders this will contain the notification or reminder message amp NOTE Depending on the type of log message not all columns will have values Deleting the JDBC Log Clicking on the Delete Log File button will display an Are you sure dialog box If you OK this dialog then the JDBC Log will be emptied and the screen will be refreshed Refreshing the Page Clicking on the Refresh button will update the screen to display the latest log entries Also See Log Settings Importing and Graphing Data in Excel Compression Compression Settings MIME Type Restrictions Exclude URLs Compression Settings The Compression Settings page lets you turn on or off the compression features as well as letting you define how the MIME Type Restrictions behave Compression Support Configuration Description GZIP Requests When this option is enabled FusionReactor will attempt to decompress HTTP requests which are sent to the server in a compressed format GZIP Responses When this option is enabled FusionReactor will attempt to compress outgoing HTTP responses unless otherwise instructed by the MIME Type R
457. tralized Log Rotation These logs can also be used by FusionAnalytics to analyze the server Enabling this will create the following logs plugin fr logrotator log Create a log of the ColdFusion Server Monitor Data When enabled the plugin will log selected ColdFusion Available only in ColdFusion 8 9 and 10 server Monitor Data into its own log files these log files will be included in the FusionReactor Centralized Log Rotation when it occurs They can also be used by FusionAnalytics to analyze the server Enabling this will create the following logs e dbpoolstats lo e hitcountstats log e realtimestats log Enable for of these for the plugin to work Summary After enabling the settings mentioned above in ColdFusion and FusionReactor the logs will be created every time FusionReactor performs a Centralized Log Rotation Also See Log Settings Installing FusionReactor Extensions for ColdFusion FREC Installing FREC into FusionReactor Instances Uninstalling FREC from FusionReactor Instances Uninstalling FusionReactor Extensions for ColdFusion FREC FREC Log Files FusionReactor Heartbeat Plugin Description Constantly logs whether or not a specific ColdFusion instance is up running amp NOTE Increasing the value of the Heartbeat Metrics Fetch Interval will lower the refresh rate of the metric data shown on the Enterprise Dashboard Decreasing this value may cause heartbeat failures It is NOT recommended to set t
458. tries When enabled FREC will save a copy of the Available in ColdFusion 7 8 9 and 10 ColdFusion log entries Such as calls to lt c log gt to the following log file located in the FusionReactor instance s log directory e fr coldfusion log log Create a log of the ColdFusion Server Monitor Data When enabled FREC will save selected ColdFusion Available only in ColdFusion 8 9 and 10 server Monitor Data to the following log files located in the FusionReactor instance s log directory e dbpoolstats lo e hitcountstats log e realtimestats lo These log files will be included in the Centralized Log Rotation which archives and pushes log files to FusionAnalytics amp NOTE Enabling these options will allow FusionAnalytics if configured in the FusionReactor instance to analyze these logs giving you a better insight into how your server is performing Disabling them is not recommended Click the Save FusionReactor ColdFusion Plugin Configuration button to save the configuration changes will be applied immediately Also See FREC Log Files How to enable FREC Once FREC is installed you may have to turn on specific monitoring within the ColdFusion Server Monitor in order to see reasonable data in the generated log files This page details how to enable the different monitoring levels with the ColdFusion Server Monitor If a required level is not enabled FREC will zero that log field to ensure each log line remains
459. try to the FusionReactor directory this will propagate down automatically icacls c FusionReactor grant fusion OI CI F Solaris Tested on Solaris SunOS 5 10 Solaris 10 On Solaris FusionReactor is typically installed as nobody In our test environment ColdFusion is installed as the cfusion user If your users differ substitute them in the commands below The following commands should be run as root with FusionReactor framd and your J2EE server stopped If your nobody user has a shell which prevents login e g sbin nologin you may need firs t apply technote FRS 284 to resolve this issue 1 Add the group fusion groupadd fusion 2 Add FusionReactor s runtime user and ColdFusion s substitute your J2EE server s runtime user to the common group usermod G fusion nobody usermod G fusion cfusion 3 Add file Access Control Entries to files in ColdFusion substitute your J2EE server s directory and FusionReactor This must be done with find as Solaris 10 has no recursive option to setfacl find opt fusieonreactor exec setiacl m G fusionsrwx mirwx find opt coldfusion9 exec setfacl m g fusion rwx m rwx 4 Add default file to the directories of ColdFusion substitute your J2EE server and FusionReactor Again this is done with find find opt fusionreactor type d exec setfacl m dui iPwx d 0 lt r x C2O1r x Gimirwx dtg tusiontrwx y find opt coldfusion9 type d exec
460. tter view of this data By default the Resource Settings store the last 12 hours of data sampled every 5 seconds The graphs shows two independent values overlaid transparent the number of JDBC requests completed per second since the previous sample on the graph in blue and the number of requests running at the time that the sample is taken Gray This graphs give you insight into the JDBC Request activity if the number of active requests stays high and constant then your server is under load It could be that the requests are taking too long to execute for the load being placed upon the server Placing your mouse pointer on a data point will show a tooltip with details about that sample Resources JDBC Request Activity Graph D JOBC Requests per second Completed JDBC Active Requests Load passebau Aygo bay agar 13 38 45 15 41 17 15 46 41 17 37 10 Refreshing the Page Because this graph shows a large amount of information there is no automatic refresh on this page but you can click the refresh button in the page header to get the latest set of data e amp NOTE After a server restart the graphs are reset but the resource logs will contain entries from before the server restart The amount of data stored in the resource log files is also typically far greater than the number of requests FusionReactor stores in memory to show on the graph screens If the graphs no longer contain the data from
461. u choose for the Hostname and Parameters fields Regular Expressions A good use of Regular Expressions here would be to restrict everything within a given folder For examples of Regular Expressions please see Regular Expressions and Content Filters The text you input here will depend on the options you choose for the Hostname and Parameters fields By default FusionReactor will ignore the hostname and simply match based on the web path of a given request but you can also opt to include it If you enable Hostname checking then the request field should also include a hostname and look something like productionMachine batchStats cfm You should NOT include HTTP or HTTPS at the start of this string Parameters Exclude From Statistics Request Hosiname Parameters Exclude From Statistics Exact Match Imyfolderimytile cim By default FusionReactor will ignore any parameters passed to a page however as with the Hostname you can also opt to include them in your restriction With parameter checking enabled the request field should include the necessary parameters For example batchStats cfm period YEAR Once again Regular Expressions can be useful here when specifying multiple possible parameter values or even specifying parameters where the order isn t fixed The meaning of this field changed depending upon what mode the Crash Protection restrictions page is working in Crash Protection Settings page
462. u have any groups set up then they will be listed here Simply select which groups you want this new server to appear within You can add new groups at any time from the Manage Groups page Once you submit the form the page will be refreshed and your new server will be listed at the bottom of the page along with its current connect status Managing Existing Servers Below the Add Server form you will see a list of all servers currently available in the Enterprise Dashboard Each server has three icons next to it Button Name Modify Server Check Server Delete Server Description Clicking on this icon will take you to the Modify Server page From this page you can change any of the information which is listed above Clicking on this icon will check the connect status for a server The screen will be refreshed and you will see a message telling you if there were any problems trying to access FusionReactor on this server Clicking on this icon will prompt you if you are sure you want to delete the server If you OK the dialog then the server will be removed from the Existing Servers list and from the Enterprise Dashboard Clicking on the URL for any server in the Existing Servers list will take you directly to the instance of FusionReactor which is running on that server Shutdown Startup Script The script file which you can associate with a server will get called whenever that server goes down or comes back
463. u wish to leave the server running As stated at the top of this page not stopping the server container means that FusionReactor and all of its components will not be completely removed from the target server This may cause issues on the corresponding server FusionReactor 4 5 0 Uninstall FusionReactor Uninstall FusionReactor was successfully removed from your computer Figure 6 FusionReactor Uninstall Complete Figure 6 When FusionReactor has finished uninstalling you will be presented with the Finish screen shown in Figure 6 Click on Finish to exit Installing FusionReactor on Linux Installing FusionReactor 4 5 x on Linux Updating FusionReactor 3 x on Linux Updating FusionReactor 2 0 on Linux Updating FusionReactor 1 0 on Linux Console Installation on Linux Updating FusionReactor 4 0 x on Linux Installing FusionReactor 4 5 x on Linux Executables Executable System Architecture FusionReactor_linux_4 5 0 sh 32 bit FusionReactor_linux_4 5 0 x64 sh 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup To start the installation login as user root and run the appropriate executable as described in the above section Executables If you can not use an X Windows session you can install FusionReactor through the console installation Please follow the guide that covers Console Installation on Linux
464. uestArray i td gt lt td gt requestArray i lt td gt requestArray i lt td gt requestArray i lt td gt lt td gt requestArray i lt td gt requestArray i lt td gt requestArray i td gt getIpAddress lt td gt getJavaSessionId lt getMethod lt td gt getOutputCompressorst getQueryString lt td getRequestIid lt td gt getRequestStatus lt getRequestUrl lt td gt getRuntime lt td gt getStartTimeMillis getStatusCode lt td gt get Thread lt td gt get ThreadCpuTime lt lt td gt requestArray i getTimeClosed lt td gt lt td gt requestArray i getTimeOfDeath lt td gt lt td gt requestArray i getTimeOpened lt td gt lt td gt requestArray i getTtfb lt td gt lt td gt requestArray i getTtlb lt td gt lt td gt requestArray i isImmortal lt td gt lt td gt requestArray i jdbcGetRunningStateme nt lt td gt lt td gt requestArray i jdbcGetRunningStateme ntDatasource lt td gt lt td gt requestArray i jdbcGetRunningStateme ntStartTimeMillis lt td gt lt td gt requestArray i jdbcTotalExecutionTim e lt td gt lt td gt requestArray i jdbcTotalQueryCount lt td gt lt td gt requestArray i jdbcTotalRows lt td gt lt td gt requestArray i jdbcTotalTime lt td gt l
465. ule allows fine grained specification of exactly which requests it matches A rule is specified as an exact match or a Regular Expression as defined by the relevant Java JRE specification1 As well as the URL path the following optional components can be used to define the rule e The requested hostname useful to differentiate requests on multi homed systems e The URL parameters useful for requests whose behavior changes according to their parameters Additionally each rule can specify whether pages matched by that rule will be protected by or excluded from all protections or just Timeout protection If the list is running in exclude mode in which all requests are protected by default it s also possible to specify whether any excluded requests will still be tracked for statistical purposes e g runtime tracking etc Crash Protection In Action Test Pages Exercising Timeout Protection Exercising Memory Protection Exercising Request Quantity Protection e Using the Queue Strategy Using the Redirect Method e Best Practices in Redirection Test Pages In order to exercise the three types of Crash Protection we have written four pages source code is presented in the appendix e pause cfm takes a timeout parameter in seconds This page simply sleeps for the given number of seconds before completing It s used to exercise the Timeout Protection e load cfm takes a load and timeout parameter This pa
466. ull setObject setRef setShort setString setTime setTimestamp setUnicodeStream setURL String representation BLOB String representation String representation String representation comma separated list of up to 256 bytes CHARACTER STREAM CLOB String represenation using Date toString to format String representation String representation String representation String representation NULL String representation if option inte rpretObjects is true or not specified otherwise OBJECT java class name xyz where xyz is the toString representation REF String representation String representation String representation String representation UNICODE STREAM String representation Parameter Type PreparedStatement Method Text Representation Input Stream Binary setBinaryStream BINARY STREAM Input Stream BLOB setBlob BLOB STREAM Reader Character setCharacterStream CHARACTER STREAM Reader CLOB setClob CLOB STREAM Reader NChar setNCharacterStream NCHAR STREAM NClob setNClob NCLOB NString setNString NSTRING RowlD setRowld ROWID x x is the toString representation of the Row ID SQLXML setSQLXML SQLXML x x is the toString representation of the SQL XML A Note On SQL Server Select Methods In this edition of the JDBC Driver Wrapper manual we have removed reference
467. untu Downloads Password Validate Password Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation The wizard is ready to begin the installation The following daemon will be installed framd on port 8087 Start FusionReactor Administration Manager Yes y Enter No n Figure 10 Ready to Install Figure 10 Here you will be given the choice of starting up the FRAM daemon Either entering y or pressing enter will start the daemon while entering n will not start the daemon FRAM can be started manually after the installation has finished vmuser ubuntu Downloads Yes y Enter No n Yy Extracting files Configuring FusionReactor Starting framd Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager The FusionReactor Administration Manager URL http 127 0 0 1 8087 fusionreactor fhtml cfm mode main Finishing installation r ubuntu DownLloads s Figure 11 Finish Screen Figure 11 You have successfully instal
468. up again It takes 5 parameters they are Parameter Status InstanceName InstancelP This parameter will have the value DOWN or UP which correlates to the status of the server This is the instance name of the server in question as defined on the Manage Servers page This is the IP address of the server in question PID The Process ID of the Server You could use this in order to terminate a server which had stopped responding If the PID is unknown then a value of 1 will be passed LastSeen ms This is the last time expressed in milliseconds that the server was last successfully contacted Manage Groups From this screen you can create or modify groups in order to better organize your servers within the Enterprise Dashboard The Add Group form is very simple Field Name Description Name This is the name of your new group which will appear in the Enterprise Dashboard and on the Manager Servers screen Servers If you have any servers currently set up then they will be listed here Simply select which servers should be added to your new group Managing Existing Groups Below the Add Group form you will see a list of all existing groups Each group has two icons next to it Button Name Description ig Modify Group Click this icon to change a group name or to change the servers which are currently a part of this group 3 Delete Group Clicking on this icon will prompt you if you are sure OK the dialog
469. ure 8 Setup FusionReactor 4 5 0 Finally FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while on the FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup i pin a Finish Figure 11 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 11 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 8 This is the last screen in the setup clicking Finish will close the window Updating FusionReactor 3 x on Mac Executables Executable System Architecture FusionReactor_macos 4 5 0 dmg 32 bit FusionReactor_macos_ 4 5 0 dmg 64 bit Setup You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 3 x ann Setup FusionReactor 4 5 0 A fusion Welcome to the FusionReactor Setup H lt tACtor wizard T
470. ure or delay of INTERGRAL to exercise any of its rights under this EULA or upon any breach of this EULA shall not be deemed a waiver of those rights or of the breach You agree that any varying or additional terms contained in any purchase order or nter C2 Users qnourton gt Down loads gt other written notification or document issued by you in relation to the Software licensed hereunder shall be of no effect INTERGRAL and other trademarks contained in the Software are trademarks or registered trademarks of INTERGRAL Information Solutions GmbH Third party trademarks trade names product names and logos may be the trademarks or registered trademarks of their respective owners You may not remove or alter any trademark trade names product names logo copyright or other proprietary notices legends symbols or labels in the Software This EULA does not authorize you to use INTERGRAL s or its i licensors names or any of their respective trademarks I accept the agreement Yes 1i Wo Figure 2 License Agreement Figure 2 After starting the install you will be shown the license agreement Please carefully review the license agreement then enter 1 if you accept the terms and conditions or enter 2 to cancel the installation Ges Administrator C Windows system32 cmd exe Enter Co Users qmourton Down loads gt other written notification or document issued by you in relation to the Software licensed
471. ut or needing to read through log files Example of changing the FusionReactor Configuration via FRAPI It s possible using FRAPI to change pretty much anything in FusionReactor s configuration In the example below we toggle an Enterprise Dashboard monitored remote server online offline programmatically In the reactor conf file the keys remoting server X control the ED monitored servers The key of interest is remoting server X online you ll have to figure out what X is in your case it s just a serial number Once you have that you can use FRAPI to toggle the online state Here s some CF to do it NB you must not have reactor conf still open in your editor otherwise the FRAPI code won t be able to change it and you ll get an error that ll require a restart to clear If you re in CF and monitoring from within a CFM instance the following CF code will toggle remoting server O s state online offline Pee eee ee ee ee eee eee lt cfscript gt frapiClass createObject java com intergral fusionreactor api FRAPI frapi frapiClass getInstance configuration frapi getRunningConfiguration 1 configuration getStringValue remoting server 0 online true configuration setValue remoting server 0 online false else configuration setValue remoting server Q online true frapi setRunningConfiguration configuration lt cfscript gt en ee eee ee e
472. utomatically and directed to the appropriate detail page defau It tomeca TE Figure 1 FusionReactor in High Availability Environments HAE In a High Availability Environment HAE we recommend a redundant Dashboard configuration FusionReactor is installed on two or more physical servers Each monitor is configured to monitor all the cluster instances or a subset of them and the other monitor Using Server Shutdown StartUp Alerts the system administrator can monitor the status of all the affected servers For maximum protection each FusionReactor monitor should be installed in its own Tomcat server If you configure FusionReactor in this way you should be careful how you handle Enterprise Scripting if you are using it to perform restart functions 1 Never use scripting to restart the monitoring instance Because of the order that FusionReactor s subsystems start and stop a normal restart may cause a script to fire 2 Always offline servers in the Dashboard before performing scheduled maintenance Otherwise Enterprise Scripting may try to restart them 3 Do read the document FusionReactor Enterprise Scripting which is available on our website and is installed along with FusionReactor Enterprise Dashboard Servers and Groups Another recommendation is for people with large numbers of servers The Enterprise gt Manage Groups page allows you to group together monitored instances into logical groups You can use this func
473. vailable to all editions and can be found in the FusionReactor Administration Manager FRAM FRAM is an isolated management instance of FusionReactor and provides a monitoring instance and management functionality for other instances For Enterprise Edition customers FRAM also houses an Enterprise Dashboard monitor from where individual instances including those on other machines can be monitored The Instance Manager makes installing and managing FusionReactor instances as easy as one Click of a button From the Instance Manager you are able to add remove and edit FusionReactor Instances as well as setting them up for log shipping to FusionAnalytics Some settings are only editable from the Administration Manager making instance management a central and secure process fusion reactor Administration Manager Add Server In the Instance Manager you are able to search the local system for installed servers This scan is performed automatically after a FusionReactor 4 0 x installation as covered by the Initial Server Scan Guide This initial scan only goes as deep as 2 sub directories from the root of the installed filesystem If this scan did not find all of your installed servers you can run the scan again and specify your own parameters for the search For more information please read the Add Server amp Scan System documentation The Add Server amp Scan System page also covers how to manually add an installed server to th
474. ver Wrapper Introducing FusionReactor JDBC Driver Wrapper This documentation will take you through the steps to install the FusionReactor JDBC Driver Wrapper and provide you with a few examples of how it can be used The intention of the Wrapper is to provide a thin layer between J2EE applications and JDBC accessible databases in order to intercept and observe the interaction between them The Wrapper can then report various useful metrics to FusionReactor and can also step in to prevent runaway queries The Wrapper is fully integrated into the FusionReactor Administrator and you can easily see all the queries which ran during a request together with their runtime metrics and row counts Although the Wrapper is equally useful for JSP and Servlet deployment this tutorial will illustrate the usage of the Wrapper under ColdFusion amp NOTE The Wrapper has its own User Guide which comprehensively details all possible options together with the JDBC URL syntax and error messages You should consult the User Guide when working through the tutorial The JDBC Driver Wrapper User Guide is the definitive reference for the driver Basic Setup of the JDBC Wrapper Gathering metrics from ColdFusion pages Pathologically bad pages Basic Setup of the JDBC Wrapper The first step in using the Wrapper is to find your ColdFusion datasource This datasource should be working prior to applying the Wrapper Find your datasource within the ColdFu
475. ver is less than this number when a request arrives Crash Protection will be triggered To turn this feature off again simply remove any value from the field You can specify what should occur when Memory Crash Protection is triggered e Abort and Notify The request will be aborted and a notification email will be sent e Queue and Notify The request will be added to a queue in order to be executed once the server has recovered and a notification email will be sent You can specify the queue timeout in the Survival Strategy section of this page e Notify The request is left running and a warning email is sent Request Protection NOTE By entering a number in this field you will enable Request Quantity Crash Protection From that point on if the amount of currently running requests on the server is greater than this number when a request arrives Crash Protection will be triggered To turn this feature off again simply remove any value from the field You can specify what should occur when Request Quantity Crash Protection is triggered e Abort and Notify The request will be aborted and a notification email will be sent e Queue and Notify The request will be added to a queue in order to be executed once the server has recovered and a notification email will be sent You can specify the queue timeout in the Survival Strategy section of this page e Notify The request is left running and a warning email is sent
476. w the installation configuration or Cancel to exit the installation wizard ASO Setup FusionReactor 4 5 0 Installing Please wait while Setup installs FusionReactor on your computer Extracting files tomcat conf tomcat users xml sss t e Intergral Information Solutions Cancel Figure 9 Installation Progress Figure 9 The installation of FusionReactor 4 5 x may take a few minutes depending on the machine running the Setup Setup FusionReactor 4 5 0 You are now ready to start configuring instances Mi Start configuring instances The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand Start configuring instances J Figure 10 Configure Instances Screen Figure 10 After the installation has finished you are presented with a screen that allows you to decide if you want to configure the instances now or later To configure now launch the Instance Manager by clicking the button Start configuring instances and follow the Initial Server Scan Guide If you wish to configure your instances later uncheck the option Open the Instance Manager on close and click the button Configure instances later You are only presented with this screen if you choose to start FusionReactor Administration Manager in Fig
477. was made against the host my host com This will match any URL myfolder myfile jso made against any host or IP address Often URL s are not case sensitive so it s generally a very good idea to set the Regex case insensitive flag i on your Regex expressions RegEx Hostname Description i myfolder myfile jsp Ignore This will case insensitive match for any URL myfolder myfile jsp made against any host or IP address Regular Expressions and Content Filters Regular Expression Restrictions for FusionReactor use the Java 1 4 RegEx language For more technical information on Regular Expressions please refer to the online Java documentation amp NOTE Since the regular expression buffer operates continuously it has no concept of line breaks the end of line and start of line match characters are not available Also pattern grouping and the backref operator n are not available Quick Overview of RegEx Special Characters RegEx Description matches any character d matches any digit w matches any word character a zA Z_0 9 s matches any whitespace character contents define a character class abc matches a b or c abc matches anything except a b or c alternation operator or X Y matches X or Y X matches X once or not at all x matches X zero or more times matching as much as possible X matches X zero or more times matching as little as possible X matches X one o
478. will be shown Figure 3 Activation Error You have run out of activations for this license FR3Y1ENT FR 0013284 If you have uninstalled a previously activated version of FusionReactor then please contact support fusion reactor com in order to reset that activation Alternatively please visit the FusionReactor website to purchase further licenses Figure 2 Activation Error Figure 2 If you have ran out of activations you will no longer be able to use that particular license unless you ve previously uninstall an activated version of FusionReactor You will be able to contact support fusion reactor co m to have that activation reset Otherwise you will need to purchase a new license which you can do at the Fusi onReactor website fusion reactor Administration Manager Edition FusionReactor Subscription Enterprise Edition for 1 year License Expiry Date Fri Aug 3 2012 Serial Number FRSYIENT FR 0013284 Licensee Intergral Intergral Intergral schickardstr 32 Boeblingen Germany Sales fusion reactor com License has been activated Why not visit fusion reactorcom or check for FusionReactor updates Revision 4 0 0 Build FusionReactor 805 21861 Uses JUG licensed under the Apache License 2 0 and INTER DSS HTT EtClient licensed under the LGPL FusionReactor is a trademark of Intergral GmbH FusionReactor Copyright amp 2005 2011 Intergral GmbH All rights reserved Figure 3 Successful License Activa
479. x does not support upgrading from FusionReactor 1 x If you currently have FusionReactor 1 x installed it is not possible to upgrade to FusionReactor 4 x x To install FusionReactor 4 5 x you must first uninstall FusionReactor 1 x and then run the FusionReactor 4 5 x Setup again Console Installation on Solaris Executables Executable System Architecture FusionReactor_solaris_ sparc _4 5 0 x64 sh SPARC 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable yee solaris The setup needs to be run as root Terminal File Edit Miew Terminal Tabs Help bash 3 00 sudo FuslonReactor_solaris sparc 4 0 0 x64 sh c Unpacking JRE Starting Installer This will install FusionReactor on your computer OK o Enter Cancel c Figure 1 Start the Installation Figure 1 To run the FusionReactor 4 5 0 installation in console mode you need to add the c switch For example sudo FusionReactor_linux_4_5_0 sh c Terminal File Edt View Terminal Tabs Help failure or delay of INTERGRAL to exercise any of its rights under this EULA or upon any breach of this EULA shall not be deemed a walver of these rights or of the breach You agree that any varying or additional terms contained in any purchase order or Enter other written notification or document issued by you in relation to the Software Licensed hereunder shall be of no e
480. xe 64 bit The FusionReactor setup comes bundled with an appropriate Java Runtime Environment JRE so make sure to select the correct executable Setup You can run the FusionReactor 4 5 x Setup to update an already installed version of FusionReactor 4 0 x To start the update login as user Administrator and run the appropriate executable as described in the above section Executables fusio E Welcome to the Fusion T Setup Wizard ast rea actor Se This will install FusionReactor on your computer The wizard will lead you step by step through the installation Click Next to continue or Cancel to exit Setup Figure 1 Welcome Screen Figure 1 The first step in the installation wizard is the welcome screen as shown in Figure 1 Clicking the Next button will proceed with the update 9 Setup FusionReactor 4 5 0 License Agreement Please read the following important information before continuing Please read the following License Agreement You must accept the terms of this agreement before IMPORTANT CAREFULLY READ THE FOLLOWING LICENSE AGREEMENT THIS END USER LICENSE AGREEMENT EULA IS A LEGAL AGREEMENT BETWEEN YOU EITHER AN INDIVIDUAL OR IF PURCHASED OR OTHERWISE ACQUIRED BY OR FOR AN ENTITY AN ENTITY AND INTERGRAL YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT BY SELECTING THE ACCEPT OPTION OR DOWNLOADING THE SOFTWARE OR BY INSTALLING USING OR COPYING THE SOFTWARE IF YOU DO NOT AGR
481. y FusionReactor has been successfully installed The installation will continue in the FusionReactor Instance Manager available on port 8087 which manages your FusionReactor instances You must use the Instance Manager to install or update your instances You may need to install a license beforehand To visit the Instance Manager manually click on Instances gt Instance Manager while onthe FusionReactor Administration Manager Once inside Instance Manager you can add instances Click Finish to exit Setup Figure 7 Final Screen If you did not choose to start FusionReactor Administration Manager Figure 7 This screen provides you with a link to the FusionReactor Administration Manager and an overview on how to access Instance Manager as well as some additional information You are only presented with this screen if you choose not to start FusionReactor Administration Manager in Figure 4 This is the last screen in the setup clicking Finish will close the window Uninstalling FusionReactor on Linux To completely remove FusionReactor from your system you can either double click on the FusionReactor Uninstaller icon in the FusionReactor directory or you can run the uninstall command located in the FusionReactor directory in a shell window Both methods require you to be logged in as the root user The Uninstaller will completely remove the FusionReactor directory including all of the generated data please take care th
482. y to configure them see Figure 6 onwards or enter either n or just Enter on the keyboard see Figure 8 onwards EA Administrator C Windows system32 cmd exe Where should FusionReactor be installed C FusionReactor Co Users qmourton Down loads gt Where should Setup place FusionKReactor s shortcuts LFusionReactor Co Users qmourton Down loads gt The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAN is being installed to manage individual instances of FusionReactor and provide the Enterprise Dashboard for the enterprise edition After install this will be available by default on port 087 Configure ports manually Yes y No n Enter Co Users qmourton Down loads gt y Manually configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana GEF L86087 Figure 6 Manually Configuring Ports Figure 6 Here you can configure the HTTP Port the port you use to view FusionReactor in a web browser It is important not to use ports that are already in use by other applications NOTE that the default port for FRAM is 8087 Administrator C Windows system32 Fus tonReactor Co wWsers qnourton Down loads gt The FusionReactor Administration Manager will be installed The FusionReactor Administration Manager FRAN is being installed to manage individual instance
483. y configure the FusionReactor Administration Manager ports Setup has chosen a default port number for the FusionReactor Administration Mana ger 8087 The FusionReactor Administration Manager uses a second port to listen for shutdo wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password is required to Log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Validate Password Figure 8 Administration Manager Password Figure 8 You will be asked to validate your password vmuser ubuntu Downloads wn commands Setup has chosen a default port number for this function 8004 Please specify an Administrator password for FusionReactor Administration Manage r The Administrator password is required to log in to the FusionReactor Administration Manager to manage your FusionReactor instances Password Validate Password Which user and group should FusionReactor Administration Manager run under Select or manually enter the owner and group of this installation User nobody Figure 9 Choose a User and a Group Figure 9 You will be asked to specify the owner and associated group of the FusionReactor installation directory including FRAM Only that user or someone with the same or higher privileges will be allowed to run FRAM vmuser ub
484. y is identity hash code string representation of the lock for example 675587393 1475122501 java util concurrent locks ReentrantLock N onfairSync 57ec9545 For this field to be written to the log file you need to be using Java 1 6 or greater Status Log plugin fr deadlock plugin log The Deadlock plugin creates a log file called plugin fr deadlock plugin log which contains information on the status of the plugin when it started stopped and if there were any problems Below is a table explaining what all the attributes in the log file mean Field Name Number Description Date Formatted 1 A The date on which this log entry was written Time Formatted 2 B The time on which this log entry was written Level 3 C Log Level basically means the nature of the log for example INFO means general information where as ERROR means an error is being logged SEVERE means something really bad has happened this will be typically followed by the a generated exception Log message 4 D Contains a message of an event that occurred such as logging that has started Also See Notifications Log Settings FusionReactor Plugins FusionReactor Extensions for ColdFusion FREC Introducing FREC FusionReactor Extensions for ColdFusion FREC is a Plugin for FusionReactor FREC works with ColdFusion Standard AND Enterprise ver 7 8 9 and 10 and extends FusionReactor to enable capture of the CF event server and applicatio
485. y to any matching requests either Timeout Protection or All Crash Protection Any requests which don t match will proceed into the J2EE container unprotected Statistics only available in Exclude mode If a request matches a rule and is therefore excluded from protection this setting specifies whether its timing values will still contribute to FusionReactor metrics Examples of Restrictions Excluding Batch Jobs Including Specific Hosts Including a Specific Action Page Excluding Batch Jobs This example excludes our named batch jobs from timeout protection Configuration Value Active Protections Timeout Protection 8 seconds Engine Mode Exclude Rule Exact match scripts CleanUpDatabase jsp Exclude from Timeout Protection Page Decisions scripts CleanUpDatabase jsp db Ignored MyDatabase lf we want to exclude this page anywhere it occurs we can use a regular expression Configuration Value Active Protections Timeout Protection 8 seconds Engine Mode Exclude Rule Regular Expression CleanUpDatabase jsp Exclude from Page Decisions Timeout Protection scripts CleanUpDatabase jsp db MyDatabase bigsite jspscripts CleanUpDataba se jsp Ignored Ignored Similarly if all our batch scripts were named batch lt job gt jsp we could also ignore them with an appropriate regular expression Configuration Active Protections Engine Mode Rule Exclude from Page Decisions Including Specific Host
486. ype of log eg request log you will end up with a set of numbered log files eg request 0 log request 1 log request 4 log Once request 0 log is full all the log files are renamed and a new request 0 log is started so request 0 log would always contain the latest log messages The oldest log file in this example request 4 log is deleted and immediately replaced with the file previously named request 3 log The settings for the File Size and File Count of your log files can be found in the associated settings page eg R equest Settings for the request log We recommend however that you switch to the new Centralized Archive and Rotation logging method as it will give you more control over your logs PQUMS O hon Sa request iog FEquest x log a bc log dim jibe 1 09 jdbc x log s Elg lt eic O lop le ele elc 1 bog ale ete amp te x kg Log files available in FusionReactor Below you will find an overview of all of the log files which are available in FusionReactor with a short description of each file Click on the log file name in the table to see a detailed description of all the log columns You can also find a TYPE headers txt file in the log folder for the main log files This file contains the symbols used in the logs Data Logs These are logs that relate to captured server data for example SQL results memory information etc Clicking on the log names will take you to a page dedicated to that log it w
487. zard to the next instance Otherwise the finish screen Figure 3 will be displayed coldfusion cfmxS INTOO5F The FusionReactor instance has been modified and may need to be restarted Figure 2 Restart Warning Figure 2 This screen is just a reminder to let you know that certain configuration changes such as new web server details will not be applied until the instance is restarted Edit Instance Figure 3 Finished Figure 3 The FusionReactor Instance has been modified Click Finish to return to the Instance Manager Edit FusionAnalytics Connector Inside the Instance Manager you will be able to edit the FusionAnalytics Connector for any FusionReactor Instance listed To do this click on the D button next to the desired FusionReactor Instance LOnnector coldfusion cimxs INTOO5F This wizard will help guide you through the short steps required to send data directly to FusionAnalytics from FusionReactor Along the way you can test each setting to make sure they are correct When done you can change any settings later using the FusionReactor web interface Figure 1 Information Figure 1 A Welcome screen explaining the FusionAnalytics Connector Wizard is displayed Clicking Next will continue on through the wizard and clicking Cancel will exit the wizard and take you back to the Instance Manager coldfusion cimxs INTOO45F In order to enable the FusionAnalytics Con

PDF - FusionReactor

Contents

Download Pdf Manuals

Related Search

Related Contents