...
Firefox Executable Path: Specifies the path to the Firefox executable. On Windows machines, SOAtest and/or Virtualize will attempt to detect a Firefox installation automatically. Linux users will have to browse to the Firefox executable.
- Chrome Executable Path: Specifies the path to the Chrome executable. Paths set here will be used in web recording wizards and other applicable areas. On Linux, choose
google-chrome
(e.g. /opt/google/chrome/google-chrome
)—notchrome
. - Safari Executable Path: Specifies the path to the Safari executable.
Proxy port: Specifies the proxy port. See Proxy Configuration Details below for more information and tips.Anchor proxy-port-field proxy-port-field - Browser communication port: Specifies the browser communication port.
Browser Timeout Settings: Specifies the length of delay (in milliseconds) after which SOAtest and/or Virtualize should stop waiting for browser startup or a user action and consider it to be "timed out."
Wait Condition Default Timeout Settings: Specifies the length of delay (in seconds) after which SOAtest and/or Virtualize should stop waiting for the activity specified in the wait condition to occur and consider it to be "timed out."
Debug Options> Print debugging information: During recording of a web scenario, it is possible that an action taken is not recorded by SOAtest and/or Virtualize. Enabling this option will allow messages to be printed to the message console during recording, with information about what events SOAtest and/or Virtualize handled, any locators that may have been generated, and if applicable, any exceptions that took place during recording.
Error Reporting> Report website's scripting errors: Configures SOAtest and/or Virtualize to report scripting errors that occur during scenario execution. In Internet Explorer, the Selenium Web-Driver framework will not report JavaScript errors on the page to SOAtest and/or Virtualize; this reporting is supported only for the legacy engine.
- Allowable Binary Files in Traffic Viewer and Outputs: Allows binary files with the specified extensions or MIME types to be used in the Traffic Viewer and output. By default, only text files will be allowed.
Browser Contents Viewer Rendering Engine: Enables you to specify what browser is used for the Browsear Contents Viewer tool tool , which can be attached to the Browser Playback tool.
- The default option (Same browser used for playback) is generally the recommended option because some web applications generate their pages differently based on the browser used. Using the same browser that was used during the playback can help ensure that pages display properly in the Browser Contents Viewer. Note that if the playback browser was Chrome, the Firefox rendering engine is used.
When Internet Explorer is selected, the version of IE that is used depends on what version of IE is installed on the machine running SOAtest and/or Virtualize. The Internet Explorer option is available only on Windows.
When Firefox is selected, the version of Firefox that is used depends on what Eclipse is being used to run SOAtest and/or Virtualize. It can range from Firefox 3.0.1 to Firefox 10, depending on what OS is being used.
- If the particular web application being tested does not render properly in the Browser Contents Viewer, you could try configuring this option to use either Internet Explorer or Firefox specifically (rather than use the default Same browser used for playback option) to see if using a specific rendering engine will improve how the page is shown in the Browser Contents Viewer.
HTML Content Fetch Mode: Enables you to determine whether the contents of hidden frames are displayed in the pre- and post-action HTML viewer. This can impact record and playback speed, as well as file size. It is possible to use one mode on some of your team’s SOAtest and/or Virtualize machines (e.g., desktop installation), and a different mode on others (e.g, the Server machine running in command-line mode).
Fetch all HTML content Choose this option if you want to see the contents of hidden frames in the pre- and post-action HTML viewer
Fetch content for all content except hidden frames: Choose this option if you do not need to see the contents of hidden frames in the pre- and post-action HTML viewer.
...
- Use DTP settings: Enable this option to use the connections settings specified in Development Testing Platform (DTP). See Connecting to Parasoft Development Testing Platform.
- Server Name: Specifies a name for the server you are connecting to CTP. This is the name that will be used to identify this server within CTP.
- CTP URL: Specifies the location of the CTP to which you are connecting (e.g., http://emdemo:8080).
Conditional Content Product: (SOAVirt, Virtualize) Product: (SOAVirt, Virtualize)sv-attr:0A010204015A9054C88481D043445E2F 0A010204015CF6008A11EEF43AC91334 0A010204015A9054C88802B9600247DF Notify CTP of virtual asset deployment: Determines whether the server notifies Parasoft CTP when virtual assets are first deployed.
- Username: Specifies the username for logging into CTP.
- Password: Specifies the password for logging into CTP.
...
Global Data Sources can be reused and shared outside of a single SOAtest project and across Virtualize deployments. The Global Data Source panel lets you determine how information about global data sources is saved.
...
...
Technical Support Settings
If you are experiencing problems with Virtualize, the best way to remedy the problem is to create a zip archive containing the related files, then send that zip file to Parasoft's support team. To facilitate this process, you can have the product automatically create an archive when problems occur. On average, these archives are about half a megabyte, and are created in about one minute.
By default, an archive is not created when problems occur. You can either manually prepare and send a support archive when needed, or you can modify Parasoft archive creation options so that the product automatically prepares and sends an archive when problems occur.
To configure the product to automatically prepare and send archives when problems occur:
- Open the Technical Support panel by choosing Parasoft> Preferences, then selecting the Parasoft> Technical Support category.
- Check Enable auto-creation of support archives.
- Customize additional options as needed. Note that Enable auto-creation of support archives and Send archives by email are not applicable to Virtualize.
- Click Apply, then OK.
To manually create a support archive:
- Choose Parasoft> Preferences, select the Technical Support category, select the desired archive options, then click Create Archive.
To open the Technical Support Archive Manager, which allows you to review, e-mail, or delete recent support archives:
- Choose Parasoft> Preferences, select the Technical Support category, then click Browse Recent Archives.
When creating a support archive it is best to ensure that it contains all the info which is relevant to the problem and does not contain any unrelated info. To ensure that detailed logs are sent to the standard output console, add the following argument to virtualizecli
:
Code Block |
---|
-J-Dcom.parasoft.xtest.logging.config.jar.file=/com/parasoft/xtest/logging/log4j/config/eclipse.on.xml |
MIME Type Settings
The MIME Types panel lets you add and remove MIME types. In addition, it lets you specify the location of your preferred text and XML editors and lets you specify what editor you want to use to edit all files that have a particular MIME type.
...
- Character Encoding: You can enable System default to configure SOAtest and/or Virtualize to use the default character set for the particular system being used. Enable Custom to encode characters from the list of encodings available on the JVM being used.
Save settings: Specifies what file format to use for saving project files (e.g., .pva, .pvn, .tst, .changetemplate).
Conditional Content Product: (Virtualize) Product: (Virtualize) sv-attr:0A010204015A9054C88481D043445E2F 0A010204015A9054C88802B9600247DFSee Understanding the Available Project File Formats in Virtualize for additional information about each type, including performance and forward compatibility.
- Default timeout (milliseconds): Allows you to enter the length of delay (in milliseconds) after which SOAtest should consider your FTP, telnet, or HTTP requests to be “timed out.” The default is 30000 milliseconds.
- Report each duplicate error that occurs on the same line: Tells SOAtest to show only the first instance of duplicate errors that occur for the same line of code.
- Reset Cookies: Allows you to clear the current global cookies so that next HTTP invocations start a new session.
- Enable the Automatically backup project files option and specify a file size threshold for .tst and/or .pva files in the Warn on file size large than (MB) field to be notified when the size of the file exceeds the threshold. You can then reduce the size (and prevent performance problems) by dividing it into smaller files.
...
- Global HTTP Authentication Properties: Allows you to specify global HTTP authentication properties that can be used when configuring HTTP protocols within an applicable tool. Select the Perform Authentication check box and enter the Username and Password to authenticate the request, and select either Basic, NTLM, or Digest, from the Authentication Type drop-down list. For Kerberos, enter the Service Principal to authenticate the request. If the correct username and password, or the correct service principal, are not used, the request will not be authenticated.
- Kerberos realm: Specify the Kerberos realm associated with your network. By convention, this is typically your domain name in all caps (e.g. PARASOFT.COM).
- KDC server: Specify the hostname of your Key Distribution Center (e.g. kdc.parasoft.com).
Check Ticket: This will execute a simple test to locate a cached Kerberos TGT (Ticket Granting Ticket) to grant access to the service. SOAtest and/or Virtualize will not be able to communicate with the service if it cannot first locate a valid TGT. For more information about Kerberos, see
Conditional Content Product: (Virtualize) Product: (Virtualize) sv-attr:0A010204015A9054C88481D043445E2F 0A010204015A9054C88802B9600247DF Configuring Kerberos Authentication. Trust all certificates: Enable this Trust all certificates: Enable this option to accept any certificate. This is useful if you want to load pages whose certificates are not "trusted."
Use default Java cacerts: Enable this option to accept only certificates from the standard list of Java-trusted certificate vendors.
- Use client keystore: Enables you to specify settings for both the server side and client side certificates for SSL through the Client Keystore options.
...
Tip | ||
---|---|---|
| ||
If you want to quickly add a large number of jar files—or add jars to a headless instance of your Parasoft solution— copy them into one of the following directories within your workspace:
| Product: (SOAVirt, Virtualize) | Product: (SOAVirt, Virtualize) |
sv-attr:0A010204015A9054C88481D043445E2F | 0A010204015CF6008A11EEF43AC91334 0A010204015A9054C88802B9600247DF | |
Conditional Content | ||
Product: (SOAVirt, Virtualize) | Product: (SOAVirt, Virtualize)||
sv-attr:0A010204015A9054C88481D043445E2F | 0A010204015CF6008A11EEF43AC91334 0A010204015A9054C88802B9600247DF |
Traffic File Processing Settings
The Traffic File Processing panel lets you globally indicate that you want certain values (such as times-tamps) ignored whenever:
- you are creating parameterized .pvas from traffic, and
- request body correlations are configured automatically.
Virtualize is automatically configured to ignore timestamps—based on the regular expression [0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,3})?(([+-][0-9]{2}:[0-9]{2})|Z)?
You can add or modify exclusions using the table controls. Element names are specified as exact matches or using a wildcard (*) to match everything. Values are specified as regular expressions.
WSDL History
The WSDL panel lets you review or modify the WSDLs that have been used in tools and projects. These WSDLs will be available for selection in relevant drop-down boxes. This way, if you need to specify the same WSDL multiple times, you don’t need to constantly type it in over and over again.
...
The XML Conversion settings panel lets you register data models for fixed length messages.
...
...
For details on using this setting, see Fixed Length Message Responder.
XML Schema History Settings
...
The XML Schema Locations panel lets you view, add, and remove schema locations.To add a new schema location:
...
- Click the Add button beneath the OASIS XML Catalog Locations section of the Schema Locations tab. The Location dialog box displays.
- Type in the OASIS XML Catalog Location or Browse to it by clicking the Browse button.
- Click OK after you have added all of the necessary locations.
...
Anchor | ||||
---|---|---|---|---|
|
There are two ways to define localsettings files:
- Enter them manually in a simple text file simple text file. There are no name or location requirements. Each local setting should be entered in a single line.
- Export your GUI preferences, then adjust or extend them as needed. To export, choose Parasoft> Preferences, select Parasoft (the root element in the left tree), click the Share link, specify which settings you want to export.
Localsettings files can specify the following settings.
Licensing Settings
Setting | Purpose |
---|---|
virtualize.license. use_network=true|false | Determines whether the current installation retrieves its license from LicenseServer. |
virtualize.license. network.host=[host] | Specifies the machine name or IP address of the machine running LicenseServer Configuration Manager. Example:
|
virtualize.license. network.port=[port] | Specifies the LicenseServer port number. Example:
|
virtualize.license. network.edition=[edition_name] | Specifies the type of license that you want this installation to retrieve from LicenseServer.
Example:
|
virtualize.license.autoconf.timeout=[seconds] | Specifies the maximum number of seconds this installation will wait for the license to be automatically configured from LicenseServer. Default is 10. |
virtualize.license. local.expiration=[expiration] | Specifies the local license that you want this installation to use. |
virtualize.license. local.password=[password] | Specifies the local password that you want this installation to use. |
virtualize.license.wait.for.tokens.time=[time in minutes] | Specifies the time that this installation will wait for a license if a license is not currently available. For example to make it wait 3 minutes for license tokens, use |
See Manually Adding the License to localsetttings for additional notes and examples.
Virtualize Settings
Setting | Purpose |
---|---|
server.startup | Determines whether the server is automatically started upon Virtualize startup. |
server.port.http | Specifies the port that the Virtualize Server uses for HTTP. |
server.port.https | Specifies the port that the Virtualize Server uses for HTTPS. |
server.port.monitoring | Specifies the port that the Virtualize Server uses for monitoring. |
system.properties.class- path=[path1];[path2];[path3] ... | Specifies which jar files and class folders are in the classpath. For example: |
scripting.timeout.minutes | Specifies the number of minutes after which Virtualize will attempt to stop an unresponsive script and log an error message. |
scripting.jython.home | Specifies the Jython installation directory. This must be a single directory. |
scripting.jython.path | Used to add to your path modules that are not in your jython.home/Lib directory. Multiple paths can be listed. |
parasoft.event.monitoring.broker.port | Specifies the port number for the event monitor. Add this setting to the JVM arguments. If you don't set this property, port 9617 is used by default. If the default number is being used by another application, the even monitor will scan for open ports incrementally starting with the default. |
parasoft.server.statistics.broker.port | Specifies the port number for the server statistics collector. Add this setting to the JVM arguments. If you don't set this property, port 9618 is used by default. If the default number is being used by another application, the statistics broker will scan for open ports incrementally starting with the default. |
parasoft.mq.environment.ccsid | Specifies a CCSID to connect ot he MQ queue manager. Contact your MQ administrator for additional information. |
datasources.jdbc.classpath=[path1];[path2];[path3] ... | Specifies the location of JDBC driver jar files and class folders. Special characters (spaces, slashes, colons, etc.) must be escaped; for instance: %20 = SPACE %3A = : %5C = \ %7B = { %7D = } %24 = $ If listing multiple jars, use \n as a delimiter. For example, becomes
|
traffic.wizard.xpath.ignores | Lets you globally indicate that you want certain values (such as times-tamps) ignored whenever:
Exclusions are specified in the format
For example:
Note that when the backslash character (\) is used in the regular expression, it needs to be escaped. For example, the regex [\d], which represents a single digit, would be entered as [\\d]. |
Continuous Testing Platform Settings
Setting | Purpose |
---|---|
env.manager.server | Specifies the location of the CTP server. Required Example: env.manager.server=http://em_hostname:8080/ |
env.manager.server.name | Specifies the name that will be used to label this server on CTP.You can use whatever value will help you identify this server. Optional Example: env.manager.server.name=MyVirtServerLabel |
env.manager.notify | Determines whether the Virtualize server notifies Parasoft CTP when virtual assets are deployed. Optional Example: env.manager.notify=true |
env.manager.username | Specifies the username for logging into CTP. Optional Example: env.manager.username=me |
env.manager.password | Specifies the password for logging into CTP. Optional Example: env.manager.password=12345 |
Miscellaneous Settings
Setting | Purpose |
---|---|
dtp.autoconfig=true|false | Enables autoconfiguration with Parasoft Test settings stored on the DTP server. Default: |
dtp.enabled=true|false | Determines whether the current Parasoft Test product is connected to DTP. Default: |
dtp.server=[host] | Specifies the host name of the DTP server. |
dtp.port=[port] | Specifies the DTP server port. |
console.verbosity.level=low|normal|high | Specifies the verbosity level for the Console view. Available settings are:
|
parallel.mode=Manual|Auto|Disabled | Determines which of the following modes is active:
|
parallel.max_threads=<number> | Specifies the maximum number of parallel threads that can be executed simultaneously. The actual number of parallel threads is determined based on the number of CPUs, available memory, and license settings. |
parallel.free_memory_limit=<percentage> | Specifies the amount of memory that should be kept free in low memory conditions (expressed as a percentage of the total memory available for the application). This is used to ensure that free memory is available for other processes. |
parallel.no_memory_limit=true|false | Indicates that you do not want to place any restrictions (beyond existing system limitations) on the memory available to the product. |
tasks.clear=true|false | Clears existing tasks upon startup in cli mode. This prevents excessive time being spent "loading existing results." The default is true. |
security.trust.all.certificatestrue|false | Tells Virtualize that you want it to accept any certificate. This is useful if you want to load pages whose certificates are not "trusted." |
security.use.default.java.cacertstrue|false | Tells Virtualize that you want it to accept only certificates from the standard list of Java trusted certificate vendors. |
Manually Adding the License to localsetttings
To add or change license settings vialocalsettings:
- If you will be using a custom edition license, define the appropriate license features in the localsettings as follows:
[product].license.custom_edition_features= All enabled features
Note that license feature settings apply only to custom edition licenses. Define the main license settings in the localsettings as follows:
Code Block virtualize.license.network.edition= Type of license edition virtualize.license.use_network= Value (true or false) license.network.host= Host name license.network.port= Port number
Here are several examples of properly-configured license settings in localsettings file:
Virtualize network license - desktop edition
Code Block |
---|
virtualize.license.network.edition=desktop_edition
virtualize.license.use_network=true
license.network.host=main1.parasoft.com.pl
license.network.port=2222 |
Virtualize network license -custom edition with various features
Code Block |
---|
virtualize.license.custom_edition_features=Virtualize, Server, Message Packs, Unlimited Million Hits / Day
virtualize.license.network.edition=custom_edition
virtualize.license.use_network=true
license.network.host=main1.parasoft.com.pl
license.network.port=2222 |
Virtualize network license -custom edition with various features
Code Block |
---|
virtualize.license.local.expiration=2014-04-15
virtualize.license.local.password=PARASOFT_353E2A7DA4F3D4B2FF142B0A262AF62B9DEC3449 C124773BAF0B4B508FF21139E867D9772F3702716FCE6D8EA16ACE668DE0EE629D154713599203BD85CE1213_7937E7ED374E70FDD62EE8411C2BB2D8EB465019E64BF3EF3A87DE6B67FB10BBCAF8611B08F70 D9420AC574FC5B3E5EB7241B20506DE2C60B0D80462CBEDBD
virtualize.license.use_network=false |
Note that with local licenses, the enabled features are specified via the generated password.