| Anchor |
|---|
| Localsettings |
|---|
| Localsettings |
|---|
|
Virtualize LocalsettingsThere 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.host=10.9.1.63
| virtualize.license. network.port=[port] | Specifies the LicenseServer port number. Example: virtualize.license.network.port=2222
| virtualize.license.network.edition=[edition_name] | Specifies the type of license that you want this installation to retrieve from LicenseServer. [edition_name] can be server_edition. To use a custom edition, do not set anything after the "="; simply leaving the value empty.
Example: virtualize.license.network.edition=desktop_edition
virtualize.license.network.edition=server_edition
| 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 virtualize.wait.for.tokens.time=3 to configure Virtualize to wait three minutes for a license token to become available. |
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: system.properties.classpath=C\:\\myjars\\myLib1.jar;C\:\\myjar s\\myLib2.jar | 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,
C:\temp\with
space\${example}\jar.jar becomes C%3A%5Ctemp%5Cwith%20space%5C$2 4%7Bexample%7D%5Cjar.jar\n
| traffic.wizard.xpath.ignores | Lets you globally indicate that you want certain values (such as times-tamps) ignored whenever: - you are creating parameterized .pvas from traffic, and
- requiest body correlations are configured automatically.
Exclusions are specified in the format traffic.wizard.xpath.ignores=[element name 1]:[value pattern 1];[element name 2]:[value pattern 2];[element name 3]:[value pattern 3]
For example: traffic.wizard.xpath.ignores=*:[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)?;uuid:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
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]. |
| 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: false | dtp.enabled=true|false | Determines whether the current Parasoft Test product is connected to DTP. Default: false | 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: low: Configures the Console view to show errors and basic information about the current step’s name and status (done, failed, up-to-date).
normal: Also shows command lines and issues reported during test and analysis.
high: Also shows warnings.
| parallel.mode=Manual|Auto|Disabled | Determines which of the following modes is active: - Auto: Allows the product to control parallel processing settings.
- Manual: Allows you to manually configure parallel processing settings to suit your specific needs.
- Disabled: Configures the product to use only one of the available CPUs.
| 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 localsetttingsTo 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. |