Difference between revisions of "Performance issues"

From PARS
Jump to navigationJump to search
 
(3 intermediate revisions by one other user not shown)
Line 12: Line 12:
  
 
Hold down CTRL and SHIFT when opening a register from the main PARS Connect diary page. Any register will do. <br> <br>
 
Hold down CTRL and SHIFT when opening a register from the main PARS Connect diary page. Any register will do. <br> <br>
 +
Seating plan trace can be viewed when clicking 'seating plan' and CTRL, SHIFT, ALT from a register
  
 
This will open a Trace Window when loading the register. The Trace Window records the exact times taken by various functions required to open a register. On a decent system a register should take less than 5 seconds to open. On a well-configured system a register will take less than 2 seconds to open. <br> <br>
 
This will open a Trace Window when loading the register. The Trace Window records the exact times taken by various functions required to open a register. On a decent system a register should take less than 5 seconds to open. On a well-configured system a register will take less than 2 seconds to open. <br> <br>
Line 23: Line 24:
 
Exper Method 2 should take less than 3 seconds; if it does not, follow the instructions below. If Exper Method 2 take less than 3 seconds then check the other times in the Trace Window. Several times highlighted in orange or red indicates an issue with the SQL server. <br> <br>
 
Exper Method 2 should take less than 3 seconds; if it does not, follow the instructions below. If Exper Method 2 take less than 3 seconds then check the other times in the Trace Window. Several times highlighted in orange or red indicates an issue with the SQL server. <br> <br>
  
If the register is taking more than 5 seconds to load, Exper Method 2 is taking less than 3 seconds and one or two times in the Trace Window are highlighted in orange or red, post a ticket on the [[help|helpdesk]] with a screenshot of the Trace Window. <br>
+
If the register is taking more than 5 seconds to load, Exper Method 2 is taking less than 3 seconds and one or two times in the Trace Window are highlighted in orange or red, post a ticket on the '''[[help|helpdesk]]''' with a screenshot of the Trace Window. <br>
 
'''In any other case, the root cause of performance issues in PARS lies with either your IIS server or your SQL server (or both).''' <br> <br>
 
'''In any other case, the root cause of performance issues in PARS lies with either your IIS server or your SQL server (or both).''' <br> <br>
  
=Identifying the Issue=
+
=Server Issues=
  
In general terms any performance issues will be lie with either the IIS server (due to overuse) or with the SQL server. Use this page to decide whether it is the IIS server or SQL server causing the issue: <br>
+
In general terms any performance issues will be lie with either the IIS server (due to overuse) or with the SQL server. Use this section to decide whether it is the IIS server or SQL server causing the issue: <br>
'''[[PARS main menu]]''' > '''[[System management]]''' > '''System''' > '''Performance monitor''' <br> <br>
+
'''PARS main menu''' > '''[[System management]]''' > '''System''' > '''Performance monitor''' <br> <br>
  
==IIS==
+
==IIS Server==
  
 
The easiest to rule out (and to fix) is the IIS server. <br> <br>
 
The easiest to rule out (and to fix) is the IIS server. <br> <br>
Line 43: Line 44:
 
Running the IIS server as a Virtual Machine can cause additional problems; Power Saving features can be left on and there may be settings on the Host to limit CPU performance to a percentage of the host's capability (nominally to maintain CPU cycles for other VM guests) that will have the effect of crippling the IIS server's performance. <br> <br>
 
Running the IIS server as a Virtual Machine can cause additional problems; Power Saving features can be left on and there may be settings on the Host to limit CPU performance to a percentage of the host's capability (nominally to maintain CPU cycles for other VM guests) that will have the effect of crippling the IIS server's performance. <br> <br>
  
==SQL==
+
==SQL Server==
  
If the IIS server is running well turn your attention to the SQL server. This will have the same potential pitfalls and more when running as a virtualised machine and sharing the host with the IIS server. <br> <br>
+
If the IIS server is running well turn your attention to the SQL server. This will have the same potential pitfalls as the IIS server, and more, when running as a virtualised machine and sharing the host with the IIS server. <br> <br>
  
 
A very realistic test of the SQL server can be performed using the following: <br>
 
A very realistic test of the SQL server can be performed using the following: <br>
Line 69: Line 70:
 
'''[[PARS main menu]]''' > '''[[System management]]''' > '''System''' > '''[[Automation]]''' > '''Status''' <br> <br>
 
'''[[PARS main menu]]''' > '''[[System management]]''' > '''System''' > '''[[Automation]]''' > '''Status''' <br> <br>
  
If automation is running but not building data caches, run a [[service pack|PARS Service Pack]]. <br> <br>
+
If automation is running but not building data caches, run a '''[[service pack|PARS Service Pack]]'''. <br> <br>
  
 
===Blockers===
 
===Blockers===

Latest revision as of 00:24, 2 March 2021

The following page can be used to diagnose performance issues in PARS. Some potential solutions for common issues are listed on this page, but the information shown below is not a definitive list of the causes and solutions for performance issues.

At TASC we will try to help our customers wherever possible but it is important to note we are software specialists, not network managers or server engineers.

We have neither the remit nor the expertise to log on to your server and resolve performance issues for you.

In a well configured environment (comprising of the IIS server, the SQL server and the network) PARS will run quickly. Any performance issues are the result of issues in the environment, not the result of the PARS programming.

Determining if PARS is Running Slowly

PARS running on an Intel i5 SQL server with mechanical drives

Hold down CTRL and SHIFT when opening a register from the main PARS Connect diary page. Any register will do.

Seating plan trace can be viewed when clicking 'seating plan' and CTRL, SHIFT, ALT from a register

This will open a Trace Window when loading the register. The Trace Window records the exact times taken by various functions required to open a register. On a decent system a register should take less than 5 seconds to open. On a well-configured system a register will take less than 2 seconds to open.

If the register takes longer than 5 seconds, examine the times in the Trace window to see what is taking a long time. You should repeat this a few times to get consistent/average timings.

An example Trace Window for a real school during peak time

The "Exper method 2" should always take the longest amount of time. This is the process of retrieving attendance marks from SIMS. Nothing in either PARS or SIMS can be changed to improve this time; if Exper method 2 is taking too long then reconfiguring the system is the only way to improve performance.

Exper Method 2 should take less than 3 seconds; if it does not, follow the instructions below. If Exper Method 2 take less than 3 seconds then check the other times in the Trace Window. Several times highlighted in orange or red indicates an issue with the SQL server.

If the register is taking more than 5 seconds to load, Exper Method 2 is taking less than 3 seconds and one or two times in the Trace Window are highlighted in orange or red, post a ticket on the helpdesk with a screenshot of the Trace Window.
In any other case, the root cause of performance issues in PARS lies with either your IIS server or your SQL server (or both).

Server Issues

In general terms any performance issues will be lie with either the IIS server (due to overuse) or with the SQL server. Use this section to decide whether it is the IIS server or SQL server causing the issue:
PARS main menu > System management > System > Performance monitor

IIS Server

The easiest to rule out (and to fix) is the IIS server.

The main indicator to IIS throughput is the Processor Queue Length. This should read 0 nearly all of the time, occasionally flicking up to 1 or 2. A Processor Queue Length consistently higher than 0 is a problem.

Processor queue.jpg

All four LEDs should be green. If any are yellow or red, there is a problem on the IIS server which must be resolved. You may not have enough memory, enough cores that are fast enough to cope, a failing or slow disk drive that cannot keep up or a poorly performing Network Card.

Running the IIS server as a Virtual Machine can cause additional problems; Power Saving features can be left on and there may be settings on the Host to limit CPU performance to a percentage of the host's capability (nominally to maintain CPU cycles for other VM guests) that will have the effect of crippling the IIS server's performance.

SQL Server

If the IIS server is running well turn your attention to the SQL server. This will have the same potential pitfalls as the IIS server, and more, when running as a virtualised machine and sharing the host with the IIS server.

A very realistic test of the SQL server can be performed using the following:
PARS main menu > System management > Management reports > Table speed test

This is a stress test that attempts to write a number of records to the SIMS and PARS databases, update them and then delete them. This will give a baseline figure as to the performance of the SQL server. You should expect to get around 2 minutes each for the longest PARS tests and 3 minutes each for the longest SIMS tests. If they are much longer than expected, your bottleneck is with the SQL server.

If your Table Speed Test times exceed those stated above, use the instructions on the SQL server performance page to diagnose and resolve issues on the SQL server.

Software Optimisations

Automation

Automated tasks or reports may increase the load on the SQL server. You can find a list of the automated jobs and their scheduled run times via:
PARS main menu > System management > System > Automation > Job list

If any of your jobs are scheduled to run during busy times (typically 8am - 5pm) then consider rescheduling them to run at a quieter time. Jobs can be rescheduled by clicking the magnifying glass button next to their title. These changes will not take effect until the following school day, so you will need to wait until then to observe the performance of PARS.

Automation should also build data caches so that end users do not have to. To test that automation is building the caches go to:
PARS main menu > System management > System > Cache viewer

Each of the PARS caches is listed on this page. Some of the caches should have a yellow background, indicating they were built by the automation module. If none of the caches have yellow backgrounds, check that automation is running by going to:
PARS main menu > System management > System > Automation > Status

If automation is running but not building data caches, run a PARS Service Pack.

Blockers

Sometimes poorly written or recursive SIMS User Defined Reports, amongst other things, will require access to SIMS datatables for a long time which denies access to those datatables for other users. Other users are then forced to 'queue' until the datatable is unengaged. The blockers tab of the performance monitor page will show whether this is happening:

PARS main menu > System management > System > Performance monitor

Note than some unobtrusive blocking is normal, so use your judgement as to how frequently and for how long blocking occurs and from which workstation and products, and whether this is a root cause or a symptom.

PARS Tweaks

Some tweaks in PARS itself may be possible to improve performance but these are likely to only affect certain areas of the system, such as saving behaviour incidents. The following report will indicate the settings in PARS that may affect performance:
PARS main menu > System management > Management reports > Performance

SIMS Tweaks

Archiving attendance data. Capita recommend that you archive your attendance data ever year. If this has not been done for many years, it can cause performance issues. Contact your SIMS team for advice on this.