Hitachi

Hitachi Application Server V10 User's Guide (For Windows® Systems)


8.2.1 Starting your system with a command

To start your system with a command, use the start-domain subcommand of the asadmin utility command to start the domain administration server, use its start-servers subcommand to start Application Server, and then, use its enable subcommand to start application. If a hardware-based load balancer is used, open the connection to the load balancer last.

Prerequisites

Intended users

Procedure

  1. To start the domain administration server, run the start-domain subcommand of the asadmin utility command.

    asadmin start-domain 

    When this command is run, the result is displayed as follows.

    Command start-domain executed successfully.
  2. 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.
  3. 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.
  4. 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.

  5. 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.
  6. To start the application, run the enable subcommand of the asadmin utility command.

    asadmin enable --target server_instance_name_or_cluster_name application_name
    • In a configuration where only one Java EE server is deployed, specify the server instance name for the --target option.

    • In a cluster configuration where more than one Java EE server is deployed, specify the cluster name for the --target option.

  7. To display a list of applications, run the list-applications subcommand of the asadmin utility command.

    asadmin list-applications --long=true server_instance_name_or_cluster_name
    • In a configuration where only one Java EE server is deployed, specify the server instance name.

    • In a cluster configuration where more than one Java EE server is deployed, specify the cluster name.

    When this command is run, the result is displayed as follows. Ensure that the statuses of applications are enabled.

    NAME                    TYPE        STATUS
    application_name  <ear, web>  enabled
    application_name   <web>       enabled
    Command list-applications executed successfully.
  8. For each application, specify the URL to start the application in a web browser and check that the started application can be accessed.

    http://server_instance's_IP_address:server_instance's_port_number/
    started_application_path
  9. If you are using a hardware load balancer, unblock it.

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