Working with web server JVM properties files

You can use properties files to modify or delete Java™ virtual machine (JVM) properties of web servers.

Before you begin

Determine the changes that you want to make to your JVM properties configuration or its configuration objects.

Start the wsadmin scripting tool. To start wsadmin using the Jython language, run the wsadmin -lang jython command from the bin directory of the server profile.

About this task

Using a properties file, you can modify or delete a JVM object.

Run administrative commands using wsadmin to change a properties file for a JVM, validate the properties, and apply them to your configuration.

Table 1. Actions for JVM properties files . You can modify or delete JVM objects.
Action Procedure
create Not applicable
modify Edit properties and then run the applyConfigProperties command to modify the value of a custom property.
delete Specify the properties to delete in the properties file and then run the deleteConfigProperties command to delete a property. If the deleted property has a default value, the property is set to the default value.
create Property Not applicable
delete Property Not applicable

Optionally, you can use interactive mode with the commands:

AdminTask.command_name('-interactive')

Procedure

  • Modify existing web server JVM properties.
    1. Obtain a properties file for the JVM that you want to change.

      You can extract a JavaVirtualMachine properties file using the extractConfigProperties command.

    2. Open the properties file in an editor and change the custom properties as needed.

      Open an editor and specify JVM custom properties in a properties file. You can copy the following example properties into an editor and modify the properties as needed for your situation. To specify a custom property, edit the AttributeInfo value and properties values. Ensure that the environment variables in the properties file match your system.

      #
      # Header
      #
      ResourceType=JavaVirtualMachine
      ImplementingResourceType=Server
      ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JavaProcessDef=:JavaVirtualMachine=
      AttributeInfo=jvmEntries
      
      #
      #Properties
      #
      internalClassAccessMode=ALLOW #ENUM(ALLOW|RESTRICT),default(ALLOW)
      JavaHome="C:\cf50922.30\test/java" #readonly
      debugArgs=
      classpath={}
      initialHeapSize=0 #integer,default(0)
      runHProf=false #boolean,default(false)
      genericJvmArguments=
      hprofArguments=
      osName=null
      bootClasspath={}
      verboseModeJNI=false #boolean,default(false)
      maximumHeapSize=0 #integer,default(0)
      disableJIT=false #boolean,default(false)
      verboseModeGarbageCollection=false #boolean,default(false)
      executableJarFileName=null
      verboseModeClass=false #boolean,default(false)
      debugMode=false #boolean,default(false)
      
      #
      EnvironmentVariablesSection
      #
      #
      #Environment Variables
      cellName=myNode04Cell
      nodeName=myNode04
      serverName=IHS
    3. Run the applyConfigProperties command to change a JVM properties configuration.

      Running the applyConfigProperties command applies the properties file to the configuration. In this Jython example, the optional -reportFileName parameter produces a report named report.txt:

      AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])
  • Delete web server JVM properties.

    To delete one or more properties, specify only those properties to delete in the properties file and run deleteConfigProperties.

    AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]') 

Results

You can use the properties file to configure and manage the JVM object and its properties.

What to do next

Save the changes to your configuration.