Friday, 28 June 2013

What to look for in a good knowledge base article.


Continuing the theme of knowledge base articles here are some hints to build a great knowledge base article.

What are the conditions that lead to the event described ?
What are the conditions exclude the event described ?

Build a compelling article by showing the
  •             The evidence needed to identify the issue
  •             What you see in that evidence,
  •             What you understand from that evidence
  •             What you recommend in this situation
  •             What does a successful outcome look like ?
  •             What reference material should you refer to.

When reviewing the document before publication
  •            Does the document read as fact or opinion ?
  •            Does the document standalone or does it need to be linked to other information.
  •            To what versions does the issue and fix apply.
  •            What impact will this have on the customer, product or company. 
  •            What is the best route of distribution, Customer alert, Urgent posting on Social media, update into company support forums, alert to customer facing teams etc.

Cue the shared knowledge picture :





What to look for in a technical case that would make a good knowledge article.


Knowledge base articles can help divert calls, improve the time to resolution and provide research material when working on technical troubleshooting calls. Good KM articles work well for support folks and customers servicing themselves.   

Every support engineer has cause to be grateful to his colleagues that took the time to generate the knowledge base articles that helped with a tricky case. These articles often derive from previous casework. 

Here are some notes about what to look for in a case to see if it is a good knowledge base article candidate.

Lost –Functionality of product is different from that expected by the customer.  Describe the feature functionality in a way that would avoid confusion in the future.

Missing – Data lost or corrupted by unintentional action of a customer or rogue product. Describe the conditions that lead to the data loss and how it can be avoided. These technotes can be the most contention so be sure to get senior technical advice on theses ones. Some times these KM articles will be promoted to product alert status for direct distribution to customers.

Gaps – Holes in a documented procedure or process that substantially impact the success rate of that process. Describe the purpose of the procedure and how the gap in the process can be avoided.

Scrolls – Documentation errors that are substantially misleading or dangerous to the integrity of customer systems. Be specific as to the documentation reference Book, Number, Page, Paragraph title.

Alien technology – Other vendor problems which impact our software.  Document the events and versions involved link to the vendors support site.

Found – New features or functionality can have unexpected benefits and/or consequences.  Describe the upside of the new feature but also include any Trade-off that come with the new feature.

Wisdom – At the end of a case ask yourself "If you knew at the start what you know now how much better would that case have gone ?" Write that KM document to save your colleagues from the same pain.

Knowledge base articles are the golden nuggets of technical support documentation, learn to find cases and forum threads from which to build them.


Cue the Knowledge base picture :


Wednesday, 19 June 2013

The speed and size of a hotrod PC's in 2012

I have been thinking about the speed and size of my favourite computer as it crunched it's way through a combinatorial monster of a problem. Looking at the differences between the parts of a PC can really help to exploit the performance characteristics of the machine.

The system in question BB02, previously seen in Gannetts Folding hall of Fame, is quite a beefy box that was assembled at a cost of about £2000 and has recently had some memory and storage upgrades.   


Starting off with memory and Core i7 Gulftown processor we can see in the top left of this screenshot, taken from Memtest, that the processor has three levels of cache and 16GB of memory.  The cache levels decrease in speed as they increase in size.


Memtest results


The speed quoted for the memory at 9600 MB/s sits a bit under the max speed shown in the reference table below that shows DDR3-13333 at 10,666 MB/Sec. Not having all the same memory modules in all 6 slots may account for part of this 10% discrepancy. Thanks to http://www.hardwaresecrets.com for the data.

Memory speed table

The motherboard, an Asus PT6 Delux V2 has 6 data ports that have been loaded with, an older 5400 RPM drive, a 7200 RPM drive,  a Corsair Force 3 SolidSateDrive and three new Seagate 3TB 7200 RPM drives.  The Seagate drives have been configured as a RAID 0 stripe group using the Ubuntu MultiDevice technology. Using a stripe group shares the I/O load across all the disks in the group. The tests were performed across 2 and 3 drives.  
Asus P6T Delux V2

The evolved and well known filesystem & disk speed utility Bonnie++ was used to access the disk performance. Bonnie tests through the filesystem layer, rather than exercising the raw disk, giving better real life performance numbers. 

Here are the consolidated results converted to MBytes for the sizes and MBytes/second for the transfer speeds. 


We can see in the table, for most levels, that as speeds go down as the size goes up. The impact of using faster drives in a RAID configuration results in at least 3 times speed up over the older single drives.


Plotting the results on a chart also gives some insight into the numbers.  Having memory as the crossover point we see the step down between CPU and storage speeds and relative sizes. The vertical axis is on a Log scale showing the progression from the 32K cache size to the 9Terra Bytes of the 3 way stripe storage.

Sizes and speeds of processor caches, memory and various storage.


Looking at the sizes of the various elements we can see that the variation in size between largest (3 way stripe) and smallest L1 Cache is much bigger than the difference in speed scale.  Interestingly the difference between main memory speed and the slowest disk is about the same order as between a cheetah and a tortoise.

Other comparisons are:
Max Differential speed scale2472
Max Differential size scale281250000.00
Diff Mem/L2 cache6.82
Diff Mem/ Fastest Disk49.66
Diff Mem/ Slowest Disk362.26
Diff Speed  Cheetha/ Tortoise411.76
Diff Size Stamp /football pitch5000000.00

Also included in the main table above are the seek operations per second numbers for the storage drives that clearly show the distinct advantage of SSDs technology in a read situation. The ability of SSDs to maintain full transfer speeds in a read (and random read) situation make them particularly useful as database index and system drives. 



Corsair SSD



Windows 7 has a performance comparison utility built into the Control panel that scores elements of a system between 1 and 7.9. The system under consideration scores a respectable 7.8 on all elements except 7.6 on Disk Drive speed.



For real cpu work Folding at home gives a system a real work out. For this system over 36 Gflops are delivered. 36 GFlops is more than a Cray T932.

Writing final coordinates.
[02:51:00] Completed 500000 out of 500000 steps  (100%)

 Average load imbalance: 0.7 %
 Part of the total run time spent waiting due to load imbalance: 0.4 %
 Steps where the load balancing was limited by -rdd, -rcon and/or -dds: X 1 % Y 0 %


Parallel run - timing based on wallclock.

               NODE (s)   Real (s)      (%)
       Time:  17278.673  17278.673    100.0
                       4h47:58
               (Mnbf/s)   (GFlops)   (ns/day)  (hour/ns)
Performance:    711.518     36.599     10.001      2.400 


When looking at network speeds be sure to register the distinction between MB/s (MegaBytes) and Mb/s (Mega bits)/s. Long distance lines and telcos will often quote as Mbits/s but payloads are usually measured in MBytes. A high res photo is about 6Mbytes so would take either 6 seconds on a 1 MByte/s line but would take 40 s on a 1Mbit line.

In the house there is Gigabit wired networking and Wireless infrastructure.

Wireless - 8.9 MB/s


Wired ( Gigabit) 70 MB/s


The numbers above are obtained using a simple shared folder drag and drop file move. Whilst a good indication of real world performance the wired number is missleading because the file transfer speed is capped at the disk speeds of the PCs involved.

Using the iperf network test utility that just sends network data between the same two machines we see on the wired network gets over 900 Mbits/s ( 113 MByte/s).


------------------------------------------------------------
Server listening on TCP port 5001
TCP window size: 85.3 KByte (default)
------------------------------------------------------------
[  4] local 192.168.1.2 port 5001 connected with 192.168.1.11 port 53619
[ ID] Interval       Transfer     Bandwidth
[  4]  0.0-10.0 sec  1.05 GBytes    906 Mbits/sec
[  5] local 192.168.1.2 port 5001 connected with 192.168.1.11 port 53620
[  5]  0.0-40.0 sec  4.28 GBytes    920 Mbits/sec
[  4] local 192.168.1.2 port 5001 connected with 192.168.1.11 port 53623
[  4]  0.0-40.0 sec  4.27 GBytes    916 Mbits/sec

and the wireless route gets up to about 100Mbits ( 12MBytes/s) when forcing a large packet size.

$ iperf_Intel -c p.local -w 256K
------------------------------------------------------------
Client connecting to pup02.local, TCP port 5001
TCP window size:   257 KByte (WARNING: requested   256 KByte)
------------------------------------------------------------
[  5] local 192.168.1.70 port 63886 connected with 192.168.1.68 port 5001
[ ID] Interval       Transfer     Bandwidth
[  5]  0.0-10.0 sec    122 MBytes    102 Mbits/sec

Out to the Internet we have a good service from BT Infinity giving 64Mbits/s ( 8MBytes/s) download and 2 MBytes upload when testing with the well respected Speedtest.net That is about the same as the internal wireless connection.  Using a wired connection about 70Mbits/s is seen.

















Saturday, 15 June 2013

Steam engines at South Molton Rally 2013

Some of the steam engines at the South Molton Rally 1&2nd June 2013.


Enjoy.













Now looking forward to :

Devon Traction Engine
Veteran & Vintage Car Club


2013 RALLY 6th & 7th JULY
Chapelton Barton, Chapelton, Barnstaple, Devon.
Well signed on the A377 Barnstaple to Exeter Road - Plenty of FREE parking next to the rally field
For SAT NAV use EX37 9EB : For details see http://www.dtec.freeuk.com