### Install for All Users Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set the `userMode` property to `1` in the `response.varfile` to install OpenWebStart for all users on the system. ```properties userMode$Integer=1 ``` -------------------------------- ### Install OpenWebStart on Linux Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use this command to install OpenWebStart using the DEB package on Linux. Ensure you have root privileges. ```bash sudo dpkg -i OpenWebStart_linux_1_1_8.deb ``` -------------------------------- ### Unattended Installation Properties Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Example properties for an unattended installation of OpenWebStart. These are defined in a `response.varfile`. ```properties ows.jvm.manager.server.default=https://my.custom.server ows.jvm.manager.server.default.locked=true ``` ```properties sys.adminRights$Boolean=false sys.fileAssociation.extensions$StringArray="jnlp","jnlpx" sys.fileAssociation.launchers$StringArray="313","313" sys.installationDir=/Applications/OpenWebStart sys.languageId=de ``` ```properties 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 ``` -------------------------------- ### Install for Current User Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set the `userMode` property to `0` in the `response.varfile` to install OpenWebStart only for the current user. ```properties userMode$Integer=0 ``` -------------------------------- ### Install Prerequisite Tools Source: https://github.com/karakun/openwebstart/blob/master/INSTALL.md Install the necessary build tools and Java 8 JDK via the package manager. ```bash sudo apt install git maven openjdk-8-jdk ``` -------------------------------- ### Execute Unattended Installer Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Commands to run the OpenWebStart installer in silent mode using a response file. ```bash -q -varfile response.varfile ``` ```bash hdiutil attach OpenWebStart_macos_1_x_x.dmg /Volumes/OpenWebStart/OpenwebStart\ Installer.app/Contents/MacOS/JavaApplicationStub -q -varfile response.varfile hdiutil detach /Volumes/OpenWebStart ``` -------------------------------- ### Example JNLP File 1 Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc An example JNLP file demonstrating resource definitions, including JVM arguments and properties. ```xml jvm_args_1.jnlp: ``` -------------------------------- ### Example JNLP File 2 Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc A second example JNLP file showcasing different JVM arguments and properties, including module additions. ```xml jvm_args_2.jnlp : ``` -------------------------------- ### Run Installer without Admin Rights Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set `sys.adminRights` to `false` in the `response.varfile` to run the installer without requiring administrator privileges. ```properties sys.adminRights$Boolean=false ``` -------------------------------- ### Configure JVM Cache Directory Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Examples of setting the JVM cache directory path on Windows. ```properties ows.jvm.manager.cache.dir=c:\temp\JVMCacheDir ows.jvm.manager.cache.dir=c:/temp/JVMCacheDir ``` -------------------------------- ### Configure System Configuration URL Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Examples of setting the deployment.system.config property with escaped special characters for different file paths and URLs. ```properties deployment.system.config=file\:/C\:/Windows/Sun/Java/global.properties ``` ```properties deployment.system.config=file\:/etc/.java/deployment/base.properties ``` ```properties deployment.system.config=https\://192.168.1.1./javaws/system.properties ``` -------------------------------- ### Override Installation Directory via Command Line Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use the -dir argument to specify an installation path relative to the user profile. ```bash OpenWebStart_windows-x64_x_x_x.exe -q -varfile response.varfile -dir %USERPROFILE%\ ``` -------------------------------- ### Resulting JVM Arguments Example Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Illustrates the final combined JVM arguments for a specific JNLP file after merging with `deployment.properties` overrides. Properties defined later in the merge process take precedence. ```text -Xmx512m, -Xms256m, -Djnlp.ccc=jnlp, -Djavaws.xyz=jnlp, -Dsun.java2d.dpiaware=true, -Djnlp.prop=jnlp, -Dhttp.agent=jnlp, -Xmx2048m, -Xms512m, -Dabc=dep, -Ddepprop=dep, -Dmy.prop=depprop, -Djavaws.xyz=dep, -Djnlp.ccc=dep, -Dsun.java2d.dpiaware=false, -Dhttp.agent=BBBB ``` -------------------------------- ### Configure Admin Rights in response.varfile Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set the admin rights property within the response.varfile for unattended installations. ```properties sys.adminRights$Boolean=true ``` -------------------------------- ### Enable Experimental Application Manager Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set this property in deployment.properties to enable the experimental application management feature, which allows starting, creating shortcuts for, and deleting downloaded applications. ```properties ows.experimental.applicationManager.active=true ``` -------------------------------- ### Configure JNLP Resources and Application Descriptor Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Example of defining Java versions, JAR dependencies, and the main application class within a JNLP file. ```xml Karakun AG ``` -------------------------------- ### Configure JNLP for JavaFX 11 Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Example JNLP structure for deploying JavaFX 11 applications. ```xml JavaFX 11 App ``` -------------------------------- ### Specify Manifest Attributes to Check Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Configure specific manifest attributes to be checked by OWS by providing a comma-separated list. This example excludes the PERMISSIONS attribute. ```properties deployment.manifest.attributes.check= CODEBASE, TRUSTED, ALAC, ENTRYPOINT ``` -------------------------------- ### Portable Update Files Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Core files that require manual updates when upgrading the portable OpenWebStart installation. ```text \openwebstart.jar (the application must be updated) \jre\ (the bundled JRE which is used to run OpenWebStart) ``` -------------------------------- ### Start JNLP Application in Offline Mode Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Use this command to launch a previously cached JNLP application without accessing a server. Ensure all necessary JAR files are present in the cache. ```bash javaws -Xoffline myapp.jnlp ``` -------------------------------- ### Configure JNLP for JavaFX 8 Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Specify a JVM vendor and a JSON server URL in the JNLP file to ensure the correct JavaFX-enabled JDK is installed. ```xml JavaFX 8 App Karakun AG ``` -------------------------------- ### Build Projects Source: https://github.com/karakun/openwebstart/blob/master/INSTALL.md Commands to build the IcedTea-Web dependency and the OpenWebStart project. ```bash mvn install ``` ```bash ./mvnw install ``` -------------------------------- ### Define System Configuration File Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc A sample deployment.config file defining the system configuration URL and mandatory loading requirement. ```properties deployment.system.config=https\://192.168.1.1./javaws/system.properties deployment.system.config.mandatory=true ``` -------------------------------- ### Launch JNLP with Arguments Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Passes arguments to the main method of the application launched via OpenWebStart. ```bash argarray=("${@:1:$#-1}") open -a "OpenWebStart javaws" "$jnlp" --args "${argarray[@]}" ``` -------------------------------- ### MacOS OpenWebStart Wrapper Script Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use this script to wrap OpenWebStart invocations on MacOS, ensuring the JNLP file or URL is passed as the final argument. ```bash #!/bin/bash # A wrapper for OpenWebStart that behaves like 'javaws' on MacOS. if [ "$#" -lt 1 ]; then echo "Must provide at least a JNLP file or URL" exit 1 fi # The JNLP file or URL which much be at the end of the argument list. jnlp=${!#} ``` -------------------------------- ### Configure Local JVM Search Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Settings to control how OpenWebStart discovers JVMs on the local file system. ```properties ows.jvm.manager.searchLocalAtStartup=true ows.jvm.manager.excludeDefaultSearchLocation=true ows.jvm.manager.customSearchLocation=c\:/path/to/jvm,c:\\path\\to\\other\\jvm ``` -------------------------------- ### Define server whitelist Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Add a comma-separated list of servers to the deployment.properties file to restrict resource downloads. ```properties deployment.security.whitelist=10.10.10.10, google.com, some.server.net ``` -------------------------------- ### OpenWebStart Log File Naming Convention Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc OpenWebStart generates log files for different stages of application launch. These files follow a specific naming convention that includes a timestamp and stage number. ```plaintext -ows-stage.log ``` ```plaintext -ows-settings.log ``` -------------------------------- ### Specify 32-bit JVM in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use the `require-32bit` attribute in the JNLP file to force OpenWebStart to use a 32-bit JVM on a 64-bit machine. ```xml ``` -------------------------------- ### Whitelist Additional JVM Arguments Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Extend the list of allowed JVM arguments by specifying them in the `deployment.properties` file. Only the argument name should be listed. ```properties deployment.jvm.arguments.whitelist=-Dnew_jvm_arg1, -Dnew_jvm_arg2 ``` -------------------------------- ### Execute OWS from Portable Media Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Command syntax for launching the javaws executable with a JNLP file or URL. ```bash javaws.exe [url-to-jnlp | path-to-jnlp] [options] ``` -------------------------------- ### Launching JNLP Application via Command Line (Mac) Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use this command to launch a JNLP application on macOS. This command opens the specified JNLP file with the OpenWebStart javaws application. ```bash open -a "OpenWebStart javaws" ``` -------------------------------- ### Configure Portable Environment Variables Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Environment variables to redirect cache and configuration directories for portable usage. ```text XDG_CACHE_HOME (default value is %USER_HOME%\.cache) XDG_CONFIG_HOME (default: %USER_HOME%\.config) ``` -------------------------------- ### Enforce 32-bit JVM in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Use the require-32bit attribute to force OpenWebStart to use a 32-bit JVM on 64-bit systems. ```xml ``` -------------------------------- ### Configure System-wide Trust Store Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Specify a central trust store and link it via the system-wide deployment configuration file. ```properties deployment.system.security.trusted.certs=\\trusted.certs deployment.system.security.trusted.certs.locked ``` ```properties deployment.system.config=file:////itw.properties deployment.system.config.mandatory=true ``` -------------------------------- ### Launching JNLP Application via Command Line (Windows) Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use this command to launch a JNLP application on Windows. Ensure 'javaws' is in your system's PATH. ```bash javaws ``` -------------------------------- ### Set JAVA_HOME Environment Variable Source: https://github.com/karakun/openwebstart/blob/master/INSTALL.md Configure the JAVA_HOME path to ensure the correct Java version is used during compilation. ```bash export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/ ``` -------------------------------- ### Enable HTTP Redirects Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Allows the javaws command to follow HTTP redirects when fetching a JNLP file. ```bash javaws -allowredirect http://jogamp.org/deployment/archive/rc/v2.3.2/jogl-demos/Gears.jnlp ``` -------------------------------- ### Define JVM server whitelist Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Restrict JVM downloads to specific server URLs by adding a whitelist entry to the deployment properties. ```properties ows.jvm.manager.server.allowFromJnlp.whitelist=myjvms.myserver.com, *.jvms.com ``` -------------------------------- ### JVM server JSON configuration Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc JSON format used by the JVM server to define available runtimes for OpenWebStart. ```json { "cacheTimeInMillis":5000, "runtimes": [ { "version":"1.8.0_252", "vendor":"Zulu Community Edition", "os":"WIN64", "href":"https://cdn.azul.com/zulu/bin/zulu8.46.0.19-ca-fx-jdk8.0.252-win_x64.zip" } ] } ``` -------------------------------- ### Configure Manifest Attribute Checking Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set the deployment.manifest.attributes.check property in deployment.properties to control which manifest attributes OWS checks. The default is ALL. Use NONE to disable all checks. ```properties deployment.manifest.attributes.check=NONE ``` -------------------------------- ### Lock Configuration Properties Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Enforce configuration settings by adding a .locked postfix to the property key. ```properties ows.jvm.manager.server.default=https\://192.168.1.1/jvms.json ows.jvm.manager.server.default.locked=true ``` -------------------------------- ### Set Global JVM Arguments via Environment Variable Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Use the `JAVAWS_VM_ARGS` environment variable to apply JVM arguments to all JNLP files. ```bash set JAVAWS_VM_ARGS=-Xss2048k -Xmx4096m ``` -------------------------------- ### List Supported JVM Vendor Names Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Valid vendor names or aliases that can be used in the JNLP vendor attribute. ```text "*" "AdoptOpenJDK", "Adopt" "Amazon.com Inc.", "Amazon Inc.", "Amazon" "Azul Systems, Inc.", "Azul" "BellSoft" "Eclipse Adoptium", "Adoptium" "Oracle Corporation", "Oracle" ``` -------------------------------- ### Use Whitelisted JVM Arguments in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Include JVM arguments in the JNLP file that have been previously whitelisted in `deployment.properties`. ```xml ``` -------------------------------- ### Specify JVM Server in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Allows the JNLP file to specify the location of the JVM download server. ```xml ``` -------------------------------- ### Implement JavaFX Launcher Class Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Required launcher pattern for JavaFX applications running on Java 11 or higher. ```java // Launcher for JavaFX application which is specified in the Jnlp file public class FXAppLauncher { public static void main(String[] args) { FXApp.main(args); } } // JavaFX Application public class FXApp extends Application { public static void main(String[] args) { launch(args); } @Override public void start(Stage primaryStage) { ... // JavaFX code } ... } ``` -------------------------------- ### Specify JVM Version and Arguments in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Configures the required JVM version and heap memory arguments for a JNLP application. ```xml ``` -------------------------------- ### Pass arguments to JNLP application Source: https://github.com/karakun/openwebstart/blob/master/documentation/faq/FAQ.adoc Use the -arg flag to pass custom arguments to the application's main method. ```bash javaws -arg arg1=value1 arg2=value2 -jnlp ``` -------------------------------- ### Customize JVM Cache Location Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Set the directory for JVM caching in the deployment.properties file, which overrides XDG_CACHE_HOME. ```properties ows.jvm.manager.cache.dir=c:\\temp\\JVMCacheDir ``` -------------------------------- ### Specify JVM Arguments in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Define JVM arguments directly within the JNLP file using the `java-vm-args` attribute. ```xml ``` -------------------------------- ### Define Custom JVM Download Server JSON Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc The JSON structure required for a custom JVM download server. The cacheTimeInMillis field determines how often the client re-contacts the server. ```json { "cacheTimeInMillis":, "runtimes":[ { "version":, "vendor":, "os":, "href": }, ... more runtime definitions } ``` -------------------------------- ### Override JNLP JVM Arguments in deployment.properties Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Specify JVM arguments in `deployment.properties` to merge with or override those defined in specific JNLP files. Note the escaping of equals signs for properties. ```properties ows.jvmargs.for.jvm_args_1.jnlp=-Xmx2048m -Xms512m -Dabc\=dep -Ddepprop=dep -Dmy.prop\=depprop -Djavaws.xyz\=dep -Djnlp.ccc\=dep -Dsun.java2d.dpiaware\=false -Dhttp.agent\=BBBB ows.jvmargs.for.jvm_args_2.jnlp=-Xmx1024m -Ddepprop=dep -Xms512m -Dsun.java2d.dpiawared\=false -Dmy.prop\=depprop -Djavaws.xyz\=dep -Djnlp.ccc\=dep -Dsun.java2d.dpiaware\=false -Dhttp.agent\="BBBB" --add-opens\=java.desktop/sun.print\=ALL-UNNAMED --add-exports\=java.desktop/sun.print\=ALL-UNNAMED --add-modules\=java.sql ``` -------------------------------- ### Launching JNLP Application in Offline Mode (Windows) Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc This command launches a JNLP application in offline mode on Windows, preventing it from accessing the server for resources. The application must have been previously cached. ```bash javaws -Xoffline myApp.jnlp ``` -------------------------------- ### Specify JVM Vendor in JNLP Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Restricts the JVM selection to a specific vendor within the JNLP file. ```xml ``` -------------------------------- ### Launching JNLP Application in Offline Mode (Mac) Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc This command launches a JNLP application in offline mode on macOS, preventing it from accessing the server for resources. The application must have been previously cached. ```bash open -a "OpenWebStart javaws" myApp.jnlp --args -Xoffline ``` -------------------------------- ### Clear JNLP Cache Source: https://github.com/karakun/openwebstart/blob/master/documentation/guide/OWSGuide.adoc Removes cached JNLP applications from the local system. ```bash javaws -Xclearcache ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.