9.2.1 Changing Application Server settings by using the set subcommand

To change Application Server settings, run the set subcommand of the asadmin utility command to change the setting values of Application Server.

Prerequisites

The domain administration server (DAS) is running.
Application Server has been set up.

Intended users

System engineers

Procedure

If you are using a hardware load balancer, then block it.

For more information about blocking, refer to the hardware load balancer manual.

If the performance tracer, server instance, and web server are not stopped, go to step 2.

If the performance tracer, server instance, and web server are already stopped, omit steps 1 to 5.
To stop all performance tracers, server instances, and web servers at the same time, execute the stop-servers subcommand of the asadmin utility command.
```
asadmin stop-servers
```
When this command is run, the result is displayed as follows:
```
Command stop-servers executed successfully.
```
To display a list of performance tracers, run the list-prfs subcommand of the asadmin utility command.
```
asadmin list-prfs
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the performance tracers are not running.
```
performance_tracer_name not running
Command list-prfs executed successfully.
```
To display a list of server instances, run the list-instances subcommand of the asadmin utility command with the --long option specified.
```
asadmin list-instances --long=true
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the server instances are not running.
```
server_instance_name host_name port_number process_ID cluster_name not running
Command list-instances executed successfully.
```
- cluster_name is displayed only for cluster configurations that contain multiple Java EE servers.
To display a list of web servers, run the list-webservers subcommand of the asadmin utility command.
```
asadmin list-webservers
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are not running.
```
web_server_name not running
Command list-webservers executed successfully.
```
To view the settings of Application Server, run the get subcommand of the asadmin utility command.
```
asadmin get "*"
```
In the execution results of the command, verify the identifier of the setting to be changed and the value before the change.

If a value is specified for multiple parameters, the specified value is treated as follows:

For performance tracer-related parameters:

When parameter values that start with both hitachi-prf.hitachi-prf.performance_tracer_name. and hitachi-prf-configs.hitachi-prf-config.configuration_name_of_the_performance_tracer are set, the value of the parameter that starts with hitachi-prf.hitachi-prf.performance_tracer_name. takes effect.

For web server-related parameters

When parameter values that start with both hitachi-webservers.hitachi-webserver.web_server_name and hitachi-webserver-configs.hitachi-webserver-config.configuration_name_of_the_web_server are set, the value of the parameter that starts with hitachi-webservers.hitachi-webserver.web_server_name takes effect.

For a server instance-related parameter

When parameter values that start with both servers.server.Java_EE_server_name and configs.config.configuration_name_of_the_Java_EE_server are set, the value of the parameter that starts with servers.server.Java_EE_server_name takes effect.
Specify the value of the identifier to be changed, and then run the set subcommand of the asadmin utility command.
```
asadmin set target_identifier_to_be_changed=value
```
Reference note

When you change values other than standard properties (directives) of the web server, use the server template to change the web server settings.
When this command is run, the result is displayed as follows:
```
Command set executed successfully.
```
To verify the settings of Application Server after the change, run the get subcommand of the asadmin utility command.
```
asadmin get "*"
```
Verify that the value that was specified for the identifier by running the set subcommand in step 7 is reflected in the execution result of the command.

If you are finished making changes, go to step 9.

If you want to change the following environment definitions, define each environment setting without starting the servers that configure Application Server.
- Web server settings
- Java VM options
- Environment variables to be applied to the processing of the asadmin utility command
To start Application Server at once, run the start-servers subcommand of the asadmin utility command.
```
asadmin start-servers
```
When this command is run, the result is displayed as follows:
```
Command start-servers executed successfully.
```
To display a list of performance tracers, run the list-prfs subcommand of the asadmin utility command.
```
asadmin list-prfs
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the performance tracers are running.
```
performance_tracer_name running
Command list-prfs executed successfully.
```
To display a list of server instances, run the list-instances subcommand of the asadmin utility command with the --long option specified.
```
asadmin list-instances --long=true
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the server instances are running.
```
server_instance_name host_name port_number process_ID cluster_name running
Command list-instances executed successfully.
```
- cluster_name is displayed only for cluster configurations that contain multiple Java EE servers.
To display a list of web servers, run the list-webservers subcommand of the asadmin utility command.
```
asadmin list-webservers
```
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are running.
```
web_server_name   running
Command list-webservers executed successfully.
```
If you are using a hardware load balancer, unblock it.

For more information about blocking, refer to the hardware load balancer manual.