Predefined configuration
When installing OpenWebStart, several properties can be predefined in a so-called response.varfile file.Some of the supported properties are lockable. If a property is lockable, you can define an additional property of type PROPERTY_NAME.locked=true to prevent users from editing the property in the user interface. For example, to define a value for the ows.jvm.manager.server.default property that cannot be changed in the user interface, specify the following two properties:
ows.jvm.manager.server.default=https://my.custom.server
ows.jvm.manager.server.default.locked=true
ows.jvm.manager.server.default.locked=true
The following table provides an overview of all properties that can be specified in the response.varfile :
| Property | Lockable | Description |
|---|---|---|
| ows.jvm.manager.cache.dir | Allows to specify the directory where the JVM cache is located. The follow example shows two examples for Windows: ows.jvm.manager.cache.dir=c:\\temp\\JVMCacheDir or ows.jvm.manager.cache.dir=c\:/temp/JVMCacheDir | |
| ows.jvm.manager.server.default | This property must contain a valid URL that defines the server that is used to download new JVMs. | |
| ows.jvm.manager.server.allowFromJnlp | Defines if a custom URL can be used to download a JVM. Such URL can be part of a JNLP file. | |
| ows.jvm.manager.vendor | Defines a specifc JVM vendor. By doing so, only JVMs from that vendor will be downloaded. You can use ‘*’ to allow any vendor. | |
| ows.jvm.manager.vendor.allowFromJnlp | Defines if a vendor attribute in a java/j2se tag of the JNLP file should be respected. Default is false i.e. the vendor from the settings is taken. | |
| ows.jvm.manager.updateStrategy | When starting a JNLP application, OpenWebStart can check if an updated JVM is available to run the application. This property defines how OpenWebstart behaves in the JVM check. Possible values are DO_NOTHING_ON_LOCAL_MATCH, ASK_FOR_UPDATE_ON_LOCAL_MATCH and AUTOMATICALLY_DOWNLOAD | |
| ows.jvm.manager.versionRange | Allows to limit the possible JVM versions. Must be valid version-string according to JSR-56 Appendix A. | |
| deployment.proxy.http.host | The HTTP proxy hostname. | |
| deployment.proxy.https.host | The HTTPS proxy hostname. | |
| deployment.proxy.http.port | The HTTP proxy port. | |
| deployment.proxy.https.port | The HTTPS proxy port. | |
| deployment.proxy.bypass.local | All local hosts should be bypassed. Default is false. | |
| deployment.proxy.bypass.list | A comma separated list of host names that should bypass the proxy. | |
| deployment.proxy.type | The proxy type that should be used. Possible values are 0 (no proxy), 1 (manual proxy, default), 2 (PAC based proxy), 3 (Firefox), 4 (system proxy) | |
| deployment.proxy.auto.config.url | The URL for the proxy auto-config (PAC) file that will be used. | |
| deployment.proxy.same | If true use the same web server and port for https and ftp as is configured for http. (This is only valid if deployment.proxy.type = 1 (manual proxy). Default is false. | |
| deployment.cache.max.size | The cache maximum size. Default is -1. | |
| deployment.https.noenforce | If set to true http urls are not converted to https. Default is false. | |
| deployment.assumeFileSystemInCodebase | Defines if files from the local filesystem are always handled as if they would be part of the codebase. | |
| deployment.security.whitelist | A comma separated list of urls that are defined as whitelist. The whitelist is checked whenever OpenWebStart will download a resource (like a JAR file). | |
| ows.jvm.manager.maxDaysUnusedInJvmCache | Max number of days an unused JVM stays in the JVM cache. The default is 30. | |
| deployment.log | If set to true debug logging is enabled. Default is false. | |
| deployment.log.file | If set to true log is outputted to file. Default is false. | |
| ows.update.activated | Defines if OpenWebStart should automatically search for updates. | |
| ows.checkUpdate | This property has no effect and is only used to lock functionality in the user interface. If this property is locked, a user cannot manually search for OpenWebStart updates. | |
| ows.update.strategy.settings | Defines how often OpenWebStart should search for updates when opening the settings windows. Allowed values are ON_EVERY_START, DAILY, WEEKLY, MONTHLY, and NEVER. | |
| ows.update.strategy.launch | Defines how often OpenWebStart should search for updates when starting an application. Allowed values are ON_EVERY_START, DAILY, WEEKLY, MONTHLY, and NEVER. |
To create a response.varfile file, run the installation of OpenWebStart at least once manually. By doing so a response.varfile file is created in OpenWebStart installation folder in your system. In the installation folder, you find a .install4j folder that contains the basic response.varfile file. The content of such a file looks like this:
sys.adminRights$Boolean=false
sys.fileAssociation.extensions$StringArray="jnlp","jnlpx"
sys.fileAssociation.launchers$StringArray="313","313"
sys.installationDir=/Applications/OpenWebStart
sys.languageId=de
sys.fileAssociation.extensions$StringArray="jnlp","jnlpx"
sys.fileAssociation.launchers$StringArray="313","313"
sys.installationDir=/Applications/OpenWebStart
sys.languageId=de
You can easily edit this file and add additional properties based on the table in this article. Do not change the initial content of the file, and add new properties always to the end of the file. After editing, a response.varfile file might look like this:
sys.adminRights$Boolean=false
sys.fileAssociation.extensions$StringArray="jnlp","jnlpx"
sys.fileAssociation.launchers$StringArray="313","313"
sys.installationDir=/Applications/OpenWebStart
sys.languageId=de
ows.jvm.manager.server.default=https://my.custom.server
ows.jvm.manager.server.default.locked=true
sys.fileAssociation.extensions$StringArray="jnlp","jnlpx"
sys.fileAssociation.launchers$StringArray="313","313"
sys.installationDir=/Applications/OpenWebStart
sys.languageId=de
ows.jvm.manager.server.default=https://my.custom.server
ows.jvm.manager.server.default.locked=true
If you now use such a file to install OpenWebStart, all the properties will be automatically imported and used at the first start of OpenWebStart.