Administering System Properties

Shared server instances will often need to override attributes defined in their referenced configuration. Any configuration attribute can be overridden through a system property of the corresponding name.

The following topics are addressed here:

• To Create System Properties

• To List System Properties

• To Delete a System Property

To Create System Properties

The remote create-system-properties command enables you to add or update one or more system properties of the domain or configuration.

1. Ensure that the server is running.

   Remote commands require a running server.

2. Create system properties by using the create-system-properties(1) command.

Example 2–9 Creating a System Property

The following example command creates a system property associated with http-listener-port=1088 on localhost:

asadmin create-system-properties http-listener-port=1088

Information similar to the following is displayed:

Command create-system-properties executed successfully.

See Also

To see the full syntax and options of the command, type asadmin create-system-properties --help at the command line.

To List System Properties

The remote list-system-properties command enables you to list the system properties that apply to a domain or configuration.

1. Ensure that the server is running.

   Remote commands require a running server.

2. List system properties by using the list-system-properties(1) command.

   The existing system properties are displayed, including predefined properties such as HTTP_LISTENER_PORT and HTTP_SSL_LISTENER_PORT.

Example 2–10 Listing System Properties

The following example command lists the system properties on host localhost:

asadmin list-system-properties

Information similar to the following is displayed:

http-listener-port=1088
Command list-system-properties executed successfully.

See Also

To see the full syntax and options of the command, type asadmin list-system-properties --help at the command line.

To Delete a System Property

The remote delete-system-property command enables you to delete system properties. Any configuration attribute can be overwritten through a system property of the corresponding name.

1. Ensure that the server is running.

   Remote commands require a running server.

2. Obtain the exact name of the system property that you are deleting.

   To list the existing system properties:

   asadmin list-system-properties

3. Delete the system property by using the delete-system-property(1) command.

4. If necessary, notify users that the system property has been deleted.

Example 2–11 Deleting a System Property

The following example command deletes a system property named http-listener-port from localhost:

asadmin delete-system-property http-listener-port

Information similar to the following is displayed:

Command delete-system-property executed successfully.

See Also

To see the full syntax and options of the command, type asadmin delete-system-property --help at the command line.