Customizing Java Virtual Machine system properties and files

You can specify Java Virtual Machine system properties and files for saving the QMF for Workstation/WebSphere system properties and files, especially when you configure a cluster to share application settings and other folders among cluster nodes and to set a timeout for a user session.

About this task

By default, all QMF for Workstation/WebSphere system properties and files are stored in the user home directory, the path to which is in the user.home Java Virtual Machine system property. But you can use qmf.instance.area.global, qmf.instance.area.shared, or qmf.instance.area Java Virtual Machine system properties to customize the directories for storing files.

If you want to specify a timeout for a user session to close the session when the user does not work with application, use the qmf.use.session.timeout parameter.

Use the VirtualDataSource.dir parameter for QMF for WebSphere® to avoid possible errors when working with virtual data sources in cluster mode.

You can configure the number of files to be imported by configuring qmf.websecurity.fileupload.restriction parameter for QMF for WebSphere

You can allow loading of QMF for WebSphere or QMF Server inside an iFrame by configuring qmf.websecurity.allow.iframe and qmf.websecurity.allow.iframe.weblink parameters.

The following table describes the available parameters.

Table 1. Java Virtual Machine parameters
Parameter	Description	Stored files
`qmf.instance.area.global`	This property is responsible for the folder that is distributed among several cluster nodes. It is used to store server configuration files, scheduled tasks, and personal repositories. If this parameter is not set, the settings from the `qmf.instance.area` are applied.	Repository connections data (`repositories.xml`) JDBC drivers properties (`.bi.jdbc.drivers`) License files Cache files
`qmf.instance.area.shared`	This property is responsible for the application folder that is shared among several cluster nodes. If this parameter is not set, the settings from the `qmf.instance.area` are applied.	Log files Session data: User settings User global variables Logins and passwords
`qmf.instance.area`	This property is responsible for storing temporary files. If this parameter is not set, the settings from the `java.io.tmpdir` Java Virtual Machine system property are applied. Note: In the cluster mode, to ensure the correct work of QMF Server features that require access to the file system, such as scheduled tasks, make sure that every cluster node that has access to this folder has full read and write permissions for the files in this folder.	Temporary files
`qmf.use.session.timeout`	This property is responsible for the timeout of a user session. If it is set to true, the user session is closed after the HTTP session timeout that is specified on the server. If this parameter is set to false or not defined, the session is active until the user closes the application.	-
`VirtualDataSource.dir`	Specifies the name of a subfolder with a virtual data source cache. For each cluster node, an individual subfolder with respective files and directories, including the cache, is generated. The VirtualDataSource.dir property must specify a unique value for each of the cluster nodes.	-
`qmf.websecurity.fileupload.restriction`	Specifies limits for the file import. maximum file imports allowed in time interval: specify values between 1 and 255 time interval (in seconds): specify values between 1 and 2147483 time (in seconds) when file upload is disabled, after limits: specify values between 1 and 2147483 For example: -Dqmf.websecurity.fileupload.restriction = 4, 30, 120 5 files can be uploaded in duration of 30 seconds. 6^th file can be uploaded after 120 seconds from the upload time of the 5^th file. -Dqmf.websecurity.fileupload.restriction = 4, 30 Error will be written in the log file, unrestricted file uploads are allowed. Dqmf.websecurity.fileupload.restriction = 4, 30, 2147483 5 files can be uploaded in duration of 30 seconds. 6^th file can be uploaded after 2147483 seconds from the upload time of the 5^th file -Dqmf.websecurity.fileupload.restriction=0,30, 2147483 Error will be written in the log file, unrestricted file uploads are allowed.	-
`qmf.websecurity.allow.iframe`	The default value of this parameter is "no". When you change it to "yes", the configuration allows you to load QMF for WebSphere inside iFrame.	-
`qmf.websecurity.allow.iframe.weblink`	The default value of this parameter is "no". When you change it to "yes", the configuration allows you to load WebLink inside iFrame.	-

To specify particular paths for saving system properties and files:

Procedure

For QMF for Workstation
1. In the application installation directory, open the eclipse.ini file.
2. Add the parameters the value of that you want to customize with the -D prefix and specify the path for the new storage. For example, -Dqmf.instance.area=C:\work\
3. Save the eclipse.ini file.
For QMF for WebSphere:
1. Start the WebSphere Administrative Console by opening a web browser on a client machine, and entering the appropriate URL.
2. Navigate to the Process definition and, in the Custom properties for Java Virtual Machine, add the required properties qmf.instance.area.global, qmf.instance.area.shared, qmf.instance.area, or qmf.use.session.timeout depending on the parameters that you want to modify.
3. Save the added parameters.