diff options
| author | Michael Larabel <michael@phx-laptop.(none)> | 2008-05-30 19:32:00 -0400 |
|---|---|---|
| committer | Michael Larabel <michael@phx-laptop.(none)> | 2008-05-30 19:32:00 -0400 |
| commit | 274eb1fac853c101c21231366c5dd56aba4d3ca1 (patch) | |
| tree | bbeb72dca7673c87fa706c77f07ff36c5380b4e8 | |
| parent | d5e66326842be7513ee2c5edc25b4dc9772a86ad (diff) | |
| download | phoronix-test-suite-upstream-274eb1fac853c101c21231366c5dd56aba4d3ca1.tar.gz phoronix-test-suite-upstream-274eb1fac853c101c21231366c5dd56aba4d3ca1.tar.xz phoronix-test-suite-upstream-274eb1fac853c101c21231366c5dd56aba4d3ca1.zip | |
Add Tips & Tricks documentation and update installation instructions...
| -rw-r--r-- | documentation/index.html | 1 | ||||
| -rw-r--r-- | documentation/install.html | 1 | ||||
| -rw-r--r-- | documentation/tips_and_tricks.html | 70 |
3 files changed, 72 insertions, 0 deletions
diff --git a/documentation/index.html b/documentation/index.html index 78231cb..3615e88 100644 --- a/documentation/index.html +++ b/documentation/index.html @@ -40,6 +40,7 @@ package(s) (or other software that you develop), or support for your company, pl <h3><a href="pts_options.html">Explanation Of User Options</a></h3> <h3><a href="writing_your_first_test.html">Writing Your First Test Profile</a></h3> <h3><a href="sensor_monitoring.html">System Sensor Monitoring</a></h3> +<h3><a href="tips_and_tricks.html">Tips & Tricks</a></h3> <h3><a href="credits.html">Development Credits</a></h3> <h2>XML Syntax / Specifications</h2> <h3><a href="specifications_xml_test.html">Test Profile</a></h3> diff --git a/documentation/install.html b/documentation/install.html index c0d9a0d..bb0d442 100644 --- a/documentation/install.html +++ b/documentation/install.html @@ -25,6 +25,7 @@ behind the use of PHP 5 for is the portability across platforms for this languag low impact on the overall system, a lower entrance barrier for new developers, and low number (if any) dependencies that PHP5 CLI requires. The PHP GD library is used for rendering the graphs within the PTS Results Viewer.</p> +<p>Note: you may need to modify the <em>php.ini</em> file on your system in order to support uploading results to PTS Global or logging into your PTS Global account. The <em>allow_url_fopen</em>, <em>file_uploads</em>, and <em>allow_url_include</em> options must be set to true in the PHP configuration and curl must be supported by the PHP installation. <a href="http://www.phoronix.com/forums/showpost.php?p=32484&postcount=4">Additional information</a>. <p>While PHP and PHP GD are the only required dependencies, many of the test profiles do require the standard Linux development tools/libraries (GCC, etc). On a clean Ubuntu installation, it's as easy as first running <em>sudo apt-get install build-essential diff --git a/documentation/tips_and_tricks.html b/documentation/tips_and_tricks.html new file mode 100644 index 0000000..cc45edf --- /dev/null +++ b/documentation/tips_and_tricks.html @@ -0,0 +1,70 @@ +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<Title>Phoronix Test Suite - Tips & Tricks</Title> +<link href="includes/pts-documentation.css" rel="stylesheet" type="text/css" /> +</head> +<body> +<div id="pts_doc_header"><div class="pts_doc_fixed"><div id="pts_doc_logo"></div></div></div> +<div class="pts_doc_fixed"> +<div class="pts_doc_notice"><div style="float: left"><a href="index.html"><< Documentation Home</a></div><div style="float: right;">Tips & Tricks</div></div> +<div class="pts_doc_main"> +<!-- PTS AREA --> +<h1>Tips & Tricks</h1> +<p>This page shares some tips and tricks about the Phoronix Test Suite as well +as some random information that some users may find useful.</p> +<h2>General</h2> +<p>- If running within a GNOME desktop, the screensaver will automatically be +shutdown when a test is running and will be restored to its previous state upon +the test's completion. If the using a different desktop environment, it will attempt +to interrupt the screensaver using an XDG command.</p> +<p>- When running a test in batch mode (through the use of the <em>batch-run</em> +or <em>batch-benchmark</em> options) that normally has end-user options (such +as the sub-test to run or resolution), the Phoronix Test Suite will run the test +with each unique combination of options possible.</p> +<p>- Phoronix Test Suite support for Mac OS X and OpenSolaris may be added in +the future.</p> +<p>- The Phoronix Test Suite really appreciates and welcomes independent code +contributions, patches, new tests/suites, etc... :)</p> +<p>- If you're just an individual user that enjoys the Phoronix Test Suite, and +not a ISV/IHV interested in submitting products for review at <a href="http://www.phoronix.com/">Phoronix.com</a> +or a company interested in professional/enterprise support of the Phoronix Test +Suite by Phoronix Media, another way to support this project is by becoming a +Phoronix Premium subscriber @ <a href="http://www.phoronix.com/scan.php?page=phoronix_premium">http://www.phoronix.com/scan.php?page=phoronix_premium</a>. +You may also contact us (phoronix [at] phoronix.com) for additional information +or ideas.</p> +<p>- If the environmental variable <em>PTS_MERGE=custom</em> is set, no compatibility +checks will be performed when merging results and it will allow you to form custom +suites very easily, etc. Though the preferred method to create a suite is by writing +a formal suite.</p> +<h2>Download Caches</h2> +<p>- If you're a company or simply own multiple computers, the download caching support of the Phoronix Test Suite can work quite well. This feature allows you to very simply setup a local (or network-wide) repository for the Phoronix Test Suite of all the files the different tests use. After you've installed the tests on one system that you normally use (or have ran <em>phoronix-test-suite install-all</em>) running <em>phoronix-test-suite make-download-cache</em> will cache all of the files that each test downloaded. The location of this cache is <em>~/.phoronix-test-suite/download-cache/</em>. Once the cache has been created, you can copy this folder to other systems and place the files in the same location. Then when the Phoronix Test Suite needs to download a file for a test, before downloading it from the Internet it will first check this cache for the file(s). If the files are there and the MD5 check-sums have been verified, it will simply copy the file -- thereby saving bandwidth and time. The download cache location can be downloaded in <em>~/.phoronix-test-suite/user-config.xml</em>. By adjusting the download cache, you could setup the cache folder to be on an FTP or NFS share (as an example) on a server that's accessible via your LAN. Configure your test systems to use this local repository and you'll be saving time and bandwidth.</p> +<h2>Configuration</h2> +<p>- The user configuration options for the Phoronix Test Suite are stored in +<em>~/.phoronix-test-suite/user-config.xml</em>. The batch mode options are also +stored within this file and those can be adjusted by running <em>phoronix-test-suite +batch-setup</em>.</p> +<p>- The colors, size, and other attributes for the graphs found within the PTS +Results Viewer can be modified via the file <em>~/.phoronix-test-suite/graph-config.xml</em>. +A description of the XML tags can be found by looking at the comments within <em>pts-core/functions/pts-interfaces.php</em> +and <em>pts-core/objects/pts_CustomGraph.php</em>. No matter the graph type, the +same generic <em>graph-config.xml</em> configuration is used.</p> +<h2>Test / Suite Writing</h2> +<p>- The Phoronix Test Suite recursively determins tests/suites and allows a suite +to call another suite.</p> +<p>- One of the quickest and easiest ways to understand how to write a profile +is by just looking at the some of the existing profiles within the <em>pts/ </em>folder.</p> +<p>- The XML syntax for all file specifications are defined within <em>pts-core/functions/pts-interfaces.php</em> +and trailing each defintion is a comment describing its purpose / value.</p> +<h2>Debugging</h2> +<p>- Setting <em>DEBUG=1</em> as an environmental variable prior to running the +Phoronix Test Suite will put it in a diagnostics mode. In this mode, additional +information may be printed to the standard output to help developers or test maintainers +debug problems. In the case of using the <em>list-tests</em> or <em>list-suites</em> +in the diagnostics mode, different information will be outputted that's more relevant +to Phoronix Test Suite developers.</p> +<p>- To save the debugging output, set <em>DEBUG_FILE=name-of-file</em> as an +environmental variable and the results will be saved to <em>~/.phoronix-test-suite/debug-messages/name-of-file</em>.</p> +<!-- END OF PTS AREA --> +</div></div><div class="pts_doc_fixed"><div class="pts_doc_bottom"><div style="float: left;"><a href="http://www.phoronix-test-suite.com/">Phoronix-Test-Suite.com</a></div><div style="float: right;">Copyright © 2008 by <a href="http://www.phoronixmedia.com/">Phoronix Media</a>.</div></div></div> +</body> +</html> |