Welcome to the new Parasoft forums! We hope you will enjoy the site and try out some of the new features, like sharing an idea you may have for one of our products or following a category.

WebBox- a web interface to control and run WebKing

LegacyForum
LegacyForum Posts: 1,664 ✭✭
edited November 2005 in FAQ
tests.
Control and run WebKing tests through a Web browser Interface

WebBox is a web interface to control and run WebKing tests. It starts a Tomcat Web server on the machine that runs WebBox and the control interface can is accessible to other machines within the network.

Advantages of using WebBox:
1. WebBox control is accessible to multiple machines on the network
2. Scheduling running tests
3. Automatically send test report through email

How to start WebBox:
1. Bring up a command prompt
2. cd to the root webking installation root
3. Type "wk -startbox"
4. You should see a message saying "Started WebBox server on port 8080" indicating WebBox has been started.
5. Go to any browser and type <server name>:8080, the WebBox interface should show up on your screen

Possible reasons of unable to start WebBox:
1. Port 8080 is already occupied by another process on the computer (such as a Tomcat web server)
2. WebKing does not have the proper license to start WebBox, please contact your sales person for more detail.

How to run projects created by GUI WebKing in WebBox:
1. Create the project in WebKing
2. Save the project in <WebKing installed root>\webbox\projects\
3. Go to WebBox interface in your browser and click on Projects Tab
4. You should see a list of projects in the <WebKing installed root>\webbox\projects\ folder, click on the name will open the project
5. At this time you can click on VIEW, PATHS and TESTS to review information about this project. VIEW, PATHS and TESTS are corresponding to Project, Path and Tests tab in WebKing GUI.

How to run Test Suite of a project within WebBox:
1. Go to WebBox interface
2. Go to PROJECT Tab and click on the project you would like to run, this will open the project.
3. Go to JOBS Tab. You should see "Run Tests" link. Click on it.
4. Select the options for this job then click on "Run this job" button. (The options will be explained below)


Determining Output and Alert Options for Jobs:

You configure each job's reporting options and alerts using the controls in the Output section of the Job Configuration page.
The same output options are available for every WebBox job. The available options are:

* To determine how many consecutive errors need to occur before WebBox sends an error alert (via email or an SNMP trap), modify the only trigger error events after N consecutive failures setting. If you want WebBox to send mail and/or an SNMP trap immediately after the first failure, set this value to 1.
* To prevent WebBox from sending mail and/or a SNMP trap for every consecutive failure of this job, check the don?t repeat events on consecutive failures.
* To prompt WebBox to email job results, check the Send output as email box, specify the desired recipients' email address in the Mail To field, and then specify the message subject in the Subject field. To send mail to multiple recipients, separate multiple email addresses by a space character. If you only want reports sent when errors are detected or test problems occur, check the only send mail if errors are detected box.
* To prompt WebBox to send an SNMP trap to a central monitoring tool when errors are detected or test problems occur, check the Send SNMP trap when errors are detected box, then enter your SNMP server's name or IP address in the SNMP Server field.
* To prompt WebBox to save the output as an HTML-format report, check the Save output as report box, then customize the report file name if desired. You can use %D to represent the report date, %T to represent the report time, and %P to represent the project name. Saved reports can be accessed from the WebBox Reports page as described in Accessing Reports.

*** Note: Currently, Webbox only support emailing reports configuration in Linux machine.

Scheduling Jobs:

You schedule each job using the controls in the Scheduling section of the Job Configuration page.

The same scheduling options are available for every WebBox job. The available options are:

* To a schedule a job that runs immediately but does not repeat, choose Run Once in the Scheduling box.
* To schedule a job that repeats one or more times per day, choose Repeat Daily in the Scheduling box, then specify how frequently you want the job to run, and at what time of the day you want the job to start. Jobs will be repeated at the specified interval from the specified start time until midnight.
* To schedule a job that repeats one or more times per week, choose Repeat Weekly in the Scheduling box, then specify the days on which you want the job to run and the time at which you want the job to start.
* To schedule a job that repeats one time per month, choose Repeat Monthly in the Scheduling box, then specify the day of the month on which you want the job to run and the time at which you want the job to start.
* To specify a custom schedule for your job, choose Repeat Custom in the Scheduling box, then use the available subset of the standard cron notation to specify when and how often you want to run the job. For details on acceptable commands, as well as sample commands, see the "Expressing Custom Schedules in Cron Format" section below.

Additional options are available if you choose any of the Repeat options. These options are:

* If you do not yet want the job to run at the scheduled times, check the Schedule job, but suspend it for now option. (Note that this option is not available with the Run Once scheduling option).
* If you want WebBox to automatically suspend this job if it encounters errors (for example, if a particular Load Test test crashes your site), check the automatically suspend job on error option. If you choose this option and WebBox encounters errors during the specified job, the job will be suspended until you manually "unsuspend" the job by clearing the Suspend check box, or by deleting the job.