Thursday, August 25, 2022

Readme Instruction: Read all instructions first.

This tool can be launched from either an external USB drive or a local disk drive. It

has been tested in Windows 10 and with these supported web browsers (Chrome, 

Edge, Firefox). It is designed for the Microsoft Windows runtime environment 

only. 

Installation and startup process 

1. You must download the FedTest.zip file which contains the test tool. 

2. Preferred installation: 

Extract the zip file to a root location on a Windows 10 compatible file 

system. (Extraction locations may include: c:\, or any related root level 

external destination on an attached USB device (e:\, f:\, etc.). 

3. Do not extract the file contents into a top-level parent folder, for example: 

\some-top-level-parent-folder\FedTest\...’). This kind of staging location may 

induce errors while testing. 

(Example of a correct install location: C:\FedTest)

How to Launch the webserver

4. After the tool has been unzipped, Locate and click (Set-path.bat) this will 

set the tools’ application path needed by the webserver modules located in 

\FedTest\ directory. You may see a command window open. Leave the 

windows open, proceed to step 5. 

*If for any reason the file ‘set-path.bat’ is not found in the \FedTest\ root folder, copy and paste 

its backup file out of the ‘\FedTest\base_files\’ folder.

The set-path.bat may generate an error message indicating that the MySQL server is not found.

This is due to the MySQL server beings disabled – a module not needed for the successful 

operation of this tool. Ignore the error. Continue to step 5.
5. Locate the Start-Lighty.bat found in the \Fedtest\ folder to start the web 

service. If prompted at the next pop-up click cancel to prevent the loading 

of the windows system tray service tool. Continue to step 6. 

6. Copy the text below into your browser then press ‘enter’ to start the tool. 

localhost/Federated_Testing_Home_Page.php

Begin Module Selection and Testing

Use the navigation bar on the left side of the main web tool page to select a 

module. Read and familiarized yourself with the interface before you begin 

testing. Familiarize yourself with the instructions given on each page of the 

module you have chosen to test. 

Note: In the mobile device module there is ‘Quick Start guide’ that contains 

information relevant to the ISO version of the tool and may not be applicable to 

your current testing state. 

Test Completion and Log File Recovery

This tool will generate a .html ‘Test Report’ file at the completion of your test run.

It will be located in ‘ \FedTest\media\cftt\FT-LOGS\’. Use this file to generate your 

own official report or send us a copy of your test results for publishing if this is in 

line with your agency’s policy and procedures.

(Example file output: test-report-mdt-2021-06-01+09+12+39.html or 

test-report-ss-2021-06-01+09+12+39.html). The abbreviation ‘mdt’ equals (mobile 

device test) and the ‘ss’ stands for (string search) if you produced a string search 

test run.

How to Stop The Application

Locate the file \FedTest\Stop-Lighty.bat – Click it shut down the tool.
File Cleanup Instructions

For example: You have completed your mobile test and have generated your test 

report great. Now, before starting a new set of tests and creating a new test 

report you must remove all log files associated with your first test report.

First remove all of the mobile device ‘mdt’ related files generated during your first 

test run. Clean up the \media\cftt\FT-LOGS\ directory by clearing the folder of all 

log files but one. Archive related log files for future reference or delete them.

DO NOT DELETE THE FILE: test-configuration.txt log file

If you delete it, simply recreate a new 0 byte - ‘test-configuration.txt’ file before 

you begin any new set of tests. 

All other files in the FT-LOGS subdirectors should be deleted or archived for future 

review.

File cleanup instructions for String Search log files and related directories

You have completed your string search test and have generated your test report 

great. Now remove all string search log files found in several locations under the 

following directory structure:

\FedTest\media\cftt\FT-LOGS\Live and \Indexed folders and their subdirectories

Note: \FedTest\media\cftt\FT-LOGS\Other – is a folder that will be created if you 

run a test set using a custom string search engine. This ‘other’ directory must be 

removed as part of your file clean up before a new set of tests.

Before you begin a new set of tests make sure these locations do not contain any 

earlier generated log files, doing this ensures that no legacy test information gets 

carried forward into your new test cycle.

*Know tool behaviors

Warning messages may appear while using the string search module. If you fail to 

make a test case selections for each designated area, you can continue testing 
without those selections being made - just ignore the warnings about data types -

this behavior will not interfere with your test case results. It is simply a tooling 

error that will be addressed in a future tool update.

Set-path.bat may sometimes get deleted during shutdown, this can be remedied 

by simply copying and pasting the backup file into the application’s root folder. 

See step 4 above.

This tool was built using ::Lighty2Go v1.5.2::

For more information contact cftt@nist.gov