Hitachi Application Server V10 ユーザーズガイド（UNIX®用）

3021-3-415-30

前書き

対象製品

適用OS：Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）、Red Hat Enterprise Linux 5（AMD/Intel 64）、Red Hat Enterprise Linux Server 6（64-bit x86_64）、Red Hat Enterprise Linux Server 7（64-bit x86_64）

P-9W43-5KA1 Hitachi Application Server 10-11

注　このマニュアルで「AIXの場合」と表記している個所については、この製品ではサポートしていません。

適用OSについては、上記以外にもご利用になれる場合があります。詳細はリリースノートでご確認ください。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI、Cosminexus、HAモニタ、HiRDB、JP1、uCosminexus、Virtageは、株式会社日立製作所の商標または登録商標です。

AMDは、Advanced Micro Devices, Inc.の商標です。

IBM、AIXは、世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

IBM、POWERは、世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

IBM、WebSphereは、世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Intelは、アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。

Internet Explorerは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Linuxは、Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

MicrosoftおよびExcelは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびHyper-Vは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびSQL Serverは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MicrosoftおよびVisual C++は、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。

RC4は、米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

Red Hatは、米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。

RSAおよびBSAFEは、米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

UNIXは、The Open Groupの米国ならびに他の国における登録商標です。

W3Cは、World Wide Web Consortiumの商標（多数の国において登録された）です。

Windowsは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

その他記載の会社名、製品名などは、それぞれの会社の商標もしくは登録商標です。

本製品は、米国EMC コーポレーションのRSA BSAFE®ソフトウェアを搭載しています。

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by Andy Clark.

Java is a registered trademark of Oracle and/or its affiliates.

発行

2017年9月 3021-3-415-30

著作権

Copyright (C) 2014, 2017, Hitachi, Ltd.

Copyright (C) 2013, Oracle and/or its affiliates. All rights reserved.

変更内容

変更内容(3021-3-415-30)

Hitachi Application Server 10-11

追加・変更内容

変更個所

リリースノートのマニュアル訂正を反映した。

−

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

マニュアルの目的

このマニュアルはHitachi Application Serverの機能概要、およびシステム開発・運用工程に沿ったユースケースをベースとして各工程にマッピングした手順について説明します。このマニュアルを利用することで、機能概要や製品アーキテクチャを理解して、インストールから運用までのひととおりの操作ができるようになることを目的としています。

対象読者

このマニュアルは次の方を対象読者としています。

システム構築者

前提知識を次に示します。

システム構築者

WindowsまたはUNIXの操作に関する知識

Application Serverの構築に関する知識

Java EE標準仕様に関する知識

システム構築で使用する周辺環境（データベース、ネットワーク、ジョブ管理など）に関する知識

関連マニュアルの表記

関連マニュアル、およびこのマニュアルで使用している関連マニュアル名の表記を次の表に示します。

Hitachi Application Server関連

表記

正式名称

資料番号

ユーザーズガイド

Hitachi Application Server V10 ユーザーズガイド（UNIX®用）

3021-3-415

GUIリファレンス

Hitachi Application Server V10 GUIリファレンス（UNIX®用）

3021-3-417

コマンドリファレンス

Hitachi Application Server V10 コマンドリファレンス（UNIX®用）

3021-3-419

定義リファレンス

Hitachi Application Server V10 定義リファレンス（UNIX®用）

3021-3-421

メッセージリファレンス

Hitachi Application Server V10 メッセージリファレンス

3021-3-422

APIリファレンス

Hitachi Application Server V10 APIリファレンス

3021-3-423

HiRDB関連

表記

正式名称

資料番号

HiRDB システム導入・設計ガイド

ノンストップデータベース HiRDB Version 9 システム導入・設計ガイド（UNIX®用）

3000-6-452

ノンストップデータベース HiRDB Version 9 システム導入・設計ガイド（Windows®用）

3020-6-452

HiRDB メッセージ

ノンストップデータベース HiRDB Version 9 メッセージ

3020-6-458

JP1関連

表記

正式名称

資料番号

JP1/Automatic Job Management System 導入ガイド

JP1 Version 10 JP1/Automatic Job Management System 3 導入ガイド

3021-3-102

JP1/Automatic Job Management System 設計ガイド

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）

3021-3-103

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）

3021-3-104

JP1/Automatic Job Management System 構築ガイド1

JP1 Version 10 JP1/Automatic Job Management System 3 構築ガイド1

3021-3-105

JP1/Automatic Job Management System 操作ガイド

JP1 Version 10 JP1/Automatic Job Management System 3 操作ガイド

3021-3-109

製品名と機能名の表記

このマニュアルでは、製品名と機能名を次のように表記しています。

表記

製品名と機能名

Application Server

Hitachi Application Server

Application Server - Base

Hitachi Application Server - Base

Application Server - Optional License for Java

Hitachi Application Server - Optional License for Java

Application Server for Developers

Hitachi Application Server for Developers

APV

IBM Advanced POWER Virtualization

DAS

Domain Administration Server

ドメイン管理サーバ

Developer's Kit for Java

Hitachi Developer's Kit for Java

Excel

Microsoft® Excel

Firefox

Firefox®

HiRDB

HiRDB Version 9

HiRDB Server Version 9

HiRDB/Single Server

HiRDB/Single Server Version 9

HWS

Hitachi Web Server

Web Server

Internet Explorer

Windows® Internet Explorer®

Java EE Server

Hitachi Java EE Server

JP1/AJS3

JP1 Version 10 JP1/Automatic Job Management System 3 - Agent

JP1 Version 10 JP1/Automatic Job Management System 3 - Manager

JP1 Version 10 JP1/Automatic Job Management System 3 - View

JP1/IM

JP1 Version 10 JP1/Integrated Management - Manager

JP1 Version 10 JP1/Integrated Management - View

Microsoft IIS

Microsoft IIS 7.5

Microsoft® Internet Information Services 7.5

Microsoft IIS 8.0

Microsoft® Internet Information Services 8.0

Microsoft IIS 8.5

Microsoft® Internet Information Services 8.5

Microsoft Visual C++

Microsoft® Visual C++®

Oracle

Oracle 11g

Oracle Database 11g

Oracle Database 11g R2

Oracle 12c

Oracle Database 12c

SQL Server

Microsoft® SQL Server

UNIX

AIX

AIX V6.1

AIX V7.1

Linux

Linux（AMD64 & Intel EM64T）

Red Hat Enterprise Linux® 5 Advanced Platform（AMD/Intel 64）

Red Hat Enterprise Linux® 5（AMD/Intel 64）

Red Hat Enterprise Linux® Server 6（64-bit x86_64）

Red Hat Enterprise Linux® Server 7（64-bit x86_64）

Virtage

Hitachi Virtage

VMware ESX

VMware vSphere® ESX

VMware vSphere ESXi

VMware vSphere® ESXi™

Windows

Windows Server 2008 R2

Microsoft® Windows Server® 2008 R2 Standard 日本語版

Microsoft® Windows Server® 2008 R2 Enterprise 日本語版

Microsoft® Windows Server® 2008 R2 Datacenter 日本語版

Windows Server 2012

Microsoft® Windows Server® 2012 Standard 日本語版

Microsoft® Windows Server® 2012 Datacenter 日本語版

Windows Server 2012 R2

Microsoft® Windows Server® 2012 R2 Standard 日本語版

Microsoft® Windows Server® 2012 R2 Datacenter 日本語版

Windows 7

Windows 7 x86

Microsoft® Windows® 7 Professional 日本語版(32ビット版)

Microsoft® Windows® 7 Enterprise 日本語版(32ビット版)

Microsoft® Windows® 7 Ultimate 日本語版(32ビット版)

Windows 7 x64

Microsoft® Windows® 7 Professional 日本語版(64ビット版)

Microsoft® Windows® 7 Enterprise 日本語版(64ビット版)

Microsoft® Windows® 7 Ultimate 日本語版(64ビット版)

Windows 8

Windows 8 x86

Windows® 8 Pro 日本語版(32ビット版)

Windows® 8 Enterprise 日本語版(32ビット版)

Windows 8 x64

Windows® 8 Pro 日本語版(64ビット版)

Windows® 8 Enterprise 日本語版(64ビット版)

Windows 8.1 x86

Windows® 8.1 Pro 日本語版(32ビット版)

Windows® 8.1 Enterprise 日本語版(32ビット版)

Windows 8.1 x64

Windows® 8.1 Pro 日本語版(64ビット版)

Windows® 8.1 Enterprise 日本語版(64ビット版)

Windows 10

Windows 10 x64

Windows® 10 Pro 日本語版(64ビット版)

Windows® 10 Enterprise 日本語版(64ビット版)

Windows Server Failover Cluster

Windows Server® Failover Cluster

クラス別統計

日立クラス別統計

パフォーマンストレーサ

Performance Tracer

パフォーマンストレーサー

Linuxに関しては、バージョンごとに次のように表記することがあります。

表記

OS名

Red Hat Enterprise Linux 5

Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）

Red Hat Enterprise Linux® 5 Advanced Platform（AMD/Intel 64）

Red Hat Enterprise Linux 5（AMD/Intel 64）

Red Hat Enterprise Linux® 5（AMD/Intel 64）

Red Hat Enterprise Linux Server 6

Red Hat Enterprise Linux Server 6（64-bit x86_64）

Red Hat Enterprise Linux® Server 6（64-bit x86_64）

Red Hat Enterprise Linux Server 7

Red Hat Enterprise Linux Server 7（64-bit x86_64）

Red Hat Enterprise Linux® Server 7（64-bit x86_64）

英略語

このマニュアルで使用している英略語を次に示します。

英略語

英字での表記

ACC

Application Client Container

ACL

Access Control List

AES

Advanced Encryption Standard

API

Application Programming Interface

ASCII

American Standard Code for Information Interchange

BLOB

Binary Large Object

CA

Certificate Authority

CDI

Contexts and Dependency Injection

CGI

Common Gateway Interface

CMP

Container-Managed Persistence

CMT

Container-Managed Transaction

CopyGC

Copy Garbage Collection

CORBA

Common Object Request Broker Architecture

CPU

Central Processing Unit

CRL

Certificate Revocation List

CSR

Certificate Signing Request

CSV

Comma Separated Value

CVS

Concurrent Versions System

DBMS

Database Management System

DCOM

Distributed Component Object Model

DD

Deployment Descriptor

DDE

Dynamic Data Exchange

DER

Distinguished Encoding Rules

DES

Data Encryption Standard

DI

Dependency Injection

DLL

Dynamic Link Library

DMZ

Demilitarized Zone

DN

Distinguished Name

DNS

Domain Name System

DoS

Denial of Service

DSO

Dynamic Shared Object

DTD

Document Type Definition

EAR

Enterprise Archive

ear

EIS

Enterprise Information System

EJB

Enterprise JavaBeans™

EJB QL

EJB™ Query Language

EL

Expression Language

EUC

Extended UNIX Code

FQDN

Fully Qualified Domain Name

FullGC

Full Garbage Collection

G1GC

Garbage First Garbage Collection

GC

Garbage Collection

GMS

Group Management Service

GMT

Greenwich Mean Time

GUI

Graphical User Interface

HA

High Availability

HTML

Hyper Text Markup Language

HTTP

Hyper Text Transfer Protocol

HTTPS

Hyper Text Transfer Protocol Security

I/O

Input/Output

ID

Identifier

IDE

Integrated Development Environment

IEC

International Electrotechnical Commission

IIOP

Internet Inter-Orb Protocol

IIS

Internet Information Services

IMAP

Internet Message Access Protocol

IP

Internet Protocol

IPv6

Internet Protocol Version 6

ISO

International Organization for Standardization

J2EE

J2EE™

Java™ 2 Platform, Enterprise Edition

JAAS

Java™ Authentication and Authorization Service

JACC

Java™ Authorization Service Provider Contract for Containers

JAF

JavaBeans™ Activation Framework Specification

JAR

Java™ Archive

jar

JASPIC

Java™ Authentication Service Provider Interface for Containers

Java

Java™

Java EE

Java™ Platform, Enterprise Edition

Java EE RI

Java EE Reference Implementation

Java HotSpot Client VM

Java HotSpot™ Client Virtual Machine

Java Platform Debugger Architecture

Java™ Platform Debugger Architecture

JPDA

Java SE

Java™ Platform, Standard Edition

Java VM

Java™ Virtual Machine

JVM

JavaMail

JavaMail™

JAX-RPC

Java™ API for XML-based RPC

JAX-RS

Java™ API for RESTful Web Services

JAX-WS

Java™ API for XML-based Web Services

JAXB

Java™ Architecture for XML Binding

JAXP

Java™ API for XML Processing

JAXR

Java™ API for XML Registries

JCA

J2EE™ Connector Architecture

JDBC

Java™ Database Connectivity

JDBC™

JDK

Java™ Development Kit

JDK™

JIS

Japanese Industrial Standards

JMS

Java™ Message Service

JMX

Java™ Management Extensions

JNDI

Java Naming and Directory Interface™

JNI

Java™ Native Interface

JPA

Java™ Persistence API

JSF

JavaServer™ Faces

JavaServer™ Faces Reference Implementation (RI) Version: 1.1_01 FCS

JSON-P

Java™ API for JSON Processing

JSP

JavaServer Pages™

JSP™

JST

Japan Standard Time

JSTL

JavaServer Pages™ Standard Tag Library

JTA

Java™ Transaction API

JVMPI

Java™ Virtual Machine Profiler Interface

JVMTI

Java™ Virtual Machine Tool Interface

KVM

Kernel-based Virtual Machine

LAN

Local Area Network

LDAP

Lightweight Directory Access Protocol

MAC

Message Authentication Code

MIME

Multipurpose Internet Mail Extensions

MPM

Multi-Proccessing Module

OASIS

Organization for the Advancement of Structured Information Standards

OMG

Object Management Group

ORB

Object Request Broker

OS

Operating System

OTS

Object Transaction Service

QNAME

Qualified Name

REST

Representational State Transfer

RMI

Remote Method Invocation

RPC

Remote Procedure Call

RSA

Rivest, Shamir and Adleman

SAAJ

SOAP with Attachments API for Java™

SAX

Simple API for XML

SEI

Service Endpoint Interface

Servlet

Java™ Servlet

SHA

Secure Hash Algorithm

SMAP

Source Map

SMTP

Simple Mail Transfer Protocol

SOAP

Simple Object Access Protocol

SSH

Secure Shell

ssh

SSL

Secure Sockets Layer

StAX

Streaming API for XML

TCP

Transmission Control Protocol

TLD

Tag Library Descriptor

TLS

Transport Layer Security

UCS

Universal multi-octet coded Character Set

UDP

User Datagram Protocol

URI

Uniform Resource Identifier

URL

Uniform Resource Locator

URN

Uniform Resource Name

UTC

Coordinated Universal Time

UTF

UCS Transformation Format

UTF-8

8-bit UCS Transformation Format

VM

Virtual Machine

VTL

Velocity Template Language

W3C

World Wide Web Consortium

WAR

Web Archive

war

WBEM

Web-Based Enterprise Management

WSDL

Web Services Description Language

XML

Extensible Markup Language

KB（キロバイト）などの単位表記について

1KB（キロバイト）、1MB（メガバイト）、1GB（ギガバイト）、1TB（テラバイト）、1PB（ペタバイト）はそれぞれ1,024バイト、1,024²バイト、1,024³バイト、1,024⁴バイト、1,024⁵バイトです。

1　マニュアルの読み方

Application Serverを利用したシステムの開発から運用までの工程に沿って、このマニュアルのどこを読めばよいかを説明します。

1.1　マニュアルの読み方について

Application Serverを利用したWebフロントシステムを開発する際に、このマニュアルで参照する章について説明します。Webフロントシステムの開発から運用までの工程ごとに、このマニュアルでの参照先（章）を示します。また、各章の概要についても説明します。なお、アプリケーションを実行する環境をアプリケーション実行環境と呼びます。

このマニュアルで説明する、Application Serverを利用したWebフロントシステムの構成を次の図に示します。

アプリケーション実行環境の設計・構築・運用時に参照する個所

アプリケーション実行環境の設計・構築・運用の工程ごとに実施する内容と、参照先の章の概要を次の表に示します。利用目的に合わせて章を選択して読むことができます。なお、システムの構築および運用で実施する作業は、コマンドまたはAdministration Consoleのどちらも利用できます。

工程

実施する内容

図中の番号

マニュアルの章タイトル

対応するマニュアルの記載概要

システムの設計

システム構成の検討、およびシステムの設計を実施します。

2

Application Serverの概要

システムの構成を検討するために必要な情報について説明します。

Application Serverの製品情報や、目的別のシステム構成例、プロセス構成などの情報を基に、システムの構成を検討します。

3

Application Serverの設計項目

システムを設計するために必要な情報について説明します。

システムの信頼性や性能を確保するために、必要に応じて設計項目を選択してシステムの設計をします。

システムの構築

アプリケーションを実行する環境を構築し、使用する機能を設定します。

4

アプリケーション実行環境の構築

アプリケーションの実行環境を構築する手順について説明します。

1つのJava EEサーバを配置するシステム、または複数のJava EEサーバを配置して負荷を分散させるクラスター構成のシステムを構築します。なお、クラスター構成とは、複数のJava EEサーバをグループ化して管理するための構成のことです。

5

システム周辺環境の設定

システム周辺環境で設定する項目について説明します。ネットワーク、負荷分散、および運用の自動化を設定します。

6

高信頼性機能の設定

高信頼性を実現するための、障害検知に関する機能（プロセス監視、メッセージ監視）、およびセキュリティーを強化する設定（リバースプロキシー、SSL）について説明します。

システムの運用

通常運用時、または保守運用時の作業を実施します。

7

通常運用時の作業

運用開始後に日々実施する、通常運用時の作業について説明します。

Application Serverに対して、次の作業を実施してシステムを運用します。

システムの起動・停止

マシンの起動・停止と同期したシステムの起動・停止

Application Serverの稼働状況の確認

アプリケーションの稼働状況の確認

データベースの接続状況の確認

8

保守運用時の作業

稼働状況の変化やシステム構成の変更に対応するための保守運用時の作業について説明します。

Application Serverに対して、次の作業を実施してシステムをメンテナンスします。

稼働状況やシステム構成に応じた環境定義の変更

IPアドレス・ホスト名の変更

アプリケーションの入れ替え

環境情報のバックアップ・リストア

修正パッチ・修正版の適用

システムの利用状況や動作状況の確認

システムのスケールアウト

バージョンアップ

出力されるトラブルシュート資料を調査します。

9

トラブルシュート資料の活用

アプリケーションの実行環境および開発環境で出力される、各種ログ、トレースなどのトラブルシュート資料について説明します。出力されるトラブルシュート資料の見方やパフォーマンストレーサーのトレース取得ポイントなどの情報を参考にして、トラブルシュート資料を調査します。

重要

このマニュアルでは、1つのメインパスを想定して、Webフロントシステムの設計、構築、および運用を説明しています。Webフロントシステム以外のシステムや、システム設計時に設計するすべての設計項目、システム構築に関するすべての手順や設定値、およびシステム運用で実施するすべての運用手順を説明しているわけではありません。

2　Application Serverの概要

Application Serverを利用したシステムの構成を検討するために必要な情報について説明します。 Application Serverの製品情報や、目的別のシステム構成例、プロセス構成などの情報を基に、システムの構成を検討します。

2.1　Application Serverが対応する標準仕様

Application Serverは、Java EE 7、Java SE、Web Service、CORBA、およびインターネット関連の標準仕様に対応しています。Application Serverが対応する標準仕様について説明します。

Java EE 7仕様

項番

標準仕様

1

Java EE 7

2

WebSocket 1.0※1

3

JSON-P 1.0

4

Servlet 3.1

5

JSF 2.2

6

EL 3.0

7

JSP 2.3

8

JSTL 1.2

9

Batch 1.0※2

10

Concurrency Utilities 1.0

11

CDI 1.1

12

DI 1.0

13

Bean Validation 1.1

14

Interceptors 1.2

15

JCA 1.7

16

JPA 2.1※3

17

Common Annotations for the Java Platform 1.2

18

JMS 2.0

19

JTA 1.2

20

JavaMail 1.5

21

JAX-RS 2.0

22

Web Services for Java EE 1.4

23

JAX-WS 2.2

24

Web Services Metadata for the Java Platform 2.1

25

JASPIC 1.1

26

JACC 1.5

27

Java EE Management 1.1

28

Debugging Support for Other Languages 1.0

29

Managed Beans 1.0

30

EJB 3.2※4

31

JAX-RPC 1.1

32

JAXR 1.0

33

Java EE Deployment 1.2

注※1

HTTPサーバとしてMicrosoft IIS 8.0以降を使用する場合に対応しています。

注※2

データベースとしてHiRDBを使用する場合に対応しています。

注※3

データベースとしてHiRDBを使用する場合、Criteria APIとストアドプロシージャーの呼び出しには対応していません。

注※4

CMPおよびEJB QLには対応していません。

Java SE仕様

Java SE 8

Java EE7仕様に関連するJava SE仕様

項番

標準仕様

1

JAXB 2.2

2

JAXP 1.3

3

JMX 1.2

4

JAF 1.1

5

StAX 1.0

6

SAAJ 1.3

7

JDBC 4.1

Web Service系仕様

項番

標準仕様

1

SOAP（W3C標準）

SOAP 1.1

2

SOAP 1.2

3

WSDL（W3C 標準）

WSDL 1.1

4

Bootstrapping

WS-MetadataExchange v1.1

5

Policy（W3C 標準）

WS-Policy v1.2

6

WS-PolicyAttachment v1.2

7

WS-Policy v1.5

8

WS-PolicyAttachment v1.5

9

Reliable Messaging （OASIS標準）

WS-ReliableMessaging v1.0

10

WS-ReliableMessaging Policy v1.0

11

WS-ReliableMessaging v1.1

12

WS-ReliableMessaging Policy v1.1

13

WS-ReliableMessaging v1.2

14

WS-ReliableMessaging Policy v1.2

15

WS-MakeConnection v1.1

16

Atomic Transactions（OASIS標準）※

WS-AtomicTransaction v1.0

17

WS-Coordination v1.0

18

Security（OASIS標準 ）

WS-Security v1.0

19

WS-Security v1.1

20

WS-SecurityPolicy v1.1

21

WS-SecurityPolicy v1.2

22

WS-Trust v1.2

23

WS-Trust v1.3

24

WS-Trust v1.4

25

WS-SecureConversation v1.2

26

WS-SecureConversation v1.3

27

WS-SecureConversation v1.4

28

Security Profiles（OASIS標準）

Web Services Security: SOAP Message Security V1.0

29

WS-Security Core Specification 1.1

30

Username Token Profile V1.0

31

Username Token Profile 1.1

32

X.509 Token Profile V1.0

33

X.509 Token Profile 1.1

34

SAML Token Profile V1.0

35

SAML Token profile 1.1

36

Kerberos Token Profile 1.1

37

Rights Expression Language (REL) Token Profile 1.1

38

SOAP with Attachments (SWA) Profile 1.1

39

Addressing（W3C標準 ）

Web Services Addressing 1.0 - Core

40

Web Services Addressing 1.0 - SOAP Binding

41

Web Services Addressing 1.0 - WSDL Binding

42

WS-I Profile

WS-I Basic Profile 1.2

43

WS-I Basic Profile 2.0

44

WS-I Attachments Profile 1.0

45

WS-I Simple SOAP Binding Profile 1.0

※

Metroがサポートしているのは、標準化前の項番16、17のバージョンです。

CORBA系仕様

Common Object Request Broker Architecture (CORBA), Version 3.0

インターネット関連の標準仕様

項番

標準仕様

1

IPv6

2

HTTP 1.0

3

HTTP 1.1

4

SSL v3

5

TLS 1.0

6

TLS 1.1

7

TLS 1.2

2.2　Application Serverの製品構成、前提プログラム、関連製品について

Application Serverの製品構成や前提OSについて説明します。また、使用できる仮想化プラットフォーム、DBMS、Webブラウザー、HTTPサーバ、メールサーバ、関連製品などの、Application Serverを使用する際に前提となる製品情報についても説明します。

製品構成

Application Serverは、次の製品で構成されます。

Application Server

アプリケーションを実行するための環境（アプリケーション実行環境）を構築する製品です。

Application Server for Developers

Application Serverで実行するアプリケーションを開発するための環境（アプリケーション開発環境）を構築する製品です。この製品はWindows版だけです。

前提OS

Application Serverは、次のOSで利用できます。

Application Serverの前提OS

OSのバージョン

Red Hat Enterprise Linux 5

Red Hat Enterprise Linux Server 6

Red Hat Enterprise Linux Server 7

AIX 6.1

AIX 7.1

対応文字コードセット

Application Server は、次の文字コードセット で利用できます。

OS

文字コードセット

Linux

UTF-8

AIX

Shift-JIS

UTF-8

EUC

仮想化プラットフォーム

Application Serverの仮想化プラットフォームには、次のハイパーバイザーを利用できます。

ハイパーバイザー

対応するゲストOS

Virtage

Linux

KVM

Linux

VMware ESX

VMware ESX 4.0

VMware ESX 4.1

VMware vSphere ESXi 5

Linux

IBM Advanced POWER Virtualization (APV)

AIX

DBMS

Application Serverは、次のDBMSと接続できます。

DBMS

JDBCドライバー

HiRDB Version 9

HiRDB Type4 JDBC Driver

Oracle 11g

Oracle JDBC Drivers 12.1.0.1.0以降

Oracle 12c

Oracle JDBC Drivers 12.1.0.1.0以降 またはOracle JDBC Drivers 12.1.0.1.0以降

Webブラウザー

Application Serverは、次のWebブラウザーから構築および運用の操作が実行できます。

なお、Administration ConsoleはUNIXでは使用できません。

Webブラウザー

必要なプログラム

Internet Explorer 7以降

Adobe Flash Player 11.8以降

Firefox 34.0以降

Firefox ESR 31以降

HTTPサーバ

Application Serverは、次のHTTPサーバと接続できます。

HTTPサーバ

バージョン

Web Server

Application Serverに同梱されるHTTPサーバ

メールサーバ

Application Serverは、次のメールサーバを利用できます。

メールサーバ

目的

SMTPサーバ、IMAPサーバ

JavaMailの使用

関連製品

Application Serverは、次の製品と関連してシステムを運用できます。

製品名

目的

JP1/IM

システム全体の障害の監視

JP1/AJS3

システムの運用の自動化

HAモニタ

クラスター構成のシステムの運用

2.3　Application Serverのシステム構成

Application Serverを利用すると、目的とする業務や実行するアプリケーションの要件に応じた構成でシステムを構築できます。Application ServerとWebサーバを同一マシンに配置する最小構成のほか、可用性および性能を確保するための構成、セキュリティーを確保するための構成、安定稼働のための構成、他システムと連携するための構成、マルチテナント構成などを構築できます。

2.3.1　最小のシステム構成について

Java EEサーバとWebサーバを同一マシンに配置する、最小の構成例について説明します。

Java EEサーバとWebサーバを同一マシンに配置する、最小の構成です。トランザクション数が少ないシステムに適しています。

2.3.2　可用性および性能を確保するためのシステム構成について

Application Serverを利用した、可用性および性能を確保するためのシステム構成について説明します。代表的なシステム構成の例として、ハードウェアロードバランサーを使用した構成、任意のソフトウェアロードバランサーを使用した構成、Web Serverのロードバランス機能を使用した構成、およびクラスターソフトウェアを使用した構成とそれぞれの特徴について説明します。

ハードウェアロードバランサーを使用した構成

ハードウェアロードバランサーを使用して、複数のJava EEサーバにリクエストを振り分ける構成です。トランザクション数が多く、ミッションクリティカルなシステムに適しています。高い信頼性および可用性を確保できます。

任意のソフトウェアロードバランサーを使用した構成

任意のソフトウェアロードバランサーを使用して、複数のJava EEサーバにリクエストを振り分ける構成です。トランザクション数が多いシステムに適しています。高価なロードバランサーを使用しないで、信頼性および可用性を確保します。

Web Serverのロードバランス機能を使用した構成

Web Serverのロードバランス機能を使用して、複数のJava EEサーバにリクエストを振り分ける構成です。トランザクション数が多いシステムに適しています。Web Serverの機能を使用することで、安価で、信頼性および可用性を確保します。

クラスターソフトウェアを使用した構成

クラスターソフトウェアを使用して、複数のJava EEサーバを、現用（Active）/待機（Standby）構成に配置した構成です。トランザクション数が少なく、マシン1台の性能でリクエストを処理できるシステムに適しています。また、障害発生時に備えて予備系（待機系）を準備し、通常は開発やテスト環境として有効活用できます。

2.3.3　セキュリティーを確保するための構成について

Application Serverを利用した、セキュリティーを確保するためのシステム構成について説明します。代表的なシステム構成の例として、リバースプロキシーを使用した構成、およびリバースプロキシーを使用しない構成とそれぞれの特徴について説明します。

リバースプロキシーを使用した構成

DMZ内にリバースプロキシー、内部ネットワークにWebサーバとJava EEサーバを配置してセキュリティーを確保する構成です。不正アクセス、盗聴、DoS攻撃を防止します。また、複数のJava EEサーバを配置して可用性を確保します。

リバースプロキシーを使用しない構成

DMZ内にWebサーバ、内部ネットワークにJava EEサーバを配置してセキュリティーを確保する構成です。通信のオーバーヘッドを削減するため、リバースプロキシーは配置しません。不正アクセス、盗聴、DoS攻撃を防止します。また、複数のJava EEサーバを配置して可用性を確保します。

2.3.4　安定稼働のための構成について

Application Serverを利用した、安定稼働のためのシステム構成について説明します。代表的なシステム構成の例として、非同期でオンラインバッチ処理を行う構成とその特徴について説明します。

非同期でオンラインバッチ処理を行う構成

負荷の高い処理をJMSのキューにいったん蓄積して、同時実行数を絞った状態で非同期処理をする構成です。短期間に送信された大量リクエストや、長時間掛る処理などによって発生する同時実行数の増大を防ぎ、安定稼働ができます。

2.3.5　他システムと連携するための構成について

Application Serverを利用した、他システムと連携するためのシステム構成について説明します。代表的なシステム構成の例として、バックに他システムと接続する構成、フロントに他システムと接続する構成、およびWebSphere MQを使用して他システムと接続する構成とそれぞれの特徴について説明します。

バックに他システムと接続する構成

フロントにあるApplication Serverでリクエストを受け付け、そのバックにある業務システムを呼び出す構成です。SOAP、CORBA、RESTといったインターフェースを利用するため、既存システムと疎結合で連携することができます。

フロントに他システムと接続する構成

既存システムからのリクエストを受け、バックのApplication Serverで業務を実行する構成です。SOAP、RESTといったインターフェースを利用するため、既存システムと疎結合で連携することができます。

WebSphere MQを使用して他システムと接続する構成

リソースアダプターであるWebSphere MQアダプターをApplication Server上にデプロイし、WebSphere MQと接続する構成です。WebSphere MQインターフェースを持った既存システムと連携できます。

2.3.6　マルチテナント構成について

Application Serverを利用した、マルチテナント構成について説明します。代表的なシステム構成の例として、テナントごとにJava EEサーバを分ける構成とその特徴について説明します。

テナントごとにJava EEサーバを分ける構成

WebサーバのバックのJava EEサーバをテナントごとに分ける構成です。それぞれのテナントのユーザーは異なるURLでシステムにアクセスします。Webサーバは、URLに応じてそれぞれのJava EEプロセスにリクエストを振り分けます。Java EEサーバを分けることによって、プロセスダウンなどの障害発生時にほかのテナントへの影響を抑止できます。

2.4　Application Serverの管理要素とプロセス構成について

Application Serverを利用したシステムは、ドメイン、ノード、サーバ、クラスター、構成、およびサーバ間関連という要素で管理します。ドメインの管理には、ドメイン管理サーバを利用します。また、Application Serverが動作するためのプロセスには、Webサーバ、Java EEサーバ、パフォーマンストレーサー、ドメイン管理サーバなどがあります。

Application Serverの管理要素

Application Serverを利用したシステムでは、システム内の構成要素をドメインという単位で管理します。ドメインを管理するためには、ドメイン内に1つあるドメイン管理サーバを利用します。ドメイン管理サーバが管理するドメインは、ノードおよびサーバという管理要素で構成されます。また、クラスター、サーバ間関連、および構成という要素で、サーバを管理します。

ドメイン

業務システムを構成する複数のサーバを管理する要素です。ドメインは、異なるマシン上のサーバ（Java EEサーバ、Webサーバ、パフォーマンストレーサー）も管理できます。ドメインの管理には、ドメイン管理サーバを利用します。

ドメイン管理サーバ

ドメイン管理サーバとは、ドメインを管理するために、特別に用意されたサーバインスタンスです。ドメイン管理サーバは1つのドメインに対して1つ存在し、serverという名称で作成されます。なお、ドメイン管理サーバは、アプリケーション実行環境マシンとは別の運用管理サーバマシン上に構築することを推奨します。

ノード

ドメイン内の接続先のホスト（マシン）を定義する要素です。サーバはノードで定義されたホストに構築されます。ドメイン内に複数のノードを定義できます。複数のドメインから1つのノードを共有することはできません。

サーバ

ドメインが管理する各種サーバのインスタンス要素です。この要素はサーバの実体を表し、サーバの設定情報を包含します。サーバ要素には、Java EEサーバ、Webサーバおよびパフォーマンストレーサーがあります。サーバは必ず1つのドメインに属します。

サーバの種類

概要

Java EEサーバ

Java EEアプリケーションを稼働させるコンテナーサーバです。

Webサーバ

Webコンテンツを提供するサービスプログラムです。Web Serverを使用します。

パフォーマンストレーサー

Java EEサーバ、Webサーバなどのサーバの稼働性能を監視するプログラムです。監視対象となるサーバと同じノードに配置します。

クラスター

同じアプリケーション、リソース、および設定情報を共有する Java EEサーバのグループ要素です。異なるマシン上の Java EEサーバをグループ化して管理できます。クラスターを利用して、複数のJava EEサーバをグループ化したシステムの構成をクラスター構成と呼びます。クラスターは、スケーラビリティー、負荷分散、およびフェイルオーバーの保護を目的に使用します。

サーバ間関連

2つのサーバ間の関連で必要な設定情報をカプセル化したインスタンス要素です。構築したサーバ同士を連携して動作させるために必要な設定として、関連先のサーバの情報を関連元のサーバに自動的に設定します。例えば、関連先サーバの待ち受けポート番号を、接続ポートとして関連元のサーバにパラメーターで自動設定します。サーバ間関連には、リダイレクト関連とパフォーマンストレーサー関連があります。

関連の種類

概要

リダイレクト関連

Webサーバが受信したリクエストのリダイレクト先 Java EE サーバを設定するための関連です。異なるノード間のサーバ同士で関連を設定できます。

関連元：Webサーバ

関連先： Java EEサーバまたはクラスター

パフォーマンストレーサー関連

運用中のサーバの稼働性能を確認するために、パフォーマンストレーサーで性能解析トレースを取得できるように設定する関連です。異なるノード間のサーバ同士で関連を設定できません。

関連元：Webサーバまたは Java EEサーバ

関連先：パフォーマンストレーサー

構成

各種サーバの設定情報をカプセル化したインスタンス要素です。サーバやクラスターは、この要素を参照して設定情報を取得します。ただし、構成と関連づいたサーバに、構成と同じパラメーターで異なる値が設定されていた場合は、サーバに設定されたパラメーターが有効になります。構成には、Java EEサーバ構成、Webサーバ構成、およびパフォーマンストレーサー構成があります。

構成の種類

概要

Java EEサーバ構成

Java EEサーバまたはクラスターと関連づく構成で、設定情報を包含しています。Java EEサーバまたはクラスターを作成すると自動的にそのサーバまたはクラスター用の構成が作成されます。

クラスターにJava EEサーバを登録した場合は、そのJava EEサーバはクラスターに関連付いている構成を引き継ぎます。

Webサーバ構成

Webサーバと関連づく構成で、設定情報を包含しています。Webサーバを作成すると自動的にそのサーバ用の構成が作成されます。

パフォーマンストレーサー構成

パフォーマンストレーサーと関連づく構成で、設定情報を包含しています。パフォーマンストレーサーを作成すると自動的にそのサーバ用の構成が作成されます。

Application Serverのプロセス構成

Application Serverのプロセス構成の例を次の図に示します。

root権限で運用する場合のApplication Serverのプロセスの一覧を次の表に示します。

構成要素

プロセス名

プロセスの権限

役割

アプリケーションクライアント

java

一般ユーザー権限

アプリケーションクライアントを実行します。

Webサーバ制御プロセス

httpsd

管理者権限

リクエストを処理するサーバプロセスの起動やその稼働監視をします。

Webサーバサーバプロセス

---

httpsd

Userディレクティブに指定したユーザーの権限

Webブラウザーからの静的コンテンツ要求に対する応答や、アプリケーション要求に対するJava EEサーバへの転送をします。

httpsdは、設定および要求リクエスト数によってプロセス数が変わります。

rotatelogsおよびrotatelogs2は、設定によってプロセス数が変わります。rotatelogsのデフォルトは2 個です。rotatelogs2のデフォルトは1 個です。

---

rotatelogs

管理者権限

---

rotatelogs2

管理者権限

---

---

gcache

Userディレクティブに指定したユーザーの権限

Java EEサーバ

java

---

---

管理者権限

アプリケーションを実行します。

パフォーマンストレーサー

cprfd

---

---

管理者権限

WebサーバおよびJava EEサーバの一連の実行履歴を取得します。

ドメイン管理サーバ

java

---

---

管理者権限

Webサーバ、Java EEサーバ、およびパフォーマンストレーサーの運用管理をします。

Java EEサーバのプロセスのカレントディレクトリーを次の表に示します。

Java EEサーバのプロセス

起動時のカレントディレクトリー

サーバインスタンス※

Java EEサーバのインストールディレクトリー/glassfish/nodes/ノード名/サーバインスタンス名/config

ドメイン管理サーバ※

Java EEサーバのインストールディレクトリー/glassfish/domains/ドメイン名/config

MQ Broker

Java EEサーバのインストールディレクトリー/glassfish/nodes/ノード名/サーバインスタンス名/config

注※

プロセスの起動時、および再起動時には、カレントディレクトリーに出力されているファイルのうち次のログファイルを除いて、すべて削除されます。ただし、次のログファイルのファイル名を変更した場合は、削除の対象となります。また、asadminユーティリティーコマンドのstart-instanceサブコマンドに、--sync=fullオプションを指定して起動すると、カレントディレクトリーのファイルはログファイルも含めて削除されます。

項番

ログ

1

スレッドダンプログ

2

メモリーダンプログ

3

Java VM出力メッセージログ（エラーリポートファイル）

4

コンパイラーリプレイファイル

2.5　Application Serverの接続構成について

Application Serverは、Application Serverを構成するJava EEサーバ、Webサーバ、ドメイン管理サーバなどのプロセスや、ロードバランサー、DBMS、クライアントなどの周辺機器の間で通信を行って動作しています。これらのプロセス間の接続関係と使用するポート番号について説明します。

Application Serverの接続関係を次の図に示します。

Application Serverの各プロセスが使用するポートのポート番号、ポート番号の変更可否、バインドするIPアドレスの指定可否、ポートの開閉可否、および通信のクライアントについて、次の表に示します。

プロセス

図中の番号

説明

デフォルトのポート番号/TCPまたはUDP

ポート番号の変更可否

IPアドレスの指定可否

ポートの開閉可否※1

デフォルト開閉※2

通信のクライアント

Webサーバ

1

HTTPのリクエスト受け付けポート

80/TCP

○

○

○

○

自マシンまたは他マシンのWebクライアント

2

HTTPSのリクエスト受け付けポート

443/TCP

○

○

○

×

自マシンまたは他マシンのWebクライアント

ドメイン管理サーバ

3

ドメイン管理サーバ用ポート

4848/TCP

○

○

×※3

○

アプリケーション実行環境マシンを含む自マシンまたは他マシンのasadminユーティリティーコマンド

4

HTTPのリクエスト受け付けポート

8080/TCP

○

○

○

○

自マシンまたは他マシンのAdministration Console

5

HTTPSのリクエスト受け付けポート

8181/TCP

○

○

○

×

なし

6

JMXのリクエスト受け付けポート

8686/TCP

○

○

○

○

自マシンまたは他マシンのJMXクライアント

7

IIOP用通信ポート

3700/TCP

○

○

○

○

なし

10

Javaデバッガ用通信ポート

9009/TCP

○

○

○

×

なし

26

JMS Providerポート

7676/TCP

○

○

○

○

なし

27

GMS listenerポート

9090〜9200の間/TCP

○

○

○

×

自マシンまたは他マシンのJava EEサーバ

28

GMS multicastポート

2048〜49151の間/UDP

○

○

○

×

自マシンまたは他マシンのJava EEサーバ

29

Message Queue TCPポート

動的短命ポートを使用/TCP

○

○

○※4

×

なし

30

Message Queue Adminポート

動的短命ポートを使用/TCP

○

○

○※4

×

なし

31

Message Queue RMI Registryポート

動的短命ポートを使用/TCP

×

×

○※4

×

自マシンまたは他マシンのJMXクライアント

Java EEサーバ

11

ドメイン管理サーバ用ポート

24848※5/TCP

○

○

×※3

○

自マシンまたは他マシンのドメイン管理サーバ

12

HTTPのリクエスト受け付けポート

28080※5/TCP

○

○

○

○

自マシンまたは他マシンのWeb Server

13

HTTPSのリクエスト受け付けポート

28181※5/TCP

○

○

○

×

なし

14

JMX用通信ポート

28686※5/TCP

○

○

○

○

自マシンまたは他マシンのJMXクライアント

15

IIOP用通信ポート

23700※5/TCP

○

○

○

×

自マシンまたは他マシンのEJBクライアント

自マシンまたは他マシンのApplication Client Container

18

JMS Providerポート

27676※5/TCP

○

○

○

○

自マシンまたは他マシンのJava EEサーバ

19

Javaデバッガ用通信ポート

29009/TCP

○

×※6

○

×

自マシンまたは他マシンのJava Remote Debugger

20

GMS listenerポート

9090〜9200の間/TCP

○

○

○

×

自マシンまたは他マシンのJava EEサーバ

21

GMS multicastポート

2048〜49151の間/UDP

○

○

○

×

自マシンまたは他マシンのJava EEサーバ

22

Message Queue TCPポート

動的短命ポートを使用/TCP

○

○

○※4

○

自マシンまたは他マシンのJava EEサーバ

23

Message Queue Adminポート

動的短命ポートを使用/TCP

○

○

○※4

○

自マシンまたは他マシンのJava EEサーバ

32

Message Queue RMI Registryポート

動的短命ポートを使用/TCP

×

×

○※4

○

自マシンまたは他マシンのJMXクライアント

SSHデーモン

24

SSHサーバの待ち受けポート

ユーザー指定 (22)/TCP

※7

※7

※7

※7

自マシンまたは他マシンのドメイン管理サーバ

（凡例）

○：ポート番号の変更、IPアドレスの指定、またはポートの開閉ができます。

×：ポート番号の変更、IPアドレスの指定、またはポートの開閉ができません。

注※1

ユーザーがポートを開閉できるかどうか示します。

注※2

○の場合、デフォルトで開いています。×の場合、デフォルトで閉じています。

注※3

このポートは該当するプロセスで必須のため、プロセスを起動すると必ず開きます。

注※4

JMS Providerポートの開閉と連動します。

注※5

コマンドのオプションで指定できます。指定を省略した場合、1つ目のJava EEサーバはデフォルト値で作成されます。2つ目以降のJava EEサーバは、サーバ作成時に、ドメイン管理サーバによって自動で設定されます。

注※6

このポートはデフォルトで閉じています。

注※7

SSHデーモンの実装によって異なります。

2.6　インストール後のディレクトリー構成

Application Serverをインストールした直後のディレクトリー構成を示します。

Application Serverのディレクトリー構成

ディレクトリー名

説明

Application Serverのインストールディレクトリー

‐

Application Serverのインストールディレクトリー

common

Application Server - Baseのインストールディレクトリー

httpsd

Web Serverのインストールディレクトリー

javaee

Java EE Serverのインストールディレクトリー

jdk

Developer's Kit for Javaのインストールディレクトリー

2.7　Application Serverの運用管理について

Application Serverの運用管理とは、ドメイン管理サーバを利用してApplication Serverを構成する各要素を管理し、Application Serverのシステムを構築および運用することです。Application Serverの運用管理には、コマンドとAdministration Consoleを利用できます。

Application Serverの運用管理では、Application Serverを構成するJava EEサーバ、Webサーバおよびパフォーマンストレーサーを、ドメインという単位でグループ化して管理します。業務に応じて、構成の異なるApplication Serverをドメイン単位で管理できます。

Application Serverの運用管理を実現するドメイン管理サーバとのインターフェースとして、コマンドとAdministration Consoleが利用できます。コマンドとAdministration Consoleのどちらを利用しても、Application Serverの運用管理の各操作を実行できます。

コマンド

Application Serverを構築および運用するための機能を、コマンドで実行するためのインターフェースです。コマンドの格納先をカレントディレクトリーにして、実行権限のあるユーザーが実行します。

Administration Console

Application Serverを構築および運用するための機能を、Webブラウザーから実行するためのインターフェースです。WebブラウザーからAdministration Consoleにログインして利用します。

2.8　Application Server V9との互換性・移行性

Application Server V10では、Application Server V9で提供していた機能およびインターフェースについて、Java EEの標準仕様の範囲内では同様に使用できます。なお、V9で提供していた製品独自機能について、V10で使用できるのは一部の機能に限られます。

Application Server V9が提供する機能の使用可否

Application Server V10では、Java EE 7に対応するためにJava EE RI（GlassFish 4.1）を採用しています。Java EEの標準仕様の範囲内ではV10でも同様に使用できますが、Application Server V9で提供していた製品独自機能について、V10で使用できるのは一部の機能に限られます。

ユーザーインターフェースの互換性・移行性

ユーザーインターフェースについて、Application Server V9、Application Server V10間の互換性を表に示します。なお、製品独自部分については、V9からV10への移行性を保証していません。

インターフェースの種別

互換性

標準仕様のAPIおよびDD

あり

製品独自のAPI、GUI、コマンド、ログフォーマット、および定義

なし

3　Application Serverの設計項目

Application Serverを利用したシステムを設計するために必要な情報について説明します。システムの信頼性や性能を確保するために、必要に応じて設計項目を選択してシステムの設計をします。

3.1　Javaのメモリー管理

Javaのメモリー管理の設計で検討が必要なメモリー管理方式の仕組みや、設定するパラメーターについて説明しています。

3.1.1　Javaのメモリー管理の方式について

Javaのメモリー管理では、プログラムが使用するメモリー領域を、GCやApplication Serverの機能を使用して制御します。適切にJavaのメモリー管理をするためには、使用するメモリー領域の構造やGCの処理の流れを理解する必要があります。Javaのメモリー管理の方式として、SerialGC、SerialGC と明示管理ヒープ機能（GCを抑止するための機能）の組み合わせ、およびG1GCという3種類から選択します。システムの要件に合わせた適切なメモリー管理の方式を選択することで、システム処理性能を向上できます。

Application ServerおよびApplication Server上で動作するアプリケーションのメモリーは、GCを使用して管理します。GCの実行中にリクエストが送信された場合、GCが終了するまでリクエスト処理が停止するため、GCを適切に実行できるかどうかが、システムの処理性能に大きく影響します。

Application ServerのJavaのメモリー管理の方式を示します。メモリー管理の方式によって、GCの動作が異なるため、システム要件に合わせてJavaのメモリー管理の方式を選択する必要があります。

項番

Javaのメモリー管理の方式

適したシステムおよび特徴

1

SerialGC

スループットを重視するシステムに適しています。

スループットが高い。

GCの実行時間を制御できない。

メモリーサイズのチューニングを実施することで、FullGCの発生を抑止できる。

2

SerialGCと明示管理ヒープ機能の組み合わせ

セッションを使用した一般的な Webフロントシステムに適しています。

スループットが高い。

GCの実行時間を制御できない。

セッションを利用したシステムでは、メモリーサイズのチューニングのほか、明示管理ヒープ機能を使用してセッションをExplicitヒープで管理することで、FullGCの発生を抑止できる。

3

G1GC

大規模なメモリーを使用するシステムやレスポンスを重視するシステムに適しています。

スループットが低い。

一部のGCの実行時間を制御できる。

メモリーサイズのチューニングをすることで、FullGCの発生を抑止できる。

GCを実施するスレッド数を増やすことで、FullGCの発生を抑止できる。

関連項目

3.1.2　SerialGCのメモリー構造とGCの流れについて

3.1.3　SerialGCと明示管理ヒープ機能を組み合わせた場合のメモリー構造とGCの流れについて

3.1.4　G1GCのメモリー構造とGCの流れについて

3.1.2　SerialGCのメモリー構造とGCの流れについて

Javaのメモリー管理の方式にSerialGCを選択すると、メモリー領域の使用状況に応じて、CopyGCやFullGCが発生します。SerialGCを選択する場合、-XX:+UseSerialGCオプションのほか、メモリー領域に関するオプションを指定します。

SerialGCのメモリー構造

Javaのメモリー管理の方式にSerialGCを選択した場合の、メモリー構造を次の図に示します。

各領域の役割を次の表に示します。

項番

領域の名称

役割

1

Javaヒープ領域

Javaプログラムが使用するメモリー領域です。大きくNew領域とTenured領域に分かれています。

2

New領域

新しいオブジェクトが格納される領域です。Eden領域とSurvivor領域に分かれています。

3

Eden領域

作成直後のオブジェクトが格納される領域です。

4

Survivor領域

New領域に格納されていたJavaオブジェクトのうち、CopyGC実行時に破棄されなかった使用中のオブジェクトが格納される領域です。From空間とTo空間に分かれています。

5

Tenured領域

長時間使用するオブジェクトが格納される領域です。

6

Metaspace領域

ロードされたクラス情報やメソッド情報が格納される領域です。

7

Cヒープ領域

Developer's Kit for Javaがネイティブライブラリーを実行する際に使用する領域です。OS固有領域です。

8

スレッドスタック領域

スレッドごとに保持するスタック領域です。OS固有領域です。

SerialGCの場合のGCの流れ

SerialGCの場合のGCの流れを示します。

1回目のCopyGC

生成されたオブジェクトは、 New領域のEden領域に格納されます。Eden領域にオブジェクトがいっぱいになると、1 回目のCopyGCが発生します。CopyGCはNew領域全体を対象としています。CopyGCが発生すると、使用済みのオブジェクトを削除し、使用中のオブジェクトをSurvivor領域のTo空間（S1）に移動します。

2回目のCopyGC

1 回目のCopyGC発生後、再びEden領域にオブジェクトがいっぱいになると、2 回目のCopyGCが発生します。CopyGCはNew領域全体を対象とするため、1 回目のCopyGCでEden領域からSurvivor領域のTo空間（S1）に移動したオブジェクトもCopyGCの対象となります。2 回目のCopyGC発生時にEden領域に格納されていた使用中のオブジェクトは、To空間（S2）に移動し、同じくFrom空間（S1）にある使用中のオブジェクトもTo空間（S2）に移動します。

n回目のCopyGC

Survivor領域に移動したオブジェクトは、CopyGC発生時に使用中の場合、Survivor領域内でFrom 空間とTo空間を交互に移動し続けます。あるオブジェクトについてCopyGCの発生回数が一定の回数を超えると（図の場合15回）、そのオブジェクトはSurvivor領域からTenured領域に移動します。

FullGC

Tenured領域がオブジェクトでいっぱいになるとFullGCが発生し、Javaヒープ領域全体を対象に使用済みオブジェクトを削除します。

SerialGCの場合に設定するパラメーター

SerialGCの場合、長時間アプリケーションを停止するFullGCが必ず発生するため、FullGCを発生できるタイミングまでFullGCが発生しないようにメモリーの設計・チューニングをする必要があります。SerialGCの場合に設定するパラメーターを示します。

項番

項目

オプション名

説明

1

SerialGCの設定

-XX:+UseSerialGC

メモリー管理方式にSerialGCを選択します。このパラメーターは、デフォルトで有効です。

2

メモリーの設計

-XmxJavaヒープ領域の最大サイズ

Javaヒープ領域の最大サイズを設定します。

3

-XmsJavaヒープ領域の初期サイズ

Javaヒープ領域の初期サイズを設定します。このパラメーターは、-Xmxオプションと同じ値の設定を推奨します。

4

-XX:MaxMetaspaceSize=Metaspace領域の最大サイズ

Metaspace領域の最大サイズを設定します。

5

-XX:MetaspaceSize=Metaspace領域に起因するFullGC の基準値

Metaspace領域に起因するFullGCの基準値を設定します。Metaspace領域のサイズが基準値を超えるとFullGCが発生するため、アプリケーションで必要なクラス情報のサイズから見積もった値を設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

6

-XX:CompressedClassSpaceSize=Compressed Class Spaceの最大サイズ

圧縮オブジェクトポインター機能が有効な場合にMetaspace領域内に作成されるCompressed Class Space領域の最大サイズを設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

7

-XX:NewRatio=New領域に対するTenured領域の割合

New領域を1とした場合のTenured領域の割合を設定します。

8

-XX:SurvivorRatio=Survivor領域のFrom空間とTo空間に対するEden領域の割合

Survivor領域のFrom空間とTo空間を1とした場合の、Eden領域の割合を設定します。

関連項目

4.6.5　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

3.1.3　SerialGCと明示管理ヒープ機能を組み合わせた場合のメモリー構造とGCの流れについて

Javaのメモリー管理の方式に、SerialGCと明示管理ヒープ機能を組み合わせた方式を選択すると、SerialGCで発生するFullGCを明示管理ヒープ機能で抑止できます。SerialGCと明示管理ヒープ機能を組み合わせた方式を選択する場合、-XX:+UseSerialGCオプションのほか、メモリーに関するオプション、明示管理ヒープ機能の設定やExplicitヒープ領域のメモリー設計に関するオプションを指定します。

SerialGCと明示管理ヒープ機能を組み合わせた場合のメモリー構造

Javaのメモリー管理の方式にSerialGCと明示管理ヒープ機能を組み合わせた場合の、メモリー構造を次の図に示します。

各領域の役割を次の表に示します。

項番

領域の名称

役割

1

Javaヒープ領域

Javaプログラムが使用するメモリー領域です。大きくNew領域とTenured領域に分かれています。

2

New領域

新しいオブジェクトを格納する領域です。Eden領域とSurvivor領域に分かれています。

3

Eden領域

作成直後のオブジェクトを格納する領域です。

4

Survivor領域

1回以上GCを実施した、使用中のオブジェクトを格納する領域です。

5

Tenured領域

長時間使用するオブジェクトを格納する領域です。

7

Explicitヒープ領域

セッションオブジェクトなどを格納する領域です。

6

Metaspace領域

ロードされたクラス情報やメソッド情報を格納する領域です。

8

Cヒープ領域

Developer's Kit for Javaがネイティブライブラリーを実行する際に使用する領域です。

9

スレッドスタック領域

スレッドごとに保持するスタック領域です。

SerialGCと明示管理ヒープ機能を組み合わせた場合のメモリー管理の仕組み

メモリー管理方式にSerialGCを選択し、Javaヒープ領域を使用していくとFullGCが発生することがあります。FullGCの発生を抑えるためには、明示管理ヒープ機能を使用して、Javaヒープ領域とは別のExplicitヒープ領域に、FullGCの要因となるオブジェクトを格納します。FullGCの対象となるTenured領域に、FullGCの要因となるオブジェクトが格納されないため、FullGCの発生を抑止できます。なお、Explicitヒープ領域に格納されたオブジェクトは、寿命が切れたタイミングで明示的に解放されます。

FullGCの要因となるオブジェクト

長寿命オブジェクトで、かつ、一定期間が経過したあと不要になるオブジェクトが、FullGCの要因となります。このようなオブジェクトには、例えば、ログインからログアウトまでの一連の処理で使用するセッション情報に関係するオブジェクトが該当します。セッション情報は複数のリクエストにわたって使用するため、長寿命で、一定期間が経過してログアウトすると不要になります。Application Serverでは、セッション情報に関係するオブジェクトは、Explicitヒープ領域に格納するオブジェクトとしてデフォルトで設定されています。

オブジェクトが不要になったときのメモリーの状態

寿命がわかっているオブジェクトが、一定期間が経過したあと不要になったときのメモリーの状態を次の図に示します。なお、明示管理ヒープ機能を使用した場合のExplicitヒープ領域は、Explicitメモリーブロックという、複数のメモリーブロックで構成されています。このExplicitメモリーブロック単位で、Explicit領域内のメモリーの初期化や解放が行われます。

明示管理ヒープ機能を使用した場合

Explicitヒープ内の寿命がわかっているオブジェクト群Aが、一定期間が経過したあと不要になると、オブジェクト群Aが格納されているExplicitメモリーブロックがブロックごと削除されます。

明示管理ヒープ機能を使用しない場合

Tenured領域内の寿命がわかっているオブジェクト群Aが、一定期間が経過したあと不要になると、FullGC が発生するまでTenured領域に残ります。

SerialGCと明示管理ヒープ機能を組み合わせた場合に設定するパラメーター

メモリー管理方式にSerialGCと明示管理ヒープ機能を組み合わせた方式を選択する場合、Javaヒープ領域とExplicitヒープ領域のメモリーの設計およびチューニングをする必要があります。SerialGCと明示管理ヒープ機能を組み合わせた場合に設定するパラメーターを示します。

項番

項目

オプション名

説明

1

SerialGCの設定

-XX:+UseSerialGC

メモリー管理方式にSerialGCを選択します。このパラメーターは、デフォルトで有効です。

2

メモリーの設計

-XmxJavaヒープ領域の最大サイズ

Javaヒープ領域の最大サイズを設定します。

3

-XmsJavaヒープ領域の初期サイズ

Javaヒープ領域の初期サイズを設定します。このパラメーターは、-Xmxオプションと同じ値の設定を推奨します。

4

-XX:MaxMetaspaceSize=Metaspace領域の最大サイズ

Metaspace領域の最大サイズを設定します。

5

-XX:MetaspaceSize=Metaspace領域に起因するFullGC の基準値

Metaspace領域に起因するFullGCの基準値を設定します。Metaspace領域のサイズが基準値を超えるとFullGCが発生するため、アプリケーションで必要なクラス情報のサイズから見積もった値を設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

6

-XX:CompressedClassSpaceSize=Compressed Class Spaceの最大サイズ

圧縮オブジェクトポインター機能が有効な場合にMetaspace領域内に作成されるCompressed Class Space領域の最大サイズを設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

7

-XX:NewRatio=New領域に対するTenured領域の割合

New領域を1とした場合のTenured領域の割合を設定します。

8

-XX:SurvivorRatio=Survivor領域のFrom空間とTo空間に対するEden領域の割合

Survivor領域のFrom空間とTo空間を1とした場合の、Eden領域の割合を設定します。

9

明示管理ヒープ機能の設定

-XX:+HitachiUseExplicitMemory

明示管理ヒープ機能を有効にします。このパラメーターは、デフォルトで有効です。

10

Explicitヒープ領域のメモリー設計

-XX:HitachiExplicitHeapMaxSize=Explicitヒープ領域の最大サイズ

Explicitヒープ領域の最大サイズを設定します。

関連項目

4.6.5　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

3.1.4　G1GCのメモリー構造とGCの流れについて

Javaのメモリー管理の方式にG1GCを選択すると、メモリー領域に対してYoungGC、MixedGC、およびFullGCの3種類のGCが発生します。このうち、YoungGCとMixedGCについては、GC発生時にアプリケーションが停止する時間を制御できます。G1GCを選択する場合、-XX:+UseG1GCオプションのほか、GC発生時の目標の停止時間、メモリーに関するオプションや処理性能のチューニングに関するオプションを指定します。

G1GCのメモリー構造

Javaのメモリー管理の方式にG1GCを選択した場合の、メモリー構造を次の図に示します。

各領域の役割を次の表に示します。

項番

領域の名称

役割

1

Javaヒープ領域

Javaプログラムが使用するメモリー領域です。大きくNew領域とTenured領域に分かれています。

2

New領域

新しいオブジェクトを格納する領域です。Eden領域とSurvivor領域に分かれています。

3

Eden領域

作成直後のオブジェクトを格納する領域です。

4

Survivor領域

1回以上GCを実施した、使用中のオブジェクトを格納する領域です。

5

Tenured領域

長時間使用するオブジェクトを格納する領域です。

6

Metaspace領域

ロードされたクラス情報やメソッド情報を格納する領域です。

7

Cヒープ領域

Developer's Kit for Javaがネイティブライブラリーを実行する際に使用する領域です。

8

スレッドスタック領域

スレッドごとに保持するスタック領域です。

9

New領域の未割り当ての領域

New領域内で、Eden領域またはSurvivor領域に割り当てていない領域です。

10

Humongous領域

サイズの大きいオブジェクトを格納する領域です。Tenured領域の一部で、連続したリージョンを割り当てます。

11

未割り当ての領域

Javaヒープ領域内で、どの領域にも割り当てていない領域です。

G1GCの場合のGCの流れ

G1GCでは、Java ヒープをリージョンというメモリーブロック単位で管理しているため、New領域やTenured領域を連続領域として確保していません。オブジェクトはリージョン内に格納し、リージョンに空きがない場合は、未割り当てのリージョンを領域に割り当て、オブジェクトを格納します。

メモリー管理方式にG1GCを選択した場合のGCの流れを次の図で説明します。

YoungGC

New 領域に割り当てたリージョンに空きがなくなると、YoungGC が発生します。YoungGCが発生すると、使用中のオブジェクトは Survivor 領域に割り当てたリージョンに移動し、使用済みのオブジェクトはリージョンごと解放します。また、YoungGC発生時に使用中のオブジェクトは、Survivor 領域に割り当てたリージョン間を移動し続け、ある一定の回数移動するとTenured領域に割り当てたリージョンに移動します。YoungGC発生後は、GC に掛かった時間から、次の GC に掛かる時間を予測して、New 領域のサイズを変更します。YoungGC発生後の図は、予測した時間より長くGCに時間が掛かったために、New領域を縮小した場合の例です。

MixedGC

Tenured 領域の使用率が増加すると、MixedGCが発生します。MixedGCが発生すると、New領域に割り当てたリージョンに加えて、目標停止時間内に収まる範囲で、一部のTenured領域に割り当てたリージョンがGCの対象となります。この一部のTenured領域に割り当てたリージョンは、アプリケーションの実行と並行して行っているオブジェクトが使用中かどうかの解析情報に基づいて、解放されるサイズが大きいと予測されるリージョンから優先してGCの対象となります。そのため、オブジェクトの情報解析が十分に実施されていない場合や、解析の結果MixedGC の効果が低い場合は、 MixedGCは発生しません。

FullGC

Java ヒープ内のリージョンに空きがなくなり、MixedGCが発生しない場合、Javaヒープ全体を対象としてFullGCが発生します。

G1GCの場合に設定するパラメーター

メモリー管理方式にG1GCを選択した場合、GC によるアプリケーションの停止時間とスループットがシステム要件を満たすように、メモリーの設計やチューニングをする必要があります。なお、G1GC はFullGCの発生によるアプリケーションの停止時間を制御できません。そのため、FullGCが発生している場合、FullGCが発生しないようにチューニングをする必要があります。G1GCの場合に設定するパラメーターを示します。

項番

項目

オプション名

説明

1

G1GCの設定

-XX:+UseG1GC

メモリー管理方式にG1GCを選択します。

2

-XX:MaxGCPauseMillis=目標停止時間

目標停止時間をミリ秒単位で設定します。

3

メモリーの設計

-XmxJavaヒープ領域の最大サイズ

Javaヒープ領域の最大サイズを設定します。

4

-XmsJavaヒープ領域の初期サイズ

Javaヒープ領域の初期サイズを設定します。このパラメーターは、-Xmxオプションと同じ値の設定を推奨します。

5

-XX:MaxMetaspaceSize=Metaspace領域の最大サイズ

Metaspace領域の最大サイズを設定します。

6

-XX:MetaspaceSize=Metaspace領域に起因するFullGC の基準値

Metaspace領域に起因するFullGCの基準値を設定します。Metaspace領域のサイズが基準値を超えるとFullGCが発生するため、アプリケーションで必要なクラス情報のサイズから見積もった値を設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

7

-XX:CompressedClassSpaceSize=Compressed Class Spaceの最大サイズ

圧縮オブジェクトポインター機能が有効な場合にMetaspace領域内に作成されるCompressed Class Space領域の最大サイズを設定します。このパラメーターは、-XX:MaxMetaspaceSizeオプションと同じ値の設定を推奨します。

8

-XX:SurvivorRatio=New領域に対するSurvivor領域が最大の場合の割合

New領域に対するSurvivor領域が最大サイズの場合の割合を設定します。

9

処理性能のチューニング

-XX:ParallelGCThreads=YoungGCおよびMixedGCを行うスレッド数

YoungGCおよびMixedGCを行うスレッド数を設定します。 ConcGCThreadsのスレッド数に合わせて設定します。

10

-XX:ConcGCThreads=アプリケーションと並行して処理を実行するスレッド数

アプリケーションと並行して処理を実行するスレッド数を設定します。

関連項目

4.6.5　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

3.2　負荷分散について

負荷分散とは、Application Serverで処理するリクエストを複数のApplication Serverに分散させて、リクエスト処理に掛かる負荷を分散させることです。負荷分散をするには、ハードウェアロードバランサーまたはソフトウェアロードバランサーを使用します。

負荷分散の手段の選択

負荷分散には、ハードウェアロードバランサーまたはソフトウェアロードバランサーのどちらかを使用します。Application Serverでは、ソフトウェアロードバランサーとしてWeb Serverを使用した負荷分散機能を提供しています。この負荷分散機能では、リクエスト数を基に各サーバに処理を振り分けます。

ハードウェアロードバランサーまたはソフトウェアロードバランサーを導入する際の、コストおよび機能性に関する比較を次の表に示します。

負荷分散の手段

コスト

機能性

ハードウェアロードバランサー

高

高

ソフトウェアロードバランサー

低

低

関連項目

5.1　システム周辺環境の設定について

5.2　ソフトウェアロードバランサーを設定する

3.3　セッション管理について

セッション管理とは、リクエストとWebクライアントの対応付けをサーバIDとセッションIDを使って管理することです。業務システムの利用者がログインからログアウトまでの一連の業務処理を行う場合に、リクエストと業務情報を結びつける仕掛けをセッションと呼びます。セッション管理をすることで、ロードバランサーを使用したシステムでもセッションを継続できます。

セッション管理の仕組み

Application Serverでは、セッション中の一連のリクエストに対して、同一のセッションIDをCookieやクエリーストリングに付与して、セッションを継続させています。

ロードバランサーを配置するシステム構成で、セッションを維持する仕組みを次の図で説明します。

クライアントからの初回リクエスト

ロードバランサーが、クライアントから初回リクエストを受け付けると、ロードバランサーはApplication Server1に対してリクエストを転送します。このとき、ロードバランサーは、サーバ識別用のCookieをリクエストに含めてApplication Server1に送付します。

初回リクエストに対するレスポンス

Application Server1は、サーバ識別用のCookieとセッションIDをレスポンスに含めて、クライアントに返信します。

クライアントからの2回目のリクエスト

2回目のリクエストには、サーバ識別用のCookieを含めてロードバランサーに送付します。2回目のリクエストを受け付けたロードバランサーは、リクエストに含まれたサーバ識別用のCookieからリクエスト転送先を判別し、セッションを確立しているサーバ（Application Server1）にリクエストを送付します。

セッションIDの構成

Application Serverでは、セッションの管理に使用するセッションIDを一意にするため、セッションIDに対してサーバIDを付与しています。セッションIDの構成を次の図に示します。

セッションIDの33文字目以降に、Java EEサーバごとに異なる識別子であるサーバIDを含めることで、システム内に存在する複数のJava EEサーバ間でセッションIDが一意であることを保証します。

3.4　トランザクション管理について

データベースやトランザクションサーバなどの企業内に構築されているバックエンドシステム（EIS）で、業務取引でのデータの一貫性を保証するためにはトランザクション管理が必要です。Application Serverのトランザクションでは、ローカルトランザクションを利用することを推奨します。

トランザクション管理の仕組み

Application Serverで利用できるトランザクション管理の方式には、ローカルトランザクションとグローバルトランザクションがあります。システム統合などでグローバルトランザクションを使用する必要がある場合を除いて、ローカルトランザクションを使用することを推奨します。

ローカルトランザクション

単一のリソースが参加するトランザクションです。

グローバルトランザクション

複数のリソースが参加するトランザクションです。グローバルトランザクションは、複数のリソースを同期して制御する必要があります。なお、同期処理の制御にはコストが掛かります。

3.5　コネクション管理について

コネクションの管理とは、JDBCコネクションプールを利用して、データベースサーバに対するコネクションを管理することです。JDBCコネクションプールにプールするコネクション数を管理することで、データベースアクセスの処理時間を低減できます。また、コネクション障害検知機能を使用することで、JDBCコネクションプールのコネクションに障害が発生した場合でも、処理を続けることができます。

コネクション管理の仕組み

データベースサーバへの接続で使用するコネクションの生成は時間が掛かる処理です。そこで、JDBCコネクションプールに一定数のコネクションをプールしておきます。コネクションの取得要求を受け取ると、JDBCコネクションプールにプールしていたコネクションを返して、コネクションを使い回すことで、データベースアクセスに掛かる処理時間を低減します。

コネクション管理の仕組みを次の図に示します。

コネクション障害検知機能

コネクション障害検知機能では、コネクションの取得要求を受け取ると、JDBCコネクションプールのコネクションに障害が発生していないかをチェックして、障害が発生していないコネクションを返します。これによって、リソースダウンやネットワーク障害などでコネクションに障害が発生した場合でも、障害が発生していないコネクションを利用して処理を続けることができます。

コネクション障害検知機能を次の図に示します。

コネクションプールのコネクション数の最大値が多い場合、メモリを多く必要とします。

サーバ障害やネットワーク障害などが多発した場合、コネクション障害検知を行う際に必要なリソースが不足し、コネクション取得要求がエラーとなります。この場合、KDKD20004-Wのメッセージが出力されます。また、コネクション障害検知でタイムアウトが発生してコネクションを破棄する場合も、障害が多発してコネクションの破棄に必要なリソースが不足すると、コネクションの破棄で応答が返らなくなるおそれがあります。この場合、KDKD20001-Wのメッセージが出力されます。

なお、コネクション障害検知機能を使用する場合、障害が発生したコネクションを破棄する前に新たにコネクションを確立することで、DBMSの最大同時接続数が一時的にコネクションプールのサイズを超えることがあります。

JDBCコネクションプールのチューニング

コネクションプールを作成する際、物理コネクションの接続先データベースで設定されているコネクション数がコネクションプールの最大サイズ以上となるように、値をチューニングする必要があります。

接続先データベースで設定されているコネクション数については、各データベースのマニュアルを参照してください。

DBMSの最大同時接続数の見積もり式

DBMSの最大同時接続数の見積もり式を示します。JDBCコネクションプールを複数利用する場合の最大同時接続数は、この式の総和になります。

DBMSの最大同時接続数＝JDBCコネクションプールのサイズ＋α※

注※

＋αは、DBMSの最大同時接続数が、一時的にJDBCコネクションプールのサイズを超えるおそれがあることを示します。コネクション障害検知機能を使用する場合、障害が発生したコネクションを破棄する前に新たにコネクションを確立することで、DBMSの最大同時接続数が一時的にコネクションプールのサイズを超えることがあります。なお、＋αは、最大でコネクションプールのサイズと同じになります。

3.6　流量制御について

流量制御とは、リクエスト処理が集中した状態でもシステムを安定して稼働させるために、システムで処理するリクエストの数を制御することです。Java EEサーバで一度に実行されるリクエスト処理数の最大値を制御したり、EJBプールにプールするBean数やJDBCコネクションプールにプールするJDBCコネクション数を制御したりすることで、Java EEサーバの負荷を一定に抑え、安定したスループットを実現できます。

流量制御の仕組み

リクエスト処理の流れと流量制御の対象について次の図に示します。

制御対象リソースと設定するパラメーターについて次の表に示します。図中の項番と表の項番が対応しています。

項番

制御対象リソース

制御内容

設定するパラメーター

1

Web Serverサーバプロセス/サーバスレッド

Web Serverのサーバプロセス/サーバスレッドは、主にJava EEサーバにリクエストを転送する役割を持つプロセスです。このプロセスはJava EEサーバでのリクエスト処理が完了するまで占有されます。

最大プロセス数を変更して、最大同時接続数を制御します。1つのリクエストに対して、プロセスが1つ割り当てられます。また、処理しきれないリクエストを格納するキューのサイズも変更できます。

キューのサイズ： ListenBackLog

最大同時接続数：MaxRequestWorkers

サーバプロセスの稼働数：HWSKeepStartServers、MinSpareServers、MaxSpareServers、StartServers

2

Java EEサーバ実行スレッドプール

Java EEサーバ実行スレッドは、リクエストの解釈、Webアプリケーションの実行、およびレスポンスの構築をするスレッドです。

最大スレッド数を変更して、最大同時実行リクエスト数を制御します。1つのリクエストに対して、スレッドが1つ割り当てられます。また、処理しきれないリクエストを格納するキューのサイズも変更できます。

最大実行スレッド数：configs.config.Java EEサーバの構成名.thread-pools.thread-pool.スレッドプールID.max-thread-pool-size

実行待ちキューサイズ：configs.config.Java EEサーバの構成名.thread-pools.thread-pool.スレッドプールID.max-queue-size

3

EJBプール

プールする最大のBean数を変更して、同時に実行するスレッド数を制御します。1つのリクエストに対して、Session Beanが1つ割り当てられます。

なお、利用しているBean数が最大の場合に新たなBeanが必要になったとき、クライアントはBeanが利用できるようになるまで待つ必要があるため、リクエストが滞留します。

最大プールサイズ：configs.config.Java EEサーバの構成名.ejb-container.max-pool-size

4

JDBCコネクションプール

プールする最大のJDBCコネクション数を制御します。

なお、利用しているコネクション数が最大の場合に新たなコネクションが必要になったとき、クライアントはコネクションが利用できるようになるまで待つ必要があるため、リクエストが滞留します。

最大プールサイズ：resources.jdbc-connection-pool.コネクションプールID.max-pool-size

3.7　タイムアウト制御について

タイムアウト制御とは、処理に掛かる時間のタイムアウトを設定することです。タイムアウトを設定すると、設定時間を超えた処理は中断されるため、システム構築者にとって意図しないリソースの占有を防いだり、業務システムのユーザーに対してシステムの無反応を回避したりできます。

タイムアウト制御の仕組み

リクエスト処理の流れとタイムアウト時間の関係について、次の図に示します。

この図の呼び出し関係はすべて同期のため、実行時間はクライアントに近いほど長くなります。このため、タイムアウト個所を特定しやすいように、呼び出し元のタイムアウトが、呼び出し先のタイムアウトよりも長くなるように設定してください（Web Serverプロキシータイムアウト＞Java EEサーバリクエストタイムアウト＞トランザクションタイムアウト）。

このようなケースのほか、JAX-RSやJAX-WSを使用して、複数のアプリケーションを連携させる場合も、呼び出し元および呼び出し先で、接続タイムアウトおよびリクエストタイムアウトのタイムアウト時間を設定できます。

Application Serverで設定できる、タイムアウトについて説明します。

サーバ処理のタイムアウト

サーバ処理のタイムアウトの制御内容、設定するパラメーターを次の表に示します。

項番

設定項目名

制御内容

制御対象

設定するパラメーター

1

Web Serverタイムアウト

クライアントとのデータ送受信の待ち時間

Web Serverサーバプロセス/サーバスレッド

Timeout

2

Web Serverプロキシータイムアウト

Java EEサーバへリクエストを送信して、レスポンスを受け取るまでの時間

Web Serverサーバプロセス/サーバスレッド

ProxyTimeout

3

Java EEサーバリクエストタイムアウト

アプリケーションの実行時間

Java EEサーバ 実行スレッド

configs.config.構成名.network-config.protocols.protocol.構成名.http.request-timeout-seconds

4

トランザクションタイムアウト

トランザクション処理時間

トランザクションサービス

configs.config.構成名.transaction-service.timeout-in-seconds

5

JAX-WSタイムアウト

Webサービス実行時間

JAX-WS、およびWebService

configs.config.構成名.hitachi-jaxws-config.request-timeout

6

JAX-RSタイムアウト

Webサービス実行時間

JAX-RS、およびResource

configs.config.構成名.hitachi-jaxrs-config.read-timeout

7

JDBC SQLタイムアウト

SQLの実行時間

JDBC接続プール

次のどれかの方法で指定します。

create-jdbc-connection-poolコマンドの--statementtimeoutオプション

glassfish-resources.xmlの/resources/jdbc-connection-poolのstatement-timeout-in-seconds属性

重要

トランザクションタイムアウト発生時の対処

トランザクションタイムアウトが発生したとき、システム運用者は、ログに出力されたメッセージ（KDKD20033-W）を調査し、タイムアウトの原因を排除する必要があります。

なお、メッセージ（KDKD20033-W）は、ローカルトランザクションでタイムアウトが発生した場合だけ出力されます。

接続タイムアウト

接続タイムアウトの制御内容、設定するパラメーターを次の表に示します。

項番

設定項目名

制御内容

制御対象

設定するパラメーター

1

JAX-WS接続タイムアウト

Webサービスに対する接続を確立するまでの時間

JAX-WS、およびWebService

configs.config.構成名.hitachi-jaxws-config.connect-timeout

2

JAX-RS接続タイムアウト

Webサービスに対する接続を確立するまでの時間

JAX-RS、およびResource

configs.config.構成名.hitachi-jaxrs-config.connect-timeout

3

JDBC接続取得タイムアウト

JDBCコネクションプールから、 コネクションを取得する最大の待ち時間

JDBCコネクションプール

次のどれかの方法で指定します。

create-jdbc-connection-poolコマンドの--maxwaitオプション

glassfish-resources.xmlの/resources/jdbc-connection-poolのmax-wait-time-in-millis属性

Java EEサーバのサブコマンドのタイムアウト

asadminユーティリティーコマンドのサブコマンドの処理は、asadminユーティリティーコマンドのプロセスやドメイン管理サーバのプロセスなどのプロセス間でHTTP通信をすることで実現されます。プロセス間の通信やasadminユーティリティーコマンドのサブコマンド自体の処理などに一定以上の時間を要した場合に、タイムアウトが発生します。asadminユーティリティーコマンドのサブコマンドには、ローカルサブコマンドとリモートサブコマンドがあります。それぞれの場合のタイムアウトについて説明します。

ローカルサブコマンドの場合

ローカルサブコマンドの場合は、asadminユーティリティーコマンドを実行したホスト上でサブコマンドが処理されるため、通信に関するタイムアウトは発生しません。ただし、サブコマンドによっては、コマンド処理タイムアウトを設定できるため、設定した値を超えるとタイムアウトが発生します。

リモートサブコマンドの場合

リモートサブコマンドの場合は、ドメイン管理サーバ上でサブコマンドが処理されるため、通信が発生し、タイムアウトが発生することがあります。リモートサブコマンドを実行した場合のタイムアウトの発生個所を次の図に示します。

リモートサブコマンドのタイムアウト発生個所（サーバインスタンスの実行なしの場合）

リモートサブコマンドを実行したとき、asadminユーティリティーコマンドのプロセスはサブコマンドの処理をドメイン管理サーバに委譲します。このとき、次の処理に対してタイムアウトが設定されます。

asadminユーティリティーコマンドのプロセスからドメイン管理サーバへの通信に対して設定するHTTPレスポンス読み取り処理

asadminユーティリティーコマンドのプロセスから受け取ったサブコマンドを含むHTTPリクエストの処理

リモートサブコマンドのタイムアウト発生個所（サーバインスタンスの実行ありの場合）

リモートサブコマンドを実行したとき、asadminユーティリティーコマンドのプロセスはサブコマンドの処理をドメイン管理サーバに委譲します。ドメイン管理サーバはasadminユーティリティーコマンドのプロセスから受け取ったサブコマンドを処理した後に、サブコマンドやユーザーが指定したオプションによっては、サーバインスタンス上でも同様のサブコマンドを実行します。このとき、次の処理に対してタイムアウトが設定されます。

asadminユーティリティーコマンドのプロセスからドメイン管理サーバへの通信に対して設定するHTTPレスポンス読み取り処理

asadminユーティリティーコマンドのプロセスから受け取ったサブコマンドを含むHTTPリクエストの処理

ドメイン管理サーバプロセスからサーバインスタンスへの通信に対して設定するHTTPレスポンス読み取り処理

ドメイン管理サーバから受け取ったサブコマンドを含むHTTPリクエストの処理

サブコマンドのタイムアウトの詳細を次の表に示します

表3‒1　サブコマンドのタイムアウト一覧

項番

名称

発生プロセス

対象処理

タイムアウト時の動作

設定方法

1

asadminユーティリティーコマンドリードタイムアウト

asadminユーティリティーコマンドのプロセス

asdminユーティリティーコマンドのプロセスからドメイン管理サーバへの通信に対して設定するHTTPレスポンス読み取り処理

asadminユーティリティーコマンドの実行に失敗しますが、サブコマンドの処理はドメイン管理サーバで継続します。ドメイン管理サーバでのサブコマンドの実行結果は、ドメイン管理サーバのホストのメッセージログにメッセージ（成功時：KDKD10162-I、失敗時：KDKD10163-E）が出力されます。※1

asadminユーティリティーコマンドのプロセスの標準出力には、タイムアウトを示すメッセージが出力されます。※2

asadminユーティリティーコマンドのメッセージログには、エラーメッセージ（KDKD10164-E）が出力されます。

asadminユーティリティーコマンドの実行ホストの環境変数AS_ADMIN_READTIMEOUTにタイムアウト値を設定します（単位：ミリ秒）。※3

2

ドメイン管理サーバリクエストタイムアウト

ドメイン管理サーバプロセス

asadminユーティリティーコマンドから受け取ったサブコマンドを含むHTTPリクエストの処理

asadminユーティリティーコマンドの実行に失敗しますが、サブコマンドの処理自体はエラーにならないで継続する場合があります。※4

asadminユーティリティーコマンドのプロセスの標準出力には、サブコマンドの実行エラーを示すメッセージが出力されます。※5

ドメイン管理サーバのメッセージログには、エラーメッセージ（KDKD10165-E）が出力されます。

set parameter (configs.config.server-config.network-config.protocols.protocol.リスナー名.http.request-timeout-seconds)で設定します（単位：秒）。

リスナー名:

admin-listener（secure adminが無効な場合）

sec-admin-listener（secure adminが有効な場合）

3

ドメイン管理サーバリードタイムアウト

ドメイン管理サーバプロセス

ドメイン管理サーバプロセスからサーバインスタンスへの通信に対して設定するHTTPレスポンス読み取り処理

asadminユーティリティーコマンドの実行に失敗しますが、サーバインスタンス上でのサブコマンドの処理は継続します。サーバインスタンス上でのサブコマンドの実行結果は、サーバインスタンスのメッセージログにメッセージ（成功時：KDKD10162-I、失敗時：KDKD10163-E）が出力されます。※1

asadminユーティリティーコマンドのプロセスの標準出力には、サブコマンドの実行エラーを示すメッセージが出力されます。※5

ドメイン管理サーバのメッセージログには、エラーメッセージ（KDKD10164-E）が出力されます。

ドメイン管理サーバのホストの環境変数AS_ADMIN_READTIMEOUTにタイムアウト値を設定します（単位：ミリ秒）。※3

4

サーバインスタンスリクエストタイムアウト

サーバインスタンスプロセス

ドメイン管理サーバから受け取ったサブコマンドを含むHTTPリクエストの処理

asadminユーティリティーコマンドの実行に失敗しますが、コマンド処理自体はエラーにならないで継続する場合があります。※4

asadminユーティリティーコマンドのプロセスの標準出力には、コマンドの実行エラーを示すメッセージが出力されます。※5

ドメイン管理サーバのメッセージログには、エラーメッセージ（KDKD10165-E）が出力されます。

set parameter (configs.config.Java EEサーバのコンフィグ名.network-config.protocols.protocol.sec-admin-listener.http.request-timeout-seconds)で設定します（単位：秒）。

注※1

実行結果ログを出力するサブコマンドと出力しないサブコマンドがあります。実行結果ログの出力の有無については、処理に時間が掛かるサブコマンドの表を参照してください。

注※2

次のメッセージが出力されます。

No response from Domain Admin Server after タイムアウト値 seconds.
The command is either taking too long to complete or the server has failed.
Please see the server log files for command status.
Command コマンド名 failed.

注※3

asadminユーティリティーコマンドリードタイムアウト、ドメイン管理サーバリードタイムアウトの設定値は各サブコマンドで共通の値になります。デフォルトのタイムアウト時間でタイムアウトが発生する場合は、最も処理に時間が掛かるコマンドの時間に合わせて、それらのタイムアウト時間を設定する必要があります。

注※4

タイムアウト時に処理を継続するサブコマンドについては、処理に時間が掛かるサブコマンドの表を参照してください。

注※5

次のメッセージが出力されます。

Command コマンド名 failed.

処理に時間が掛かるサブコマンドを次の表に示します。

表3‒2　処理に時間が掛かるサブコマンド

項番

コマンド名

条件

実行結果ログ

デプロイするアプリケーション数

デプロイするアプリケーションのサイズ

リクエスト終了待ち時間

収集対象のファイルサイズおよびファイル数

1

start-instance

○

−

−

−

出力する

2

stop-instance

○

−

○

−

出力する

3

start-cluster

○

−

−

−

出力する

4

stop-cluster

○

−

−

−

出力する

5

start-servers

○

−

−

−

出力しない

6

stop-servers

○

−

○

−

出力しない

7

deploy

−

○

−

−

出力する

8

undeploy

−

○

○

−

出力する

9

enable

−

○

−

−

出力する

10

disable

−

−

○

−

出力する

11

collect-snapshot

−

−

−

○

出力しない

（凡例）

○：条件によってサブコマンドの処理時間が変動します。

−：サブコマンドの処理時間は変動しません。

次のどれかが発生した場合、それらのタイムアウト時間にコマンド処理タイムアウトより十分に大きな時間を設定し、それらのタイムアウトが発生しないようにしてください。

asadminユーティリティーコマンドリードタイムアウト

ドメイン管理サーバリクエストタイムアウト

ドメイン管理サーバリードタイムアウト

サーバインスタンスリクエストタイムアウト

タイムアウト値を設定する場合、これらのタイムアウト値には、すべて同じタイムアウト時間を設定してください。

タイムアウト時間は、asadminユーティリティーコマンドのサブコマンドごとではなく、すべてのサブコマンドで同じ値が適用されます。そのため、最も処理時間が掛かるサブコマンドの時間に合わせてタイムアウト時間を設定してください。

メモ

処理に時間が掛かるサブコマンドは、デプロイするアプリケーション数に依存して時間が掛かるなど、条件によってコマンドの処理時間が増加し、タイムアウトになることがあります。

3.8　セキュリティー対策について

Application Serverを使用したシステムのセキュリティー対策とは、暗号化やユーザー認証などの機能で、データの改ざんやハッキングなどの脅威からデータやシステムを守ることです。Application Serverの機能としてのセキュリティー対策のほか、システムの運用方法を規定して脅威からデータやシステムを守るセキュリティー対策も必要です。

セキュリティー対策の方針

Application Serverを利用した標準的なシステム構成を基に、そこで想定される脅威を挙げ、その脅威への対応方針と対策を示します。 なお、Application Server上で動作するアプリケーションのセキュリティーについては、アプリケーションの開発元が考慮する内容のため、ここでは説明の対象外とします。

Application Serverを利用した標準的なシステム構成と想定される脅威

Application Serverを利用した標準的なシステム構成を例に、運用シナリオと想定される脅威を次に示します。

Application Serverを利用した標準的なシステム構成

Application Serverを利用した標準的なシステム構成を次の図に示します。

システムの構成要素

Application Serverを利用した標準的なシステムの構成要素を次の表に示します。

表3‒3　システムの構成要素

項番

要素

説明

1

社内

社内ユーザーおよびシステム運用者が作業するエリアです。このエリアは、社内LANおよび管理LANが敷設されていて、管理LANと社内LANは物理的に分離されています。社内の管理LANと社内LANは、どちらも社外からは物理的に分離されていることを想定しています。

2

マシン室

システム構築者 が作業するエリアです。セキュリティーを確保するため、運用管理サーバマシン、アプリケーション実行環境マシン、データベースサーバマシンなどを配置しています。

このエリアは、入退室管理などが厳格に行われているため、社内で一番セキュリティーレベルが高いことを想定しています。

3

社内LAN

社内ユーザーが使うPCとアプリケーションとの間で、業務用データをやりとりするためのLANです。

4

管理LAN

システム運用者が使うPCとドメイン管理サーバとの間で、管理用データをやりとりするためのLANです。

5

DMZ

社内LANとWWWの間に設置された隔離されたネットワーク領域です。

6

ドメイン管理サーバ

Application Serverがインストールされた複数のアプリケーション実行環境マシンを、ドメイン単位にグループ化して運用を管理するサーバです。

7

運用管理サーバマシン

ドメイン管理サーバがインストールされているマシンです。アプリケーション実行環境マシンの運用を管理します。

8

アプリケーション実行環境マシン

Application Serverがインストールされているマシンです。アプリケーションを管理します。

9

データベースサーバマシン

DBMSが動作するサーバです。アプリケーションが使用することを想定しています。

なお、データベースのセキュリティー機能は、Application Serverの管理対象外です。

10

スイッチ

IPアドレスによるルーティングの制御をします。

11

ファイアウォール

IPアドレスとポート番号などによるアクセス制御ができます。

12

ハードウェアロードバランサー/SSL

アプリケーション実行環境マシンへのリクエストを分散させることができます。SSL通信をサポートしているため、暗号化した通信もできます。

システムの運用シナリオ

Application Serverを利用した標準的なシステム構成図を基にした運用シナリオを次に示します。

社外ユーザーは、PC にインストールされたWeb ブラウザーを使用してHTTPやWebSocketでアプリケーションにアクセスし、インターネット経由でシステムを利用します。

なお、社外ユーザーは、Webサービス（JAX-WS、JAX-RS）やRMI/RMI-IIOPを使用したアクセスはしないと想定します。

社内ユーザーは、社内から業務用のPC にインストールされたWeb ブラウザーまたはアプリケーションのクライアントを利用してアプリケーションにHTTP（SOAP/REST含む）やWebSocketでアクセスし、社内LAN 経由で業務を行います。

なお、社内ユーザーは、RMI/RMI-IIOPを使用したアクセスはしないと想定します。

システム運用者は、社内から管理用のPC にインストールされたWeb ブラウザーまたはApplication Serverの管理コマンドを使用してドメイン管理サーバ にアクセスし、管理LAN 経由で運用時の管理をします。

システム構築者 は、運用管理サーバマシン、アプリケーション実行環境マシンおよびデータベースサーバマシンに直接アクセスし、セットアップおよび設定変更をします。

システム構築者 は、マシン室から、管理用のPC にインストールされたWeb ブラウザーまたはApplication Serverの管理コマンドを使用してドメイン管理サーバ にアクセスし、複数のアプリケーション実行環境マシンの管理をします。

ドメイン管理サーバ はシステム運用者あるいはシステム構築者 から受けた指示を各アプリケーション実行環境マシンに送信し、アプリケーション実行環境マシン上のApplication Serverプロセスの起動、停止、および設定変更をします。

想定されるシステムへの攻撃

Application Serverを利用したシステムに対する攻撃者による脅威を次に示します。

攻撃者Aは、インターネット上からアプリケーション実行環境マシンを直接攻撃します。

攻撃者Bは、社内LAN に接続している業務用のPC から、不正にアプリケーションへアクセスし、攻撃します。

攻撃者Cは、システム運用者になりすまして、管理LANに接続している業務用PCから不正にシステムへアクセスし、ドメイン管理サーバやアプリケーション実行環境マシンを攻撃します。

システム上で想定される脅威に対するセキュリティーポリシー

Application Serverを利用したシステムのセキュリティーポリシーの想定を示します。

ネットワークのセキュリティーポリシーの想定

レイヤー3までのネットワークに関するセキュリティーでは、次の内容を考慮して設計します。

社外からのパケットは、ハードウェアロードバランサー/ファイアウォールによって通常使用されるポートに限定したアクセスに制限する。

社内LANおよび社外からのパケットは管理用のLANに送信されないようにする。

レイヤー4以上のネットワークに関するセキュリティーでは、次の内容を考慮して設計します。

Java EEの標準仕様の範囲内で対応し、そのほかについてはアプリケーション開発者の責任にする。

管理LANのネットワークに関するセキュリティーでは、次の内容を考慮して設計します。

管理LANは社内LANとは独立しているが、悪意の有無に関係なく、攻撃者に接続させないようにする。

物理的操作のセキュリティーポリシーの想定

社外は、次の内容を考慮して設計します。

悪意のある人物がいる可能性があるため、社外からは、社内LANおよび管理LANに物理的に接続させないようにする。

社内は、次の内容を考慮して設計します。

悪意のある攻撃者がいるため、Application Serverへの物理的アクセスはネットワーク経由に限定する。

マシン室エリアは、次の内容を考慮して設計します。

悪意の有無に関係なく、攻撃者がエリアに入れないようにする。

開発環境のセキュリティーポリシーの想定

社内LAN上のマシンでアプリケーションを開発します。

開発者が悪意のあるコードをアプリケーションに混入させる恐れがないか確認します。

開発したアプリケーションに対して、有識者がレビューを実施します。

開発したアプリケーションがウイルスに感染していないことを確認する。

社内LAN上で開発したアプリケーションは、システム構築者が管理LANを経由してアプリケーション実行環境マシンにデプロイします。

管理LAN上のアプリケーション実行環境マシンに、アプリケーション開発者がアプリケーションを直接デプロイさせない。

Application Serverのセキュリティーポリシー

想定する脅威に対するApplication Serverのセキュリティーポリシーを次に示します。

社内LANからのアプリケーションに対するアクセスでは、システム構築者が指定した権限の範囲内で運用します。

社内LANからのアプリケーションに対するアクセスでは、システム構築者が指定した権限を逸脱しないようにします。

指定したファイルアクセス権限を逸脱しないようにします。

社内LANからのアプリケーションに対するアクセスは盗聴・改ざん防止のための暗号化をサポートします。

社内LANからのアプリケーションに対するアクセスは、アプリケーションのログとApplication Serverのログをそれぞれ取得します。

社内LANからのアプリケーションに対するアクセスは認証機能をJava EEの標準仕様の範囲内で提供します。

運用管理機能に使用されるポートのセキュリティーは保証しないようにします。

Application Serverのファイルおよびメモリの耐タンパ性は保証しないようにします。

Application Serverのファイルおよびメモリで保護すべきデータの出力は制限しないようにします。

Application Serverからのネットワークを超えた出力については、セキュリティーに関連した設定データ（Java EEサーバの設定ファイルのdomain.xml、パスワード管理ファイルなど）は保護します。

システムに対する脅威と対策

Application Serverを利用した標準的なシステム構成図を基に、システムで発生するおそれがあるセキュリティー上の脅威について説明します。

図中の丸付き数字は脅威が想定される個所を示しています。

システムに対する脅威への対策を次の表に示します。なお、図中の丸付き数字と表の項番が対応しています。

項番

システムに対する脅威

脅威の概要

Application Serverの機能、および運用面での対策

セキュリティー機能の設定

1

通信データののぞき見、および改ざん

ネットワークに流れるパケットを不正に取得して業務データや管理データを不正に閲覧したり、パケット自体を改変してデータを不正に変更したりすることです。

機能

Web ServerのSSL、およびTLS暗号機能を利用します。

運用

ロードバランサーのSSL、およびTLS暗号機能を利用します。

Webサーバの動作環境を設定するファイル（httpsd.conf）で、SSL認証の暗号機能を指定します。

2

指令の改ざん

ネットワークに流れるパケットを改変して、システム構築者や運用者が発行した指令を改変することです。

運用

管理LANのアクセス制御を実施します。

--

3

権限がないユーザーのアプリケーションへのアクセス

攻撃者が、アクセス権限のないアプリケーションにリクエストを送信し、不正に業務を行うことです。

機能

Java EE標準のセキュリティーロールを使用します。

create-auth-realmサブコマンドで、名前付き認証レルムを作成し、アプリケーションのDDでセキュリティーロールを定義します。

4

権限がないユーザーの指令の実行

アクセス権がない攻撃者が、運用管理機能にアクセスし、不正に指令を実行することです。

機能

ドメイン管理サーバの管理パスワードで認証します。

運用

ドメイン管理サーバのユーザー認証用のデータ（パスワードなど）は、管理LANだけに接続された機器だけに保存します。

ドメイン管理サーバの管理ポートは、アクセス元を管理LAN側だけに限定します。

create-domainサブコマンドでドメインを作成する際に、管理ユーザーのパスワードを指定します。管理ユーザーのパスワードは、change-admin-passwordサブコマンドで変更できます。

5

アプリケーションの脆弱性が連鎖的にJava EEサーバ全体に及ぼす影響

特定のアプリケーションが受信した想定外の電文によって脆弱性が発現し、それが連鎖的にJava EEサーバ全体へ影響することです。

機能

Javaのセキュリティーポリシーによって保護（API利用の制限）します。

Java SE が提供するシステムプロパティー（server.policyファイル）のロケーションを指定します 。

6

不正アクセスの否認

攻撃者が不正アクセスをしたにもかかわらず、攻撃者が不正アクセスの事実を否認することです。

機能

Web Serverのアクセスログを設定します。

Webサーバの動作環境を設定するファイル（httpsd.conf）で、Webサーバのアクセスログを設定します。

7

ショルダーハッキング

攻撃者がシステム構築者やシステム運用者の肩越しにパスワードなどの情報を盗み見ることです。

機能

パスワードなどの重要な情報を見られないにするため、テキストボックスに入力した文字を隠して、代わりに黒丸や別の文字を表示する機能を使用します。

--

8

サービス拒否攻撃

攻撃をしてサービスの提供ができない状態にすることです。

機能

タイムアウト制御やパケットサイズの制限をするための機能を使用します。

運用

JP1と連携して、セキュリティー異常監視をします。

その他

ファイアウォール、ロードバランサーなどのネットワーク製品で対策をして、DoS攻撃のアクセスを軽減する必要があります。

Webサーバの動作環境を設定するファイル（httpsd.conf）で、タイムアウト制御やパケットサイズの制限を指定します。

関連項目

6.2.1　リバースプロキシーを設定する

6.2.2　SSLを設定する

3.9　Application Serverで利用できるアプリケーション認証について

アプリケーション認証とは、セキュリティーを確保するために使用するユーザー認証のことです。Application Serverで利用できるアプリケーション認証の方式には、クライアント認証、BASIC認証、FORM認証、およびDIGEST認証があります。

アプリケーション認証の分類

Application Serverで利用できるアプリケーション認証について次の表に示します。認証を行う個所が複数ある認証方式については、どれか1個所を設定します。

項番

認証方式

認証を行う個所

認証の仕組み

1

クライアント認証

Web Server

SSL

2

SSLアクセラレーター

3

BASIC認証

Web Server

パスワードファイル

4

LDAPリポジトリー

5

Java EEサーバ

JAAS

6

FORM認証

Java EEサーバ

JAAS

7

DIGEST認証

Java EEサーバ

3.10　リソースの見積もりについて

リソースは、共用メモリーサイズ、プロセス数、スレッド数、ファイルディスクリプター数、およびデータベース容量を見積もったあと、それらを集計して全体のリソースを見積もります。

共用メモリーサイズの見積もり

Webサーバ、およびパフォーマンストレーサーが使用する共用メモリーサイズの見積もりを次に示します。

Webサーバが使用する共用メモリーサイズ

Web サーバが使用する共用メモリーサイズは、次の計算式で算出します。

なお、Web サーバが使用する共用メモリーサイズは共用メモリーセグメントのサイズです。

Webサーバが使用する共用メモリーサイズ＝409,600＋7,168×MaxRequestWorkers

（凡例）

MaxRequestWorkers：同時に接続できるクライアントの最大数（バイト）

パフォーマンストレーサーが使用する共用メモリーサイズ

パフォーマンストレーサーが使用する共用メモリーサイズは、次の計算式で算出します。

なお、パフォーマンストレーサーが使用する共用メモリーサイズは共用メモリーセグメントのサイズです。

パフォーマンストレーサーが使用する共用メモリーサイズ＝PrfTraceBufferSize指定値×1,024＋18,496

（凡例）

PrfTraceBufferSize指定値：共用メモリーに確保するパフォーマンストレーサーのトレースバッファーサイズ（バイト）

プロセス数の見積もり

Java EE Server、Webサーバ、およびパフォーマンストレーサーのプロセス数の見積もりを次に示します。

Java EE Serverのプロセス数

Java EE Serverの常駐プロセス数は、次の計算式で算出します。

Java EE Serverの常駐プロセス数＝ドメイン管理サーバ数＋サーバインスタンス数

Webサーバのプロセス数

Web サーバのプロセス数は、次の計算式で算出します。

Webサーバのプロセス数＝制御プロセス＋サーバプロセス＋CGIプロセス＋gcacheサーバ
＋rotatelogsプロセス＋rotatelogs2プロセス

（凡例）

制御プロセス：1

サーバプロセス：MaxRequestWorkersディレクティブ指定数

CGIプロセス：サーバプロセス数分

gcacheサーバ：1

rotatelogsプロセス：CustomLogディレクティブ、ErrorLogディレクティブ、HWSRequestLogディレクティブ、TransferLogディレクティブに指定したrotatelogsプログラム数

rotatelogs2プロセス：CustomLogディレクティブ、ErrorLogディレクティブ、HWSRequestLogディレクティブ、TransferLogディレクティブに指定したrotatelogs2プログラム数

パフォーマンストレーサーのプロセス数

パフォーマンストレーサーの常駐プロセス数は1です。

スレッド数の見積もり

Java EE Server、Webサーバ、およびパフォーマンストレーサーのスレッド数の見積もりを次に示します。

Java EE Serverのスレッド数

Java EE Serverが使用するスレッド数は、次の計算式で算出します。

（凡例）

Dt：ドメイン管理サーバの1プロセス当たりのスレッド総数

SIt： サーバインスタンスの1プロセス当たりのスレッド総数

ｍ：ドメイン管理サーバのプロセス数

ｎ：サーバインスタンスのプロセス数

ドメイン管理サーバの1プロセス当たりのスレッド総数Dtと、サーバインスタンスの1プロセス当たりのスレッド総数SItを求める計算式を次に示します。

（凡例）

Tm：スレッドプールの最大値

Cm：JDBCコネクションプールのコネクション最大値（コネクション障害検知機能が有効な場合だけ。コネクション障害検知機能が無効な場合は0。）

Tn：スレッドプールに属さないスレッド数。ドメイン管理サーバやサーバインスタンスがデフォルトで生成するスレッド数は44です。

ｍ：ドメイン管理サーバのスレッドプール数

ｎ：サーバインスタンスのスレッドプール数

ｒ：サーバインスタンスのJDBCコネクションプール数

ｍとｎのスレッドプール数は、list-threadpoolsコマンドを実行して表示されるスレッドプールの一覧で確認してください。

Webサーバのスレッド数

Webサーバが使用するスレッド数は、Webサーバが使用するプロセス数と同じです。

パフォーマンストレーサーのスレッド数

パフォーマンストレーサーが使用するスレッド数は10です。

ファイルディスクリプター数の見積もり

Java EEサーバ、Webサーバ、およびパフォーマンストレーサーのファイルディスクリプター数の見積もりを次に示します。

Java EEサーバのファイルディスクリプター数

Java EEサーバのファイルディスクリプター数は、OSのopen()、socket()などのシステムコールの発行に従って増減します。また、ファイルディスクリプター数は、DBMSの同時接続数によっても異なります。

ここでは、DBMSの最大同時接続数を基に、Java EEサーバが使用するファイルディスクリプター数の見積もりを示します。

Java EEサーバが使用するファイルディスクリプター数は、次の計算式で算出します。

Java EEサーバのファイルディスクリプター数＝JDBコネクションプールサイズ×2

Webサーバのファイルディスクリプター数

Webサーバが使用するファイルディスクリプター数は、次の計算式で算出します。

Linuxの場合

Webサーバが使用するファイルディスクリプター数＝(50＋A×B＋C＋11×C×D＋8×E＋(F＋H)×G)×1.2

AIXの場合

Webサーバが使用するファイルディスクリプター数＝(50＋A×B＋C＋3×C×D＋5×E＋(F＋H)×G)×1.2

（凡例）

A：Listenディレクティブ指定数（Listenディレクティブの指定がない場合は1）

B：ホストに割り当てられたIPアドレスの数

C：CustomLogディレクティブ、ErrorLogディレクティブ、HWSRequestLogディレクティブ、TransferLogディレクティブ指定の総数

D：rotatelogsプログラムまたはrotatelogs2プログラムを使用する場合は1、使用しない場合は0

E：同時実行CGI数（MaxRequestWorkers指定値。CGIプログラムを使用しない場合は0）

F：SSLを使用する場合は3、使用しない場合は2

G：同時実行リクエスト数（MaxRequestWorkers指定値）

H：リバースプロキシーを使用する場合は1、使用しない場合は0

なお、CGIプログラム内およびWebサーバに同梱されていない外部モジュール内で使用するファイルディスクリプターの数は含みません。

パフォーマンストレーサーのファイルディスクリプター数

パフォーマンストレーサー起動時に使用するファイルディスクリプターの数は、32以上に設定してください。

データベース容量の見積もり

Application Serverの機能としてEJBタイマーサービスとJava Batchを使用する場合、DBMSを必要とします。DBMSにはテーブル情報が定義されているDDLファイルが格納されています。このDDLファイルのテーブル情報および実測したレコード数を基に、データベース容量の見積もりをしてください。

見積もりに必要なDDLファイルの格納場所を次に示します。

表3‒4　DDLファイルの格納場所

項番

対象

格納先ディレクトリー

ファイル名

DBMS

1

EJBタイマーサービス

Application Serverのインストールディレクトリー/javaee/glassfish/lib/install/databases

ejbtimer_hirdb.sql

HiRDB

2

ejbtimer_oracle.sql

Oracle

3

Java Batch

jsr352-hirdb.sql

HiRDB

3.11　トラブルシュートの流れについて

Application Serverのシステムで障害が発生した場合、トラブルシュートの流れに従って障害の調査や対処を実施します。システム運用時と、システム構築時とでは、トラブルシュートの流れが異なります。

システム運用時のトラブルシュートの流れ

システム運用時のトラブルシュートの流れについて説明します。

Application Serverのシステム運用時に、障害が発生した場合のトラブルシュートの流れを次の図に示します。

業務システムのユーザーの業務に支障が発生した場合、ユーザーからシステム運用者に障害発生が通知されます。Application Serverのメッセージ監視では、障害を知らせるメッセージが出力され、システム運用者に障害発生が通知されます。

障害発生の通知を受け、システム運用者が障害の一次判定を実施します。

一次判定の結果、対応できる場合は、障害の対処および対策を実施します。

一次判定の結果、さらに障害調査が必要な場合は、システム構築者がトラブルシュート資料を収集します。

トラブルシュート資料を利用して、回復できるかどうかの回復判断を実施します。

回復判断の結果、回復できる場合は障害を回復させます。

回復判断の結果、回復できない場合、および回復可能で回復作業を実施した場合のどちらの場合も、トラブルシュート資料を利用して、問題を切り分けます。

問題を切り分けた結果、システム構築者が対応できる場合は、障害の対処および対策を実施します。

さらに詳細な調査が必要な場合は、製品サポートサービスで詳細な調査を実施します。

詳細な調査の結果、障害への対処および対策を実施します。

システム構築時のトラブルシュートの流れ

システム構築時に、障害が発生した場合のトラブルシュートの流れを次の図に示します。

発生した障害について、システム構築者がトラブルシュート資料を収集します。

トラブルシュート資料を利用して、問題を切り分けます。

問題を切り分けた結果、システム構築者が対応できる場合は、障害の対処および対策を実施します。

さらに詳細な調査が必要な場合は、製品サポートサービスで詳細な調査を実施します。

詳細な調査の結果、障害への対処および対策を実施します。

関連項目

9.1　Application Serverが出力するトラブルシュート資料について

3.12　クラスローダーの構成について

クラスローダーとは、クラスをロードするオブジェクトです。アプリケーションで利用するライブラリーを開発するとき、ライブラリーのスコープを定義する必要があります。

クラスローダーの構成

アプリケーションで利用するライブラリーを開発するとき、ライブラリーのスコープを定義するには、Java EE Serverのクラスローダーの階層構造をアプリケーション開発者が把握しておく必要があります。

Java EE Serverのクラスローダーの階層構造を次に示します。

各クラスローダーの内容を次の表に示します。

項番

クラスローダー名

説明

1

Bootstrap

Java VMが提供するクラスをロードします。

2

Extension

system extensionsディレクトリー（domain-dir/lib/ext）に配置したJARファイルからクラスをロードします。

3

Public API

Java EE APIおよびApplication Server固有APIとその実装クラスをロードします。

4

Common

アプリケーションやリソースアダプターで共通して使用するライブラリー（JARファイル）をロードします。

Application Serverのインストールディレクトリー/javaee/glassfish/libディレクトリーに配置されたJARファイルからクラスをロードし、次にApplication Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/libからクラスをロードします。

5

Connector

すべてのアプリケーションが共用するリソースアダプターアーカイブをロードします。

6

Applib

デプロイ時に指定したライブラリー（JARファイル）をロードします。※

7

Archive

デプロイしたアプリケーションやモジュールに含まれる次のファイルおよびクラスをロードします。

WARファイル、EARファイル、およびJARファイル

サーバインスタンスが生成するアプリケーション固有のクラス（スタブクラスやJSPページから作られるサーブレットなど）

注※

デプロイした複数のアプリケーションで同一ライブラリーを利用する場合、各アプリケーションは同じライブラリーのインスタンスを共有します。

ライブラリーからほかのライブラリーのクラスは参照できません。

4　アプリケーション実行環境の構築

アプリケーション実行環境を構築する手順について説明します。1つのJava EEサーバを配置するシステム、または複数のJava EEサーバを配置しロードバランサーを利用するクラスター構成のシステムを構築します。システムの構築には、コマンドまたはAdministration Consoleを利用します。なお、クラスター構成とは、複数のJava EEサーバをグループ化して管理するための構成のことです。

4.1　構築するアプリケーション実行環境について

アプリケーション実行環境は、1つのJava EEサーバを配置する構成、または複数のJava EEサーバを配置して負荷を分散させるクラスター構成のどちらかの方法で構築できます。構築できるアプリケーション実行環境の構成や、構築方法の種別など、アプリケーション実行環境の構築の概要について説明します。

構築するアプリケーション実行環境の構成

このマニュアルで説明しているアプリケーション実行環境の構築手順では、次のどちらかの構成を構築できます。

1つのJava EEサーバを配置する構成

Java EEサーバを1つ配置する構成です。次のマシンで構成されます。

アプリケーション実行環境マシン兼運用管理サーバマシン

1台のマシンに、1つのJava EE サーバ、Webサーバ、パフォーマンストレーサー、およびドメイン管理サーバを配置します。各プロセスは、ドメインおよびノードで管理します。

1つのJava EEサーバを配置する構成の場合のアプリケーション実行環境の論理構成を次に示します。

複数のJava EEサーバを配置する構成

クラスター構成にした複数のJava EEサーバを配置した構成です。別マシン上の複数のJava EEサーバをグループ化し、クラスター内の複数のJava EEサーバにリクエストを振り分けます。リクエストの振り分けにはロードバランサーを利用します。次のマシンで構成されます。

アプリケーション実行環境マシン

複数台のアプリケーション実行環境マシンそれぞれに、Java EE サーバ、Webサーバ、およびパフォーマンストレーサーを配置します。各プロセスは、ドメイン、ノード、およびクラスターで管理します。

運用管理サーバマシン

ドメイン管理サーバを配置します。

複数のJava EEサーバを配置する構成の場合のアプリケーション実行環境の論理構成を次に示します。

なお、構築するアプリケーション実行環境の構成によって構築手順や指定値などが異なる個所には、「1つのJava EEサーバを配置する構成の場合」、または「複数のJava EEサーバを配置するクラスター構成の場合」と記載しています。

Application Serverのインストールおよびセットアップ後にデフォルトで作成される要素

Application Serverのインストールが完了すると、インストール先のホスト上に、次のコンポーネントが作成されます（[]内は名称を示します）。

デフォルトのドメイン[domain1]

デフォルトのノード[localhost-domain1]

ドメイン管理サーバのスレッドプール[admin-thread-pool、 http-thread-pool、 thread-pool-1]

アプリケーション実行環境の構築方法の種別

アプリケーション実行環境は、次のどちらの方法でも構築できます。このマニュアルでは、コマンドを利用した方法で構築手順を説明しています。

コマンド

このマニュアルに記載されている手順のとおりに実行して構築します。コマンドは管理者権限で実行します。

Administration Console

Administration Consoleにログインして、GUIを利用して構築します。ドメインに関する操作を除き、コマンドと同様の操作ができます。

関連項目

7.4.1　Administration Consoleにログインする

4.2　アプリケーション実行環境の構築の流れ

アプリケーション実行環境を構築するために実施する作業と、作業の流れについて説明します。アプリケーション実行環境を構築するには、Application Serverをインストールし、アプリケーション実行環境をセットアップします。そのあと、データベースサーバと接続し、アプリケーションをデプロイします。さらに、リモートホストにApplication Serverを構築し、運用管理サーバを利用するための設定をします。すべての設定が完了したら、システムを停止します。コマンドでアプリケーション実行環境を構築する場合は、管理者権限で実行します。

関連項目

4.4.1　Application Serverのインストールの種類について

4.5.1　ドメインを作成する

4.5.2　ノードを作成する

4.5.3　ノードを削除する

4.5.4　ドメインを削除する

4.6.1　Application Serverのセットアップの流れ

4.7.1　データベースサーバへの接続の流れ

4.8.1　アプリケーションのデプロイの流れ

4.9.1　システム設定情報の確認について

4.10.1　リモートホストへのアプリケーション実行環境の構築の流れ

7.2.1　コマンドを利用してシステムを開始する

7.2.2　コマンドを利用してシステムを停止する

4.11.1　Application Serverを削除する

4.11.2　Application Serverをアンインストールする

4.3　ディスク占有量およびメモリー所要量について

Application Serverのディスク占有量、Application Serverで使用するメモリー所要量について説明します。

ディスク占有量

AIXの場合

AIXの場合のディスク占有量については、リリースノートを参照してください。

Linuxの場合

機能名

ディスク占有量（MB）

Application Server - Base

44.0

Developer's Kit for Java

179.0

Java EE Server

140.0

Web Server

36.0

メモリー所要量

AIXの場合

AIXの場合のメモリー所要量については、リリースノートを参照してください。

Linuxの場合

機能名

メモリー所要量（MB）

Application Server - Base

20

Developer's Kit for Java

各Javaアプリケーションに含まれます

Java EE Server（サーバインスタンス分）

2,649

Java EE Server（ドメイン管理サーバ分）

1,000

Web Server

90

4.4　Application Serverのインストール

Application Serverのインストール手順について説明します。Application Serverは、OSの準備が完了しているマシンに、製品の提供媒体からインストーラーを利用してインストールします。

4.4.1　Application Serverのインストールの種類について

インストールの種類には、Application Serverがインストールされていないマシンにインストールする新規インストール、複数のApplication Serverを別のディレクトリーにインストールする複数インストール、V9以前のアプリケーション実行環境、またはV9以前のアプリケーション開発環境がインストールされているディレクトリーとは別のディレクトリーにApplication Serverをインストールする追加インストール、およびApplication Serverをアップデートする上書きインストールがあります。

Application Serverのインストールには、次の種類があります。

新規インストール

Application Serverがインストールされていないマシンで、Application Serverをインストールすることです。

複数インストール

Application Serverがインストール済みのマシンで、Application Serverを別のディレクトリーにインストールすることです。

マシン内にApplication Serverを共存させる運用をする場合に使用します。例えば、1台のマシンに異なるバージョンのApplication Serverを共存させて、アップデート前の実行環境を残したまま、アップデート後の実行環境へ移行することもできます。

追加インストール

V9以前のアプリケーション実行環境、またはV9以前のアプリケーション開発環境がインストール済みのマシンで、V10以降のApplication Serverを別のディレクトリーにインストールすることです。

マシン内に異なるバージョン、または異なるエディションのApplication Serverを共存させる運用をする場合に使用します。例えば、V9以前のアプリケーション開発環境が構築済みのマシンで、V10以降のApplication Serverを別ディレクトリーに追加インストールできます。

上書きインストール

Application Serverがインストール済みのマシンで、アップデートするApplication Serverを同じディレクトリーにインストールすることです。インストール済みのApplication Serverは上書きされます。

関連項目

4.1　構築するアプリケーション実行環境について

4.4.2　Application Serverを新規インストールする

4.4.3　Application Serverを複数インストールする

4.4.4　V9以前のアプリケーション実行環境が構築済みのマシンにApplication Serverを追加インストールする

4.4.5　Application Serverを上書きインストールする

4.4.2　Application Serverを新規インストールする

Application Serverを新規インストールするには、製品の提供媒体から日立PPインストーラーを起動し、PPインストール画面でインストールするプログラムを選択します。インストール完了後、環境変数の設定をします。

前提条件

管理者特権（スーパーユーザー）で実行する

前提としているOS（OSのパッチを含む）のインストールが完了している

Application Serverがインストールされていない

想定ユーザー

システム構築者

操作手順

次の表に示すパッケージがインストールされていることを確認します。

表4‒1　OSごとに適用するパッケージ

パッケージ名

Red Hat Enterprise Linux 5

Red Hat Enterprise Linux Server 6

Red Hat Enterprise Linux Server 7

compat-libstdc++-296 (i386)

○

—

—

compat-libstdc++-33 (i386)

○

—

—

compat-libstdc++-33 (i686)

—

○

—

compat-libstdc++-33 (x86_64)

○

○

—

coreutils (x86_64)

○

○

○

findutils (x86_64)

○

○

○

gdb (x86_64)

○

○

○

glibc (i686)

○

○

○※1

glibc (i686) 2.5-24以降

○※2

—

—

glibc (x86_64)

—

○

○

glibc (x86_64) 2.5-24以降

○※2

—

—

glibc-common (x86_64)

—

○

○

glibc-common (x86_64) 2.5-24以降

○※2

—

—

glibc-devel (i386) 2.5-24以降

○※2

—

—

glibc-devel (i686)

—

○

○※1

glibc-devel (x86_64)

—

○

○

glibc-devel (x86_64) 2.5-24以降

○※2

—

—

glibc-headers (x86_64)

—

○

○

glibc-headers (x86_64) 2.5-24以降

○※2

—

—

glibc-utils (x86_64)

—

○

○※1

glibc-utils (x86_64) 2.5-24以降

○※2

—

—

gzip (x86_64)

○

○

○

ksh (x86_64)

—

○

○※1

libgcc (i386)

○

—

—

libgcc (i686)

—

○

○※1

libstdc++ (i386)

○

—

—

libstdc++ (i686)

—

○

○※1

lksctp-tools (x86_64)

○

○

○※1

ncompress (x86_64)

○

○※3

○※1

ncurses (x86_64)

○

○

○

net-tools (x86_64)

○

○

○

nscd (x86_64)

—

○

○※1

nscd (x86_64) 2.5-24以降

○※2

—

—

nss-softokn-freebl (i686)

—

○

○※1

procps (x86_64)

○

○

○

rpm (x86_64)

○

○

○

sysstat (x86_64)

○

○

○

tar (x86_64)

○

○

○

tcsh (x86_64)

○

○

○※1

（凡例）

○：適用します。

—：該当しません。

注

AIXのパッケージについては、リリースノートを参照してください。

注※1

これらのパッケージについては、使用しているRed Hat Enterprise Linux Server 7のバージョンによってはデフォルトでインストールされない場合があります。

注※2

これらのパッケージについては、使用しているRed Hat Enterprise Linux 5のバージョンによってはインストールメディアに含まれていない場合があります。

注※3

Red Hat Enterprise Linux Server 6のバージョンが6.2の場合、ncompress (x86_64)のバージョンは4.2.4-54.el6_2.1以降です。

パッケージがインストールされているかどうかは、rpmコマンドを実行して確認します。コマンドの実行例と実行結果の例を次に示します。

（実行例）

#rpm -q --qf  '%{NAME}-%{ARCH}¥n'  ncompress

（実行結果の例）

ncompress-x86_64

この例では、64ビット版のncompressパッケージがインストールされていることを示します。

「package パッケージ名 is not installed」メッセージが表示された場合は、パッケージがインストールされていないので、パッケージ名に示すパッケージをインストールしてください。なお、インストール時には、関連するパッケージも必要に応じてインストールしてください。

日立PPインストーラー実行時の言語種別と、実行するターミナルの言語が一致しているかどうかを確認し、一致していない場合は一致させます。

製品の提供媒体を該当するドライブにセットします。

mountコマンドを実行して、該当する媒体のファイルシステムをマウントします。

AIXの場合

mount -r -v cdrfs デバイススペシャルファイル名
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

mount -r -o mode=0544 /dev/cdrom
該当する媒体のファイルシステムのマウントディレクトリー名

デバイススペシャルファイル名、および該当する媒体のファイルシステムのマウントディレクトリー名は、OS、ハードウェア、および環境によって異なります。

該当する媒体のセットアッププログラムを起動します。

AIXの場合

該当する媒体のファイルシステムのマウントディレクトリー名/AIX/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

該当する媒体のファイルシステムのマウントディレクトリー名/x64lin/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

重要

該当する媒体のディレクトリー名やファイル名は、マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し、表示されたファイル名をそのまま入力してください。

該当する媒体のセットアッププログラムによって、日立PPインストーラーと常駐プロセス自動起動プログラムがハードディスク上にインストールされ、日立PPインストーラーが自動的に起動されます。

日立PPインストーラーのメインメニューで、［I］キーを押します。

PPインストール画面で、インストールする製品（Hitachi Application Server）にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示されます。

製品を構成するプログラムを選択してインストールする場合、インストールしないプログラムにカーソルを移動させ、［スペース］キーを押します。

インストールが任意のプログラムの左側には、[@]が表示されます。［スペース］キーを押すと、[ ]に表示が変わり、インストール対象から外されます。

なお、インストールが必須のプログラムの左側には、@が表示されます。

インストールする製品の左側に<@>、およびプログラムの左側に[@]または@が表示されていることを確認して、［I］キーを押します。

画面の最下行に、Install PP? (y: install, n: cancel)==>が表示されます。

［y］＋キーまたは［Y］キーを押します。

画面の最下行に、Enter the installation path ==>インストール先のデフォルト値が表示されます。

［Ctrl］＋［n］キーまたは［Ctrl］＋［N］キーを押すと、インストールが中止されてPPインストール画面に戻ります。

インストール先のデフォルト値を確認し、必要に応じてインストール先を変更して、［Enter］キーを押します。

インストール先には半角英数字、-、_以外は指定できません。

インストール先ディレクトリーが存在しない場合、ディレクトリー作成を確認するメッセージが表示されます。

The specified path does not exist. Do you want to create the path?
Specified path: インストール先

インストール先を確認して、［y］＋キーまたは［Y］キーを押してください。

画面の最下行に、Enter a display name ==>表示名のデフォルト値が表示されます。

インストール先を再設定する場合は、［Ctrl］＋［B］キーを押します。

表示名のデフォルト値を確認し、必要に応じて表示名を変更して、［Enter］キーを押します。

表示名に指定できる文字の長さは、半角で40文字です。ただし、半角英数字、-、_以外は指定できません。

画面に、指定した表示名、およびインストール先でインストールを続行してよいかどうかを確認するメッセージが表示されます。

This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: 表示名
Specified path        : インストール先

表示名、およびインストール先を再設定する場合は、［n］＋キーまたは［N］キーを押すと、手順10に戻ります。

表示名、およびインストール先を確認して、［y］＋キーまたは［Y］キーを押します。

インストールが開始されます。

インストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverのインストールが完了します。

次の作業

インストール後の環境設定をする

関連項目

4.4.6　インストール後の環境設定をする

4.1　構築するアプリケーション実行環境について

4.4.3　Application Serverを複数インストールする

Application Serverを同じマシンの別のディレクトリーに複数インストールするには、製品の提供媒体から、-mオプションを指定して日立PPインストーラーを起動し、PPインストール画面でインストールするプログラムを選択します。

前提条件

管理者特権（スーパーユーザー）で実行する

前提としているOS（OSのパッチを含む）のインストールが完了している

同じエディションのApplication Serverが1つ以上インストールされている

想定ユーザー

システム構築者

操作手順

製品の提供媒体を該当するドライブにセットします。

mountコマンドを実行して、該当する媒体のファイルシステムをマウントします。

AIXの場合

mount -r -v cdrfs デバイススペシャルファイル名
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

mount -r -o mode=0544 /dev/cdrom
該当する媒体のファイルシステムのマウントディレクトリー名

デバイススペシャルファイル名、および該当する媒体のファイルシステムのマウントディレクトリー名は、OS、ハードウェア、および環境によって異なります。

該当する媒体のセットアッププログラムを起動します。

AIXの場合

該当する媒体のファイルシステムのマウントディレクトリー名/AIX/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

該当する媒体のファイルシステムのマウントディレクトリー名/x64lin/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

重要

該当する媒体のディレクトリー名やファイル名は、マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し、表示されたファイル名をそのまま入力してください。

該当する媒体のセットアッププログラムによって、日立PPインストーラーと常駐プロセス自動起動プログラムがハードディスク上にインストールされ、日立PPインストーラーが自動的に起動されます。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［I］キーを押します。

PPインストール画面で、インストールする製品（Hitachi Application Server）にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示されます。

製品を構成するプログラムを選択してインストールする場合、インストールしないプログラムにカーソルを移動させ、［スペース］キーを押します。

インストールが任意のプログラムの左側には、[@]が表示されます。［スペース］キーを押すと、[ ]に表示が変わり、インストール対象から外されます。

なお、インストールが必須のプログラムの左側には、@が表示されます。

インストールする製品の左側に<@>、およびプログラムの左側に[@]または@が表示されていることを確認して、［I］キーを押します。

画面の最下行に、Install PP? (y: install, n: cancel)==>が表示されます。

［y］＋キーまたは［Y］キーを押します。

画面の最下行に、Enter the installation path ==>インストール先のデフォルト値が表示されます。

［Ctrl］＋［n］キーまたは［Ctrl］＋［N］キーを押すと、インストールが中止されてPPインストール画面に戻ります。

インストール先のデフォルト値を確認し、必要に応じてインストール先を変更して、［Enter］キーを押します。

インストール先のデフォルト値には、手順5で確認したインストール先と異なる値を指定してください。

インストール先には半角英数字、-、_以外は指定できません。

インストール先ディレクトリーが存在しない場合、ディレクトリー作成を確認するメッセージが表示されます。

The specified path does not exist. Do you want to create the path?
Specified path: インストール先

インストール先を確認して、［y］＋キーまたは［Y］キーを押してください。

画面の最下行に、Enter a display name ==>表示名のデフォルト値が表示されます。

インストール先を再設定する場合は、［Ctrl］＋［B］キーを押します。

表示名のデフォルト値を確認し、必要に応じて表示名を変更して、［Enter］キーを押します。

表示名のデフォルト値には、手順5で確認した表示名と異なる値を指定してください。

表示名に指定できる文字の長さは、半角で40文字です。

画面に、指定した表示名、およびインストール先でインストールを続行してよいかどうかを確認するメッセージが表示されます。

This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: 表示名
Specified path        : インストール先

表示名、およびインストール先を再設定する場合は、［n］＋キーまたは［N］キーを押すと、手順10に戻ります。

表示名、およびインストール先を確認して、［y］＋キーまたは［Y］キーを押します。

インストールが開始されます。

インストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverのインストールが完了します。

次の作業

インストール後の環境設定をする

関連項目

4.4.6　インストール後の環境設定をする

4.1　構築するアプリケーション実行環境について

4.4.4　V9以前のアプリケーション実行環境が構築済みのマシンにApplication Serverを追加インストールする

V9以前のアプリケーション実行環境が構築済みのマシンに、Application Server を同じマシンの別のディレクトリーに追加インストールするには、製品の提供媒体から、-m オプションを指定して日立PP インストーラーを起動し、PPインストール画面でインストールするプログラムを選択します。

前提条件

管理者特権（スーパーユーザー）で実行する

前提としているOS（OSのパッチを含む）のインストールが完了している

V9以前のアプリケーション実行環境が構築されている

想定ユーザー

システム構築者

操作手順

製品の提供媒体を該当するドライブにセットします。

mountコマンドを実行して、該当する媒体のファイルシステムをマウントします。

AIXの場合

mount -r -v cdrfs デバイススペシャルファイル名
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

mount -r -o mode=0544 /dev/cdrom
該当する媒体のファイルシステムのマウントディレクトリー名

デバイススペシャルファイル名、および該当する媒体のファイルシステムのマウントディレクトリー名は、OS、ハードウェア、および環境によって異なります。

該当する媒体のセットアッププログラムを起動します。

AIXの場合

該当する媒体のファイルシステムのマウントディレクトリー名/AIX/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

該当する媒体のファイルシステムのマウントディレクトリー名/x64lin/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

重要

該当する媒体のディレクトリー名やファイル名は、マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し、表示されたファイル名をそのまま入力してください。

該当する媒体のセットアッププログラムによって、日立PPインストーラーと常駐プロセス自動起動プログラムがハードディスク上にインストールされ、日立PPインストーラーが自動的に起動されます。

日立PPインストーラーのメインメニューで、［I］キーを押します。

PPインストール画面で、インストールする製品（Hitachi Application Server）にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示されます。

製品を構成するプログラムを選択してインストールする場合、インストールしないプログラムにカーソルを移動させ、［スペース］キーを押します。

インストールが任意のプログラムの左側には、[@]が表示されます。［スペース］キーを押すと、[ ]に表示が変わり、インストール対象から外されます。

なお、インストールが必須のプログラムの左側には、@が表示されます。

インストールする製品の左側に<@>、およびプログラムの左側に[@]または@が表示されていることを確認して、［I］キーを押します。

画面の最下行に、Install PP? (y: install, n: cancel)==>が表示されます。

［y］＋キーまたは［Y］キーを押します。

画面の最下行に、Enter the installation path ==>インストール先のデフォルト値が表示されます。

［Ctrl］＋［n］キーまたは［Ctrl］＋［N］キーを押すと、インストールが中止されてPPインストール画面に戻ります。

インストール先のデフォルト値を確認し、必要に応じてインストール先を変更して、［Enter］キーを押します。

インストール先のデフォルト値には、V9以前のアプリケーション実行環境のインストール先の/opt/Cosminexusと異なる値を指定してください。

インストール先には半角英数字、-、_以外は指定できません。

インストール先ディレクトリーが存在しない場合、ディレクトリー作成を確認するメッセージが表示されます。

The specified path does not exist. Do you want to create the path?
Specified path: インストール先

インストール先を確認して、［y］＋キーまたは［Y］キーを押してください。

画面の最下行に、Enter a display name ==>表示名のデフォルト値が表示されます。

インストール先を再設定する場合は、［Ctrl］＋［B］キーを押します。

表示名のデフォルト値を確認し、必要に応じて表示名を変更して、［Enter］キーを押します。

表示名に指定できる文字の長さは、半角で40文字です。ただし、半角英数字、-、_以外は指定できません。

画面に、指定した表示名、およびインストール先でインストールを続行してよいかどうかを確認するメッセージが表示されます。

This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: 表示名
Specified path        : インストール先

表示名、およびインストール先を再設定する場合は、［n］＋キーまたは［N］キーを押すと、手順8に戻ります。

表示名、およびインストール先を確認して、［y］＋キーまたは［Y］キーを押します。

インストールが開始されます。

インストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverのインストールが完了します。

次の作業

インストール後の環境設定をする

関連項目

4.4.6　インストール後の環境設定をする

4.1　構築するアプリケーション実行環境について

4.4.5　Application Serverを上書きインストールする

Application Serverを同じマシンの同じディレクトリーに上書きインストールするには、製品の提供媒体から日立PPインストーラーを起動し、PPインストール画面でインストールするプログラムを選択します。

前提条件

管理者特権スーパーユーザー）で実行する

前提としているOS（OSのパッチを含む）のインストールが完了している

アップデートするApplication Serverと同じApplication Serverがインストールされている

アップデートするApplication Serverを使用したシステムが停止している

想定ユーザー

システム構築者

操作手順

インストール済みのApplication Server上に、稼働中のサーバやドメインがある場合は、次の手順で停止します。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、Application Serverを停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメインを停止します。

asadmin stop-domain ドメイン名

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

asadminユーティリティーコマンドのlist-domainsサブコマンドを実行して、ドメインの一覧を表示します。

asadmin list-domains

コマンドの実行結果を次に示します。停止したドメインのステータスがnot running になっていることを確認してください。

domain1 not running
ドメイン名 not running
Command list-domains executed successfully.

製品の提供媒体を該当するドライブにセットします。

mountコマンドを実行して、該当する媒体のファイルシステムをマウントします。

AIXの場合

mount -r -v cdrfs デバイススペシャルファイル名
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

mount -r -o mode=0544 /dev/cdrom
該当する媒体のファイルシステムのマウントディレクトリー名

デバイススペシャルファイル名、および該当する媒体のファイルシステムのマウントディレクトリー名は、OS、ハードウェア、および環境によって異なります。

該当する媒体のセットアッププログラムを起動します。

AIXの場合

該当する媒体のファイルシステムのマウントディレクトリー名/AIX/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

該当する媒体のファイルシステムのマウントディレクトリー名/x64lin/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

重要

該当する媒体のディレクトリー名やファイル名は、マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し、表示されたファイル名をそのまま入力してください。

該当する媒体のセットアッププログラムによって、日立PPインストーラーと常駐プロセス自動起動プログラムがハードディスク上にインストールされ、日立PPインストーラーが自動的に起動されます。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

上書きインストールする製品のインストール先を確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［I］キーを押します。

PPインストール画面で、上書きインストールする製品にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示されます。

製品を構成するプログラムを選択して上書きインストールする場合、インストールしないプログラムにカーソルを移動させ、［スペース］キーを押します。

インストールが任意のプログラムの左側には、[@]が表示されます。［スペース］キーを押すと、[ ]に表示が変わり、上書きインストール対象から外されます。

なお、インストールが必須のプログラムの左側には、@が表示されます。

上書きインストールする製品の左側に<@>、およびプログラムの左側に[@]または@が表示されていることを確認して、［I］キーを押します。

画面の最下行に、Install PP? (y: install, n: cancel)==>が表示されます。

［y］＋キーまたは［Y］キーを押します。

画面の最下行に、Enter the installation path ==>インストール先が表示されます。

［Ctrl］＋［n］キーまたは［Ctrl］＋［N］キーを押すと、インストールが中止されてPPインストール画面に戻ります。

インストール先を手順6で確認したインストール先に変更して、［Enter］キーを押します。

指定したインストール先に同一製品がインストール済みであるが、インストールを実行してよいかどうかを確認するメッセージが表示されます。

This program product is already installed.
Do you want to continue with the installation?
Installation path: インストール先

インストール先を再設定する場合は、［n］＋キーまたは［N］キーを押します。

［y］＋キーまたは［Y］キーを押します。

画面に、指定した表示名、およびインストール先でインストールを続行してよいかどうかを確認するメッセージが表示されます。

This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: 表示名
Specified path        : インストール先

インストール先を再設定する場合は、［n］＋キーまたは［N］キーを押すと、手順11に戻ります。

設定済みの表示名を確認し、［y］＋キーまたは［Y］キーを押します。

インストールが開始されます。

インストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverの上書きインストールが完了します。

関連項目

4.1　構築するアプリケーション実行環境について

4.4.6　インストール後の環境設定をする

Application Serverのインストール後に、システムが動作するように環境設定を行います。

前提条件

Application Serverがインストールされている

想定ユーザー

システム構築者

操作手順

設定ファイル（asenv.conf）にTZ環境変数を設定します。

設定ファイル（asenv.conf）は、Java EE Serverのインストールディレクトリー/glassfish/config/asenv.conf に格納されています。設定ファイル（asenv.conf）の定義例を次に示します。

TZ=JST-9

/etc/hostsファイルに、自ホスト名に対してネットワークインターフェースに割り当てられた適切なIPアドレスを設定して、自ホスト名からIPアドレスを解決できるように設定します。

4.5　ドメインとノードの作成と削除

コマンドを利用してドメインとノードを作成する手順について説明します。また、コマンドを利用して不要なドメインとノードを削除する手順についても説明します。なお、デフォルトのドメインとノードは、Application Serverのインストールが完了すると作成されます。

4.5.1　ドメインを作成する

ドメインを作成するには、asadminユーティリティーコマンドのcreate-domainサブコマンドを実行します。なお、デフォルトのドメインはdomain1です。

前提条件

Application Serverのインストールが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-domainサブコマンドを実行して、ドメインを作成します。

asadmin create-domain --adminport Adminのポート --instanceport HTTPのポート
--domainproperties domain.jmxPort=値:http.ssl.port=値:java.debugger.port=値:
jms.port=値:orb.listener.port=値:orb.mutualauth.port=値:orb.ssl.port=値:
osgi.shell.telnet.port=値 ドメイン名

重要

Admin のポートは、作成したドメインに対してasadminユーティリティーコマンドのサブコマンドを実行する際に、asadminユーティリティーオプションの--portオプションで指定する必要があります。

コマンド実行時に、管理ユーザーのユーザー名の入力要求（Enter admin user name [Enter to accept default ""admin"" / no password]）に対してユーザー名、管理ユーザーのパスワードの入力要求（Enter the admin password [Enter to accept default of no password]）に対してパスワードを設定します。なお、管理ユーザーのユーザー名のデフォルト値はadmin、パスワードのデフォルト値はありません。

コマンドの実行結果を次に示します。

Command create-domain executed successfully.

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメインを起動します。

asadmin start-domain ドメイン名

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのlist-domainsサブコマンドを実行して、ドメインの一覧を表示します。

asadmin list-domains

コマンドの実行結果を次に示します。手順2で起動したドメインのステータスがrunningになっていることを確認してください。

domain1 running
ドメイン名 running
Command list-domains executed successfully.

次の作業

ノードを作成する

関連項目

4.5.2　ノードを作成する

4.5.2　ノードを作成する

ノードを作成するには、asadminユーティリティーコマンドのcreate-node-configサブコマンドを実行します。なお、デフォルトのノードはlocalhost-domain1です。

前提条件

Application Serverのインストールが完了している

作成したドメイン管理サーバが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-node-configサブコマンドを実行して、ノードを作成します。

asadmin create-node-config
--nodehost ノードに対するホスト名
--installdir Application Serverのインストールディレクトリー/javaeeの絶対パス
--nodedir ノードの情報を格納するディレクトリーのパス ノード名

重要

デフォルトのドメイン以外にノードを作成する場合は、asadminユーティリティーオプションの--portオプションでAdminのポートを指定して、create-node-configサブコマンドを実行してください。

コマンドの実行結果を次に示します。

Command create-node-config executed successfully.

4.5.3　ノードを削除する

ノードを削除するには、asadminユーティリティーコマンドのdelete-node-configサブコマンドを実行します。

前提条件

Application Serverのインストールが完了している

作成したドメイン管理サーバが起動している

ノードに対するホストでApplication Serverの削除が完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-nodesサブコマンドを実行して、ノードの一覧を表示します。

asadmin list-nodes

重要

デフォルトのドメイン以外でノードの一覧を表示する場合は、asadminユーティリティーオプションの--portオプションでAdminのポートを指定して、list-nodesサブコマンドを実行してください。

コマンドの実行結果を次に示します。

ノード名  CONFIG  IPアドレスまたはホスト名
ノード名  CONFIG  IPアドレスまたはホスト名
Command list-nodes executed successfully.

asadminユーティリティーコマンドのdelete-node-configサブコマンドを実行して、ノードを削除します。

asadmin delete-node-config ノード名

重要

デフォルトのドメイン以外でノードを削除する場合は、asadminユーティリティーオプションの--portオプションでAdminのポートを指定して、delete-node-configサブコマンドを実行してください。

削除するノードのノードディレクトリー以下のファイルまたはディレクトリーをほかのプロセスが使用していると、ノードの削除に失敗する場合があります。稼働中のほかのプログラムでノードディレクトリー以下のファイルまたはディレクトリーを使用していないことを確認してから、ノードの削除を実行してください。

コマンドの実行結果を次に示します。

Command delete-node-config executed successfully.

4.5.4　ドメインを削除する

ドメインを削除するには、asadminユーティリティーコマンドのstop-domainサブコマンドを実行してドメインを停止し、delete-domainサブコマンドを実行します。

前提条件

Application Serverのインストールが完了している

作成したドメイン管理サーバが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメインを停止します。

asadmin stop-domain ドメイン名

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

asadminユーティリティーコマンドのlist-domainsサブコマンドを実行して、ドメインの一覧を表示します。

asadmin list-domains

コマンドの実行結果を次に示します。手順1で停止したドメインのステータスがnot runningになっていることを確認してください。

domain1 running
ドメイン名 not running
Command list-domains executed successfully.

asadminユーティリティーコマンドのdelete-domainサブコマンドを実行して、ドメインを削除します。

asadmin delete-domain ドメイン名

重要

削除するドメインのドメインディレクトリー以下のファイルまたはディレクトリーをほかのプロセスが使用していると、ドメインの削除に失敗する場合があります。稼働中のほかのプログラムでドメインディレクトリー以下のファイルまたはディレクトリーを使用していないことを確認してから、ドメインの削除を実行してください。

コマンドの実行結果を次に示します。

Command delete-domain executed successfully.

4.6　Application Serverのセットアップ

Application Serverをセットアップする手順について説明します。Application Serverをセットアップすると、ホスト上にパフォーマンストレーサー、Java EEサーバ、およびWebサーバが構築されます。また、コマンドを利用してApplication Serverを起動する手順についても説明します。

4.6.1　Application Serverのセットアップの流れ

Application Serverをセットアップするために実施する作業と、作業の流れについて説明します。Application Serverのセットアップでは、ホスト上にパフォーマンストレーサー、Java EEサーバ、およびWebサーバを構築し、各サーバのサーバ間関連を設定します。そのあと、Application Serverの設定を変更して、Application Serverを起動します。

関連項目

4.6.2　Application Serverをセットアップする

4.6.3　setサブコマンドを使用してApplication Serverの設定を変更する

4.6.4　サーバテンプレートを使用してWebサーバの設定を変更する

4.6.5　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

4.6.6　トラブルシュート資料を一括収集するための設定をする

4.6.7　ポート番号を変更する

4.6.8　Javaデバッガー用通信ポート番号を変更する

4.6.9　ポートをオープンする

4.6.10　IIOPリスナーのポートをオープンする

4.6.11　JMSホストのポートをオープンする

4.6.12　ポートをクローズする

4.6.13　IIOPリスナーのポートをクローズする

4.6.14　JMSホストのポートをクローズする

4.6.15　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

4.6.16　Application ServerにJDBCドライバーをインストールする

4.6.17　Application Serverを起動する

4.6.2　Application Serverをセットアップする

Application Serverをセットアップするには、asadminユーティリティーコマンドのcreate-prfサブコマンドでパフォーマンストレーサー、create-clusterサブコマンドとcreate-instanceサブコマンドでJava EEサーバ、およびcreate-webserverサブコマンドでWebサーバを構築します。そのあと、create-relationサブコマンドで各サーバのサーバ間関連を設定します。

前提条件

Application Serverのインストールが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのcreate-prfサブコマンドを実行して、パフォーマンストレーサーを構築します。

asadmin create-prf --node ノード名 パフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command create-prf executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。手順2で構築したパフォーマンストレーサー名が表示されていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

複数のJava EEサーバを配置するクラスター構成の場合、asadminユーティリティーコマンドのcreate-clusterサブコマンドを実行して、Java EEサーバをグループ化するクラスターを構築します。

asadmin create-cluster クラスター名

コマンドの実行結果を次に示します。

Command create-cluster executed successfully.

asadminユーティリティーコマンドのcreate-instanceサブコマンドを実行して、Java EEサーバ（サーバインスタンス）を構築します。

asadmin create-instance --node ノード名 --prf パフォーマンストレーサー名
--cluster クラスター名 サーバインスタンス名

パフォーマンストレーサー名には、手順2で構築したパフォーマンストレーサー名を指定します。

複数のJava EEサーバを配置するクラスター構成の場合、--clusterオプションには、手順4で構築したクラスター名を指定します。

--prfオプションを指定することで、サーバインスタンスとパフォーマンストレーサーの間に関連（関連タイプ：prf-relation）が作成されます。

コマンドの実行結果を次に示します。

Command create-instance executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、Java EEサーバの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。手順5で構築したサーバインスタンス名が表示されていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのcreate-webserverサブコマンドを実行して、Webサーバを構築します。

asadmin create-webserver --node ノード名
--prf パフォーマンストレーサー名 Webサーバ名

パフォーマンストレーサー名には、手順2で構築したパフォーマンストレーサー名を指定します。

--prfオプションを指定することで、Webサーバとパフォーマンストレーサーの間に関連（関連タイプ：prf-relation）が作成されます。

コマンドの実行結果を次に示します。

Command create-webserver executed successfully.

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。手順7で構築したWebサーバ名が表示されていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのcreate-relationサブコマンドを実行して、Webサーバが受信したリクエストのリダイレクト先となるJava EEサーバ（サーバインスタンス）を関連づけます。

asadmin create-relation --relationtype redirect
--from Webサーバ名 --to サーバインスタンス名
[--properties サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値
[:サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値]...]
サーバ間関連の関連名

Webサーバ名には、手順7で構築したWebサーバ名を指定します。

サーバインスタンス名には、手順5で構築したサーバインスタンス名を指定します。

リダイレクト関連の関連づけを設定する場合、静的コンテンツをWebサーバで処理し、静的コンテンツ以外のリクエストをJava EEサーバで処理するために、--propertiesオプションにpath、およびnetwork-listenerを指定します。

（例）

path=/apserver/:network-listener=http-listener-1

pathには、スラッシュ（/）から始まるURLのパスを指定します。スラッシュだけの指定（path=/）はしないでください。この例では、http://xxxxxxxxxxx/index.htmlのようにURLのパスの先頭にapserverを含まないリクエストは、Webサーバの静的コンテンツにアクセスされます。また、http://xxxxxxxxxxx/apserver/sample/index.jspのようにURLのパスの先頭にapserverを含むリクエストは、http://yyyyyyyyyyy/sample/index.jspというURLでJava EEサーバにリダイレクトされます。

network-listenerには、リダイレクト先のJava EEサーバのHTTPリスナー、またはHTTPSリスナーを示すネットワークリスナー名を指定します。Java EEサーバには、デフォルトでHTTPリスナーにhttp-listener-1、HTTPSリスナーにhttp-listener-2というネットワークリスナーが定義されています。

コマンドの実行結果を次に示します。

Command create-relation executed successfully.

asadminユーティリティーコマンドのlist-relationsサブコマンドを実行して、サーバ間関連の一覧を表示します。

asadmin list-relations

コマンドの実行結果を次に示します。次のサーバ間関連が表示されていることを確認してください。

サーバインスタンスとパフォーマンストレーサーとのパフォーマンストレーサー関連

Webサーバとパフォーマンストレーサーとのパフォーマンストレーサー関連

手順9で設定したWebサーバとサーバインスタンスとのリダイレクト関連

サーバ間関連の関連名 prf-relation サーバインスタンス名
パフォーマンストレーサー名
サーバ間関連の関連名 prf-relation Webサーバ名
パフォーマンストレーサー名
サーバ間関連の関連名 redirect Webサーバ名
サーバインスタンス名
Command list-relations executed successfully.

4.6.3　setサブコマンドを使用してApplication Serverの設定を変更する

Application Serverの設定を変更するには、asadminユーティリティーコマンドのsetサブコマンドを実行して、Application Serverの設定値を変更します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのgetサブコマンドを実行して、Application Serverの設定値を取得します。

asadmin get "*"

コマンドの実行結果から、変更対象の設定対象識別子と、変更前の設定値を確認してください。

複数のパラメーターに値が設定されている場合、設定値は次のように扱われます。

パフォーマンストレーサー関連のパラメーターの場合

「hitachi-prfs.hitachi-prf.パフォーマンストレーサー名.で始まるパラメーター」と「hitachi-prf-configs.hitachi-prf-config.パフォーマンストレーサーのコンフィグ名で始まるパラメーター」の両方に値が設定されているときは、「hitachi-prfs.hitachi-prf.パフォーマンストレーサー名.で始まるパラメーター」の値が有効になります。

Webサーバ関連のパラメーターの場合

「hitachi-webservers.hitachi-webserver.Webサーバ名で始まるパラメーター」と「hitachi-webserver-configs.hitachi-webserver-config.Webサーバのコンフィグ名で始まるパラメーター」の両方に値が設定されているときは、「hitachi-webservers.hitachi-webserver.Webサーバ名で始まるパラメーター」の値が有効になります。

サーバインスタンス関連のパラメーターの場合

「servers.server.Java EEサーバ名で始まるパラメーター」と「configs.config.Java EEサーバの構成名で始まるパラメーター」の両方に値が設定されているときは、「servers.server.Java EEサーバ名で始まるパラメーター」の値が有効になります。

asadminユーティリティーコマンドのsetサブコマンドを実行して、変更対象の設定対象識別子に対して変更後の設定値を指定します。

asadmin set 設定対象識別子=設定値

メモ

Webサーバの標準プロパティー以外（デイレクティブ）の設定値を変更する場合は、サーバテンプレートを使用してWebサーバの設定を変更してください。

コマンドの実行結果を次に示します。

Command set executed successfully.

asadminユーティリティーコマンドのgetサブコマンドを実行して、Application Serverの設定値を再度取得します。

asadmin get "*"

コマンドの実行結果から、変更対象の設定対象識別子に、手順2で指定した設定値が反映されていることを確認してください。

関連項目

4.6.4　サーバテンプレートを使用してWebサーバの設定を変更する

4.6.4　サーバテンプレートを使用してWebサーバの設定を変更する

Webサーバで標準プロパティー以外の設定値を変更するには、サーバテンプレートを使用します。サーバテンプレートには、Webサーバの運用に必要な設定を記述しています。Webサーバの設定を変更する場合は、拡張プロパティーを設定するか、またはディレクティブをサーバテンプレートに直接記述するかのどちらかを実施します。サーバテンプレートを編集する場合は、拡張プロパティーを設定する方法をお勧めします。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

サーバテンプレートの格納先とファイル名

サーバテンプレートは、初回のドメイン起動後に展開されます。

サーバテンプレートのファイル名を次に示します。

httpsd.conf@linux.vtl（Linuxの場合）

Webサーバの基本設定用サーバテンプレートです。リクエスト転送と負荷分散以外の基本設定を記述します。

httpsd.conf@aix.vtl（AIXの場合）

Webサーバの基本設定用サーバテンプレートです。リクエスト転送と負荷分散以外の基本設定を記述します。

reverse_proxy.conf@.vtl

Webサーバのリクエスト転送設定用サーバテンプレートです。リクエスト転送先サーバインスタンスがクラスター構成でない場合に、設定を記述します。

proxy_balancer.conf@.vtl

Webサーバの負荷分散設定用サーバテンプレートです。リクエスト転送先サーバインスタンスがクラスター構成の場合に、設定を記述します。

初回のドメイン起動時、サーバテンプレートの各ファイルは、Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/server_templates/webserver/confに展開されます。

サーバテンプレートの編集方法

サーバテンプレートは、次の方法で編集できます。

拡張プロパティーを設定するために、VTL構文を記述する

サーバテンプレートにVTL構文を記述し、asadminユーティリティーコマンドのsetサブコマンドの拡張プロパティーの値を操作することで、Webサーバを設定します。

ディレクティブを直接記述する

サーバテンプレートにディレクティブを直接記述することで、Webサーバを設定します。

拡張プロパティーを設定するために、VTL構文を記述すると、asadminユーティリティーコマンドのsetサブコマンドでWebサーバの設定を変更し、getサブコマンドで変更内容を確認できるようになります。

サーバテンプレートは、asadminユーティリティーコマンドのcreate-webserverサブコマンド、およびstart-webserverサブコマンド実行時にドメイン管理サーバによって読み込まれ、Webサーバが読み込む定義ファイルに設定が反映されます。

操作手順

拡張プロパティーを設定するために、VTL構文を記述する場合は、次の手順で設定します。

reverse_proxy.confにProxyPreserveHostディレクティブを設定する例で、手順を説明します。

テキストエディターなどを利用して、サーバテンプレートのファイル（reverse_proxy.conf@.vtl）を開いて、拡張プロパティーのVTL構文を記述します。

拡張プロパティーは、接頭辞にex_を付加した名称で設定します。

ProxyPreserveHostディレクティブの場合、拡張プロパティーはex_ProxyPreserveHost.valueで設定します。

ProxyPreserveHost ${property.ex_ProxyPreserveHost.value}

サーバテンプレートのファイルを保存します。

asadminユーティリティーコマンドのsetサブコマンドを実行して、Webサーバのコンフィグに対して、拡張プロパティー ex_ProxyPreserveHost.valueの値にOn を設定します。

asadmin set hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=On

コマンドの実行結果を次に示します。

hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=On
Command set executed successfully.

asadminユーティリティーコマンドのgetサブコマンドを実行して、拡張プロパティー ex_ProxyPreserveHost.valueの値が設定したとおりになっているかを確認します。

asadmin get hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost

コマンドの実行結果を次に示します。

hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=On
Command get executed successfully.

ディレクティブを直接記述する場合は、次の手順で直接記述します。

テキストエディターなどを利用して、サーバテンプレートのファイルを開いて、Web Serverのディレクティブを直接記述します。

ディレクティブをコメントとする場合は、先頭の#の直後に半角スペースを入れて記述します。

重要

サーバテンプレート上で、各種ログの出力先やファイル名を変更しないでください。システム情報収集機能での一括収集の対象外となります。ログの出力先はHJES_LOGSDIR環境変数で変更できます。ファイル名は変更できません。

サーバテンプレートのファイルを保存します。

Webサーバの初期設定値

各サーバテンプレートのファイルからWebサーバを構築した場合にドメイン管理サーバによって読み込まれる、Webサーバの各定義ファイルの初期設定値を次に示します。

httpsd.confの場合

Listen 80

StartServers 20
MinSpareServers 10
MaxSpareServers 20
MaxRequestWorkers 150
MaxConnectionsPerChild 10000
Timeout 30
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 3
HostnameLookups Off

User bin
Group bin

ServerRoot "Application Serverのインストールディレクトリー/httpsd"

ServerName www.example.com
DocumentRoot "Application Serverのインストールディレクトリー/javaee/glassfish/nodes/localhost-domain1/Web1/root/htdocs"
DirectoryIndex index.html
UseCanonicalName Off
ServerSignature Off
ServerTokens ProductOnly
TraceEnable Off

LogLevel warn
ErrorLog "|Application Serverのインストールディレクトリー/httpsd/sbin/rotatelogs Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/error 86400 -fnum 8 -diff 540"
HWSRequestLog "|Application Serverのインストールディレクトリー/httpsd/sbin/rotatelogs Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/hwsrequest 86400 -fnum 8 -diff 540"
LogFormat "%h %l %u %t ¥"%r¥" %>s %b ¥"%{Referer}i¥" ¥"%{User-Agent}i¥" %I %O" combinedio
LogFormat "%h %l %u %t ¥"%r¥" %>s %b ¥"%{Referer}i¥" ¥"%{User-Agent}i¥"" combined
LogFormat "%h %l %u %t ¥"%r¥" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent
LogFormat "%h %l %u %t ¥"%r¥" %>s %b %P %{hws_ap_root}n %I %O %X %D ¥"%{Referer}i¥" ¥"%{User-Agent}i¥"" hws_trace
LogFormat "%h %l %u %t ¥"%r¥" %>s %b %T %P %{hws_ap_root}n" hws_std
HWSLogTimeVerbose On
CustomLog "|Application Serverのインストールディレクトリー/httpsd/sbin/rotatelogs Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/access 86400 -fnum 8 -diff 540" hws_std
PidFile "Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/httpd.pid"
HWSTraceIdFile "Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/hws.trcid"
HWSTraceLogFile "Application Serverのインストールディレクトリー/javaee/logs/nodes/localhost-domain1/Web1/hws.trclog"

SSLDisable

TypesConfig "Application Serverのインストールディレクトリー/httpsd/conf/mime.types"
AddEncoding x-compress .Z
AddEncoding x-gzip .gz .tgz
AddLanguage ca .ca
AddLanguage cs .cz .cs
AddLanguage da .dk
AddLanguage de .de
AddLanguage el .el
AddLanguage en .en
AddLanguage eo .eo
AddLanguage es .es
AddLanguage et .et
AddLanguage fr .fr
AddLanguage he .he
AddLanguage hr .hr
AddLanguage it .it
AddLanguage ja .ja
AddLanguage ko .ko
AddLanguage ltz .ltz
AddLanguage nl .nl
AddLanguage nn .nn
AddLanguage no .no
AddLanguage pl .po
AddLanguage pt .pt
AddLanguage pt-BR .pt-br
AddLanguage ru .ru
AddLanguage sv .sv
AddLanguage tr .tr
AddLanguage zh-CN .zh-cn
AddLanguage zh-TW .zh-tw

BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4¥.0b2;" nokeepalive downgrade-1.0 force-response-1.0
BrowserMatch "RealPlayer 4¥.0" force-response-1.0
BrowserMatch "Java/1¥.0" force-response-1.0
BrowserMatch "JDK/1¥.0" force-response-1.0
BrowserMatch "Microsoft Data Access Internet Publishing Provider" redirect-carefully
BrowserMatch "MS FrontPage" redirect-carefully
BrowserMatch "^WebDrive" redirect-carefully
BrowserMatch "^WebDAVFS/1.[01234]" redirect-carefully
BrowserMatch "^gnome-vfs/1.0" redirect-carefully
BrowserMatch "^XML Spy" redirect-carefully
BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully
BrowserMatch " Konqueror/4" redirect-carefully

Alias /icons/ "Application Serverのインストールディレクトリー/httpsd/icons/"
IndexOptions FancyIndexing
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*
AddIcon /icons/binary.gif .bin .exe
AddIcon /icons/binhex.gif .hqx
AddIcon /icons/tar.gif .tar
AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
AddIcon /icons/a.gif .ps .ai .eps
AddIcon /icons/layout.gif .html .shtml .htm .pdf
AddIcon /icons/text.gif .txt
AddIcon /icons/c.gif .c
AddIcon /icons/p.gif .pl .py
AddIcon /icons/f.gif .for
AddIcon /icons/dvi.gif .dvi
AddIcon /icons/uuencoded.gif .uu
AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
AddIcon /icons/tex.gif .tex
AddIcon /icons/bomb.gif core
AddIcon /icons/back.gif ..
AddIcon /icons/hand.right.gif README
AddIcon /icons/folder.gif ^^DIRECTORY^^
AddIcon /icons/blank.gif ^^BLANKICON^^
DefaultIcon /icons/unknown.gif
ReadmeName README.html
HeaderName HEADER.html
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t

<Directory />
        Options None
        AllowOverride None
</Directory>

<Directory "Application Serverのインストールディレクトリー/httpsd/htdocs">
        Options None
        AllowOverride None
</Directory>

<FilesMatch "^¥.(ht|key)">
        Order allow,deny
        Deny from all
</FilesMatch>

Include "Application Serverのインストールディレクトリー/javaee/glassfish/nodes/localhost-domain1/Web1/root/conf/reverse_proxy.conf"

HWSGracefulStopLog On
HWSGracefulStopTimeout 0

HWSPrfId PRF1

reverse_proxy.confの場合

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
HWSSuppressModuleTrace mod_proxy.c hook
ProxyVia Off
ProxyTimeout 200
ProxyPass / http://ホスト名:28080/  connectiontimeout=2
ProxyPassReverse / http://ホスト名:28080/
HWSProxyPassReverseCookie /

proxy_balancer.confの場合

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule lbmethod_byrequests_module modules/mod_lbmethod_byrequests.so
LoadModule slotmem_shm_module modules/mod_slotmem_shm.so
HWSSuppressModuleTrace mod_proxy.c hook
HWSSuppressModuleTrace mod_proxy_balancer.c
ProxyVia Off
ProxyTimeout 200

4.6.5　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

JavaVMオプションは、サーバインスタンスと、ドメイン管理サーバに対して指定できます。すでに指定されているJavaVMオプションを変更するには、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドで削除してから、create-jvm-optionsサブコマンドで変更後のJavaVMオプションを指定します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、クラスター内のすべてのサーバインスタンスのオプションの一覧を表示します。

asadmin list-jvm-options --target サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

手順1で表示した一覧に変更するオプションがある場合は、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドを実行して、変更するオプションを削除します。

asadmin delete-jvm-options --target サーバインスタンス名またはクラスター名
[オプション名[=オプションの値][:オプション名[=オプションの値]]...]

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

オプションを複数指定する場合は、コロン（:）で区切って指定します。

重要

オプション入力時、記号に対するエスケープ処理が必要になります。

例えば、-XX:MaxMetaspaceSize=192mを指定する場合は、:に対して¥¥を付けてエスケープ処理し、-XX¥¥:MaxMetaspaceSize=192mと入力します。

コマンドの実行結果を次に示します。

Deleted n option(s)
Command delete-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドを実行して、すべてのサーバインスタンスに対して、オプションでJavaヒープなどのJavaメモリーの値を設定します。

asadmin create-jvm-options --target サーバインスタンス名またはクラスター名
[オプション名[=オプションの値][:オプション名[=オプションの値]]...]

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

オプションには、JavaVMのデフォルト値と、Java EE Serverの初期値とが異なるものがあります。サーバインスタンスでJavaVMのデフォルト値と初期値が異なるオプションを次に示します。

表4‒2　サーバインスタンスでJavaVMのデフォルト値と初期値が異なるオプション

オプション名

Java EE Serverの初期値

-XX:HitachiExplicitHeapMaxSize

-XX:HitachiExplicitHeapMaxSize=512m

-XX:SurvivorRatio

Linuxの場合

-XX:SurvivorRatio=8

-XX:[+|-]HitachiUseExplicitMemory

-XX:+HitachiUseExplicitMemory

-XX:MaxMetaspaceSize

-XX:MaxMetaspaceSize=256m

-XX:MetaspaceSize

-XX:MetaspaceSize=256m

-Xms

-Xms1536m

-Xmx

-Xmx1536m

重要

すでに指定されているオプションを変更する場合は、delete-jvm-optionsサブコマンドで変更するオプションを削除してください。削除しないまま、create-jvm-optionsサブコマンドでオプションを指定した場合は、警告が表示され、同じオプションが複数登録されます。警告が表示された場合は、list-jvm-optionsサブコマンドで指定されているオプションを確認し、不要なオプションを削除してください。

ドメイン管理サーバは1時間ごと、サーバインスタンスは24時間ごとにSystemGCを実行します。SystemGCの実行間隔は、sun.rmi.dgc.server.gcIntervalと、sun.rmi.dgc.client.gcIntervalで変更できます。これらのシステムプロパティーでFullGCの発生間隔を広げてもGC発生回数が削減されない場合、Javaヒープが不足していることがあります。この場合は、Javaヒープのチューニングを実施することで改善することがあります。

コマンドの実行結果を次に示します。

Created n option(s)
Command create-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、すべてのサーバインスタンスのオプションの一覧を表示します。

asadmin list-jvm-options --target サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

手順3で指定したオプションの値が変更されていることを確認してください。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、ドメイン管理サーバのオプションの一覧を表示します。

asadmin list-jvm-options

手順5で表示した一覧に変更するオプションがある場合は、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドを実行して、変更するオプションを削除します。

asadmin delete-jvm-options [オプション名[=オプションの値]
[:オプション名[=オプションの値]]...]

コマンドの実行結果を次に示します。

Deleted n option(s)
Command delete-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドを実行して、ドメイン管理サーバに対して、オプションでJavaヒープなどのJavaメモリーの値を設定します。

asadmin create-jvm-options [オプション名[=オプションの値]
[:オプション名[=オプションの値]]...]

オプション名[=オプションの値]には、オプションとして、-Xms1024m、-Xmx1024m などを設定します。

オプションには、JavaVMのデフォルト値と、Java EE Serverの初期値とが異なるものがあります。ドメイン管理サーバでJavaVMのデフォルト値と初期値が異なるオプションを次に示します。

表4‒3　ドメイン管理サーバでJavaVMのデフォルト値と初期値が異なるオプション

オプション名

Java EE Serverの初期値

-XX:MaxMetaspaceSize

-XX:MaxMetaspaceSize=192m

-XX:MetaspaceSize

-XX:MetaspaceSize=192m

-Xms

-Xms512m

-Xmx

-Xmx512m

重要

ドメイン管理サーバのJavaヒープサイズは、デプロイするアプリケーションのアーカイブのサイズに応じて調整してください。アプリケーションのアーカイブのサイズによっては、ドメイン管理サーバのJavaヒープサイズが枯渇し、メモリー不足となることがあります。

また、ドメイン管理サーバのJavaヒープサイズに不適切な値（極端に小さい値や大きい値など）を指定した場合、ドメイン管理サーバが起動しなくなり、ドメインの再構築が必要になることがあります。

このような事態を避けるために、ドメイン管理サーバのオプションを変更する場合は、あらかじめ、backup-domainコマンドを実行して、ドメインのバックアップを取得しておくことをお勧めします。

コマンドの実行結果を次に示します。

Created n option(s)
Command create-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、ドメイン管理サーバのオプションの一覧を表示します。

asadmin list-jvm-options

手順7で指定したオプションの値が変更されていることを確認してください。

サーバインスタンス、およびドメイン管理サーバに対して、Javaメモリー以外のオプションを指定する場合は、手順1から手順8までを繰り返します。

オプションには、JavaVMのデフォルト値と、Java EE Serverの初期値とが異なるものがあります。JavaVMのデフォルト値と初期値が異なるオプションを次に示します。

表4‒4　JavaVMのデフォルト値と初期値が異なるオプション

分類

オプション名

Java EE Serverの初期値

サーバインスタンスの場合

-XX:HitachiExplicitMemoryJavaLog

-XX:HitachiExplicitMemoryJavaLog:Java EE Serverのインストールディレクトリー/logs/nodes/ノード名/サーバインスタンス名/je_eheap_event

-XX:HitachiExplicitMemoryLogLevel

-XX:HitachiExplicitMemoryLogLevel:normal

-XX:HitachiJavaLog

-XX:HitachiJavaLog:Java EE Serverのインストールディレクトリー/logs/nodes/ノード名/サーバインスタンス名/je_javavm

-XX:[+|-]HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemoryCause

-XX:[+|-]HitachiOutOfMemorySize

-XX:+HitachiOutOfMemorySize

-XX:[+|-]HitachiTrueTypeInLocals

-XX:+HitachiTrueTypeInLocals

-XX:[+|-]UseCompressedOops

Linux（AMD64 & Intel EM64T）の場合：

-XX:+UseCompressedOops

-Xhras（指定なし）

-Xhras

ドメイン管理サーバの場合

-XX:HitachiJavaLog

-XX:HitachiJavaLog:Java EE Serverのインストールディレクトリー/logs/domains/ドメイン名/das_javavm

-XX:[+|-]HitachiOutOfMemoryCause

-XX:+HitachiOutOfMemoryCause

-XX:[+|-]HitachiOutOfMemorySize

-XX:+HitachiOutOfMemorySize

-XX:[+|-]HitachiTrueTypeInLocals

-XX:+HitachiTrueTypeInLocals

-XX:[+|-]UseCompressedOops

Linux（AMD64 & Intel EM64T）の場合：

-XX:+UseCompressedOops

-Xhras（指定なし）

-Xhras

4.6.6　トラブルシュート資料を一括収集するための設定をする

障害の原因究明に必要なトラブルシュート資料は、システム情報収集機能を使用して一括収集できます。システム情報収集機能を使用してトラブルシュート資料を一括収集するためには、トラブルシュート資料を収集するコマンドのスクリプトファイルを編集します。障害発生時には、このコマンドが自動で実行されて、トラブルシュート資料が収集されます。なお、ドメインのデフォルトの管理ユーザーおよびパスワードを変更していない場合は、編集する必要はありません。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

トラブルシュート資料を一括収集するコマンドのスクリプトファイルを編集します。

ドメインのデフォルトの管理ユーザーおよびパスワードを変更していない場合は、編集する必要はありません。

編集するスクリプトファイル

Java EE Serverのインストールディレクトリー/glassfish/config/manager/snapshot_event-hook

編集する内容

スクリプトファイルをテキストエディタで開いて、次の設定値を編集します。

ADMIN_HOST=ドメイン管理サーバのホスト名
USER_ID=ドメイン管理サーバのユーザー名
PWDFILE=パスワードファイルのパス※

注※ AS_ADMIN_PASSWORD=ドメイン管理サーバのパスワードを記述したパスワードファイルのファイルパスを指定してください。パスワードを設定していない場合は、PWDFILEの値に空文字を指定してください。

（例）パスワードを設定していない場合

PWDFILE=

関連項目

9.1　Application Serverが出力するトラブルシュート資料について

4.6.7　ポート番号を変更する

ポート番号を変更するには、asadminユーティリティーコマンドのsetサブコマンドで、ポート関連パラメーターに変更後のポート番号を設定します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

ポート番号の変更で指定するポート関連パラメーター

ポート番号を変更するときに、asadminユーティリティーコマンドのgetサブコマンド、およびsetサブコマンドで指定するポート関連パラメーターを次に示します。

configs.config.Java EEサーバのコンフィグ名.iiop-service.iiop-listener.ID.port

configs.config.Java EEサーバのコンフィグ名.network-config.network-listeners.network-listener.リスナー名.port

configs.config.Java EEサーバのコンフィグ名.admin-service.jmx-connector.system.port

configs.config.Java EEサーバのコンフィグ名.jms-service.jms-host.JMSホスト名.port

hitachi-webservers.hitachi-webserver.Webサーバ名.property.listen-port

hitachi-webservers.hitachi-webserver.Webサーバ名.property.listen-add-portn

hitachi-webservers.hitachi-webserver.Webサーバ名.property.server-name

hitachi-webserver-configs.hitachi-webserver-config.Webサーバのコンフィグ名.property.listen-port

hitachi-webserver-configs.hitachi-webserver-config.Webサーバのコンフィグ名.property.listen-add-portn

hitachi-webserver-configs.hitachi-webserver-config.Webサーバのコンフィグ名.property.server-name

操作手順

asadminユーティリティーコマンドのgetサブコマンドを実行して、ポート関連パラメーターの設定値を取得して、変更前のポート番号を確認します。

asadmin get ポート関連パラメーター名

コマンドの実行結果を次に示します。

Command get executed successfully.

asadminユーティリティーコマンドのsetサブコマンドを実行して、変更後のポート番号を設定します。

asadmin set ポート関連パラメーター名=変更後のポート番号

コマンドの実行結果を次に示します。

Command set executed successfully.

4.6.8　Javaデバッガー用通信ポート番号を変更する

Javaデバッガー用通信ポート番号を変更するには、asadminユーティリティーコマンドのdelete-system-propertyサブコマンドで変更前のポート番号を削除してから、create-system-propertiesサブコマンドで変更後のポート番号を設定します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-system-propertiesサブコマンドを実行して、Javaデバッガー用通信ポート番号のシステムプロパティー（JAVA_DEBUGGER_PORT）の設定値を取得して、変更前のポート番号を確認します。

asadmin list-system-properties サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。

JAVA_DEBUGGER_PORT=29009
    :
Command list-system-properties executed successfully.

メモ

システムプロパティー（JAVA_DEBUGGER_PORT）が設定されている場合には、手順2、および手順3を実行してください。設定されていない場合には、手順3を実行してください。

asadminユーティリティーコマンドのdelete-system-propertyサブコマンドを実行して、システムプロパティーJAVA_DEBUGGER_PORTを削除します。

asadmin delete-system-property --target サーバインスタンス名またはクラスター名 JAVA_DEBUGGER_PORT

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command delete-system-property executed successfully.

asadminユーティリティーコマンドのcreate-system-propertiesサブコマンドを実行して、システムプロパティーJAVA_DEBUGGER_PORTに変更後のポート番号を設定します。

asadmin create-system-properties --target サーバインスタンス名またはクラスター名 JAVA_DEBUGGER_PORT=変更後のポート番号

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command create-system-properties executed successfully.

4.6.9　ポートをオープンする

クローズしているポートをオープンするには、asadminユーティリティーコマンドのsetサブコマンドで、ポート関連パラメーターの設定を有効にします。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

ポートのオープンで指定するポート関連パラメーター

ポートをオープンするときに、asadminユーティリティーコマンドのgetサブコマンド、およびsetサブコマンドで指定するポート関連パラメーターを次に示します。

configs.config.Java EEサーバのコンフィグ名.network-config.network-listeners.network-listener.リスナー名.enabled

このパラメーターでは、configs.config.Java EEサーバのコンフィグ名.network-config.network-listeners.network-listener.リスナー名.portでポート番号を指定したポートをオープンします。

操作手順

asadminユーティリティーコマンドのgetサブコマンドを実行して、ポート関連パラメーターの設定値を取得して、ポートがクローズしていること（設定値がfalseであること）を確認します。

asadmin get ポート関連パラメーター名

コマンドの実行結果を次に示します。

Command get executed successfully.

asadminユーティリティーコマンドのsetサブコマンドを実行して、クローズしているポートをオープンします。

asadmin set ポート関連パラメーター名=true

ポート関連パラメーターの値にtrueを指定し、ポート関連パラメーターの設定を有効にすることで、ポートをオープンします。

コマンドの実行結果を次に示します。

Command set executed successfully.

4.6.10　IIOPリスナーのポートをオープンする

IIOPリスナーのポートをオープンするには、asadminユーティリティーコマンドのcreate-iiop-listenerサブコマンドでIIOPリスナーを作成します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

使用できるポート番号を確認済みである

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-iiop-listenerサブコマンドを実行して、IIOPリスナーを作成してポートをオープンします。

asadmin create-iiop-listener --listeneraddress 0.0.0.0 --iiopport ポート番号
--target サーバインスタンス名またはクラスター名 IIOPリスナー名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command create-iiop-listener executed successfully.

4.6.11　JMSホストのポートをオープンする

JMSホストのポートをオープンするには、asadminユーティリティーコマンドのcreate-jms-hostサブコマンドでJMSホストを作成します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

使用できるポート番号を確認済みである

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-jms-hostサブコマンドを実行して、JMSホストを作成してポートをオープンします。

asadmin create-jms-host --mqhost JMSサービスのホスト名 --mqport JMSサービスのポート番号
--mquser JMSサービスのユーザー名 --mqpassword JMSサービスのパスワード
--target サーバインスタンス名またはクラスター名 JMSホスト名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command create-jms-host executed successfully.

4.6.12　ポートをクローズする

オープンしているポートをクローズするには、asadminユーティリティーコマンドのsetサブコマンドで、ポート関連パラメーターの設定を無効にします。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

ポートのクローズで指定するポート関連パラメーター

ポートをクローズするときに、asadminユーティリティーコマンドのgetサブコマンド、およびsetサブコマンドで指定するポート関連パラメーターを次に示します。

configs.config.Java EEサーバのコンフィグ名.network-config.network-listeners.network-listener.リスナー名.enabled

このパラメーターでは、configs.config.Java EEサーバのコンフィグ名.network-config.network-listeners.network-listener.リスナー名.portでポート番号を指定したポートをクローズします。

操作手順

asadminユーティリティーコマンドのgetサブコマンドを実行して、ポート関連パラメーターの設定値を取得して、ポートがオープンしていること（設定値がtrueであること）を確認します。

asadmin get ポート関連パラメーター名

コマンドの実行結果を次に示します。

Command get executed successfully.

asadminユーティリティーコマンドのsetサブコマンドを実行して、オープンしているポートをクローズします。

asadmin set ポート関連パラメーター名=false

ポート関連パラメーターの値にfalseを指定して、ポート関連パラメーターの設定を無効にすることで、ポートをクローズします。

コマンドの実行結果を次に示します。

Command set executed successfully.

4.6.13　IIOPリスナーのポートをクローズする

IIOPリスナーのポートをクローズするには、asadminユーティリティーコマンドのdelete-iiop-listenerサブコマンドでIIOPリスナーを削除します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-iiop-listenersサブコマンドを実行して、ポートをクローズするIIOPリスナーを確認します。

asadmin list-iiop-listeners サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。

Command list-iiop-listeners executed successfully.

asadminユーティリティーコマンドのdelete-iiop-listenerサブコマンドを実行して、IIOPリスナーを削除してポートをクローズします。

asadmin delete-iiop-listener --target サーバインスタンス名またはクラスター名 IIOPリスナー名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command delete-iiop-listener executed successfully.

4.6.14　JMSホストのポートをクローズする

JMSホストのポートをクローズするには、asadminユーティリティーコマンドのdelete-jms-hostサブコマンドでJMSホストを削除します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-jms-hostsサブコマンドを実行して、ポートをクローズするJMSホストを確認します。

asadmin list-jms-hosts --target サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command list-jms-hosts executed successfully.

asadminユーティリティーコマンドのdelete-jms-hostサブコマンドを実行して、JMSホストを削除してポートをクローズします。

asadmin delete-jms-host --target サーバインスタンス名またはクラスター名 JMSホスト名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Command delete-jms-host executed successfully.

4.6.15　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

asadminユーティリティーコマンドのプロセスに適用する環境変数を変更するには、Java EE Serverの環境変数定義ファイル（asenv.conf）を編集します。asadminユーティリティーコマンドのプロセスに適用する環境変数には、JavaヒープなどのJavaメモリーの値や、asadminユーティリティーコマンドのログなどを設定します。例えば、デプロイしたアプリケーション数やアプリケーション中のファイル数が多く、Java EEサーバの起動時にメモリー不足になる場合は、asadminユーティリティーコマンドのプロセスに適用するJavaヒープ領域のサイズを変更します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

Java EE Serverの環境変数定義ファイル（asenv.conf）を編集して、asadminユーティリティーコマンドのプロセスに適用する環境変数を変更します。

複数のJava EEサーバを配置するクラスター構成の場合は、リモートホストおよびローカルホストのそれぞれに対して、環境変数を変更します。

Java EE Serverの環境変数定義ファイル

Application Serverのインストールディレクトリー/javaee/glassfish/config/asenv.conf

編集の例

例えば、Javaヒープ領域の最大サイズを変更する場合は、環境変数HJES_ASADMIN_JVM_OPTIONSに値を指定します。

HJES_ASADMIN_JVM_OPTIONS=-Xmx256m

4.6.16　Application ServerにJDBCドライバーをインストールする

Application ServerにJDBCドライバーをインストールするには、データベースのベンダーが提供するJDBCドライバーのJARファイルを、Application Serverにコピーします。JDBCドライバーを有効にするために、asadminユーティリティーコマンドのrestart-domainサブコマンドでドメイン管理サーバを再起動します。

前提条件

ドメイン管理サーバが起動している

想定ユーザー

システム構築者

操作手順

Application ServerにJDBCドライバーのJARファイルをコピーします。

JDBCドライバーのJARファイルは、データベースのベンダーから提供されているものを使用します。コピー先ディレクトリーは、Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/libです。

asadminユーティリティーコマンドのrestart-domainサブコマンドを実行して、ドメイン管理サーバを再起動します。

asadmin restart-domain

コマンドの実行結果を次に示します。

Command restart-domain executed successfully.

関連項目

4.7.2　データベースサーバへの接続を設定する

4.6.17　Application Serverを起動する

Application Serverを起動するには、asadminユーティリティーコマンドのstart-serversサブコマンドを実行します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

4.7　データベースサーバへの接続

Application Serverとデータベースサーバを接続する手順について説明します。データベースサーバと接続するためには、Application Serverにデータベースサーバと接続するための設定が必要です。

4.7.1　データベースサーバへの接続の流れ

Application Serverとデータベースサーバを接続するために実施する作業と、作業の流れについて説明します。Application Serverにデータベースサーバと接続するための設定をします。データベースサーバと接続できるかどうかを確認するために、接続テストを実施します。

関連項目

4.7.2　データベースサーバへの接続を設定する

4.7.3　データベースサーバへの接続テストをする

4.7.2　データベースサーバへの接続を設定する

データベースサーバへの接続を設定するには、asadminユーティリティーコマンドのcreate-jdbc-connection-poolサブコマンドでJDBCコネクションプールを作成し、create-jdbc-resourceサブコマンドでJDBCリソースを作成します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

データベースサーバ（DBMS）が起動している

Application ServerでJDBCドライバーのインストールが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-jdbc-connection-poolサブコマンドを実行して、JDBCコネクションプールを作成します。

asadmin create-jdbc-connection-pool コネクションプールの設定
接続先ベンダー固有の設定 コネクションプールID

コネクションプールの設定には、コネクションプールサイズや、コネクション障害検知機能の使用などをサブコマンドのオプションで設定します。

接続先ベンダー固有の設定には、データベースのベンダーが提供しているドライバー固有情報をサブコマンドのオプションで設定します。

コネクションプールIDには、JDBCコネクションプールを識別するための名称を設定します。

（例1）Oracleの場合

asadmin create-jdbc-connection-pool
--datasourceclassname oracle.jdbc.pool.OracleDataSource
--restype javax.sql.DataSource
--property user=ユーザー名:password=パスワード:
url="jdbc¥:oracle¥:thin¥:@IPアドレス¥:ポート番号¥:Oracle SID"
コネクションプールID

（例2）HiRDBの場合

asadmin create-jdbc-connection-pool
--datasourceclassname JP.co.Hitachi.soft.HiRDB.JDBC.PrdbDataSource
--restype javax.sql.DataSource
--property user=ユーザー名:password=パスワード:DBHostName=IPアドレス:
description=ポート番号 コネクションプールID

コマンドの実行結果を次に示します。

JDBC connection pool コネクションプールID created successfully.
Command create-jdbc-connection-pool executed successfully.

asadminユーティリティーコマンドのcreate-jdbc-resourceサブコマンドを実行して、クラスター内のすべてのサーバインスタンスに対してJDBCリソースを作成します。

asadmin create-jdbc-resource --connectionpoolid コネクションプールID
--target サーバインスタンス名またはクラスター名 JNDI名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

JNDI名には、データベースサーバ（DBMS）の接続を取得するための名称を指定します。

コマンドの実行結果を次に示します。

JDBC resource JNDI名 created successfully.
Command create-jdbc-resource executed successfully.

次の作業

データベースサーバへの接続テストをする

関連項目

4.7.3　データベースサーバへの接続テストをする

4.7.3　データベースサーバへの接続テストをする

データベースサーバへの接続テストをするには、asadminユーティリティーコマンドのping-connection-poolサブコマンドで、サーバインスタンスからデータベースサーバへ接続できていることを確認します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

データベースサーバ（DBMS）が起動している

データベースサーバへ接続するための設定が完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのping-connection-poolサブコマンドを実行して、サーバインスタンスからデータベースサーバに接続できるかどうかを確認します。

asadmin ping-connection-pool --target サーバインスタンス名
コネクションプールID

コマンドの実行結果を次に示します。

Command ping-connection-pool executed successfully.

4.8　アプリケーションのデプロイ

アプリケーションをデプロイする手順について説明します。アプリケーションから静的コンテンツを切り分けて、Webサーバに配置します。アプリケーション（動的コンテンツ）は、Java EEサーバ（サーバインスタンス）にデプロイします。デプロイすると、アプリケーションは開始されます。

4.8.1　アプリケーションのデプロイの流れ

アプリケーションをデプロイするために実施する作業と、作業の流れについて説明します。システムのパフォーマンスを向上させる場合は、アプリケーションから静的コンテンツを切り分けてWebサーバに配置します。アプリケーション（動的コンテンツ）は、Java EEサーバ（サーバインスタンス）にデプロイします。アプリケーションが開始しているかどうかを稼働状況で確認します。

関連項目

4.8.2　静的コンテンツをWebサーバに配置する

4.8.3　アプリケーションをデプロイする

4.8.4　アプリケーションの稼働状況を確認する

4.8.2　静的コンテンツをWebサーバに配置する

静的コンテンツをWebサーバに配置するには、Webサーバのドキュメントルートディレクトリーに格納します。Webサーバに静的コンテンツを配置し、ネットワークアクセスの回数や、やり取りするデータのサイズを減らすことで、パフォーマンスを向上できます。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

アプリケーション開発者からアプリケーションを入手済みである

想定ユーザー

システム構築者

操作手順

静的コンテンツをWebサーバのドキュメントルートディレクトリーに格納します。

Webサーバのドキュメントルートディレクトリーは、Application Serverのインストールディレクトリー/javaee/glassfish/nodes/ノード名/Webサーバ名/root/htdocsです。

次の作業

アプリケーションをデプロイする

関連項目

4.8.3　アプリケーションをデプロイする

4.8.3　アプリケーションをデプロイする

アプリケーションをデプロイするには、asadminユーティリティーコマンドのdeployサブコマンドを実行します。アプリケーションは、Java EEサーバ（サーバインスタンス）にデプロイすると開始されます。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

アプリケーション開発者からアプリケーションを入手済みである

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのdeployサブコマンドを実行して、アプリケーションをサーバインスタンスにデプロイします。

asadmin deploy --target サーバインスタンス名またはクラスター名
アプリケーションのファイルパス

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。

Application deployed with name アプリケーション名.
Command deploy executed successfully.

アプリケーションごとに、手順1を繰り返します。

注意事項

デプロイするアプリケーションの文字の範囲について

次の項目に設定する文字には、英数字、ハイフン（-）、アンダースコア（_）、ピリオド（.）だけが使用できます。また、これらの文字列の先頭には、英数字またはアンダースコア（_）だけが使用できます。

deployサブコマンドとredeployサブコマンドに指定する、--nameオプションのcomponent_name

deployサブコマンドとredeployサブコマンドに指定するアーカイブファイル名

DDのapplication-name要素またはmodule-name要素

クラスファイルなど、Java SE仕様に準拠するファイル以外の、アプリケーション内のすべてのファイル名およびディレクトリー名

デプロイするアプリケーションに含めるモジュールのファイルパスについて

デプロイするアプリケーションに含めるモジュール（WAR、RAR、EJB-JAR、アプリケーションクライアントJAR）のファイルパスは、次の置換規則に従って置換されるため、各モジュールのファイルパスが置換された結果がアプリケーション内で重複しないように、各モジュールのファイルパスを設定してください。

ファイルパスに含まれるディレクトリー区切り文字を”__”（アンダースコア2つ）に変換します。

末尾が”.war”、”.jar”、”.rar”であるファイルパスに対して次の処理をします。

末尾が”.war”の場合：「最初に現れる”.war”の手前までの文字列」と”_war”を結合

末尾が”.jar”の場合：「最初に現れる”.jar”の手前までの文字列」と”_jar”を結合

末尾が”.rar”の場合：「最初に現れる”.rar”の手前までの文字列」と”_rar”を結合

（例1）次のファイルパスは、置換された結果がすべて重複します。

ファイルパス1：EARのトップディレクトリー/war/war1_/sample-web.war

ファイルパス2：EARのトップディレクトリー/war/war1/_sample-web.war

ファイルパス3：EARのトップディレクトリー/war/war1___sample-web.war

置換された結果：war__war1___sample-web_war

（例2）次のファイルパスは、置換された結果がすべて重複します。

ファイルパス1：EARのトップディレクトリー/war/sample-web.war

ファイルパス2：EARのトップディレクトリー/war/sample-web.war.war

ファイルパス3：EARのトップディレクトリー/war/sample-web.war.web.war

置換された結果：war__sample-web_war

次の作業

アプリケーションの稼働状況を確認する

関連項目

4.8.4　アプリケーションの稼働状況を確認する

4.8.4　アプリケーションの稼働状況を確認する

アプリケーションの稼働状況を確認するには、asadminユーティリティーコマンドのlist-applicationsサブコマンドでアプリケーションの一覧を表示します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

アプリケーションのデプロイが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-applicationsサブコマンドに--longオプションを指定して実行し、サーバインスタンスにデプロイしたアプリケーションの一覧を表示します。

asadmin list-applications --long=true サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。デプロイしたすべてのアプリケーションのステータスがenabledになっていることを確認してください。

NAME                    TYPE        STATUS
アプリケーション名  <ear, web>     enabled
アプリケーション名  <web>          enabled
Command list-applications executed successfully.

4.9　システム設定情報の確認

システム設定情報を確認する手順について説明します。システム設定情報とは、Application Serverを構築したホストや、Application Server内の各サーバの構成、各サーバの設定値などのことです。これらの情報は、コマンドで出力するファイル、またはAdministration Consoleで表示するペインで確認できます。

4.9.1　システム設定情報の確認について

システム設定情報とは、Application Serverを構築したホストや、Application Server内の各サーバの構成、各サーバの設定値などのことです。システム設定情報の種類と確認方法、およびApplication Serverのセットアップ、データベースサーバへの接続、およびアプリケーションのデプロイを実施したあとのシステム構成について説明します。

システム設定情報の種類と確認方法

システム設定情報の種類には、次のものがあります。

サーバで設定しているシステムプロパティー、プロパティー、ファイルの定義項目などの名称とその設定値

サーバの構成情報と稼働状況

ドメイン管理サーバおよびサーバの構成情報と、名前、種別、ノードなどの基本情報

これらの情報は、コマンド、またはAdministration Consoleの画面を利用して確認できます。Web サーバの設定情報は、サーバテンプレートから確認します。コマンドの場合はファイルに出力することもできます。

アプリケーションのデプロイ後のシステム構成

Application Serverのインストール後、次の作業を実施したあとのシステム構成を示します。

Application Serverのセットアップ

データベースサーバへの接続

アプリケーションのデプロイ

4.9.2　コマンドを利用してシステム設定情報を確認する

コマンドを利用してシステム設定情報を確認するには、asadminユーティリティーコマンドのlist-から始まるサブコマンドやgetサブコマンドで一覧をファイルに出力します。ファイルの内容が、設定したとおりになっているかを確認します。すべての標準プロパティー、および拡張プロパティーの設定値は、getサブコマンドで参照できます。これらのプロパティー以外でテンプレートに設定した情報は、サーバテンプレートで確認してください。

前提条件

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのlist-instancesサブコマンドを実行して、ドメイン内のすべてのJava EEサーバと、その詳細情報（ホスト名、ポート番号などの情報）の一覧をファイルに出力します。

asadmin list-instances --long=true
>> 出力ファイルのファイルパス

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、ドメイン内のすべてのパフォーマンストレーサーと、その詳細情報（ホスト名、プロセスIDなどの情報）の一覧をファイルに出力します。

asadmin list-prfs --long=true
>> 出力ファイルのファイルパス

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、ドメイン内のすべてのWebサーバと、その詳細情報（ホスト名、プロセスIDなどの情報）の一覧をファイルに出力します。

asadmin list-webservers --long=true >> 出力ファイルのファイルパス

asadminユーティリティーコマンドのlist-clustersサブコマンドを実行して、ドメイン内のすべてのクラスターの一覧をファイルに出力します。

asadmin list-clusters >> 出力ファイルのファイルパス

asadminユーティリティーコマンドのlist-relationsサブコマンドを実行して、ドメイン内のすべてのサーバ間関連と、その詳細情報（関連の種類、関連元、関連先などの情報）の一覧をファイルに出力します。

asadmin list-relations --long=true >> 出力ファイルのファイルパス

asadminユーティリティーコマンドのlist-から始まるサブコマンドを実行して、設定されている情報の一覧をファイルに出力します。

（例）

list-jvm-optionsサブコマンド、list-system-propertiesサブコマンドを実行して、JavaVMオプションとシステムプロパティーの一覧をファイルに出力します。

asadmin list-jvm-options --target サーバインスタンス名またはクラスター名
>> 出力ファイルのファイルパス
asadmin list-jvm-options --target 構成名 >> 出力ファイルのファイルパス
asadmin list-system-properties サーバインスタンス名またはクラスター名
>> 出力ファイルのファイルパス
asadmin list-system-properties 構成名 >> 出力ファイルのファイルパス

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

asadminユーティリティーコマンドのgetサブコマンドを実行して、各サーバの設定内容をファイルに出力します。

asadmin get "*" >> 出力ファイルのファイルパス

手順1〜手順7で出力したファイルの内容が、設定したとおりのシステム設定情報になっているかを確認します。

メモ

すべての標準プロパティー、および拡張プロパティーの設定値は、getサブコマンドで参照できます。ただし、サーバテンプレートを使用して設定した、標準プロパティーおよび拡張プロパティー以外の情報は、サーバテンプレートから確認してください。

4.9.3　サーバテンプレートからWebサーバの設定情報を確認する

Webサーバの設定情報は、サーバテンプレートのファイルの内容から、設定したとおりになっているかを確認します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのgetサブコマンドを実行して、Webサーバのコンフィグ名を取得します。

asadmin get hitachi-webservers.hitachi-webserver.Webサーバ名.
hitachi-webserver-config-ref

手順1で取得したWebサーバのコンフィグ名を指定し、asadminユーティリティーコマンドのgetサブコマンドを実行して、サーバテンプレートのファイルパスを取得します。

asadmin get hitachi-webserver-configs.hitachi-webserver-config.
Webサーバのコンフィグ名.hitachi-manage-info.template-path

取得したファイルパスに含まれる${com.sun.aas.instanceRoot} は、Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名を示しています。

手順2で取得したファイルパスにあるサーバテンプレートを開いて次のファイルの内容と比較し、設定したとおりになっているかを確認します。

httpsd.conf

reverse_proxy.conf

proxy_balance.conf

これらのファイルは次のディレクトリーに格納されています。

Application Serverのインストールディレクトリー/javaee/glassfish/nodes/ノード名/Webサーバ名/root/conf/

4.9.4　Administration Consoleを利用してシステム設定情報を確認する

Administration Consoleを利用してシステム設定情報を確認するには、［構成管理］タブを使用します。画面の内容が、設定したとおりになっているかを確認します。

前提条件

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

Webブラウザーを起動し、次に示すURLに接続してAdministration Consoleを起動します。

http://ドメイン管理サーバのIPアドレス:ドメイン管理サーバのHTTPポート番号/admin/

メモ

ドメイン管理サーバのIPアドレスのデフォルト値は127.0.0.1、ドメイン管理サーバのHTTPポート番号のデフォルト値は8080です。どちらもデフォルトの場合は、スタートメニュー/スタート画面からAdministration Consoleを起動できます。

ただし、Windows Server 2012、Windows Server 2012 R2、またはWindows 8でビルトインAdministratorアカウントを使用している場合は、セキュリティ上の理由でModern UI版Internet Explorerを起動できないため、別のアカウントでサインインしてやり直すように促すエラーメッセージが表示されることがあります。その場合は、Internet Explorerの［ツール］メニューから［インターネットオプション］を選択し、［プログラム］タブの［リンクの開き方を選択］で［常にデスクトップ用Internet Explorerで開く］を選択して、Administration Consoleを再度起動してください。

［ユーザID］テキストボックスにユーザID、［パスワード］テキストボックスにパスワードを入力して、［ログイン］ボタンをクリックします。

メモ

ユーザIDのデフォルト値はadmin、パスワードのデフォルト値はありません。

Administration Consoleの［構成管理］タブを開きます。

Java EEサーバ、パフォーマンストレーサー、およびWebサーバの設定情報を確認する場合は、次の手順で実施します。

［構成管理］タブのナビゲーションペインのツリーから、［全サーバ］をクリックします。

［全サーバ］ペインの［名前］カラムで、サーバの名称のリンクをクリックします。

［基本情報］タブで、サーバのシステム設定情報が設定したとおりになっているかを確認します。

クラスターの設定情報を確認する場合は、次の手順で実施します。

［構成管理］タブのナビゲーションペインのツリーから、［全クラスタ］をクリックします。

［全クラスタ］ペインの［名前］カラムで、クラスター名のリンクをクリックします。

［基本情報］タブで、クラスターのシステム設定情報が設定したとおりになっているかを確認します。

サーバ間関連の設定情報を確認する場合は、次の手順で実施します。

［構成管理］タブのナビゲーションペインのツリーから［関連］をクリックします。

［関連］ペインで、サーバ間関連のシステム設定情報が設定したとおりになっているかを確認します。

4.10　リモートホストへのApplication Serverの構築

ドメイン管理サーバをApplication Serverと切り分けて、運用管理サーバマシンとして利用するための設定手順、およびクラスター構成のシステムを構築する手順について説明します。クラスター構成とは、複数のJava EEサーバをグループ化して管理するための構成のことです。Application Serverをクラスター構成にすると、リクエストが複数のApplication Serverへ振り分けられるようになり、システムの信頼性や可用性を確保できます。負荷分散には、ソフトウェアロードバランサー、またはハードウェアロードバランサーを利用します。

4.10.1　リモートホストへのアプリケーション実行環境の構築の流れ

運用管理サーバマシンおよびクラスター構成のシステムを構築するために実施する作業と、作業の流れについて説明します。クラスター構成とは、複数のJava EEサーバをグループ化して管理するための構成のことです。運用管理サーバマシンおよびクラスター構成のシステムを構築するには、リモートホストにApplication Serverをインストール、およびセットアップします。また、ローカルホストを運用管理サーバマシンとして利用するための設定をします。

関連項目

4.10.2　リモートホストにApplication Serverをインストールする

4.10.3　リモートホストに接続するための設定をする

4.10.4　リモートホストにApplication Serverをセットアップする

4.10.5　運用管理サーバマシンを利用するための設定をする

5.1　システム周辺環境の設定について

4.10.2　リモートホストにApplication Serverをインストールする

新たに用意したリモートホストにApplication Serverをインストールするには、製品の提供媒体から日立PPインストーラーを起動し、PPインストール画面でインストールするプログラムを選択します。インストール完了後、環境変数の設定をします。

前提条件

管理者特権（スーパーユーザー）で実行する

リモートホストが起動している

リモートホストで前提としているOS（OSのパッチを含む）のインストールが完了している

想定ユーザー

システム構築者

操作手順

次の表に示すパッケージがインストールされていることを確認します。

表4‒5　OSごとに適用するパッケージ

パッケージ名

Red Hat Enterprise Linux 5

Red Hat Enterprise Linux Server 6

Red Hat Enterprise Linux Server 7

compat-libstdc++-296 (i386)

○

—

—

compat-libstdc++-33 (i386)

○

—

—

compat-libstdc++-33 (i686)

—

○

—

compat-libstdc++-33 (x86_64)

○

○

—

coreutils (x86_64)

○

○

○

findutils (x86_64)

○

○

○

gdb (x86_64)

○

○

○

glibc (i686)

○

○

○※1

glibc (i686) 2.5-24以降

○※2

—

—

glibc (x86_64)

—

○

○

glibc (x86_64) 2.5-24以降

○※2

—

—

glibc-common (x86_64)

—

○

○

glibc-common (x86_64) 2.5-24以降

○※2

—

—

glibc-devel (i386) 2.5-24以降

○※2

—

—

glibc-devel (i686)

—

○

○※1

glibc-devel (x86_64)

—

○

○

glibc-devel (x86_64) 2.5-24以降

○※2

—

—

glibc-headers (x86_64)

—

○

○

glibc-headers (x86_64) 2.5-24以降

○※2

—

—

glibc-utils (x86_64)

—

○

○※1

glibc-utils (x86_64) 2.5-24以降

○※2

—

—

gzip (x86_64)

○

○

○

ksh (x86_64)

—

○

○※1

libgcc (i386)

○

—

—

libgcc (i686)

—

○

○※1

libstdc++ (i386)

○

—

—

libstdc++ (i686)

—

○

○※1

lksctp-tools (x86_64)

○

○

○※1

ncompress (x86_64)

○

○※3

○※1

ncurses (x86_64)

○

○

○

net-tools (x86_64)

○

○

○

nscd (x86_64)

—

○

○※1

nscd (x86_64) 2.5-24以降

○※2

—

—

nss-softokn-freebl (i686)

—

○

○※1

procps (x86_64)

○

○

○

rpm (x86_64)

○

○

○

sysstat (x86_64)

○

○

○

tar (x86_64)

○

○

○

tcsh (x86_64)

○

○

○※1

（凡例）

○：適用します。

—：該当しません。

注

AIXのパッケージについては、リリースノートを参照してください。

注※1

これらのパッケージについては、使用しているRed Hat Enterprise Linux Server 7のバージョンによってはデフォルトでインストールされない場合があります。

注※2

これらのパッケージについては、使用しているRed Hat Enterprise Linux 5のバージョンによってはインストールメディアに含まれていない場合があります。

注※3

Red Hat Enterprise Linux Server 6のバージョンが6.2の場合、ncompress (x86_64)のバージョンは4.2.4-54.el6_2.1以降です。

パッケージがインストールされているかどうかは、rpmコマンドを実行して確認します。コマンドの実行例と実行結果の例を次に示します。

（実行例）

#rpm -q --qf  '%{NAME}-%{ARCH}¥n'  ncompress

（実行結果の例）

ncompress-x86_64

この例では、64ビット版のncompressパッケージがインストールされていることを示します。

「package パッケージ名 is not installed」メッセージが表示された場合は、パッケージがインストールされていないので、パッケージ名に示すパッケージをインストールしてください。なお、インストール時には、関連するパッケージも必要に応じてインストールしてください。

日立PPインストーラー実行時の言語種別と、実行するターミナルの言語が一致しているかどうかを確認し、一致していない場合は一致させます。

製品の提供媒体を該当するドライブにセットします。

mountコマンドを実行して、該当する媒体のファイルシステムをマウントします。

AIXの場合

mount -r -v cdrfs デバイススペシャルファイル名
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

mount -r -o mode=0544 /dev/cdrom
該当する媒体のファイルシステムのマウントディレクトリー名

デバイススペシャルファイル名、および該当する媒体のファイルシステムのマウントディレクトリー名は、OS、ハードウェア、および環境によって異なります。

該当する媒体のセットアッププログラムを起動します。

AIXの場合

該当する媒体のファイルシステムのマウントディレクトリー名/AIX/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

Linuxの場合

該当する媒体のファイルシステムのマウントディレクトリー名/x64lin/setup -m
該当する媒体のファイルシステムのマウントディレクトリー名

重要

該当する媒体のディレクトリー名やファイル名は、マシン環境によって記述した内容と見え方が異なることがあります。lsコマンドで確認し、表示されたファイル名をそのまま入力してください。

該当する媒体のセットアッププログラムによって、日立PPインストーラーと常駐プロセス自動起動プログラムがハードディスク上にインストールされ、日立PPインストーラーが自動的に起動されます。

日立PPインストーラーのメインメニューで、［I］キーを押します。

PPインストール画面で、インストールする製品（Hitachi Application Server）にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示されます。

製品を構成するプログラムを選択してインストールする場合、インストールしないプログラムにカーソルを移動させ、［スペース］キーを押します。

インストールが任意のプログラムの左側には、[@]が表示されます。［スペース］キーを押すと、[ ]に表示が変わり、インストール対象から外されます。

なお、インストールが必須のプログラムの左側には、@が表示されます。

インストールする製品の左側に<@>、およびプログラムの左側に[@]または@が表示されていることを確認して、［I］キーを押します。

画面の最下行に、Install PP? (y: install, n: cancel)==>が表示されます。

［y］＋キーまたは［Y］キーを押します。

画面の最下行に、Enter the installation path ==>インストール先のデフォルト値が表示されます。

［Ctrl］＋［n］キーまたは［Ctrl］＋［N］キーを押すと、インストールが中止されてPPインストール画面に戻ります。

インストール先のデフォルト値を確認し、必要に応じてインストール先を変更して、［Enter］キーを押します。

インストール先には半角英数字、-、_以外は指定できません。

インストール先ディレクトリーが存在しない場合、ディレクトリー作成を確認するメッセージが表示されます。

The specified path does not exist. Do you want to create the path?
Specified path: インストール先

インストール先を確認して、［y］＋キーまたは［Y］キーを押してください。

画面の最下行に、Enter a display name ==>表示名のデフォルト値が表示されます。

インストール先を再設定する場合は、［Ctrl］＋［B］キーを押します。

表示名のデフォルト値を確認し、必要に応じて表示名を変更して、［Enter］キーを押します。

表示名に指定できる文字の長さは、半角で40文字です。ただし、半角英数字、-、_以外は指定できません。

画面に、指定した表示名、およびインストール先でインストールを続行してよいかどうかを確認するメッセージが表示されます。

This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: 表示名
Specified path        : インストール先

表示名、およびインストール先を再設定する場合は、［n］＋キーまたは［N］キーを押すと、手順10に戻ります。

表示名、およびインストール先を確認して、［y］＋キーまたは［Y］キーを押します。

インストールが開始されます。

インストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［L］キーを押します。

PP一覧表示画面にインストール済みの製品一覧が表示されます。

製品がインストールされていることを確認して、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverのインストールが完了します。

設定ファイル（asenv.conf）にTZ環境変数を設定します。

設定ファイル（asenv.conf）は、Java EEサーバのインストールディレクトリー/glassfish/config/asenv.conf に格納されています。設定ファイル（asenv.conf）の定義例を次に示します。

TZ=JST-9

/etc/hostsファイルに、自ホスト名に対してネットワークインターフェースに割り当てられた適切なIPアドレスを設定して、自ホスト名からIPアドレスを解決できるように設定します。

リクエストの振り分け先として必要なリモートホストごとに、手順1から手順19までを繰り返します。

次の作業

リモートホストに接続するための設定をする

関連項目

4.10.3　リモートホストに接続するための設定をする

4.10.3　リモートホストに接続するための設定をする

クラスター構成にするためには、ローカルホストとリモートホストがSSHで接続できるようにします。ローカルホストでは、asadminユーティリティーコマンドのsetup-sshサブコマンドでSSH接続をするための準備をします。

前提条件

ドメイン管理サーバが起動している

ローカルホストでApplication Serverのセットアップが完了している

リモートホストが起動している

リモートホストでApplication Serverのインストールが完了している

リモートホストとローカルホストがSSHで接続できる

想定ユーザー

システム構築者

操作手順

リモートホストで、ドメイン管理サーバ（ローカルホスト）のホスト名を名前解決できるようにhostsファイルを編集します。

ローカルホストで、パスワードファイルを作成します。

AS_ADMIN_SSHPASSWORD=リモートホストのパスワード

ローカルホストで、asadminユーティリティーコマンドのsetup-sshサブコマンドを実行して、暗号キー（SSLキー）を作成します。

asadmin --passwordfile パスワードファイルのパス setup-ssh --sshuser リモートホストのSSHユーザー名 リモートホスト名

コマンドの実行結果を次に示します。

Command setup-ssh executed successfully.

ローカルホストで、asadminユーティリティーコマンドのcreate-password-aliasサブコマンドを実行して、パスワードに対するエイリアスを設定します。

asadmin create-password-alias パスワードエイリアス名

パスワードが求められた場合は、リモートホストのパスワードを入力してください。

コマンドの実行結果を次に示します。

Command create-password-alias executed successfully.

ドメイン管理サーバを再起動します。

asadmin restart-domain

コマンドの実行結果を次に示します。

Command restart-domain executed successfully.

ローカルホストで、手順2で作成したパスワードファイルを編集します。

AS_ADMIN_SSHPASSWORD=${ALIAS=パスワードエイリアス名}

リクエストの振り分け先として必要なリモートホストごとに、手順1から手順6までを繰り返します。

次の作業

リモートホストにApplication Serverをセットアップする

関連項目

4.10.4　リモートホストにApplication Serverをセットアップする

4.10.4　リモートホストにApplication Serverをセットアップする

リモートホストにApplication Serverをセットアップするには、create-node-sshサブコマンドでリモートホストに対するノードを作成します。そのあと、create-prfサブコマンドでパフォーマンストレーサー、create-instanceサブコマンドでJava EEサーバ（サーバインスタンス）をリモートホストに構築します。ハードウェアロードバランサーを利用する場合は、create-webserverサブコマンドでリモートホストにWebサーバを構築します。ソフトウェアロードバランサーを利用する場合は、delete-webserverサブコマンドでローカルホストのWebサーバを削除します。これらのコマンドは、ドメイン管理サーバが起動しているローカルホストで実行します。

前提条件

ドメイン管理サーバが起動している

ローカルホストでApplication Serverのセットアップが完了している

リモートホストでApplication Serverのインストールが完了している

リモートホストとローカルホストがSSHで接続できる

想定ユーザー

システム構築者

操作手順

ローカルホストで、asadminユーティリティーコマンドのcreate-node-sshサブコマンドを実行して、リモートホストに対するノードを追加します。

asadmin --user ドメイン管理サーバのユーザー名
--passwordfile パスワードファイルのパス
create-node-ssh --nodehost リモートホストのホスト名
--installdir Application Serverのインストールディレクトリー/javaeeの絶対パス
--sshuser リモートホストのSSHユーザー名
--sshkeyfile ~/.ssh/id_rsa リモートホストのノード名

コマンドの実行結果を次に示します。

Command create-node-ssh executed successfully.

ローカルホストで、asadminユーティリティーコマンドのcreate-prfサブコマンドを実行して、リモートホストにパフォーマンストレーサーを構築します。

asadmin create-prf --node リモートホストのノード名
リモートホストのパフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command create-prf executed successfully.

ローカルホストで、asadminユーティリティーコマンドのcreate-instanceサブコマンドを実行して、リモートホストにJava EEサーバ（サーバインスタンス）を構築します。

asadmin create-instance --node リモートホストのノード名
--prf リモートホストのパフォーマンストレーサー名
--cluster クラスター名 リモートホストのサーバインスタンス名

クラスター名には、ローカルホストでApplication Serverをセットアップした際に構築したクラスターを指定します。

コマンドの実行結果を次に示します。

Command create-instance executed successfully.

ハードウェアロードバランサーを利用する場合は、リモートホストにWebサーバを構築します。

ローカルホストで、asadminユーティリティーコマンドのcreate-webserverサブコマンドを実行して、リモートホストにWebサーバを構築します。

asadmin create-webserver --node リモートホストのノード名
--prf パフォーマンストレーサー名 リモートホストのWebサーバ名

コマンドの実行結果を次に示します。

Command create-webserver executed successfully.

ローカルホストのWebサーバに拡張プロパティーを設定している場合は、ローカルホストで、asadminユーティリティーコマンドのsetサブコマンドを実行して、リモートホストに作成するWebサーバに拡張プロパティーを設定します。

メモ

前の手順で実行したcreate-webserverサブコマンドでは、リモートホストに作成するWebサーバに、ローカルホストのサーバテンプレートの設定は適用されますが、拡張プロパティーの設定は適用されません。

asadmin set hitachi-webservers.hitachi-webserver.
リモートホストのWebサーバ名.property.拡張プロパティー名=値

コマンドの実行結果を次に示します。

hitachi-webservers.hitachi-webserver.リモートホストのWebサーバ名.property.
拡張プロパティー名=値
Command set executed successfully.

ローカルホストで、asadminユーティリティーコマンドのcreate-relationサブコマンドを実行して、Webサーバが受信したリクエストのリダイレクト先となるJava EEサーバ（サーバインスタンス）を関連づけます。

asadmin create-relation --relationtype redirect
--from リモートホストのWebサーバ名
--to リモートホストのサーバインスタンス名
--properties サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値
リモートホストのサーバ間関連の関連名

リダイレクト関連の関連づけを設定する場合、サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値には、pathとnetwork-listenerを指定します。

（例）

path=/:network-listener=http-listener-1

コマンドの実行結果を次に示します。

Command create-relation executed successfully.

ローカルホストで静的コンテンツをWebサーバに配置しているときは、リモートホストのWebサーバのドキュメントルートディレクトリーに静的コンテンツを格納します。

リモートホストのWebサーバのドキュメントルートディレクトリーは、リモートホストのApplication Serverのインストールディレクトリー/javaee/glassfish/nodes/リモートホストのノード名/リモートホストのWebサーバ名/root/htdocsです。

リクエストの振り分け先として必要なリモートホストごとに、手順1から手順4までを繰り返します。

Web Serverをソフトウェアロードバランサーとして利用する場合は、ローカルホストのWebサーバを削除します。

ローカルホストで、asadminユーティリティーコマンドのstop-webserverサブコマンドを実行して、ローカルホストのWebサーバを計画停止します。

asadmin stop-webserver --graceful true ローカルホストのWebサーバ名

コマンドの実行結果を次に示します。

Command stop-webserver executed successfully.

ローカルホストで、asadminユーティリティーコマンドのdelete-relationサブコマンドを実行して、不要なリダイレクト関連の関連づけを削除します。

asadmin delete-relation ローカルホストのサーバ間関連の関連名

リクエストの受信先のWebサーバがソフトウェアロードバランサーとなるため、ローカルホストに構築したWebサーバは不要になります。ローカルホストのサーバ間関連の関連名には、ローカルホストのApplication Serverをセットアップした際に作成したサーバ間関連を指定します。

コマンドの実行結果を次に示します。

Command delete-relation executed successfully.

ローカルホストで、asadminユーティリティーコマンドのdelete-webserverサブコマンドを実行して、不要なWebサーバを削除します。

asadmin delete-webserver ローカルホストのWebサーバ名

ローカルホストのWebサーバ名には、ローカルホストのApplication Serverをセットアップした際に構築したWebサーバ名を指定します。

コマンドの実行結果を次に示します。

Command delete-webserver executed successfully.

次の作業

運用管理サーバマシンを利用するための設定をする

関連項目

4.10.5　運用管理サーバマシンを利用するための設定をする

4.10.5　運用管理サーバマシンを利用するための設定をする

運用管理サーバマシンは、ドメイン管理サーバだけが動作するマシンです。運用管理サーバマシンを利用するためには、ローカルホストからApplication Serverの各サーバを削除して、ドメイン管理サーバだけが動作するマシンに変更します。Application Serverの各サーバは、asadminユーティリティーコマンドのdelete-instanceサブコマンド、delete-webserverサブコマンド、およびdelete-prfサブコマンドで削除します。

前提条件

ドメイン管理サーバが起動している

リモートホストとローカルホストでApplication Serverのセットアップが完了している

リモートホストとローカルホストがSSHで接続できる

想定ユーザー

システム構築者

操作手順

ローカルホストで、asadminユーティリティーコマンドのstop-instanceサブコマンドを実行して、ローカルホストのJava EEサーバ（サーバインスタンス）を停止します。

asadmin stop-instance ローカルホストのサーバインスタンス名

コマンドの実行結果を次に示します。

Command stop-instance executed successfully.

ローカルホストで、asadminユーティリティーコマンドのstop-prfサブコマンドを実行して、ローカルホストのパフォーマンストレーサーを停止します。

asadmin stop-prf ローカルホストのパフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command stop-prf executed successfully.

ハードウェアロードバランサーを利用する場合は、ローカルホストで、asadminユーティリティーコマンドのdelete-relationサブコマンドを実行して、ローカルホストのApplication Serverで設定している関連づけを削除します。

asadmin delete-relation ローカルホストのサーバ間関連の関連名

コマンドの実行結果を次に示します。

Command delete-relation executed successfully.

ローカルホストで、asadminユーティリティーコマンドのdelete-instanceサブコマンドを実行して、ローカルホストのJava EEサーバ（サーバインスタンス）を削除します。

asadmin delete-instance ローカルホストのサーバインスタンス名

コマンドの実行結果を次に示します。

Command delete-instance executed successfully.

ハードウェアロードバランサーを利用する場合は、ローカルホストのWebサーバを削除します。

ローカルホストで、asadminユーティリティーコマンドのstop-webserverサブコマンドを実行して、ローカルホストのWebサーバを計画停止します。

asadmin stop-webserver --graceful true ローカルホストのWebサーバ名

コマンドの実行結果を次に示します。

Command stop-webserver executed successfully.

ローカルホストで、asadminユーティリティーコマンドのdelete-webserverサブコマンドを実行して、ローカルホストのWebサーバを削除します。

asadmin delete-webserver ローカルホストのWebサーバ名

コマンドの実行結果を次に示します。

Command delete-webserver executed successfully.

ローカルホストで、asadminユーティリティーコマンドのdelete-prfサブコマンドを実行して、ローカルホストのパフォーマンストレーサーを削除します。

asadmin delete-prf ローカルホストのパフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command delete-prf executed successfully.

構成例を次に示します。

4.11　Application Serverの削除とApplication Serverのアンインストール

Application Serverの削除手順、およびApplication Serverのアンインストール手順について説明します。

4.11.1　Application Serverを削除する

Application Serverを削除するには、各サーバを停止してから、asadminユーティリティーコマンドのdelete-relationサブコマンド、delete-instanceサブコマンド、delete-webserverサブコマンド、およびdelete-prfサブコマンドを実行します。各コマンドでは、サーバ間関連、Java EEサーバ、Webサーバ、およびパフォーマンストレーサーを削除します。削除前に、必要に応じて、環境情報のバックアップファイルを取得します。

前提条件

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

必要に応じて、次の手順で環境情報のバックアップを取得します。

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメイン管理サーバを停止します。

asadmin stop-domain

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

asadminユーティリティーコマンドのbackup-domainサブコマンドを実行して、環境情報のバックアップを取得します。

asadmin backup-domain --backupdir バックアップファイルの保存先のディレクトリー
ドメイン名

出力されたバックアップファイルを確認してください。

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

ドメインディレクトリー以外で管理しているファイル（サーバテンプレートなど）をバックアップします。

asadminユーティリティーコマンドのdelete-relationサブコマンドを実行して、サーバ間関連を削除します。

asadmin delete-relation サーバ間関連の関連名

コマンドの実行結果を次に示します。

Command delete-relation executed successfully.

asadminユーティリティーコマンドのdelete-instanceサブコマンドを実行して、Java EEサーバ（サーバインスタンス）を削除します。

asadmin delete-instance サーバインスタンス名

コマンドの実行結果を次に示します。

Command delete-instance executed successfully.

asadminユーティリティーコマンドのdelete-webserverサブコマンドを実行して、Webサーバを削除します。

asadmin delete-webserver Webサーバ名

コマンドの実行結果を次に示します。

Command delete-webserver executed successfully.

asadminユーティリティーコマンドのdelete-prfサブコマンドを実行して、パフォーマンストレーサーを削除します。

asadmin delete-prf パフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command delete-prf executed successfully.

asadminユーティリティーコマンドのdelete-node-sshサブコマンドを実行して、ノードを削除します。

asadmin delete-node-ssh ノード名

コマンドの実行結果を次に示します。

Command delete-node-ssh executed successfully.

4.11.2　Application Serverをアンインストールする

Application Serverをアンインストールするには、日立PPインストーラーを起動し、PPインストール画面でアンインストールするプログラムを選択します。

前提条件

管理者特権（スーパーユーザー）で実行する

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメインを停止します。

asadmin stop-domain ドメイン名

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

必要に応じて、asadminユーティリティーコマンドのbackup-domainサブコマンドを実行して、環境情報のバックアップを取得します。

asadmin backup-domain --backupdir バックアップファイルの保存先のディレクトリー
ドメイン名

出力されたバックアップファイルを確認してください。

ドメインディレクトリー以外で管理しているファイル（サーバテンプレートなど）をバックアップします。

次のコマンドを実行して、日立PPインストーラーを起動します。

AIXの場合

/etc/hitachi_setup

Linuxの場合

/etc/hitachi_x64setup

日立PPインストーラーのメインメニューで、［D］キーを押します。

製品（Application Server）を選択してアンインストールする場合は、PP削除画面で、アンインストールする製品にカーソルを移動させ、［スペース］キーを押します。

製品名の左側には、選択状態を示す<@>が表示され、製品を構成するプログラム名の左側には、選択状態を示す[@]または@が表示されます。

同じ製品が複数インストールされている場合は、アンインストールする製品の表示名（DisplayName）を確認してください。

製品を構成するプログラムを選択してアンインストールする場合は、PP削除画面で、アンインストールするプログラムにカーソルを移動させ、［スペース］キーを押します。

アンインストールできるプログラムの左側には、[ ]が表示されます。［スペース］キーを押すと、[@]に表示が変わり、アンインストール対象となります。

アンインストールする製品の左側に<@>、プログラムの左側に[@]が表示されていることを確認して、［D］キーを押します。

画面の最下行に「Delete PP? (y: delete, n: cancel)==>」メッセージが表示されます。

［y］＋キーまたは［Y］キーを押します。

アンインストールが開始されます。

［n］＋キーまたは［N］キーを押すと、アンインストールが中止されます。

アンインストール終了を示すメッセージが出力されたら、［Q］キーを押します。

日立PPインストーラーのメインメニューで、［Q］キーを押します。

日立PPインストーラーが終了し、Application Serverのアンインストールが完了します。

5　システム周辺環境の設定

システム周辺環境で必要に応じて設定する項目について説明します。設定する項目は、ネットワーク、負荷分散、および運用の自動化です。

5.1　システム周辺環境の設定について

システム周辺環境で設定が必要な項目は、ネットワーク、負荷分散、および運用の自動化です。ネットワーク設定時の注意事項、負荷分散の種類（ハードウェアロードバランサー、ソフトウェアロードバランサー）ごとの設定内容、およびJP1/AJS3を使用した運用の自動化（ジョブ化）について説明します。

ネットワーク設定時の注意事項

重要

Application Serverとデータベースとの間でファイアーウォールの無通信監視機能が有効になっている場合、通信速度が低下するおそれがあるため、無通信監視機能を無効にしてください。

無通信監視機能が有効になっている場合、コネクションプールに確保されているコネクションを使用するときより通信速度が低下することがあります。コネクションプールに確保されているデータベースとのコネクションが無通信監視機能によって切断され、データベースへの操作をするたびに接続が必要となるためです。

負荷分散の設定

ハードウェアロードバランサーを使用する場合

ハードウェアロードバランサー上で、Application Serverへのリクエスト振り分け、およびセッション維持を設定します。設定の方法については、使用しているハードウェアロードバランサーのマニュアルを参照してください。

ドメイン管理サーバと実行環境を別のホストに配置する構成の場合

構築したリモートホストのApplication Serverだけにリクエスト振り分けを設定します。ドメイン管理サーバのホストに対するリクエスト振り分けは設定しません。

ドメイン管理サーバと実行環境を同じホストに配置する構成の場合

ドメイン管理サーバのホストに対するリクエスト振り分けを設定します。

ソフトウェアロードバランサーを使用する場合

リモートホストのノード上にWebサーバを構築して、ローカルホストと、リモートホストのクラスターとのサーバ間関連を作成することで負荷分散を設定します。

JP1/AJS3を使用した運用の自動化の設定

Application Serverの起動、停止、稼働状況の確認、稼働情報の収集、および障害情報の収集をジョブとして定義し、JP1/AJS3に登録します。稼働状況の確認、稼働情報の収集、および障害情報の収集については、バッチプログラムの作成も必要です。

関連項目

5.2　ソフトウェアロードバランサーを設定する

5.3　JP1/AJS3を使用した運用の自動化を設定する

5.2　ソフトウェアロードバランサーを設定する

リクエストの負荷分散をするために、Web Serverをソフトウェアロードバランサーとして使用する場合に必要な設定をします。リモートホストにノードを作成して（create-node-ssh）、ノード上にWebサーバを構築します（create-webserver）。リモートホストの準備が完了したら、ローカルホストと、リモートホストに構築した関連先のクラスターとのサーバ間関連を作成します（create-relation）。

前提条件

ドメイン管理サーバが起動している

ソフトウェアロードバランサー用のリモートホストにApplication Serverがインストールされている

ソフトウェアロードバランサー用のリモートホストに接続するための設定が完了している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのcreate-node-sshサブコマンドを実行して、リモートホストにノードを作成します。

asadmin --user ドメイン管理ユーザー --passwordfile パスワードファイルのパス
create-node-ssh --nodehost リモートホストのIPアドレス
--sshuser リモートホストのアカウント名 --sshkeyfile ~/.ssh/id_rsa
--installdir Application Serverのインストールディレクトリー/javaeeの絶対パス 作成するノード名

コマンドの実行結果を次に示します。

Command create-node-ssh executed successfully.

asadminユーティリティーコマンドのcreate-webserverサブコマンドを実行して、リモートホストに作成したノードにWebサーバを構築します。

asadmin create-webserver --node 作成したノード名 構築するWebサーバ名

コマンドの実行結果を次に示します。

Command create-webserver executed successfully.

asadminユーティリティーコマンドのcreate-relationサブコマンドを実行して、サーバ間関連を作成します。

asadmin create-relation --relationtype redirect
--from 構築したWebサーバ名
--to 構築済みの関連先のクラスター名
--properties path=/:network-listener=http-listener-1
作成するサーバ間関連の関連名

コマンドの実行結果を次に示します。

Command create-relation executed successfully.

性能を考慮して静的コンテンツをWebサーバに配置する場合は、Webサーバのドキュメントルートディレクトリーに静的コンテンツを格納します。

Webサーバのドキュメントルートディレクトリーは、Application Serverのインストールディレクトリー/javaee/glassfish/nodes/ノード名/Webサーバ名/root/htdocsです。

複数のリクエストを送信して、Application Serverに正しく振り分けられているかをWebサーバのリクエストログの転送先IPアドレスとポート番号で確認します。

次のファイルを参照してください。ファイル名のxには可変値が付与されます。

Application Serverのインストールディレクトリー/javaee/logs/nodes/ノード名/Webサーバ名/hwsrequest.x

Webサーバのリクエストログの出力例を次に示します。

[時刻] (サーバスレッドID) proxy : 転送先IPアドレス:ポート番号 : req send(メッセージテキスト)(メッセージテキスト)

5.3　JP1/AJS3を使用した運用の自動化を設定する

Application Serverの起動、停止、稼働状況の確認、稼働情報の収集、および障害情報の収集をジョブとして定義し、JP1/AJS3に登録します。

前提条件

JP1/AJS3の環境が構築されている

想定ユーザー

システム構築者

操作手順

JP1/AJS3にApplication Serverの起動をジョブとして定義します。

ドメイン管理サーバ、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを起動するコマンドを、ジョブとして定義します。

作成したジョブをJP1/AJS3に登録します。

JP1/AJS3にApplication Serverの停止をジョブとして定義します。

Webサーバ、サーバインスタンス、パフォーマンストレーサー、およびドメイン管理サーバを停止するコマンドを、ジョブとして定義します。

作成したジョブをJP1/AJS3に登録します。

JP1/AJS3にApplication Serverの稼働状況の確認をジョブとして定義します。

稼働状況を確認するバッチプログラムを作成します。

作成したバッチプログラムをジョブとしてJP1/AJS3に登録します。

JP1/AJS3にApplication Serverの稼働情報の収集をジョブとして定義します。

稼働情報ファイルを収集するバッチプログラムを作成します。

作成したバッチプログラムをジョブとしてJP1/AJS3に登録します。

JP1/AJS3にApplication Serverの障害情報の収集をジョブとして定義します。

障害情報ファイルを収集するバッチプログラムを作成します。

作成したバッチプログラムをジョブとしてJP1/AJS3に登録します。

関連項目

4.6.6　トラブルシュート資料を一括収集するための設定をする

7.2.1　コマンドを利用してシステムを開始する

7.2.2　コマンドを利用してシステムを停止する

7.3.1　コマンドを利用してApplication Serverの稼働状況を確認する

7.3.2　コマンドを利用してデータベースサーバへの接続状況を確認する

7.3.3　コマンドを利用してアプリケーションの稼働状況を確認する

8.9　システムの利用状況を確認する

8.10　システムの動作状況を確認する

9.1　Application Serverが出力するトラブルシュート資料について

6　高信頼機能の設定

高信頼性を実現するための、障害検知に関する機能（プロセス監視、メッセージ監視）、およびセキュリティーを強化する設定（リバースプロキシー、SSL）について説明します。

6.1　障害検知の設定

システムの障害を検知するために必要な、プロセスの監視とメッセージの監視について説明します。

6.1.1　プロセス監視について

ドメイン管理サーバで起動したプロセスは、起動状況、稼働状況、および停止処理が自動的に監視されます。そのほかのプロセスは監視アプリケーションや監視システムで監視できます。

Application Serverで障害が発生した場合に短時間で安全に復旧するためには、各プロセスの監視が必要です。ドメイン管理サーバのプロセス監視機能と、監視アプリケーションや監視システムを併用することで、Application Server全体のプロセスを監視できます。また、ドメイン管理サーバ自体も監視する必要があるため、その方法についても説明します。

ドメイン管理サーバのプロセス監視機能

ドメイン管理サーバが起動している場合は、ドメイン管理サーバのプロセス監視機能によってJava EEサーバ、Webサーバ、パフォーマンストレーサーのプロセスが監視されます。そのため、汎用的なプロセス監視製品や監視システムでプロセスを監視する場合、それぞれのプロセスを監視するのではなく、ドメイン管理サーバだけを監視対象にしてください。ドメイン管理サーバのプロセス監視機能について、次の図にプロセスの流れと、監視のために任意で設定できる時間、および間隔を示します。

図中の設定項目について次の表で説明します。なお、それぞれパラメーターで任意の時間を設定できます。

図中の番号

監視対象のプロセス

設定項目の説明

設定するパラメーター

1

パフォーマンストレーサー

Webサーバ

起動のタイムアウト時間です。

パフォーマンストレーサー：hitachi-prf-configs.hitachi-prf-config.パフォーマンストレーサーの構成名.hitachi-manage-info.start-timeout-in-seconds

Webサーバ：hitachi-webserver-configs.hitachi-webserver-config.Webサーバの構成名.hitachi-manage-info.start-timeout-in-seconds

Java EEサーバ：configs.config.Java EEサーバの構成名.hitachi-manage-info.start-timeout-in-seconds

2

JavaEEサーバ

3

パフォーマンストレーサー

Webサーバ

JavaEEサーバ

各サーバの稼働状況の監視をする間隔です。プロセスダウンやハングアップによるサービス停止などのサーバの障害を監視します。設定した時間に従って、サーバの障害監視の対象期間中、サーバプロセスの稼働状況を定期的に確認します。

稼働状況の確認には監視対象のプロセス1つに対して監視用のプロセスを定期的に1つ生成します。この処理はCPUリソースを消費するため、オンラインの処理性能に影響を及ぼす場合には、監視する間隔を延ばしてください。

パフォーマントレーサー：hitachi-prf-configs.hitachi-prf-config.パフォーマンストレーサーの構成名.hitachi-manage-info.running-watch-interval-in-seconds

Webサーバ：hitachi-webserver-configs.hitachi-webserver-config.Webサーバの構成名.hitachi-manage-info.running-watch-interval-in-seconds

Java EEサーバ：configs.config.Java EEサーバの構成名.hitachi-manage-info.running-watch-interval-in-seconds

4

パフォーマンストレーサー

Webサーバ

停止のタイムアウト時間です。

パフォーマンストレーサー：hitachi-prf-configs.hitachi-prf-config.パフォーマンストレーサーの構成名.hitachi-manage-info.stop-timeout-in-seconds

Webサーバ：hitachi-webserver-configs.hitachi-webserver-config.Webサーバの構成名.hitachi-manage-info.stop-timeout-in-seconds

Java EEサーバ：configs.config.Java EEサーバの構成名.hitachi-manage-info.stop-timeout-in-seconds

5

JavaEEサーバ

プロセスの監視可否

監視対象となるプロセスと、プロセスの監視可否を次の表に示します。ドメイン管理サーバで監視できないプロセスは、必要に応じてほかの監視アプリケーションや監視システムで監視できます。

構成要素

監視対象となるプロセス

ドメイン管理サーバでの監視可否

監視アプリケーション、監視システムでの監視可否

アプリケーションクライアント

java

‐

○

Webサーバ

httpsd

○※

○

---

rotatelogs2

‐

○

---

rotatelogs

‐

○

---

httpsd

‐

○

JavaEEサーバ

java

○※

○

パフォーマンストレーサー

cprfd

○※

○

ドメイン管理サーバ

java

‐

○

（凡例）

○：監視対象にできます。

‐：監視対象にできません。

注※

asadminユーティリティーコマンドを使用しないで、直接起動した場合はドメイン管理サーバでの監視対象になりません。

ドメイン管理サーバおよびJava EEサーバの監視

ドメイン管理サーバおよびJava EEサーバのプロセス名はjavaであるため、ほかのjavaプロセスと区別できるよう、コマンドのオプションを含めて監視します。コマンドの実行例を次に示します。

（例）ドメイン管理サーバのプロセス監視

ps auxww | grep "¥-domainname domain1"

（例）Java EEサーバのプロセス監視

ps auxww | grep "¥-instancedir .*/localhost-domain1/JavaEE1"

6.1.2　メッセージ監視について

Application Serverは、障害発生時に特定のメッセージをログファイルに出力します。監視アプリケーションや監視システムを利用して、出力されるメッセージを監視し、メッセージ出力を契機に障害発生を通知するように設定できます。

メッセージは、次の表に示すログファイルに出力されます。監視アプリケーションや監視システムで、ログファイル中の監視対象キーを監視の対象に設定できます。

ログファイルの格納先は、HJES_LOGSDIR環境変数で変更できます。HJES_LOGSDIR環境変数のデフォルト値は、"Application Serverのインストールディレクトリー/javaee/logs"です。

メッセージが出力されるログファイル

監視対象キー

種別

格納先

ファイル形式

Webサーバ エラーログ

HJES_LOGSDIR/nodes/ノード名/サーバインスタンス名/error.[n]

UPD※1※2

emerg

alert

crit

error

Java EEサーバ サーバインスタンス メッセージログ

HJES_LOGSDIR/nodes/ノード名/サーバインスタンス名/je_message[n].log

SEQ2※3

KDKDXXXXX-E※4

EMERGENCY

ALERT

SEVERE

Transaction rolled back due to time out.

ドメイン管理サーバ メッセージログ

HJES_LOGSDIR/domains/ドメイン名/das_message[n].log

SEQ2※3

KDKDXXXXX-E※4

EMERGENCY

ALERT

SEVERE

注※1

ファイル名に日付など不定な文字列が設定されるファイル形式です。1つのログファイルに連続して書き込み続け、ログファイルが一定の容量に達すると、別のファイル名で新たにログファイルを作成して書き込みます。

注※2

ログの分割方法にrotatelogsを使用した場合のファイル形式です。rotatelogs2を利用した場合のファイル形式は、「WRAP2/新規出現タイプ」です。「WRAP2」はJP1/Base のログファイルトラップ機能のファイル形式です。ラップラウンドするとき、データを削除して再び先頭からログを書き込みます。「新規出現タイプ」は監視対象ファイルの出現タイプです。監視対象ファイルが順に出現します。そのため、監視開始時にすべてのファイルが存在しているわけではありません。

注※3

JP1/Base のログファイルトラップ機能のファイル形式です。ファイル名を変更して保存、またはファイルをいったん削除したあと、同じ名称のファイルを作成して新たにログを書き込みます。

注※4

「XXXXX」の部分はメッセージを出力したプログラムで管理する5桁の固有の番号（メッセージ番号）を表します。

関連項目

9.1　Application Serverが出力するトラブルシュート資料について

6.2　セキュリティー強化の設定

システムのセキュリティーを高めるために、Webサーバに対してリバースプロキシーとSSLの設定をします。なお、この設定方法は、運用管理サーバを経由しないでWebサーバを直接起動する場合に適用する設定方法です。

6.2.1　リバースプロキシーを設定する

セキュリティーの強化のために、httpsd.confファイルとreverse_proxy.confファイルにリバースプロキシーに関連するパラメーターを設定して、Webサーバをリバースプロキシーとして設置します。

前提条件

システムのセキュリティー要件が決定している

想定ユーザー

システム構築者

操作手順

リバースプロキシー用のホストにApplication Serverをインストールします。

httpsd.confファイルとreverse_proxy.confファイルにリバースプロキシーに関連するパラメーターを設定します。

httpsd.confファイルの定義例

Include "Application Serverのインストールディレクトリー/httpsd/conf/reverse_proxy.conf"

reverse_proxy.confファイルの定義例

LoadModule proxy_module modules/mod_proxy.so

LoadModule proxy_http_module modules/mod_proxy_http.so

ProxyPass パス名バックエンドサーバのURL キー=値

ProxyPassReverse パス名 URL

HWSProxyPassReverseCookie パス名

6.2.2　SSLを設定する

セキュリティーの強化のために、WebサーバをSSLアクセラレーターとして設置します。httpsd.confファイルにSSLアクセラレーターに関連するパラメーターを設定して、Webサーバのコマンド (hwskeygen、hwscertutil reqgen)で、Web サーバの秘密鍵、および証明書発行要求（CSR）を作成します。秘密鍵、および証明書を格納して、設置を完了します。

前提条件

システムのセキュリティー要件が決定している

想定ユーザー

システム構築者

操作手順

SSLアクセラレーター用のホストにWebサーバをインストールします。

httpsd.confファイルにSSLアクセラレーターに関連するパラメーターを設定します。

httpsd.confファイルの定義例

SSLEnable

SSLCertificateFile "Application Serverのインストールディレクトリー/httpsd/conf/ssl/server/httpsd.pem"

SSLCertificateKeyFile "Application Serverのインストールディレクトリー/httpsd/conf/ssl/server/httpsdkey.pem"

hwskeygenコマンドを使用して、Webサーバの秘密鍵を作成します。

hwskeygenコマンドの指定例

hwskeygen -rand 任意のファイル名 -out 秘密鍵ファイル名 -bits 秘密鍵のビット長

hwscertutil reqgenコマンドを使用して、証明書発行要求 （CSR）を作成します。

hwscertutil reqgenコマンドの指定例

hwscertutil reqgen -sign 署名アルゴリズム -key 秘密鍵ファイル名 -out CSRファイル名

証明機関にWebサーバの証明書発行を依頼して、証明書を取得します。

秘密鍵、および証明書をhttpsd.confファイルで指定した配置先に格納します。

7　通常運用時の作業

運用開始後に日々実施する、通常運用時の作業について説明します。通常運用では、コマンドまたはAdministration Consoleを利用して、システムの開始・停止、およびシステムの稼働状況の確認を実施します。また、マシンの起動・停止と同時に、システムの開始・停止もできます。

7.1　通常運用時の作業の流れ

通常運用では、システムの開始・停止に加えて、システムの稼働状況の確認を実施します。システムの稼働状況の確認では、システムの安定した稼働状態を保つために、Application Serverやアプリケーションなどの稼働状況を適宜確認します。システムの開始・停止、およびシステムの稼働状況の確認には、コマンドまたはAdministration Consoleを利用します。コマンドで通常運用時の作業を実行する場合は、管理者権限で実行します。また、マシンの起動・停止と同時に、システムの開始・停止もできます。通常運用時の作業の流れを次に示します。

関連項目

7.2.1　コマンドを利用してシステムを開始する

7.2.2　コマンドを利用してシステムを停止する

7.3.1　コマンドを利用してApplication Serverの稼働状況を確認する

7.3.2　コマンドを利用してデータベースサーバへの接続状況を確認する

7.3.3　コマンドを利用してアプリケーションの稼働状況を確認する

7.4.1　Administration Consoleにログインする

7.4.2　Administration Consoleを利用してシステムを開始する

7.4.3　Administration Consoleを利用してシステムを停止する

7.5.1　Administration Consoleを利用してApplication Serverの稼働状況を確認する

7.5.2　Administration Consoleを利用してデータベースサーバへの接続状況を確認する

7.5.3　Administration Consoleを利用してアプリケーションの稼働状況を確認する

7.6.1　マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）

7.6.2　マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 7の場合）

7.6.3　マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）

7.6.4　マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 7の場合）

7.2　コマンドを利用したシステムの開始と停止

コマンドを利用したシステムの開始または停止の手順について説明します。

7.2.1　コマンドを利用してシステムを開始する

コマンドを利用してシステムを開始するには、asadminユーティリティーコマンドのstart-domainサブコマンドでドメイン管理サーバを起動し、start-serversサブコマンドでApplication Serverを起動したあと、enableサブコマンドでアプリケーションを開始します。なお、ハードウェアロードバランサーを使用している場合は、最後に、ハードウェアロードバランサーの閉塞を解除します。

前提条件

ドメイン管理サーバが停止している

Application Serverが停止している

アプリケーションが停止している

想定ユーザー

システム運用者

操作手順

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのenableサブコマンドを実行して、アプリケーションを開始します。

asadmin enable --target サーバインスタンス名またはクラスター名 アプリケーション名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

asadminユーティリティーコマンドのlist-applicationsサブコマンドに--longオプションを指定して実行し、アプリケーションの一覧を表示します。

asadmin list-applications --long=true サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。アプリケーションのステータスがenabledになっていることを確認してください。

NAME                    TYPE        STATUS
アプリケーション名  <ear, web>  enabled
アプリケーション名  <web>       enabled
Command list-applications executed successfully.

Webブラウザーでアプリケーションの起動URLを指定して、開始したアプリケーションにアクセスできることを確認します。

http://サーバインスタンスのIPアドレス:サーバインスタンスのポート番号/開始したアプリケーションのパス

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

7.2.2　コマンドを利用してシステムを停止する

コマンドを利用してシステムを停止するには、asadminユーティリティーコマンドのdisableサブコマンドでアプリケーションを停止し、stop-serversサブコマンドでApplication Serverを停止したあと、stop-domainサブコマンドでドメイン管理サーバを停止します。なお、ハードウェアロードバランサーを使用している場合は、最初に、ハードウェアロードバランサーを閉塞します。また、ソフトウェアロードバランサーを使用している場合は、最初に、Webサーバを停止します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

アプリケーションが開始している

想定ユーザー

システム運用者

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

ソフトウェアロードバランサーを使用している場合は、asadminユーティリティーコマンドのstop-webserverサブコマンドに--gracefulオプションを指定して実行し、Webサーバを計画停止します。

asadmin stop-webserver --graceful true Webサーバ名

計画停止では、現在受け付けているすべてのリクエストの処理終了を待ってから、Webサーバを停止します。

コマンドの実行結果を次に示します。

Command stop-webserver executed successfully.

ソフトウェアロードバランサーを使用している場合は、asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名   not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのdisableサブコマンドを実行して、アプリケーションを停止します。

asadmin disable --target サーバインスタンス名またはクラスター名 アプリケーション名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

重要

アプリケーションをアンデプロイするとメモリーからインスタンスが解放されますが、アプリケーションを無効化（disable）した状態ではインスタンスが解放されません。多量のアプリケーションを無効化した場合、使用中のメモリーが増えていてOutOfMemoryErrorが発生しやすくなります。インスタンスを解放するには、asadminユーティリティーコマンドのdelete-application-refサブコマンドまたはundeployサブコマンドを実行してください。

コマンドの実行結果を次に示します。

Command disable executed successfully.

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。なお、ソフトウェアロードバランサーを使用している場合は、この操作は不要です。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメイン管理サーバを停止します。

asadmin stop-domain

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

7.3　コマンドを利用したシステムの稼働状況の確認

システムの安定した稼働状態を保つために、Application Serverやアプリケーションなどの稼働状況を適宜確認します。コマンドを利用したシステムの稼働状況の確認の手順について説明します。

7.3.1　コマンドを利用してApplication Serverの稼働状況を確認する

コマンドを利用してApplication Serverの稼働状況を確認するには、asadminユーティリティーコマンドのlist-prfsサブコマンド、list-instancesサブコマンド、およびlist-webserversサブコマンドを実行します。

前提条件

ドメイン管理サーバが起動している

想定ユーザー

システム運用者

操作手順

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。ステータスには、稼働の場合はrunning、停止の場合はnot runningが表示されます。

パフォーマンストレーサー名   running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。ステータスには、稼働の場合はrunning、停止の場合はnot runningが表示されます。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。ステータスには、稼働の場合はrunning、停止の場合はnot runningが表示されます。

Webサーバ名   running
Command list-webservers executed successfully.

7.3.2　コマンドを利用してデータベースサーバへの接続状況を確認する

コマンドを利用してサーバインスタンスからデータベースサーバへの接続状況を確認するには、asadminユーティリティーコマンドのping-connection-poolサブコマンドを実行します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

サーバインスタンスからデータベースサーバへの接続が設定されている

想定ユーザー

システム運用者

操作手順

asadminユーティリティーコマンドのping-connection-poolサブコマンドを実行して、サーバインスタンスからデータベースサーバに接続できるかどうかを確認します。

asadmin ping-connection-pool --target サーバインスタンス名 コネクションプールID

コマンドの実行結果を次に示します。データベースサーバに接続できる場合は、コマンドが正常に終了します。

Command ping-connection-pool executed successfully.

7.3.3　コマンドを利用してアプリケーションの稼働状況を確認する

コマンドを利用してサーバインスタンス上のアプリケーションの稼働状況を確認するには、asadminユーティリティーコマンドのlist-applicationsサブコマンドを実行します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム運用者

操作手順

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-applicationsサブコマンドに--longオプションを指定して実行し、サーバインスタンス上のアプリケーションの一覧を表示します。

asadmin list-applications --long=true サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。STATUSでアプリケーションの稼働状況を確認してください。アプリケーションが有効の場合はenabled、無効の場合はdisabledが表示されます。

NAME                    TYPE        STATUS
アプリケーション名  <ear, web>  enabled
アプリケーション名  <web>       enabled
Command list-applications executed successfully.

7.4　Administration Consoleを利用したシステムの開始と停止

Administration Consoleへのログイン、Administration Consoleを利用したシステムの開始または停止の手順について説明します。

7.4.1　Administration Consoleにログインする

Administration Consoleにログインするには、WebブラウザーからAdministration Consoleを起動し、ユーザーIDとパスワードを入力します。

前提条件

ドメイン管理サーバが起動している

想定ユーザー

システム運用者

操作手順

Webブラウザーを起動し、次に示すURLに接続してAdministration Consoleを起動します。

http://ドメイン管理サーバのIPアドレス:ドメイン管理サーバのHTTPポート番号/admin/

メモ

ドメイン管理サーバのIPアドレスのデフォルト値は127.0.0.1、ドメイン管理サーバのHTTPポート番号のデフォルト値は8080です。どちらもデフォルトの場合は、スタートメニュー/スタート画面からAdministration Consoleを起動できます。

ただし、Windows Server 2012、Windows Server 2012 R2、またはWindows 8でビルトインAdministratorアカウントを使用している場合は、セキュリティ上の理由でModern UI版Internet Explorerを起動できないため、別のアカウントでサインインしてやり直すように促すエラーメッセージが表示されることがあります。その場合は、Internet Explorerの［ツール］メニューから［インターネットオプション］を選択し、［プログラム］タブの［リンクの開き方を選択］で［常にデスクトップ用Internet Explorerで開く］を選択して、Administration Consoleを再度起動してください。

［ユーザID］テキストボックスにユーザID、［パスワード］テキストボックスにパスワードを入力して、［ログイン］ボタンをクリックします。

メモ

ユーザIDのデフォルト値はadmin、パスワードのデフォルト値はありません。

7.4.2　Administration Consoleを利用してシステムを開始する

Administration Consoleを利用してシステムを開始するには、［運用］タブの［全サーバ］ペインでApplication Serverを起動し、［全アプリケーション］ペインでアプリケーションを開始します。

前提条件

ドメイン管理サーバが起動している

Application Serverが停止している

アプリケーションが停止している

Administration Consoleにログインしている

想定ユーザー

システム運用者

操作手順

Application Serverを起動します。

Administration Consoleの［運用］タブを開き、ナビゲーションペインのツリーから［全サーバ］を選択します。

［全サーバ］ペインの［一括起動］ボタンをクリックします。

［サーバの起動］ダイアログボックスで起動するサーバを確認し、［OK］ボタンをクリックします。

［全サーバ］ペインで、すべてのサーバが起動している（稼働を示すアイコン[図データ]が表示されている）ことを確認してください。

アプリケーションを開始します。

ナビゲーションペインのツリーから［全アプリケーション］を選択します。

［全アプリケーション］ペインの［一括有効化］ボタンをクリックします。

［アプリケーションの有効化］ダイアログボックスで開始するアプリケーションを確認し、［OK］ボタンをクリックします。

［全アプリケーション］ペインで、すべてのアプリケーションが開始している（［有効］にチェックがある）ことを確認してください。

Webブラウザーでアプリケーションの起動URLを指定して、開始したアプリケーションにアクセスできることを確認します。

http://サーバインスタンスのIPアドレス:サーバインスタンスのポート番号/開始したアプリケーションのパス

7.4.3　Administration Consoleを利用してシステムを停止する

Administration Consoleを利用してシステムを停止するには、［運用］タブの［全アプリケーション］ペインでアプリケーションを停止し、［全サーバ］ペインでApplication Serverを停止します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

アプリケーションが開始している

Administration Consoleにログインしている

想定ユーザー

システム運用者

操作手順

アプリケーションを停止します。

Administration Consoleの［運用］タブを開き、ナビゲーションペインのツリーから［全アプリケーション］を選択します。

［全アプリケーション］ペインの［一括無効化］ボタンをクリックします。

［アプリケーションの無効化］ダイアログボックスで停止するアプリケーションを確認し、［OK］ボタンをクリックします。

［全アプリケーション］ペインで、すべてのアプリケーションが停止している（［有効］にチェックがない）ことを確認してください。

Application Serverを停止します。

ナビゲーションペインのツリーから［全サーバ］を選択します。

［全サーバ］ペインの［一括停止］ボタンをクリックします。

［サーバの停止］ダイアログボックスで停止するサーバを確認し、［OK］ボタンをクリックします。

［全サーバ］ペインで、すべてのサーバが停止している（停止を示すアイコン[図データ]が表示されている）ことを確認してください。

7.5　Administration Consoleを利用したシステムの稼働状況の確認

システムの安定した稼働状態を保つために、Application Serverやアプリケーションなどの稼働状況を適宜確認します。Administration Consoleを利用したシステムの稼働状況の確認の手順について説明します。

7.5.1　Administration Consoleを利用してApplication Serverの稼働状況を確認する

Administration Consoleを利用してApplication Serverの稼働状況を確認するには、［ホーム］タブの［システムのステータス］ペインを使用します。

前提条件

ドメイン管理サーバが起動している

Administration Consoleにログインしている

想定ユーザー

システム運用者

操作手順

Administration Consoleの［ホーム］タブを開きます。

［システムのステータス］ペインで、各サーバのステータスを示すアイコン（稼働の場合は[図データ]、停止の場合は[図データ]）を確認して、Application Serverの稼働状況を確認してください。

7.5.2　Administration Consoleを利用してデータベースサーバへの接続状況を確認する

Administration Consoleを利用してサーバインスタンスからデータベースサーバへの接続状況を確認するには、［運用］タブのJDBCリソースの［ターゲット］ペインを使用します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

サーバインスタンスからデータベースサーバへの接続が設定されている

Administration Consoleにログインしている

想定ユーザー

システム運用者

操作手順

Administration Consoleの［運用］タブを開き、ナビゲーションペインのツリーからJDBCリソース名のリンクをクリックします。

JDBCリソースの［ターゲット］ペインで、JDBCリソースが有効かどうか（［有効］のチェックの有無）を確認してください。

7.5.3　Administration Consoleを利用してアプリケーションの稼働状況を確認する

Administration Consoleを利用してアプリケーションの稼働状況を確認するには、［運用］タブのアプリケーションの［ターゲット］ペインを使用します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

Administration Consoleにログインしている

想定ユーザー

システム運用者

操作手順

Administration Consoleの［運用］タブを開き、ナビゲーションペインのツリーからアプリケーション名のリンクをクリックします。

アプリケーションの［ターゲット］ペインで、アプリケーションが有効かどうか（［有効］のチェックの有無）を確認してください。

7.6　マシンの起動・停止時のシステムの同時開始・停止

マシンの起動・停止と同時に、システムを開始・停止する手順について説明します。

7.6.1　マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）

マシンの起動時にシステムを同時に開始するには、システムの開始処理を記述したスクリプトを作成します。スクリプトには、asadminユーティリティーコマンドのstart-domainサブコマンド、およびstart-serversサブコマンドを記述します。

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstart-domainサブコマンド、およびstart-serversサブコマンドを記述したスクリプトを作成します。

作成したスクリプト（またはそのシンボリックリンク）をrcスクリプトとしてUNIXに登録します。

マシンの起動時にシステムが同時に開始できるかどうかを確認するために、マシンを再起動します。

実行結果を確認します。

マシンの起動時にシステムが同時に開始できない場合は、スクリプトの内容や、スクリプトの登録に問題がないかを確認してください。

7.6.2　マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 7の場合）

マシンの起動時にシステムを同時に開始するには、システムの開始処理を記述したsystemdのユニット設定ファイルを作成します。ユニット設定ファイルには、asadminユーティリティーコマンドのstart-domainサブコマンド、およびstart-serversサブコマンドを記述します。

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstart-domainサブコマンド、およびstart-serversサブコマンドを記述したsystemdのユニット設定ファイルを作成します。

ユニット設定ファイル※1の記述例を次に示します。

start-domainサブコマンドを記述する場合

[Unit]
Description=Application Server Domain
After=network.target
[Service]
Type=oneshot
ExecStart=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin start-domain※2
ExecStop=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin stop-domain※2
RemainAfterExit=yes
TimeoutStartSec=630
TimeoutStopSec=90
[Install]
WantedBy=multi-user.target

start-serversサブコマンドを記述する場合

[Unit]
Description=Application Server
After=HAS_domain1.service
Requires=HAS_domain1.service
[Service]
Type=oneshot
ExecStart=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin start-servers※3
ExecStop=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin stop-servers※3
RemainAfterExit=yes
TimeoutStartSec=930
TimeoutStopSec=930
[Install]
WantedBy=multi-user.target

注※1

コマンドの実行だけをサービスとして記述する場合の例です。systemdのユニット設定ファイルの詳細は、Red Hat Enterprise Linux Server 7のドキュメントを参照してください。

注※2

ローカルホストのデフォルトドメインを起動する場合の例です。asadminオプションおよびサブコマンドオプションは環境に応じて適切に記述してください。

注※3

ローカルホストのデフォルトドメイン内のすべてのサーバを一括起動する場合の例です。asadminオプションは環境に応じて適切に記述してください。

作成したユニット設定ファイルを/etc/systemd/system/に配置し、systemctl enable サービス名コマンドでサービスを有効にします。

マシンの起動時にシステムが同時に開始できるかどうかを確認するために、マシンを再起動します。

実行結果を確認します。

マシンの起動時にシステムが同時に開始できない場合は、スクリプトの内容や、スクリプトの登録に問題がないかを確認してください。

7.6.3　マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）

マシンの停止時にシステムを同時に停止するには、システムの停止処理を記述したスクリプトを作成します。スクリプトには、asadminユーティリティーコマンドのstop-serversサブコマンド、およびstop-domainサブコマンドを記述します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-serversサブコマンド、およびstop-domainサブコマンドを記述したスクリプトを作成します。

作成したスクリプト（またはそのシンボリックリンク）をrcスクリプトとしてUNIXに登録します。

マシンの停止時にシステムが同時に停止できるかどうかを確認するために、マシンをシャットダウンします。

実行結果を確認します。

マシンの停止時にシステムが同時に停止できない場合は、スクリプトの内容や、スクリプトの登録に問題がないかを確認してください。

7.6.4　マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 7の場合）

マシンの停止時にシステムを同時に停止するには、システムの停止処理を記述したsystemdのユニット設定ファイルを作成します。ユニット設定ファイルには、asadminユーティリティーコマンドのstop-serversサブコマンド、およびstop-domainサブコマンドを記述します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-serversサブコマンド、およびstop-domainサブコマンドを記述したsystemdのユニット設定ファイルを作成します。

マシンの起動時にシステムを同時に開始する設定をしていて、かつ記述例に示すとおりstop-serversサブコマンド、stop-domainサブコマンドも記載している場合、手順1および手順2は不要です。次の記述例は、マシンの起動時にシステムを同時に開始する場合に使用する設定ファイルの例と同じです。

ユニット設定ファイル※1の記述例を次に示します。

stop-domainサブコマンドを記述する場合

[Unit]
Description=Application Server Domain
After=network.target
[Service]
Type=oneshot
ExecStart=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin start-domain※2
ExecStop=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin stop-domain※2
RemainAfterExit=yes
TimeoutStartSec=630
TimeoutStopSec=90
[Install]
WantedBy=multi-user.target

stop-serversサブコマンドを記述する場合

[Unit]
Description=Application Server
After=HAS_domain1.service
Requires=HAS_domain1.service
[Service]
Type=oneshot
ExecStart=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin start-servers※3
ExecStop=/opt/hitachi/APServer/javaee/glassfish/bin/asadmin stop-servers※3
RemainAfterExit=yes
TimeoutStartSec=930
TimeoutStopSec=930
[Install]
WantedBy=multi-user.target

注※1

コマンドの実行だけをサービスとして記述する場合の例です。systemdのユニット設定ファイルの詳細は、Red Hat Enterprise Linux Server 7のドキュメントを参照してください。

注※2

ローカルホストのデフォルトドメインを停止する場合の例です。asadminオプションおよびサブコマンドオプションは環境に応じて適切に記述してください。

注※3

ローカルホストのデフォルトドメイン内のすべてのサーバを一括停止する場合の例です。asadminオプションは環境に応じて適切に記述してください。

作成したユニット設定ファイルを/etc/systemd/system/に配置し、systemctl enable サービス名コマンドでサービスを有効にします。

マシンの停止時にシステムが同時に停止できるかどうかを確認するために、マシンをシャットダウンします。

実行結果を確認します。

マシンの停止時にシステムが同時に停止できない場合は、スクリプトの内容や、スクリプトの登録に問題がないかを確認してください。

8　保守運用時の作業

稼働状況の変化やシステム構成の変更に対応するための保守運用時の作業について説明します。保守運用では、Application Serverに対して、稼働状況やシステム構成に応じた環境定義の変更、アプリケーションの入れ替え、環境情報のバックアップ・リストア作業などを実施します。保守運用時の作業には、コマンドまたはAdministration Consoleを利用します。

8.1　保守運用時の作業の概要について

保守運用とは、システムのメンテナンスを目的とした運用です。稼働状況の変化やシステム構成の変更に対応するための作業を実施します。保守運用の作業の目的と作業項目、実行方法の種別など、保守運用時の作業の概要について説明します。

保守運用時の作業一覧

保守運用時の作業の目的と作業項目を次の表に示します。

項番

作業の目的

作業項目

1

次のような場合に、Application Serverの環境定義を変更します。

アクセス数の増加やアプリケーションの変更などで、稼働状況が変わった場合。

セキュリティーの問題が発生した際の、一時的な対策として実施する場合。

環境定義を変更する場合、一連の作業をする前にパフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。また、一連の作業が完了したら、Application Serverを一括起動します。

setサブコマンドを使用してApplication Serverの設定を変更する

2

サーバテンプレートを使用してWeb サーバの設定を変更する

3

create-jvm-optionsサブコマンドを使用してJava VMオプションを変更する

4

asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

5

アプリケーションへの機能追加や不具合対策などを実施するため、Application Serverで稼働しているアプリケーションを入れ替えます。

アプリケーションを入れ替える

6

定期的なメンテナンス時などネットワーク構成を変更する際に、Application ServerがインストールされているホストのIPアドレスやホスト名を変更します。

IPアドレスおよびホスト名を変更する

7

Application Serverの環境定義の変更に際して設定を保管する場合などに、環境情報をバックアップします。また、環境定義の変更に失敗するなど、バックアップした環境情報を復元する場合にリストアします。

環境情報をバックアップする

8

環境情報をリストアする

9

Application Serverの修正パッチが発行された際やシステムの定期メンテナンス時などに、修正パッチおよび修正版を適用します。

修正パッチおよび修正版を適用する

10

マシン構成や環境定義の見直しに向けて、システムの利用状況（アクセスログなど）や動作状況（稼働情報ファイル）を確認します。

システムの利用状況を確認する

11

システムの動作状況を確認する

12

業務処理量の増加が判明した場合や、将来予期される業務処理に備える場合などに、マシンを増設してほかのApplication Serverと同じ設定をします。

システムをスケールアウトする

13

Application Serverのバージョンアップ版を適用します。

Application Serverをバージョンアップする

保守運用時の作業の実行方法の種別

保守運用時の作業は、次のどちらの方法でも実行できます。このマニュアルでは、コマンドを利用した方法で実行手順を説明しています。

コマンド

このマニュアルに記載されている手順のとおりに実行します。コマンドは管理者権限で実行します。

Administration Console

Administration Consoleにログインして、GUIを利用して作業を実行します。

関連項目

8.2.1　setサブコマンドを使用してApplication Serverの設定を変更する

8.2.2　サーバテンプレートを使用してWebサーバの設定を変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.4　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

8.3　アプリケーションを入れ替える

8.4　IPアドレスおよびホスト名を変更する

8.5　環境情報をバックアップする

8.6　環境情報をリストアする

8.7　修正パッチおよび修正版を適用する

8.9　システムの利用状況を確認する

8.10　システムの動作状況を確認する

8.11　システムをスケールアウトする

8.12　Application Serverをバージョンアップする

8.2　Application Serverの環境定義の変更

Application Serverの環境定義として、Application Serverの設定、Webサーバの設定、およびJava VMオプションの設定を変更できます。

8.2.1　setサブコマンドを使用してApplication Serverの設定を変更する

Application Serverの設定を変更するには、asadminユーティリティーコマンドのsetサブコマンドで変更します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバが停止していない場合は、手順2に進んでください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバがすでに停止している場合は、手順1〜手順5を省略してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのgetサブコマンドを実行して、Application Serverの設定値を取得します。

asadmin get "*"

コマンドの実行結果から、変更対象の設定対象識別子と、変更前の設定値を確認してください。

複数のパラメーターに値が設定されている場合、設定値は次のように扱われます。

パフォーマンストレーサー関連のパラメーターの場合

「hitachi-prfs.hitachi-prf.パフォーマンストレーサー名.で始まるパラメーター」と「hitachi-prf-configs.hitachi-prf-config.パフォーマンストレーサーのコンフィグ名で始まるパラメーター」の両方に値が設定されているときは、「hitachi-prfs.hitachi-prf.パフォーマンストレーサー名.で始まるパラメーター」の値が有効になります。

Webサーバ関連のパラメーターの場合

「hitachi-webservers.hitachi-webserver.Webサーバ名で始まるパラメーター」と「hitachi-webserver-configs.hitachi-webserver-config.Webサーバのコンフィグ名で始まるパラメーター」の両方に値が設定されているときは、「hitachi-webservers.hitachi-webserver.Webサーバ名で始まるパラメーター」の値が有効になります。

サーバインスタンス関連のパラメーターの場合

「servers.server.Java EEサーバ名で始まるパラメーター」と「configs.config.Java EEサーバの構成名で始まるパラメーター」の両方に値が設定されているときは、「servers.server.Java EEサーバ名で始まるパラメーター」の値が有効になります。

asadminユーティリティーコマンドのsetサブコマンドを実行して、変更対象の設定対象識別子に対して変更後の設定値を指定します。

asadmin set 設定対象識別子=設定値

メモ

Webサーバの標準プロパティー以外（デイレクティブ）の設定値を変更する場合は、サーバテンプレートを使用してWebサーバの設定を変更してください。

コマンドの実行結果を次に示します。

Command set executed successfully.

asadminユーティリティーコマンドのgetサブコマンドを実行して、Application Serverの設定値を再度取得します。

asadmin get "*"

コマンドの実行結果から、変更対象の設定対象識別子に、手順7で指定した設定値が反映されていることを確認してください。

ここで変更作業を完了する場合は、手順9に進んでください。

次の環境定義を変更する場合は、Application Serverを一括起動しないで、それぞれの環境定義を実施してください。

Webサーバの設定

JavaVMオプション

asadminユーティリティーコマンドのプロセスに適用する環境変数

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

関連項目

8.2.2　サーバテンプレートを使用してWebサーバの設定を変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.4　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

8.2.2　サーバテンプレートを使用してWebサーバの設定を変更する

Webサーバで標準プロパティー以外の設定値を変更するには、サーバテンプレートを使用します。サーバテンプレートには、Webサーバの運用に必要な設定を記述しています。Webサーバの設定を変更する場合は、拡張プロパティーを設定するか、またはディレクティブをサーバテンプレートに直接記述するかのどちらかを実施します。サーバテンプレートを編集する場合は、拡張プロパティーを設定する方法をお勧めします。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

サーバテンプレートの格納先とファイル名

サーバテンプレートのファイル名を次に示します。

httpsd.conf@linux.vtl（Linuxの場合）

Webサーバの基本設定用サーバテンプレートです。リクエスト転送と負荷分散以外の基本設定を記述します。

httpsd.conf@aix.vtl（AIXの場合）

Webサーバの基本設定用サーバテンプレートです。リクエスト転送と負荷分散以外の基本設定を記述します。

reverse_proxy.conf@.vtl

Webサーバのリクエスト転送設定用サーバテンプレートです。リクエスト転送先サーバインスタンスがクラスター構成でない場合に、設定を記述します。

proxy_balancer.conf@.vtl

Webサーバの負荷分散設定用サーバテンプレートです。リクエスト転送先サーバインスタンスがクラスター構成の場合に、設定を記述します。

初回のドメイン起動時、サーバテンプレートの各ファイルは、Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/server_templates/webserver/confに展開されます。

サーバテンプレートの編集方法

サーバテンプレートは、次の方法で編集できます。

拡張プロパティーを設定するために、VTL構文を記述する

サーバテンプレートにVTL構文を記述し、asadminユーティリティーコマンドのsetサブコマンドの拡張プロパティーの値を操作することで、Webサーバを設定します。

ディレクティブを直接記述する

サーバテンプレートにディレクティブを直接記述することで、Webサーバを設定します。

拡張プロパティーを設定するために、VTL構文を記述すると、asadminユーティリティーコマンドのsetサブコマンドでWebサーバの設定を変更し、getサブコマンドで変更内容を確認できるようになります。

サーバテンプレートは、asadminユーティリティーコマンドのcreate-webserverサブコマンド、およびstart-webserverサブコマンド実行時にドメイン管理サーバによって読み込まれ、Webサーバが読み込む定義ファイルに設定が反映されます。

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバが停止していない場合は、手順2に進んでください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバがすでに停止している場合は、手順1〜手順5を省略してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

拡張プロパティーを設定するために、VTL構文を記述する場合は、次の手順で設定します。

reverse_proxy.confにProxyPreserveHostディレクティブを設定する例で、手順を説明します。

テキストエディターなどを利用して、サーバテンプレートのファイル（reverse_proxy.conf@.vtl）を開いて、拡張プロパティーのVTL構文を記述します。

拡張プロパティーは、接頭辞にex_を付加した名称で設定します。

ProxyPreserveHostディレクティブの場合、拡張プロパティーはex_ProxyPreserveHost.valueで設定します。

ProxyPreserveHost ${property.ex_ProxyPreserveHost.value}

サーバテンプレートのファイルを保存します。

asadminユーティリティーコマンドのsetサブコマンドを実行して、Webサーバのコンフィグに対して、拡張プロパティー ex_ProxyPreserveHost.valueの値にOn を設定します。

asadmin set
hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=
On

コマンドの実行結果を次に示します。

hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=On
Command set executed successfully.

asadminユーティリティーコマンドのgetサブコマンドを実行して、拡張プロパティー ex_ProxyPreserveHost.valueの値が設定したとおりになっているかを確認します。

asadmin get
hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost

コマンドの実行結果を次に示します。

hitachi-webservers.hitachi-webserver.Webサーバ名.property.ex_ProxyPreserveHost=On
Command get executed successfully.

ディレクティブを直接記述する場合は、次の手順で直接記述します。

テキストエディターなどを利用して、サーバテンプレートのファイルを開いて、Web Serverのディレクティブを直接記述します。

ディレクティブをコメントとする場合は、先頭の#の直後に半角スペースを入れて記述します。

サーバテンプレートのファイルを保存します。

ここで変更作業を完了する場合は、手順8に進んでください。

次の環境定義を変更する場合は、Application Serverを一括起動しないで、それぞれの環境定義を実施してください。

Application Serverの設定

JavaVMオプション

asadminユーティリティーコマンドのプロセスに適用する環境変数

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

関連項目

8.2.1　setサブコマンドを使用してApplication Serverの設定を変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.2.4　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

JavaVMオプションは、サーバインスタンスと、ドメイン管理サーバに対して指定できます。すでに指定されているJavaVMオプションを変更するには、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドで削除してから、create-jvm-optionsサブコマンドで変更後のJavaVMオプションを指定します。

前提条件

ドメイン管理サーバが起動している

Application Serverのセットアップが完了している

想定ユーザー

システム構築者

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバが停止していない場合は、手順2に進んでください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバがすでに停止している場合は、手順1〜手順5を省略してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、クラスター内のすべてのサーバインスタンスのオプションの一覧を表示します。

asadmin list-jvm-options --target サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

手順6で表示した一覧に変更するオプションがある場合は、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドを実行して、変更するオプションを削除します。

asadmin delete-jvm-options --target サーバインスタンス名またはクラスター名
[オプション名[=オプションの値][:オプション名[=オプションの値]]...]

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

オプションを複数指定する場合は、コロン（:）で区切って指定します。

重要

オプション入力時、記号に対するエスケープ処理が必要になります。

例えば、-XX:MaxMetaspaceSize=192mを指定する場合は、:に対して¥¥を付けてエスケープ処理し、-XX¥¥:MaxMetaspaceSize=192mと入力します。

コマンドの実行結果を次に示します。

Deleted n option(s)
Command delete-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドを実行して、すべてのサーバインスタンスに対して、オプションでJavaヒープなどのJavaメモリーの値を設定します。

asadmin create-jvm-options --target サーバインスタンス名またはクラスター名
[オプション名[=オプションの値][:オプション名[=オプションの値]]...]

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

重要

すでに指定されているオプションを変更する場合は、delete-jvm-optionsサブコマンドで変更するオプションを削除してください。削除しないまま、create-jvm-optionsサブコマンドでオプションを指定した場合は、警告が表示され、同じオプションが複数登録されます。警告が表示された場合は、list-jvm-optionsサブコマンドで指定されているオプションを確認し、不要なオプションを削除してください。

ドメイン管理サーバは1時間ごと、サーバインスタンスは24時間ごとにSystemGCを実行します。SystemGCの実行間隔は、sun.rmi.dgc.server.gcIntervalと、sun.rmi.dgc.client.gcIntervalで変更できます。これらのシステムプロパティーでFullGCの発生間隔を広げてもGC発生回数が削減されない場合、Javaヒープが不足していることがあります。この場合は、Javaヒープのチューニングを実施することで改善することがあります。

コマンドの実行結果を次に示します。

Created n option(s)
Command create-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、すべてのサーバインスタンスのオプションの一覧を表示します。

asadmin list-jvm-options --target サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

手順8で指定したオプションの値が変更されていることを確認してください。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、ドメイン管理サーバのオプションの一覧を表示します。

asadmin list-jvm-options

手順10で表示した一覧に変更するオプションがある場合は、asadminユーティリティーコマンドのdelete-jvm-optionsサブコマンドを実行して、変更するオプションを削除します。

asadmin delete-jvm-options [オプション名[=オプションの値]
[:オプション名[=オプションの値]]...]

コマンドの実行結果を次に示します。

Deleted n option(s)
Command delete-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドを実行して、ドメイン管理サーバに対して、オプションでJavaヒープなどのJavaメモリーの値を設定します。

asadmin create-jvm-options [オプション名[=オプションの値]
[:オプション名[=オプションの値]]...]

オプション名[=オプションの値]には、オプションとして、-Xms1024m、-Xmx1024m などを設定します。

重要

ドメイン管理サーバのJavaヒープサイズは、デプロイするアプリケーションのアーカイブのサイズに応じて調整してください。アプリケーションのアーカイブのサイズによっては、ドメイン管理サーバのJavaヒープサイズが枯渇し、メモリー不足となることがあります。

また、ドメイン管理サーバのJavaヒープサイズに不適切な値（極端に小さい値や大きい値など）を指定した場合、ドメイン管理サーバが起動しなくなり、ドメインの再構築が必要になることがあります。

このような事態を避けるために、ドメイン管理サーバのオプションを変更する場合は、あらかじめ、backup-domainコマンドを実行して、ドメインのバックアップを取得しておくことをお勧めします。

コマンドの実行結果を次に示します。

Created n option(s)
Command create-jvm-options executed successfully.

nには、指定したオプションの数に応じて数字が埋め込まれます。

asadminユーティリティーコマンドのlist-jvm-optionsサブコマンドを実行して、ドメイン管理サーバのオプションの一覧を表示します。

asadmin list-jvm-options

手順12で指定したオプションの値が変更されていることを確認してください。

サーバインスタンス、およびドメイン管理サーバに対して、Javaメモリー以外のオプションを指定する場合は、手順6から手順13までを繰り返します。

ここで変更作業を完了する場合は、手順15に進んでください。

次の環境定義を変更する場合は、Application Serverを一括起動しないで、それぞれの環境定義を実施してください。

Application Serverの設定

Webサーバの設定

asadminユーティリティーコマンドのプロセスに適用する環境変数

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

関連項目

8.2.1　setサブコマンドを使用してApplication Serverの設定を変更する

8.2.2　サーバテンプレートを使用してWebサーバの設定を変更する

8.2.4　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

8.2.4　asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する

asadminユーティリティーコマンドのプロセスに適用する環境変数を変更するには、Java EE Serverの環境変数定義ファイル（asenv.conf）を編集します。asadminユーティリティーコマンドのプロセスに適用する環境変数には、JavaヒープなどのJavaメモリーの値や、asadminユーティリティーコマンドのログなどを設定します。例えば、デプロイしたアプリケーション数やアプリケーション中のファイル数が多く、Java EEサーバの起動時にメモリー不足になる場合は、asadminユーティリティーコマンドのプロセスに適用するJavaヒープ領域のサイズを変更します。

前提条件

ドメイン管理サーバが起動している

Application Serverが起動している

想定ユーザー

システム構築者

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバが停止していない場合は、手順2に進んでください。

パフォーマンストレーサー、サーバインスタンス、およびWebサーバがすでに停止している場合は、手順1〜手順5を省略してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

Java EE Serverの環境変数定義ファイル（asenv.conf）を編集して、asadminユーティリティーコマンドのプロセスに適用する環境変数を変更します。

複数のJava EEサーバを配置するクラスター構成の場合は、リモートホストおよびローカルホストのそれぞれに対して、環境変数を変更します。

Java EE Serverの環境変数定義ファイル

Application Serverのインストールディレクトリー/javaee/glassfish/config/asenv.conf

編集の例

例えば、Javaヒープ領域の最大サイズを変更する場合は、環境変数HJES_ASADMIN_JVM_OPTIONSに値を指定します。

HJES_ASADMIN_JVM_OPTIONS=-Xmx256m

ここで変更作業を完了する場合は、手順7に進んでください。

次の環境定義を変更する場合は、Application Serverを一括起動しないで、それぞれの環境定義を実施してください。

Application Serverの設定

Webサーバの設定

JavaVMオプション

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

関連項目

8.2.1　setサブコマンドを使用してApplication Serverの設定を変更する

8.2.2　サーバテンプレートを使用してWebサーバの設定を変更する

8.2.3　create-jvm-optionsサブコマンドを使用してJavaVMオプションを変更する

8.3　アプリケーションを入れ替える

アプリケーションへの機能追加や不具合対策などを実施するため、Application Serverで稼働するアプリケーションを入れ替えます。この作業には、稼働中のApplication Serverを停止させたあと、入れ替え対象のアプリケーションをasadminユーティリティーコマンドのundeployサブコマンドでアンデプロイし、変更後のアプリケーションをdeployサブコマンドでデプロイします。なお、ハードウェアロードバランサーを使用している場合は、最初に、ハードウェアロードバランサーを閉塞します。

前提条件

ドメイン管理サーバが起動している

サーバインスタンスが起動している

サーバインスタンスでアプリケーションが稼働している

入れ替えるアプリケーションが存在する

想定ユーザー

システム構築者

操作手順

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーを閉塞します。

閉塞の方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

アプリケーション名を確認するためasadminユーティリティーコマンドのlist-applicationsサブコマンドを実行して、サーバインスタンスまたはクラスターを対象に、デプロイされているアプリケーションの一覧を表示します。

asadmin list-applications --long=true サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。出力されたアプリケーションの一覧から、アプリケーション名を確認してください。

NAME                     TYPE                STATUS
アプリケーション名    <ear, web, ejb>     enabled
アプリケーション名    <ear, web, ejb>     enabled
Command list-application executed successfully.

手順6で確認したアプリケーション名を指定してasadminユーティリティーコマンドのundeployサブコマンドを実行し、サーバインスタンスまたはクラスターを対象に、入れ替えるアプリケーションをサーバインスタンスからアンデプロイします。

asadmin undeploy --target サーバインスタンス名またはクラスター名 アプリケーション名

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。入れ替えるアプリケーションのアンデプロイに成功したことを確認してください。

Command undeploy executed successfully.

入れ替えるすべてのアプリケーションに対して、手順7の作業を実施します。

asadminユーティリティーコマンドのdeployサブコマンドを実行し、サーバインスタンスまたはクラスターを対象に、変更後のアプリケーションをサーバインスタンスへデプロイします。

asadmin deploy --target サーバインスタンス名またはクラスター名 アプリケーションのファイルパス

1つのJava EEサーバを配置する構成の場合は、--targetオプションにサーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、--targetオプションにクラスター名を指定します。

コマンドの実行結果を次に示します。変更後のアプリケーションのデプロイに成功したことを確認してください。

Application deployed with name アプリケーション名.
Command deploy executed successfully.

変更後のすべてのアプリケーションに対して、手順9の作業を実施します。

メモ

手順6から手順10では、アンデプロイしたあとにデプロイしてアプリケーションを入れ替えていますが、リデプロイしてアプリケーションを入れ替えることもできます。

ドメインディレクトリーの下位階層のdocrootディレクトリーに格納されている静的コンテンツを、新しいコンテンツに入れ替えます。

Webサーバのドキュメントルートディレクトリー（Application Serverのインストールディレクトリー/javaee/glassfish/nodes/ノード名/Webサーバ名/root/htdocs）に格納されている静的コンテンツを、新しいコンテンツに入れ替えます。

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

変更後のアプリケーションの状態を確認するため、asadminユーティリティーコマンドのlist-applicationsサブコマンドを実行して、サーバインスタンスまたはクラスターを対象に、サーバインスタンスにデプロイされているアプリケーションの一覧を表示します。

list-applications

サブコマンドを実行する際、アプリケーションが有効かどうかを表示するため

--long

オプションを指定します。

asadmin list-applications --long=true サーバインスタンス名またはクラスター名

1つのJava EEサーバを配置する構成の場合は、サーバインスタンス名を指定します。複数のJava EEサーバを配置するクラスター構成の場合は、クラスター名を指定します。

コマンドの実行結果を次に示します。NAMEにはアプリケーション名が、TYPEには、アプリケーションの種類が表示されます。すべてのアプリケーションのステータスがenabled（有効）になっていることを確認してください。

NAME                    TYPE         STATUS
アプリケーション名   <ear, web>   enabled
アプリケーション名   <web>        enabled
Command list-applications executed successfully.

ハードウェアロードバランサーを使用している場合は、外部からアプリケーションにアクセスできるようにするため、ハードウェアロードバランサーの閉塞を解除します。

閉塞を解除する方法は、使用しているハードウェアロードバランサーのマニュアルを参照してください。

8.4　IPアドレスおよびホスト名を変更する

定期メンテナンス時などネットワークの構成を変更する場合、Application ServerがインストールされているホストのIPアドレスやホスト名を変更します。この作業には、稼働中のApplication Serverを停止し、ドメイン管理サーバのホストを対象にする場合はドメイン管理サーバを停止させたあと、OSの手順に従って対象のホストのIPアドレスまたはホスト名を変更します。さらに、asadminユーティリティーコマンドのupdate-node-configまたはupdate-node-sshサブコマンドで、ノードの構成情報を更新します。

前提条件

Application Serverが起動している

ドメイン管理サーバが起動している

想定ユーザー

システム構築者

操作手順

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

ドメイン管理サーバのホストのIPアドレスまたはホスト名を変更する場合は、次に示す手順を実施します。

リモートホストのIPアドレスまたはホスト名を変更する場合は、手順6の操作に進んでください。

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメイン管理サーバを停止します。

asadmin stop-domain

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

ドメイン管理サーバのホストに設定されているIPアドレスまたはホスト名を、OSの手順に従って変更します。

必要に応じて、マシンを再起動してください。

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのlist-nodesサブコマンドを実行して、ノードの一覧を表示します。

asadmin list-nodes

コマンドの実行結果を次に示します。

ノード名 CONFIG IPアドレスまたはホスト名
ノード名 SSH IPアドレスまたはホスト名
Command list-nodes executed successfully.

ドメイン管理サーバと同じホストにノードがある場合は、asadminユーティリティーコマンドのupdate-node-configサブコマンドを実行して、ノードの構成情報を更新します。

デフォルトのノード（

localhost-domain1

）のようにローカルホストで登録されているノードの場合、この操作は必要ありません（ローカルホストでホスト名を解決できるため）。

asadmin update-node-config --nodehost 変更後のIPアドレスまたはホスト名 ノード名

コマンドの実行結果を次に示します。

Command update-node-config executed successfully.

リモートホストにノードがある場合（手順dで確認したノードの一覧に、ノードタイプSSHのノードがある場合）は、リモートホストがドメイン管理サーバのホスト（ローカルホスト）のホスト名を解決できるようにします。

リモートホストのhostsファイルを編集します。

リモートホストにノードがある場合は、リモートホストにある設定ファイル（das.properties）を修正します。

設定ファイル（

das.properties

）のパラメーター（

agent.das.host

）に、変更後のIPアドレスまたはホスト名を指定してください。設定ファイル（

das.properties

）は、

Java EE Serverのインストールディレクトリー/glassfish/nodes/ノード名/agent/config/das.properties

に格納されています。

リモートホストのIPアドレスまたはホスト名を変更する場合は、次に示す手順を実施します。

リモートホストに設定されているIPアドレスまたはホスト名を、OSの手順に従って変更します。

必要に応じて、マシンを再起動してください。

asadminユーティリティーコマンドのlist-nodesサブコマンドを実行して、ノードの一覧を表示します。

asadmin list-nodes

コマンドの実行結果を次に示します。

ノード名 CONFIG IPアドレスまたはホスト名
ノード名 SSH IPアドレスまたはホスト名
Command list-nodes executed successfully.

リモートホストのノード（手順bで確認したノードの一覧で、ノードタイプSSHが表示されたノード）に対してasadminユーティリティーコマンドのupdate-node-sshサブコマンドを実行し、ノードの構成情報を更新します。

asadmin --user ドメイン管理サーバのユーザー名 --passwordfile パスワードファイルのパス
update-node-ssh --nodehost 変更後のIPアドレスまたはホスト名 ノード名

コマンドの実行結果を次に示します。

Command update-node-ssh executed successfully.

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

8.5　環境情報をバックアップする

環境定義の変更に際して変更前後の設定を保管する場合などに、Application Serverの環境情報をバックアップします。ドメインディレクトリーで管理しているファイルは、asadminユーティリティーコマンドのbackup-domainサブコマンドでバックアップファイルを作成します。なお、ノードディレクトリーやサーバが使用するファイル（主にサーバテンプレート）をドメインディレクトリーの外に作成した場合は、手動でバックアップする必要があります。

前提条件

ドメイン管理サーバが停止している

Application Serverが停止している

想定ユーザー

システム構築者またはシステム運用者

操作手順

asadminユーティリティーコマンドのbackup-domainサブコマンドを実行して、ドメインに対応するApplication Serverの環境情報をバックアップします。

asadmin backup-domain
--backupdir バックアップファイルを格納するディレクトリーのパス ドメイン名

コマンドの実行結果を次に示します。

Command  backup-domain executed successfully.

backup-domainサブコマンドの実行時に指定したディレクトリーを参照し、バックアップファイルが格納されていることを確認します。

ドメインディレクトリー以外で管理しているファイル（主にサーバテンプレート）を、バックアップ用のディレクトリーにコピーしてバックアップします。

8.6　環境情報をリストアする

バックアップしたApplication Serverの環境情報をリストア（復元）するには、asadminユーティリティーコマンドのrestore-domainサブコマンドで、バックアップファイルの環境情報をドメインディレクトリーに復元します。また、ドメインディレクトリー以外で管理するサーバテンプレートなどのファイルを、元の格納ディレクトリーにコピーして戻します。

前提条件

ドメイン管理サーバが停止している

Application Serverが停止している

想定ユーザー

システム構築者またはシステム運用者

操作手順

asadminユーティリティーコマンドのrestore-domainサブコマンドを実行して、バックアップファイルを基に、Application Serverの環境情報を指定したドメインのドメインディレクトリーに復元します。

asadmin restore-domain
--backupdir バックアップファイルが格納されているディレクトリーのパス 環境情報をリストアするドメイン名

コマンドの実行結果を次に示します。

Command  restore-domain executed successfully.

restore-domainサブコマンドの実行時に指定したドメインのドメインディレクトリーを参照し、環境情報が復元されたことを確認します。

バックアップ用のディレクトリーに格納されているサーバテンプレートなどのファイルを、元の格納ディレクトリーにコピーして戻します。

8.7　修正パッチおよび修正版を適用する

Application Serverの修正パッチが発行された際やシステムの定期メンテナンス時などに、修正パッチ・修正版をインストールしてシステムに適用します。修正パッチ・修正版を適用するには、稼働中のApplication Serverとドメイン管理サーバを停止させたあと、提供媒体を使用してインストールを実施します。

前提条件

Application Serverが起動している

ドメイン管理サーバが起動している

想定ユーザー

システム構築者

操作手順

Application Serverの修正パッチおよび修正版の提供媒体を入手します。

ソフトウェアサポートサービスのWebサイトまたは修正パッチCD-ROMから修正パッチがリリースされているか確認し、リリースされている場合は、そのどちらかから提供媒体を入手してください。

asadminユーティリティーコマンドのstop-serversサブコマンドを実行して、パフォーマンストレーサー、サーバインスタンス、およびWebサーバを一括停止します。

asadmin stop-servers

コマンドの実行結果を次に示します。

Command stop-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがnot runningになっていることを確認してください。

パフォーマンストレーサー名 not running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがnot runningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 not running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがnot runningになっていることを確認してください。

Webサーバ名 not running
Command list-webservers executed successfully.

asadminユーティリティーコマンドのstop-domainサブコマンドを実行して、ドメイン管理サーバを停止します。

asadmin stop-domain

コマンドの実行結果を次に示します。

Command stop-domain executed successfully.

提供媒体を使用して修正パッチおよび修正版をインストールします。

適用手順については、修正パッチに添付されているRELEASE.TXTを参照してください。

修正パッチおよび修正版がインストールされたことを［セットアップの完了］ダイアログで確認します。

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのstart-serversサブコマンドを実行して、Application Serverを一括で起動します。

asadmin start-servers

コマンドの実行結果を次に示します。

Command start-servers executed successfully.

asadminユーティリティーコマンドのlist-prfsサブコマンドを実行して、パフォーマンストレーサーの一覧を表示します。

asadmin list-prfs

コマンドの実行結果を次に示します。パフォーマンストレーサーのステータスがrunningになっていることを確認してください。

パフォーマンストレーサー名 running
Command list-prfs executed successfully.

asadminユーティリティーコマンドのlist-instancesサブコマンドに--longオプションを指定して実行し、サーバインスタンスの一覧を表示します。

asadmin list-instances --long=true

コマンドの実行結果を次に示します。サーバインスタンスのステータスがrunningになっていることを確認してください。

サーバインスタンス名 ホスト名 ポート番号 プロセスID クラスター名 running
Command list-instances executed successfully.

クラスター名は、複数のJava EEサーバを配置するクラスター構成の場合だけ表示されます。

サーバインスタンスの起動に成功したかどうかは、Java EEサーバ（サーバインスタンス）のメッセージログにKDKD20031-Iが出力されているかどうか、またはAdministration ConsoleのJava EEサーバ（サーバインスタンス）のステータスでも確認できます。

asadminユーティリティーコマンドのlist-webserversサブコマンドを実行して、Webサーバの一覧を表示します。

asadmin list-webservers

コマンドの実行結果を次に示します。Webサーバのステータスがrunningになっていることを確認してください。

Webサーバ名   running
Command list-webservers executed successfully.

関連項目

8.8　修正パッチ適用時のエラーメッセージ

8.8　修正パッチ適用時のエラーメッセージ

UNIXの場合に、修正パッチ適用時の障害を通知するメッセージについて、意味と対処を説明します。

エラーメッセージの意味と対処

修正パッチ適用時、標準エラー出力に出力されるメッセージについて、意味と対処を説明します。

メッセージID

メッセージ

意味

対処

KESP5100-E

usage : %s [-D log_file]

UPDATEの引数に誤りがあります。

引数を確認して、再度実行してください。

KESP5101-E

An attempt to execute the pre-processing program for the update has failed. (details code = %d) Read the product documentation and follow the instructions.

前処理に失敗しました。

弊社問い合わせ窓口へ連絡してください。

KESP5102-E

An attempt to execute the post-processing program for the update has failed. (details code = %d) Read the product documentation and follow the instructions.

後処理に失敗しました。

弊社問い合わせ窓口へ連絡してください。

KESP5103-E

The module replacement program has failed. (details code = %d) Read the product documentation and follow the instructions.

モジュールの入れ替えに失敗しました。

弊社問い合わせ窓口へ連絡してください。

KESP5104-E

An attempt to execute the patch program for the update has failed. (details code = %d)

MODPATCHが失敗しました。

ログファイルを確認してください。

KESP5105-E

You must be a superuser to run this program.

ルート権限のないユーザーで実行したため処理に失敗しました。

ルート権限のあるユーザーが実行してください。

KESP5106-E

This patch is for the %s platform. The patch cannot be applied to the %s platform.

対象外のプラットフォームで実行されました。

対象プラットフォームとパッチの製品情報ファイル（PRODUCT.INI）の[!comfirm]platformを確認してください。

KESP5107-E

Sufficient memory could not be allocated. Please retry the operation.

メモリが不足しています。

修正パッチ適用に必要なメモリを確保してから再度実行してください。

KESP5108-E

Disk space is insufficient. Increase the available disk space, and then retry the operation.

ディスクの空き容量が不足しています。

修正パッチ適用に必要な空き容量を確保してから再度実行してください。

KESP5109-E

An attempt to modify the file pplistd(%s), has failed. Please retry the operation.

インストール製品情報ファイル（pplistd）の更新中に解析に失敗しました。

インストール製品情報ファイル（pplistd）のフォーマットが正しいか確認してください。

KESP5110-E

The file (%s) was not found. Get the patch file again.

修正パッチに必要なファイルが存在しません。

表示されたファイルが修正パッチにアーカイブされていることを確認してください。

KESP5111-E

The file pplistd was not found. (%s)

インストール製品情報ファイル（pplistd）が存在しません。

インストール製品情報ファイル（pplistd）が存在するか確認してください。

KESP5112-E

The installation path does not exist. (%s)

インストールディレクトリが存在しません。

インストールディレクトリが存在しているか確認してください。

KESP5113-E

The check program for the update has failed. (details code = %d)

チェッカープログラムの実行に失敗しました。

デバッグモードで再度実行して、デバッグログを確認してください。

KESP5114-E

An attempt to modify the history file has failed. (%s)

履歴ファイルの更新に失敗しました。

表示されたファイル名と同じディレクトリが存在しないことを確認してください。

KESP5115-E

The format of the file (%s) is invalid.

製品情報ファイル（PRODUCT.INI）、またはインストール製品情報ファイル（pplistd）のフォーマットに誤りがあります。

製品情報ファイル（PRODUCT.INI）、またはインストール製品情報ファイル（pplistd）のフォーマットを確認してください。

KESP5116-E

[%s] %s is too long.

製品情報ファイル（PRODUCT.INI）に定義された値が指定できる最大長を超えています。

製品情報ファイル（PRODUCT.INI）に定義された値を確認してください。

KESP5117-E

[%s] %s has not been written.

製品情報ファイル（PRODUCT.INI）に必要なエントリーが存在しません。

製品情報ファイル（PRODUCT.INI）に必要なエントリーが記述されていることを確認してください。

KESP5118-E

The specified platform key in the [!confirm] section is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたplatformの値に誤りがあります。

製品情報ファイル（PRODUCT.INI）に定義されたplatformの値が、HPUX、SOLARIS、DIGITAL、LINUX、AIX、IPLINUX、IPFHPUX、X64LINのどれかであることを確認してください。

KESP5119-E

The specified installtype key in the [!common] section is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたinstalltypeの値に誤りがあります。

製品情報ファイル（PRODUCT.INI）に定義されたinstalltypeの値が、HIPPINSTであることを確認してください。

KESP5120-E

The version of the file (%s) is not 1.0.

ファイルバージョンが1.0以外です。

ファイルバージョンが1.0であることを確認してください。

KESP5121-E

The installtype (%s) is not "%s".

インストールタイプに誤りがあります。

インストールタイプが、HIPPINSTであることを確認してください。

KESP5122-E

The file PRODUCT.INI is invalid.

製品情報ファイル（PRODUCT.INI）に誤りがあります。

製品情報ファイル（PRODUCT.INI）のファイルフォーマットを確認してください。

KESP5123-E

The file (%s) cannot be opened.

ファイルを開けませんでした。

表示されたファイルが使用中でないことを確認してください。また、ディスクの空き容量を確認してください。

KESP5124-E

The %s processing has failed.

表示された処理に失敗しました。

ログファイルを確認してください。

KESP5125-E

The %s system call has failed.

表示されたシステムコールの実行に失敗しました。

ログファイルを確認してください。

KESP5126-E

The specified logfilemode key in the [!updater] section is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたlogfilemodeの値に誤りがあります。

製品情報ファイル（PRODUCT.INI）に定義されたlogfilemodeの値がOVERWRITE、またはAPPENDであることを確認してください。

KESP5129-E

The specified unpatch key in the [!modpatch] section is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたunpatchの値に誤りがあります。

製品情報ファイル（PRODUCT.INI）に定義されたunpatchの値がSPKUTIL.TARであることを確認してください。

KESP5130-E

The specified unpatchversion key in the [!modpatch] section is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたunpatchversionの値に誤りがあります。

製品情報ファイル（PRODUCT.INI）に定義されたunpatchversionの値が0303であることを確認してください。

KESP5131-E

[%s]%s is invalid.

製品情報ファイル（PRODUCT.INI）に定義されたパス定義に誤りがあります。

製品情報ファイル（PRODUCT.INI）のエントリーに定義されたパスが正しいことを確認してください。

KESP5132-E

The installation stopped because the version information of the selected product has been changed and is incorrect.

指定された製品のバージョン情報が正しくありません。

CD-ROM媒体に問題があります。弊社問い合わせ窓口へ連絡してください。

KESP5133-E

The update stopped because the version information of the installed product has been changed and is incorrect.

インストールされている製品のバージョン情報が正しくありません。

インストールされている製品に問題があります。弊社問い合わせ窓口へ連絡してください。

KESP5134-E

An attempt to start %s failed.

アップデート要否チェックの起動に失敗しました。

アップデート要否チェックDLLが正しいDLLであることを確認してください。

KESP5135-E

The rollback has failed. Please rerun UPDATE.

ロールバックに失敗しました。

UPDATEを再実行してください。

KESP5255-E

A fatal error occurred.

致命的なエラーが発生しました。

ログファイルを確認してください。

8.9　システムの利用状況を確認する

マシン構成や環境定義の見直しなどに向けて、アクセスログを参照し、システムの利用状況を示す業務分布やリクエスト数の情報を確認および現状分析します。

前提条件

Application Serverがセットアップされている

サーバインスタンスでアプリケーションが稼働している

業務システムが稼働し、Webクライアントから送信されたHTTPリクエストを受け付けている

想定ユーザー

システム構築者

操作手順

アクセスログを参照して、システムの利用状況を確認します。

参照するファイルを次に示します。ファイル名のxには可変値が付与されます。

業務分布（ファイル名：Application Serverのインストールディレクトリー/javaee/logs/nodes/ノード名/Webサーバ名/access.x）

1秒当たりのリクエスト数（ファイル名：Application Serverのインストールディレクトリー/javaee/logs/nodes/ノード名/Webサーバ名/access.x）

なお、このファイルで確認できる1秒当たりのリクエスト数には、Java EEサーバで処理されるリクエストのほかに、Webサーバで処理される静的コンテンツへのリクエストも含まれています。この点を考慮して、利用状況の確認や分析を実施してください。

8.10　システムの動作状況を確認する

マシン構成や環境定義の見直しなどに向けて現状分析するため、稼働情報ファイルを参照し、システムの動作状況を確認します。稼働情報ファイルには、Java EEサーバを対象に、Application Serverの稼働情報収集機能によって定期的に収集されたシステムの稼働情報が出力されます。このファイルを基に、システムの動作状況を示す情報を確認、分析します。

前提条件

Application Serverがセットアップされている

サーバインスタンスでアプリケーションが稼働している

想定ユーザー

システム構築者

操作手順

稼働情報ファイルの出力先ディレクトリーから、確認対象の期間に該当するファイルを取得します。

デフォルトの出力先ディレクトリーは、Application Serverのインストールディレクトリー/javaee/logs/nodes/ノード名/サーバインスタンス名/statistics です。

取得した稼働情報ファイルを参照し、システムの動作状況を確認します。

参照する稼働情報ファイルと確認項目を次に示します。ファイル名のYYYYMMDDhhmmにはファイル出力時の日付と時刻が、TZにはGMT からの数値タイムゾーンオフセット（日本標準時の場合は+0900）が付与されます。

Java VMメモリ拡張稼働情報ファイル（ファイル名：JVMMemoryExtensionsStatistics_サーバインスタンス名_YYYYMMDDhhmmTZ.csv）

確認項目

属性名

説明

ThreadBlockedCount

ThreadBlockedCount.Count

Java VM上でモニターロックのためにブロック状態にあるスレッド数

EdenUsedMemorySize

EdenUsedMemorySize.Count

現在使用されているEden領域のメモリーサイズ

EdenTotalMemorySize

EdenTotalMemorySize.Count

使用できることが保証（コミット）されているEden領域のメモリーサイズ

EdenMaxMemorySize

EdenMaxMemorySize.Count

使用できるEden領域の最大メモリーサイズ

SurvivorUsedMemorySize

SurvivorUsedMemorySize.Count

現在使用されているSurvivor領域のメモリーサイズ

SurvivorTotalMemorySize

SurvivorTotalMemorySize.Count

使用できることが保証（コミット）されているSurvivor領域のメモリーサイズ

SurvivorMaxMemorySize

SurvivorMaxMemorySize.Count

使用できるSurvivor領域の最大メモリーサイズ

TenuredUsedMemorySize

TenuredUsedMemorySize.Count

現在使用されているTenured領域のメモリーサイズ

TenuredTotalMemorySize

TenuredTotalMemorySize.Count

使用できることが保証（コミット）されているTenured領域のメモリーサイズ

TenuredMaxMemorySize

TenuredMaxMemorySize.Count

使用できるTenured領域の最大メモリーサイズ

MetaspaceUsedMemorySize

MetaspaceUsedMemorySize.Count

現在使用されているMetaspace領域のメモリーサイズ

MetaspaceTotalMemorySize

MetaspaceTotalMemorySize.Count

使用できることが保証（コミット）されているMetaspace領域のメモリーサイズ

MetaspaceMaxMemorySize

MetaspaceMaxMemorySize.Count

使用できるMetaspace領域の最大メモリーサイズ

ExplicitHeapSize

ExplicitHeapSize.Count

Explicitヒープサイズ

ExplicitMemoryBlockCount

ExplicitMemoryBlockCount.Count

Explicitヒープ領域のExplicitメモリーブロックの個数

ExplicitMemoryBlockMaxSize

ExplicitMemoryBlockMaxSize.Count

Explicitメモリブロックの最大サイズ

HttpSessionExplicitMemoryBlockMaxSize

HttpSessionExplicitMemoryBlockMaxSize.Count

HTTPセッションで取得したExplicitメモリーブロックの最大サイズ

HttpSessionExplicitMemoryBlockCount

HttpSessionExplicitMemoryBlockCount.Count

HTTPセッションで取得したExplicitメモリーブロックの個数

ContainerExplicitHeapSize

ContainerExplicitHeapSize.Count

HTTPセッションで取得したExplicitヒープ領域を除く、コンテナーが管理しているExplicitヒープサイズ

ApplicationExplicitHeapSize

ApplicationExplicitHeapSize.Count

アプリケーションおよびJava VMが管理しているExplicitヒープサイズ

ネットワークコネクションキュー稼働情報ファイル（ファイル名：NetworkConnectionQueueStatistics_サーバインスタンス名_YYYYMMDDhhmmTZ.csv）

確認項目

属性名

説明

CountOverflows

CountOverflows.Count

コネクションキューからあふれた数（累積値）

ExCountQueued

−

キュー内にあるコネクション数

ExCountQueued.Current

コネクションキューの現在値

ExCountQueued.HighWaterMark

前回の稼働情報の出力時点からのコネクションキューに格納したコネクションの最大値

ExCountQueued.LowWaterMark

前回の稼働情報の出力時点からのコネクションキューに格納したコネクションの最小値

（凡例）−：該当しない。

ネットワークスレッドプール稼働情報ファイル（ファイル名：NetworkThreadPoolStatistics_サーバインスタンス名_YYYYMMDDhhmmTZ.csv）

確認項目

属性名

説明

ExCurrentThreadsBusy

−

リクエストを処理するリスナースレッドプール内で使用しているリクエスト処理スレッドの数

ExCurrentThreadsBusy.Current

実行中のスレッドの現在値

ExCurrentThreadsBusy.HighWaterMark

前回の稼働情報の出力時点からの同時に実行したスレッドの最大値

ExCurrentThreadsBusy.LowWaterMark

前回の稼働情報の出力時点からの同時に実行したスレッドの最小値

（凡例）−：該当しない。

Webセッション稼働情報ファイル（ファイル名：WebSessionStatistics_サーバインスタンス名_YYYYMMDDhhmmTZ.csv）

確認項目

属性名

説明

ActiveSessions

−

アクティブなセッションの数

ActiveSessions.Current

セッション数の現在値

ActiveSessions.HighWaterMark

前回の稼働情報の出力時点からのセッション数の最大値

ActiveSessions.LowWaterMark

前回の稼働情報の出力時点からのセッション数の最小値

（凡例）−：該当しない。

JDBC接続プール稼働情報ファイル（ファイル名：JDBCConnectionPoolStatistics_サーバインスタンス名_YYYYMMDDhhmmTZ.csv）

確認項目

属性名

説明

NumConnUsed

−

使用されているコネクションの合計数

NumConnUsed.Current

使用中コネクションの現在値

NumConnUsed.HighWaterMark

前回の稼働情報の出力時点からの使用中となったプール内コネクションの最大値

NumConnUsed.LowWaterMark

前回の稼働情報の出力時点からの使用中となったプール内コネクションの最小値

NumConnFree

−

最後のサンプリング時点におけるプール内コネクションの合計数

NumConnFree.Current

未使用コネクションの現在値

NumConnFree.HighWaterMark

前回の稼働情報の出力時点からの未使用となったプール内コネクションの最大値

NumConnFree.LowWaterMark

前回の稼働情報の出力時点からの未使用となったプール内コネクションの最小値

（凡例）−：該当しない。

8.11　システムをスケールアウトする

業務処理量の増加が判明した場合や、将来予測される業務処理量に備える場合などに、増設したマシン（新設サーバ）にApplication Serverを構築して、システムをスケールアウトします。システムをスケールアウトするには、新設サーバにApplication Serverをインストールし、新設サーバのローカルホストから既存サーバのリモートホストへ接続するための設定をしたあと、Application Serverのセットアップを実施します。

前提条件

クラスター構成で、既存のサーバインスタンスがクラスターに含まれている

既存サーバでドメイン管理サーバが起動している

既存サーバにApplication Serverがセットアップされている

新設サーバが稼働している

想定ユーザー

システム構築者

操作手順

新設サーバにApplication Serverをインストールします。

リモートホストで、ドメイン管理サーバ（ローカルホスト）のホスト名を名前解決できるようにhostsファイルを編集します。

ローカルホストで、パスワードファイルを作成します。

AS_ADMIN_SSHPASSWORD=リモートホストのパスワード

ローカルホストで、asadminユーティリティーコマンドのsetup-sshサブコマンドを実行して、暗号キー（SSLキー）を作成します。

asadmin --passwordfile パスワードファイルのパス
setup-ssh --sshuser リモートホストのSSHユーザー名 リモートホスト名

コマンドの実行結果を次に示します。

Command setup-ssh executed successfully.

ローカルホストで、asadminユーティリティーコマンドのcreate-password-aliasサブコマンドを実行して、パスワードに対するエイリアスを設定します。

asadmin create-password-alias パスワードエイリアス名

パスワードが求められた場合は、リモートホストのパスワードを入力してください。

コマンドの実行結果を次に示します。

Command create-password-alias executed successfully.

ローカルホストで、手順3で作成したパスワードファイルを編集します。

AS_ADMIN_SSHPASSWORD=${ALIAS=パスワードエイリアス名}

ドメイン管理サーバを再起動します。

asadmin restart-domain

コマンドの実行結果を次に示します。

Command restart-domain executed successfully.

新設サーバにApplication Serverをセットアップするため、asadminユーティリティーコマンドのcreate-node-sshサブコマンドを実行して、リモートホストに対するノードを追加します。

asadmin --user ドメイン管理サーバのユーザー名
--passwordfile パスワードファイルのパス
create-node-ssh --nodehost リモートホストのホスト名
--sshuser リモートホストのアカウント名 --sshkeyfile ~/.ssh/id_rsa
--installdir Application Serverのインストールディレクトリー/javaeeの絶対パス リモートホストのノード名

リモートホストのノード名には、リモートホストに構築するノード名（ノードを識別するための任意の名称）を指定します。

コマンドの実行結果を次に示します。

Command create-node-ssh executed successfully.

新設サーバにApplication Serverをセットアップするため、asadminユーティリティーコマンドのcreate-prfサブコマンドを実行して、パフォーマンストレーサーを構築します。

asadmin create-prf --node リモートホストのノード名 パフォーマンストレーサー名

コマンドの実行結果を次に示します。

Command create-prf executed successfully.

新設サーバにApplication Serverをセットアップするため、asadminユーティリティーコマンドのcreate-instanceサブコマンドを実行して、Java EEサーバ（サーバインスタンス）を構築します。

asadmin create-instance --node リモートホストのノード名
--prf パフォーマンストレーサー名
--cluster クラスター名 サーバインスタンス名

クラスター名には、構築済みのクラスター名を指定します。

コマンドの実行結果を次に示します。

Command create-instance executed successfully.

ハードウェアロードバランサーを使用している場合は、asadminユーティリティーコマンドのcreate-webserverサブコマンドを実行して、新設サーバにWebサーバを構築します。

ソフトウェアロードバランサーを使用している場合は、

手順15

の操作に進んでください。

asadmin create-webserver --node リモートホストのノード名 Webサーバ名

コマンドの実行結果を次に示します。

Command create-webserver executed successfully.

ハードウェアロードバランサーを使用している場合は、asadminユーティリティーコマンドのcreate-relationサブコマンドを実行して、新設サーバにサーバ間関連を設定します。

asadmin create-relation --relationtype redirect
--from Webサーバ名
--to サーバインスタンス名
--properties サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値 サーバ間関連の関連名

リダイレクト関連の関連づけを設定する場合、静的コンテンツをWebサーバで処理し、静的コンテンツ以外のリクエストをJava EEサーバで処理するために、--propertiesオプションにpath、およびnetwork-listenerを指定します。

（例）

path=/apserver/:network-listener=http-listener-1

pathには、スラッシュ（/）から始まるURLのパスを指定します。スラッシュだけの指定（path=/）はしないでください。この例では、http://xxxxxxxxxxx/index.htmlのようにURLのパスの先頭にapserverを含まないリクエストは、Webサーバの静的コンテンツにアクセスされます。また、http://xxxxxxxxxxx/apserver/sample/index.jspのようにURLのパスの先頭にapserverを含むリクエストは、http://yyyyyyyyyyy/sample/index.jspというURLでJava EEサーバにリダイレクトされます。

network-listenerには、リダイレクト先のJava EEサーバのHTTPリスナー、またはHTTPSリスナーを示すネットワークリスナー名を指定します。Java EEサーバには、デフォルトでHTTPリスナーにhttp-listener-1、HTTPSリスナーにhttp-listener-2というネットワークリスナーが定義されています。

コマンドの実行結果を次に示します。

Command create-relation executed successfully.

ハードウェアロードバランサーを使用している場合で、かつ、性能を考慮して静的コンテンツをWebサーバに配置する場合は、Webサーバのドキュメントルートディレクトリーに静的コンテンツを格納します。

Webサーバのドキュメントルートディレクトリーは、

Application Serverインストールディレクトリー/javaee/glassfish/nodes/ノード名/Webサーバ名/root/htdocs

です。

ハードウェアロードバランサーを使用している場合は、ハードウェアロードバランサーに対してリクエストの振り分けを設定します。

リクエストを振り分ける設定については、使用しているハードウェアロードバランサーのマニュアルを参照してください。

ソフトウェアロードバランサーを使用している場合は、asadminユーティリティーコマンドのcreate-relationサブコマンドを実行して、新設サーバにサーバ間関連を設定します。

asadmin create-relation --relationtype redirect
--from Webサーバ名
--to クラスター名
--properties サーバ間関連のプロパティー名=サーバ間関連のプロパティーの値 サーバ間関連の関連名

リダイレクト関連の関連づけを設定する場合、静的コンテンツをWebサーバで処理し、静的コンテンツ以外のリクエストをJava EEサーバで処理するために、--propertiesオプションにpath、およびnetwork-listenerを指定します。

（例）

path=/apserver/:network-listener=http-listener-1

pathには、スラッシュ（/）から始まるURLのパスを指定します。スラッシュだけの指定（path=/）はしないでください。この例では、http://xxxxxxxxxxx/index.htmlのようにURLのパスの先頭にapserverを含まないリクエストは、Webサーバの静的コンテンツにアクセスされます。また、http://xxxxxxxxxxx/apserver/sample/index.jspのようにURLのパスの先頭にapserverを含むリクエストは、http://yyyyyyyyyyy/sample/index.jspというURLでJava EEサーバにリダイレクトされます。

network-listenerには、リダイレクト先のJava EEサーバのHTTPリスナー、またはHTTPSリスナーを示すネットワークリスナー名を指定します。Java EEサーバには、デフォルトでHTTPリスナーにhttp-listener-1、HTTPSリスナーにhttp-listener-2というネットワークリスナーが定義されています。

コマンドの実行結果を次に示します。

Command create-relation executed successfully.

8.12　Application Serverをバージョンアップする

Application Serverをバージョンアップするには、旧バージョンのドメインを新バージョンに適用するためのアップグレードが必要です。この作業には、asadminユーティリティーコマンドのbackup-domainサブコマンドで、旧バージョンのドメインのバックアップファイルを作成し、新バージョンをインストールしたあとに、asadminユーティリティーコマンドのrestore-domainサブコマンドで、ドメインを新環境にリストアします。このリストアしたドメインに対してasadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバの構成をアップグレードします。

前提条件

旧バージョンのドメインが存在する

想定ユーザー

システム構築者またはシステム運用者

操作手順

旧バージョンの環境情報のバックアップを取得します。

旧バージョンの環境で稼働中のすべてのサーバおよびすべてのドメイン管理サーバを停止します。

asadminユーティリティーコマンドのbackup-domainサブコマンドを実行して、旧バージョンの環境情報のバックアップファイルを出力します。

asadmin backup-domain
--backupdir バックアップファイルの格納ディレクトリー ドメイン名

コマンドの実行結果を次に示します。

Command  backup-domain executed successfully.

次に示すバックアップファイルが出力されたことを確認します。

バックアップファイルの格納ディレクトリー/ドメイン名/ドメイン名_YYYY_MM_DD_v通番.zip

通番は、00001から始まる数値が割り当てられます。

新バージョンをインストールします。

旧バージョン環境で稼働中のすべてのサーバおよびすべてのドメイン管理サーバを停止します。

新バージョンをインストールします。

インストールの種類を次に示します。

新規インストール：旧バージョンがインストールされているマシンとは別のマシンに、新バージョンをインストールする

複数インストール：旧バージョンがインストールされているマシンで、別のディレクトリーに新バージョンをインストールする

上書きインストール：旧バージョンがインストールされているマシンで、同じディレクトリーに新バージョンをインストールする

複数のJava EEサーバを配置するクラスター構成にする場合は、リモートホストごとにインストールを実行します。

旧バージョンでバックアップを取得した環境情報を、新バージョンの環境に移行します。

上書きインストールをした場合、この作業は不要です。

旧バージョンのJava EE Serverの環境変数定義ファイル（asenv.conf）に追加した環境変数を、新バージョンの同じファイルに設定します。

Java EE Serverの環境変数定義ファイル

インストールディレクトリー/javaee/glassfish/config/asenv.conf

インストールディレクトリーには、Application Serverのインストールディレクトリーを指定します。

新バージョンの環境で、asadminユーティリティーコマンドのrestore-domainサブコマンドを実行して、バックアップした旧バージョンの環境情報を新バージョンの環境にリストア（復元）します。

asadmin restore-domain
--backupdir バックアップファイルの格納ディレクトリー 環境情報をリストアするドメイン名

リストアしたドメインのドメインディレクトリーを参照して、環境情報が復元されたことを確認します。

ドメインのアップグレードをします。

新バージョンの環境で、asadminユーティリティーコマンドのstart-domainサブコマンドに--upgradeオプションを指定して実行し、ドメインのアップグレードをします。

asadmin start-domain --upgrade ドメイン名

コマンドの実行結果を次に示します。

Command start-domain executed successfully.
The DAS was stopped.

このとき、コンソールを参照して、 SEVERE、 ALERT、または EMERGENCY レベルのメッセージが出力されていないことを確認します。

新バージョンの環境で、ドメインディレクトリー以下に出力された osgi-cache-数字という名称のディレクトリーを削除します。

ドメインのアップグレードを実行すると、ドメインディレクトリー以下にあったOSGiキャッシュディレクトリーが

osgi-cache-数字

という名前にリネームされます。アップグレード後は使用しないディレクトリーであるため、削除します。

asadminユーティリティーコマンドのstart-domainサブコマンドを実行して、ドメイン管理サーバを起動します。

asadmin start-domain ドメイン名

コマンドの実行結果を次に示します。

Command start-domain executed successfully.

asadminユーティリティーコマンドのupdate-node-configサブコマンドまたはupdate-node-sshサブコマンドを実行して、各ノードのインストールディレクトリーを新バージョンのインストールディレクトリーに変更します。

ローカルホストのノードの場合

asadmin update-node-config
--installdir 新バージョンのインストールディレクトリー/javaeeの絶対パス
--nodedir ノードディレクトリー ノード名

SSH接続のノードの場合

asadmin update-node-ssh --installdir 新バージョンのインストールディレクトリー/javaeeの絶対パス --nodedir
ノードディレクトリー ノード名

旧バージョンの環境でノードディレクトリーをデフォルトから変更していた場合は、--nodedirオプションを指定して、ノードディレクトリーも変更します。

ノードディレクトリーの変更が必要な場合は、ノードディレクトリーも変更してください。

コマンドの実行結果を次に示します。

ローカルホストのノードの場合

Command update-node-config executed successfully.

SSH接続のノードの場合

Command update-node-ssh executed successfully.

動作確認をします。

ドメイン上のサーバを起動し、サーバの動作確認とアプリケーションのテストを実施します。

テストで問題がないことを確認したら、新バージョンの本番環境として運用を開始します。

必要に応じて、旧バージョンの環境を削除します。

上書きインストールした場合は、この手順は不要です。

旧バージョンの環境を複数のJava EEサーバを配置するクラスター構成にしていた場合、リモートホストごとに旧バージョンの環境をアンインストールします。

9　トラブルシュート資料の活用

アプリケーションの実行環境および開発環境では、トラブルシュート資料として各種ログ、トレースなどが出力されます。出力されるトラブルシュート資料の見方やパフォーマンストレーサーのトレース取得ポイントなど、トラブルシュート資料を活用する際に必要な情報について説明します。

9.1　Application Serverが出力するトラブルシュート資料について

Application Serverが出力するトラブルシュート資料には、メッセージログや性能解析トレースのほか、各プロセスの特徴に応じたトラブルシュート資料などがあります。必要に応じて、システム情報収集機能または手動でトラブルシュート資料を収集します。

システム情報収集機能とは

システム情報収集機能は、Application Serverを使用して構築されたシステムに関する情報を一括収集する機能です。システム情報収集機能を障害発生時に用いることで、現象発生時点のダンプや設定ファイル・ログ・トレースといった障害の原因究明に必要な資料一式を収集することができます。

収集が必要なトラブルシュート資料

Application Serverのインストール時およびシステムの運用時に障害が発生した場合に必要な、トラブルシュート資料を次の表に示します。なお、トラブルシュート資料は、システム情報収集機能を利用して収集します。システム情報収集機能で収集できない情報については、手動で収集する必要があります。

項番

障害発生のタイミング

トラブルシュート資料の内容

システム情報収集機能での収集可否

1

Application Serverのインストール時

インストールログ

-

2

Application Serverのシステム構築時、およびシステム運用時

各プロセスのログ・トレース

○

3

メモリーダンプ

○

4

定義・設定情報 （製品のバージョン情報、製品の設定ファイルなど ）

○

5

作業ディレクトリーの内容

×

6

画面のキャプチャー

×

7

標準エラー出力（コマンド実行時のコンソール出力）

×

8

性能解析トレース（CSV形式）

○

9

OS のログ （syslog）

○

10

OS のログ （イベントログ）

×

11

OS の統計情報 (CPU利用率、メモリー使用量、スレッド数など )

×

12

OS の状態情報 （環境変数、netstat/ps/sarなどの各種コマンドの結果 ）

○

（凡例）

○：システム情報収集機能で収集できます。

×：システム情報収集機能で収集できません。

Application Serverが出力するトラブルシュート資料の分類

Application Serverを使用したシステムで障害が発生した場合に、Application Serverが出力するトラブルシュート資料には、次のような種類があります。必要に応じて、トラブルシュート資料を収集して、調査してください。

なお、トラブルシュート資料の出力先ディレクトリーは、一部の資料を除きHJES_LOGSDIR環境変数で変更できます。HJES_LOGSDIR環境変数のデフォルト値は、"Application Serverのインストールディレクトリー/javaee/logs"です。

メッセージログ

Java EEサーバやWebサーバから出力されるログです。障害の原因や稼働状況が確認できます。

性能解析トレース

複数のプロセスにわたるリクエスト処理の流れを追跡できるトレース情報です。障害の解析や性能の解析に利用できます。

Java EEサーバおよびHiRDBで出力されるID付きの性能解析トレースを、Webサーバのリクエストログに出力されるリクエストを識別するIDと突き合わせることで、リクエスト処理の追跡ができます。

各プロセスのトラブルシュート資料

プロセスの特徴によって、それぞれ異なる資料に出力されるログやトレース情報です。プロセスの構成を次の図に示します。

プロセスの特徴に応じたトラブルシュート資料について次の表に示します。

項番

プロセス

プロセスの特徴と資料の用途

トラブルシュート資料

1

すべてのプロセス

OS上で動作します。

OSから出力される情報をトラブルシュート資料として利用できます。

OSのログ

OSの統計情報

OSの状態情報

メモリーダンプ（coreダンプ）

2

Javaのプロセス

Java EEサーバ

ドメイン管理サーバ

asadmin

Java VM上で動作します。

Java VMレイヤーについては、一般的なJavaのトラブルシュート資料に加え、製品で拡張したJavaログやスレッドダンプがトラブルシュート資料として利用できます。

Java VMログ

スタックトレースログ

スレッドダンプ

エラーリポートファイル

3

リクエストを処理するプロセス

Webサーバ

Java EEサーバ

HiRDB

複数のプロセスにわたってリクエスト処理が実行されます。

リクエスト処理の流れを複数プロセスにわたって追うことができます。

Webサーバのアクセスログ

Webサーバのリクエストログ

性能解析トレース

4

Java EEサーバ

セッションオブジェクトを明示管理ヒープで管理します。

明示管理ヒープ機能のイベントの発生がログで確認できます。

明示管理ヒープイベントログ

5

インプロセスでMQ Brokerが動作します。

MQ Brokerのメッセージがログで確認できます。

MQ Brokerメッセージログ

6

JSPやJAX-WSの開発時に使用されるコマンドを提供します。

標準エラー出力でエラーメッセージが確認できます。

標準エラー出力

7

Java EEサーバ（asadmin）

Java EEサーバを起動します。

Java EEサーバのロガー初期化前のタイミングの障害情報が確認できます。

プロセス起動ログ

ドメイン管理サーバのトラブルシュート資料

ドメイン管理サーバのトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数※1（初期値）

ログの設定方法

1

ドメイン管理サーバ メッセージログ※2

HJES_LOGSDIR/domains/ドメイン名

das_messagen.log

00:00:00

16メガバイト

8

asadminユーティリティーコマンドのset-log-attributesサブコマンドのパラメーターで指定します。

2

ドメイン管理サーバ スタックトレースログ※2

HJES_LOGSDIR/domains/ドメイン名

das_stacktracen.log

00:00:00

16メガバイト

8

asadminユーティリティーコマンドのset-log-attributesサブコマンドのパラメーターで指定します。

3

ドメイン管理サーバ Java VMログ

HJES_LOGSDIR/domains/ドメイン名

das_javavmn.log

00:00:00

128メガバイト

8

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドのパラメーターで指定します。

4

ドメイン管理サーバ スレッドダンプ

Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/config

javacoreプロセスID.日時.txt

ユーザーの操作を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

5

ドメイン管理サーバ エラーリポートファイル

Application Serverのインストールディレクトリー/javaee/glassfish/domains/ドメイン名/config

hs_err_pidプロセスID.log

プロセスの異常終了を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

注※1

バックアップ用のファイルに加えて書き込み用のファイルが1つ作成されます。例えば、面数が8の場合は合計9ファイルが作成されます。

注※2

スタックトレースの一部は、メッセージログに出力されます。

Java EEサーバ（サーバインスタンス）のトラブルシュート資料

Java EEサーバ（サーバインスタンス）のトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数※1（初期値）

ログの設定方法

1

サーバインスタンス メッセージログ※2

HJES_LOGSDIR/nodes/ノード名/サーバインスタンス名

je_messagen.log

00:00:00

16メガバイト

8

asadminユーティリティーコマンドのset-log-attributesサブコマンドのパラメーターで指定します。

2

サーバインスタンス スタックトレースログ※2

je_stacktracen.log

00:00:00

16メガバイト

8

asadminユーティリティーコマンドのset-log-attributesサブコマンドのパラメーターで指定します。

3

WebSocketアクセスログ

je_websocket_accessn.log

00:00:00

300メガバイト

8

asadminユーティリティーコマンドのset-log-attributesサブコマンドのパラメーターで指定します。

4

サーバインスタンス Java VM ログ

je_javavmn.log

00:00:00

128メガバイト

8

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドのパラメーターで指定します。

5

サーバインスタンス 明示管理ヒープイベントログ

je_eheap_eventn.log

00:00:00

128メガバイト

8

asadminユーティリティーコマンドのcreate-jvm-optionsサブコマンドのパラメーターで指定します。

6

サーバインスタンス スレッドダンプログ

Application Serverのインストールディレクトリー/javaee/glassfish/nodes/ノード名/サーバインスタンス名/config

javacoreプロセスID.日時.txt

ユーザーの操作を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

7

サーバインスタンス エラーリポートファイル

hs_err_pidプロセスID.log

プロセスの異常終了を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

注※1

バックアップ用のファイルに加えて書き込み用のファイルが1つ作成されます。例えば、面数が8の場合は合計9ファイルが作成されます。

注※2

スタックトレースの一部は、メッセージログに出力されます。ユーザーが作成したアプリケーションによって出力される標準出力および標準エラー出力も、メッセージログに出力されます。

Java EEサーバ（asadmin）のトラブルシュート資料

Java EEサーバ（asadmin）のトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数※1（初期値）

ログの設定方法

1

asadmin メッセージログ※2

HJES_LOGSDIR/commands/asadmin

asadmin_messagen.log

00:00:00

16メガバイト

8

asenvの環境変数に指定します。

2

asadmin スタックトレースログ※2

asadmin_stacktracen.log

00:00:00

16メガバイト

8

asenvの環境変数に指定します。

3

asadmin スレッドダンプ

コマンド実行時のカレントディレクトリー

javacoreプロセスID.日時.txt

ユーザーの操作を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

4

asadmin エラーリポートファイル

hs_err_pidプロセスID.log

プロセスの異常終了を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

5

asadmin プロセス起動時ログ

HJES_LOGSDIR/commands/asadmin

asadmin_launchn.log

00:00:00

16メガバイト

8

asenvの環境変数に指定します。

注※1

バックアップ用のファイルに加えて書き込み用のファイルが1つ作成されます。例えば、面数が8の場合は合計9ファイルが作成されます。

注※2

スタックトレースの一部は、メッセージログに出力されます。

Java EEサーバ（アプリケーションクライアント）のトラブルシュート資料

Java EEサーバ（アプリケーションクライアント）のトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数※（初期値）

ログの設定方法

1

アプリケーションクライアント スレッドダンプログ

カレントディレクトリー（appclientコマンドを起動したディレクトリー）

javacoreプロセスID.日時.txt

ユーザーの操作を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

2

アプリケーションクライアント エラーリポートファイル

hs_err_pidプロセスID.log

プロセスの異常終了を契機に出力される。

サイズ制限なし。

時間・面数による削除はなし。

なし

注※

バックアップ用のファイルに加えて書き込み用のファイルが1つ作成されます。例えば、面数が8の場合は合計9ファイルが作成されます。

Java EEサーバ（MQ Broker） のトラブルシュート資料

Java EEサーバ（MQ Broker）のトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数※1（初期値）

ログの設定方法

1

MQ Broker メッセージログ

Application Serverのインストールディレクトリー/javaee/nodes/ノード名/サーバインスタンス名/imq/instances/MQインスタンス名/log

log_n※2.txt

00:00:00

16メガバイト

8

config.propertiesファイルに指定します。

注※1

バックアップ用のファイルに加えて書き込み用のファイルが1つ作成されます。例えば、面数が8の場合は合計9ファイルが作成されます。

注※2

n＝0〜面数-1

Webサーバのトラブルシュート資料

Webサーバのトラブルシュート資料の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数（初期値）

ログの設定方法

1

アクセスログ

HJES_LOGSDIR/nodes/ノード名/Webサーバ名

access.n※1

24時間

最大2ギガバイト

8

TransferLogディレクティブまたはCustomLogディレクティブで指定します。※2

2

リクエストログ

hwsrequest.n※1

24時間

最大2ギガバイト

8

HWSRequestLogディレクティブで指定します。※2

3

エラーログ

error.n※1

24時間

最大2ギガバイト

8

ErrorLogディレクティブで指定します。※2

4

WebSocketリクエストログ

hws_websocket_log.n※3

‐（ログファイルサイズでローテート）

512メガバイト

2

HWSWebSocketLogディレクティブで指定します。※2

5

プロセスIDログ

httpd.pid

‐

‐

‐

PidFileディレクティブで指定します。※2

6

内部トレース

hws.trclog.n※4

‐

‐

5

HWSTraceLogFileディレクティブで指定します。※2

7

共有メモリーIDログ

hws.trcid

‐

‐

‐

HWSTraceIdFileディレクティブで指定します。※5

（凡例）

‐：該当なし

注※1

n＝ログ採取開始時刻

注※2

出力先ディレクトリー、ファイル名を変更した場合、システム情報収集機能で収集できません。手動で収集する必要があります。

注※3

n=001〜256

製品の初期設定のrotatelogs2を使用した場合の値です。

注※4

n=01〜05

注※5

システム情報収集機能で収集できません。手動で収集する必要があります。

パフォーマンストレーサーのトラブルシュート資料（トラブルシュート用）

パフォーマンストレーサーのトラブルシュート資料（トラブルシュート用）の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数（初期値）

ログの設定方法

1

メッセージログ

HJES_LOGSDIR/nodes/ノード名/PRF識別子/log/PRF識別子

prf_messagen※

00:00:00

10メガバイト

8

なし

注※

n=01〜32

パフォーマンストレーサーのトラブルシュート資料（性能解析用）

パフォーマンストレーサーのトラブルシュート資料（性能解析用）の一覧を示します。

項番

ログの名称

出力先ディレクトリー

ファイル名

ラップ時間（初期値）

サイズ（初期値）

面数（初期値）

ログの設定方法

1

PRFトレース

HJES_LOGSDIR/nodes/ノード名/PRF識別子/utt/prf/PRF識別子/dcopltrc

prf_n※1

時間でラップしません。

8メガバイト

4

なし

2

性能解析トレースファイル（PRFトレースをCSV形式に編集したファイル）

システム情報収集機能によって収集されたアーカイブファイル内。

（例）アーカイブファイルの出力先がD:/snapshotの場合は、性能解析トレースファイルは次のフォルダにzip形式で格納されます。

アーカイブファイルのルート/D/snapshot/作業用ディレクトリ/prfTrace/

node名-サーバインスタンス名-ファイル生成日時.csv※2

システム情報収集機能の実行を契機にPRFトレースがCSV形式に変換される。

サイズ制限なし。

時間・面数による削除はなし。

なし

注※1

n=001〜256

注※2

zipファイルを展開したファイルです。

9.2　ログファイルの出力形式について

各プロセスから出力されるログファイルのローテーション方式と出力形式について説明します。

9.2.1　ログファイルのローテーション方式

各プロセスのログは、複数のファイルにローテーションして出力されます。指定した時刻または出力先のファイルサイズが一定のサイズになったタイミングで、出力先ファイルを切り替えて出力されます。各プロセスのログのローテーション方式について説明します。

Java EEサーバのログのローテーション方式

ログファイルがprf_message01だった場合、ローテーションが発生すると、ログファイルをprf_message02にリネームし、新しく作成したprf_message01にログを出力します。2回目のローテーションが発生すると、prf_message01をprf_message02に、prf_message02をprf_message03にリネームし、ログをprf_message01に出力します。指定したファイル数を超えると、番号が最も大きいファイルを削除します。

Webサーバのログのローテーション方式

rotatelogsプログラムまたはrotatelogs2プログラムを使用してログファイルの分割方法を指定できます。分割方法は、Webサーバの定義ファイルに指定します。

rotatelogsプログラム

アクセスログやエラーログを一定時間単位（例えば、24時間ごと）に分割して、複数のファイルに出力できます。

ログ分割時間間隔

1つのログファイルを採取する時間間隔を指定します。指定した時間が経過するごとに、新規ファイルにログを採取します。

ファイル数

分割したログファイルのファイル数を指定します。指定したファイル数を超えた場合、最も古いファイルから削除されます。

rotatelogs2プログラム

アクセスログやエラーログをログファイルサイズで分割して、複数のファイルにラップアラウンドして出力できます。

ログファイルサイズ

ログファイルの最大サイズを指定します（単位：キロバイト）。ログを出力するタイミングで、最大サイズを超えていると、次のログファイルをクリアして続きが出力されます。

ログファイル個数

出力するログファイルの最大個数を指定します。最大サイズを超えて次のログファイルに移る場合、それまで処理していたログファイルの拡張子が最大個数と同じとき、再度1つ目のファイルから使用します。

（例）ログファイル個数を3に指定した場合

ログファイルがerrorlog.001の場合、errorlog.001からerrorlog.003の順番にログが出力されます。errorlog.003が指定したログファイルサイズを超えると、errorlog.001をクリアして続きが出力されます。

パフォーマンストレーサーのログのローテーション方式

prf_message01が常に最新のログファイルです。ローテーションが発生すると、prf_message01をprf_message02にリネームします。2回目のローテーション事案が発生すると、prf_message01をprf_message03にリネームします(prf_message02からprf_message03へのリネームは行わない)。

アプリケーション開発環境のログのローテーション方式

指定したファイルサイズを契機にログファイルをリネームして、出力します。

9.2.2　Java EEサーバのログの出力形式

Java EEサーバが提供するログの出力形式と出力項目について説明します。

Java EEサーバの提供するログ

Java EEサーバが提供するログの種別を次に示します。

メッセージログ

スタックトレースログ

Java VMログ

明示管理ヒープ機能のイベントログ

スレッドダンプログ

プロセス起動時ログ

WebSocketアクセスログ

保守ログ

それぞれのログの出力形式と、出力項目について説明します。

メッセージログ

出力形式

番号 日付 時刻 アプリケーション名 pid tid メッセージID  テキスト

出力項目

出力項目

説明

番号

トレースレコードの通番（4けた） 。

日付

トレースの取得日付。yyyy/mm/dd形式で出力されます。

時刻

トレースの取得時刻。hh:mm:ss.sss形式で出力されます。

アプリケーション名

アプリケーション識別名。

アプリケーションを特定するための名称です。

pid

プロセスID。

tid

スレッド識別子。

スレッドを識別するためのIDです。

メッセージID

メッセージID。

メッセージを区別するためのIDです。

テキスト

メッセージテキスト。

ログレベル

ログレベル

概要

1

システムが続行できなくなる障害に関するメッセージや運用時に必須となるメッセージなどを出力します。

2

レベル1のメッセージに加え、障害になるおそれがある事象に関する警告メッセージなどを出力します。

3

レベル2のメッセージに加え、稼働情報に関するメッセージなどを出力します。

レベル3は開発環境だけで使用し、実行環境では使用しないでください。

スタックトレースログ

出力形式

メッセージログと同じです。

出力項目

メッセージログと同じです。

Java VMログ

拡張verbosegc出力機能(G1GC使用時以外)

出力形式

[id] date (Skip Full:full_count, Copy:copy_count）
[gc_kind gc_info, gc_time secs][Eden: eden_info][Survivor: survivor_info]
[Tenured: tenured_info][Metaspace: metaspace_info]
[class space: class_space_info] [cause:cause_info] [User: user_cpu secs]
[Sys: system_cpu secs][IM: jvm_alloc_size, mmap_total_size, malloc_total_size]
[TC: thread_count]
[DOE: doe_alloc_size, called_count][CCI: cc_used_sizeK, cc_max_sizeK, cc_infoK]

注

改行はありません。

出力項目

出力項目

説明

id

Java VM ログファイル識別子。

date

GCの開始日時。-XX:-HitachiVerboseGCPrintDateオプション指定時は出力されません。

full_count

FullGCをスキップした回数。-XX:HitachiVerboseGCIntervalTimeオプション指定時に出力されます。

copy_count

CopyGCをスキップした回数。-XX:HitachiVerboseGCIntervalTimeオプション指定時に出力されます。

gc_kind

GC種別（Full GC またはGC）。

gc_info

GC情報（GC前の領域長 -> GC後の領域長(領域サイズ)） (例) 264K->0K(512K)。

gc_time

GC経過時間（単位：秒）。

Eden

Eden領域の種別（DefNew::Eden）。

eden_info

Eden領域のメモリー情報。

Survivor

Survivor領域の種別（DefNew::Survivor）。

survivor_info

Survivor領域のメモリー情報。

Tenured

Tenured領域の種別（Tenured）。

tenured_info

Tenured領域のメモリー情報。

metaspace_info

Metaspace領域のメモリー情報（単位：キロバイト）。

classspace_info

CompressedClassSpace情報（単位：キロバイト）。

cause_info

GC要因内容。

user_cpu

GCスレッドがユーザーモードに費やしたCPU 時間（単位：秒）。

system_cpu

GCスレッドがカーネルモードに費やしたCPU 時間（単位：秒）。

jvm_alloc_size

Java VM 内部で管理している領域のうち、現在使用中の領域のサイズ。

mmap_total_size

Java VM 内部で管理している領域のうち、mmapで割り当てたCヒープ領域の総サイズ。-XX:+HitachiVerboseGCPrintJVMInternalMemoryオプション指定時に出力されます。

malloc_total_size

Java VM 内部で管理している領域のうち、mallocで割り当てたCヒープの総サイズ。-XX:+HitachiVerboseGCPrintJVMInternalMemoryオプション指定時に出力されます。

thread_count

Java スレッドの数。-XX:+HitachiVerboseGCPrintThreadCountオプション指定時に出力されます。

doe_alloc_size

java.io.File.deleteOnExit()を呼び出して確保した累積のヒープサイズ。-XX:+HitachiVerboseGCPrintDeleteOnExitオプション指定時に出力されます。

called_count

java.io.File.deleteOnExit()の呼び出し回数。-XX:+HitachiVerboseGCPrintDeleteOnExitオプション指定時に出力されます。

cc_used_size

GC時のコードキャッシュ領域の使用サイズ（単位：キロバイト）。-XX:+PrintCodeCacheInfoオプション指定時に出力されます。

cc_max_size

コードキャッシュ領域の最大サイズ（単位：キロバイト）。-XX:+PrintCodeCacheInfoオプション指定時に出力されます。

cc_info

保守情報。-XX:+PrintCodeCacheInfoオプション指定時に出力されます。

拡張verbosegc出力機能(G1GC使用時)

出力形式

[id]date[gc_kind gc_info, gc_time secs][Status:gc_status]
[G1GC::Eden: eden_info][G1GC::Survivor: survivor_info]
[G1GC::Tenured: tenured_info][G1GC::Humongous: humongous_info]
[G1GC::Free: free_info][Metaspace: metaspace_info]
[class space: class_space_info] [cause:cause_info][RegionSize: region_sizeK]
[Target: target_time secs][Predicted: predicted_time secs]
[TargetTenured: target_sizeK][Reclaimable: reclaimable_info]
[User: user_cpu secs][Sys: system_cpu secs]
[IM: jvm_alloc_sizeK, mmap_total_sizeK, malloc_total_sizeK]
[TC: thread_count][DOE: doe_alloc_sizeK, called_count]
[CCI: cc_used_sizeK, cc_max_sizeK, cc_infoK]

注

改行はありません。

出力項目

出力項目

説明

id

Java VM ログファイル識別子。

date

GCまたはCMの開始日時。

gc_kind

GCまたはCMの種別。

Full GC、Mixed GC、Young GC、Young GC(initial-mark)、CM Remark、または、CM Cleanupが出力されます。

gc_info

Javaヒープ領域のメモリー情報（単位：キロバイト）。

gc_time

GC経過時間（単位：秒）。

gc_status

GCの状態（to exhaustedまたは-）。

gc_kindがYoung GC、Young GC(initial-mark)または、Mixed GCのどれかの場合

-またはto exhaustedが出力されます。

gc_kindがYoung GC、Young GC(initial-mark)または、Mixed GC以外の場合

-が出力されます。

eden_info

Eden領域のメモリー情報（単位：キロバイト）。

survivor_info

Survivor領域のメモリー情報（単位：キロバイト）。

tenured_info

Tenured領域のメモリー情報（単位：キロバイト）。

humongous_info

Humongous領域のメモリー情報（単位：キロバイト）。

free_info

Free領域のメモリー情報（単位：キロバイト）。

metaspace_info

Metaspace領域のメモリー情報（単位：キロバイト）。

classspace_info

CompressedClassSpace情報（単位：キロバイト）。

cause_info

GC要因内容。

region_size

1リージョンのサイズ（単位：キロバイト）。

target_time

GCによるアプリケーション停止時間の目標時間（単位：秒）。

predicted_time

Java VMが予測したGCによるアプリケーション停止時間（単位：秒）。

target_size

Mixed GCでGC対象となったTenured領域のサイズ。

reclaimable_info

予測回収サイズ情報（単位：キロバイト）。

user_cpu

GCスレッドがユーザーモードに費やしたCPU 時間（単位：秒）。-XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

CPU時間取得に失敗した場合にはunknownが表示されます。

system_cpu

GCスレッドがカーネルモードに費やしたCPU 時間（単位：秒）。 -XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

CPU時間取得に失敗した場合にはunknownが表示されます。

CSV形式出力(G1GC使用時以外)

出力形式

id,date,full_count,copy_count,gc_kind,gc_info,gc_time,eden_info,
survivor_info,tenured_info,metaspace_info,classspace_info,cause_info,user_cpu,
system_cpu,jvm_alloc_size,mmap_total_size,malloc_total_size,thread_count,
doe_alloc_size,called_count,cc_used_size,cc_max_size,cc_info

注

改行はありません。

出力項目

出力項目

説明

id

Java VM ログファイル識別子。

date

GCの開始日時。

full_count

FullGCをスキップした回数（-XX:HitachiVerboseGCIntervalTimeオプション指定時に出力されます）。

copy_count

CopyGCをスキップした回数。-XX:HitachiVerboseGCIntervalTimeオプション指定時に出力されます。

gc_kind

GC種別（Full GC またはGC）。

gc_info

GC情報（GC前の領域長 -> GC後の領域長(領域サイズ)）（単位：キロバイト）。

(例) 264K->0K(512K)。

gc_time

GC経過時間（単位：秒）。

eden_info

Eden領域情報（単位：キロバイト）。

survivor_info

Survivor領域のメモリー情報（単位：キロバイト）。

tenured_info

Tenured領域のメモリー情報（単位：キロバイト）。

metaspace_info

Metaspace領域のメモリー情報（単位：キロバイト）。

classspace_info

CompressedClassSpace情報（単位：キロバイト）。

圧縮オブジェクトポインタ機能が無効の場合はダミーで0を出力します。

cause_info

GC要因番号。-XX:-HitachiVerboseGCPrintCauseオプション指定時は出力さません。

user_cpu

GCスレッドがユーザーモードに費やしたCPU 時間（単位：秒）。

CPU時間取得に失敗した場合にはunknownが表示されます。-XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

system_cpu

GCスレッドがカーネルモードに費やしたCPU 時間（単位：秒）。

CPU 時間取得に失敗した場合にはunknown が表示されます。-XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

jvm_alloc_size

Java VM 内部で管理している領域のうち、現在使用中の領域のサイズ。

mmap_total_size

Java VM 内部で管理している領域のうち、mmapで割り当てたCヒープ領域の総サイズ。-XX:-HitachiVerboseGCPrintJVMInternalMemoryオプション指定時は出力されません。

malloc_total_size

Java VM 内部で管理している領域のうち、mallocで割り当てたCヒープ領域の総サイズ。-XX:-HitachiVerboseGCPrintJVMInternalMemoryオプション指定時は出力されません。

thread_count

Java スレッドの数。-XX:-HitachiVerboseGCPrintJVMInternalMemoryオプション指定時は出力されません。

doe_alloc_size

java.io.File.deleteOnExit()を呼び出して確保した累積のヒープサイズ-XX:-HitachiVerboseGCPrintDeleteOnExitオプション指定時は出力されません。

called_count

java.io.File.deleteOnExit()の呼び出し回数。-XX:-HitachiVerboseGCPrintDeleteOnExitオプション指定時は出力されません。

cc_used_size

GC時のコードキャッシュ領域の使用サイズ（単位：キロバイト）。-XX:-PrintCodeCacheInfoオプション指定時は出力されません。

cc_max_size

コードキャッシュ領域の最大サイズ（単位：キロバイト）。-XX:-PrintCodeCacheInfoオプション指定時は出力されません。

cc_info

保守情報。-XX:-PrintCodeCacheInfoオプション指定時は出力されません。

CSV形式出力(G1GC使用時)

出力形式

id,date,gc_kind,gc_info,gc_time,gc_status,eden_info,survivor_info,
tenured_info,humongous_info,free_info,metaspace_info,
classspace_info,cause_info,region_size,target_time,predicted_time,
target_size,reclaimable_info,user_cpu,system_cpu,jvm_alloc_size,
mmap_total_size,malloc_total_size,thread_count,doe_alloc_size,
called_count,cc_used_size,cc_max_size,cc_info

注

改行はありません。

出力項目

出力項目

説明

id

Java VM ログファイル識別子。

date

GCの開始日時。

gc_kind

GCまたはCMの種別。

Full GC、Mixed GC、Young GC、 Young GC(initial-mark)、CM Remark、または、 CM Cleanupが出力されます。

gc_info

Javaヒープ領域のメモリー情報（単位：キロバイト）。

gc_time

GCによるアプリケーション停止時間（単位：秒）。

gc_status

GCの状態（to exhaustedまたは-）。

gc_kindがYoung GC、Young GC(initial-mark)または、Mixed GCのどれかの場合

-またはto exhaustedが出力されます。

gc_kindがYoung GC、Young GC(initial-mark)または、Mixed GC以外の場合

-が出力されます。

eden_info

Eden領域のメモリー情報（単位：キロバイト）。

survivor_info

Survivor領域のメモリー情報（単位：キロバイト）。

tenured_info

Tenured領域のメモリー情報（単位：キロバイト）。

humongous_info

Humongous領域のメモリー情報（単位：キロバイト）。

free_info

Free領域のメモリー情報（単位：キロバイト）。

metaspace_info

Metaspace領域のメモリー情報（単位：キロバイト）。

classspace_info

CompressedClassSpace情報（単位：キロバイト）。

cause_info

GC要因内容。

region_size

1リージョンのサイズ（単位：キロバイト）。

target_time

GCによるアプリケーション停止時間の目標時間（単位：秒）。

predicted_time

Java VMが予測したGCによるアプリケーション停止時間（単位：秒）。

target_size

Mixed GCでGC対象となったTenured領域のサイズ。

reclaimable_info

予測回収サイズ情報（単位：キロバイト）。

user_cpu

全GCスレッドがユーザーモードに費やしたCPU 時間（単位：秒）。-XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

CPU時間取得に失敗した場合にはunknownが表示されます。

system_cpu

全スレッドがカーネルモードに費やしたCPU 時間（単位：秒）。 -XX:-HitachiVerboseGCCpuTimeオプション指定時は出力されません。

CPU時間取得に失敗した場合にはunknownが表示されます。

明示管理ヒープ機能のイベントログ

明示管理ヒープ機能のイベントログの出力契機は、設定しているログ出力レベルに応じて、イベントが異なります。

ログ出力レベルには、normal、verbose、debugの3種類があります。各レベルごとの出力形式を示します。

normalの場合（GC時のExplicitヒープの利用状況）

出力形式

[ENS]ctime[EH: EH_USED_BF->EH_USED_AF(EH_TOTAL/EH_MAX)]
[E/F/D: AC_NUM/FL_NUM/DA_NUM][cause:CAUSE][CF: CF_CNT]

注

改行はありません。

出力項目

出力項目

説明

ctime

GC発生の日時を示します。拡張verbosegc機能で出力しているものと同一の時刻形式で出力されます。

HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

GC前の、Explicitヒープの利用済みサイズが出力されます（単位：キロバイト）。

EH_USED_AF

GC後の、Explicitヒープ利用済みサイズ。

EH_TOTAL

GC後の、確保済みExplicitヒープサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

AC_NUM

GC後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0が出力されます。

DA_NUM

GC後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

CAUSE

GCはCopy GC、Full GCはFull GCが契機となって、このログを出力したことを示します。

CF_CNT

前回のGCから今回のGCまでの間に、Explicitメモリーブロックの初期化に失敗した回数。

normalの場合（Explicitメモリーブロック解放処理）

出力形式

[ENS]ctime[EH: EH_USED_BF->EH_USED_AF(EH_TOTAL/EH_MAX),
ELAPSED secs][E/F/D: AC_NUM/FL_NUM/DA_NUM]
[DefNew::Eden: ED_USED_BF->ED_USED_AF(ED_TOTAL)]
[DefNew::Survivor: SV_USED_BF->SV_USED_AF(SV_TOTAL)]
[Tenured: TN_USED_BF->TN_USED_AF(TN_TOTAL)][User: USERCPU secs]
[Sys: SYSCPU secs][cause:CAUSE]

出力項目

出力項目

説明

ctime

Explicitメモリーブロック解放処理発生の日時。拡張verbosegc機能で出力されるログと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

Explicitメモリーブロック解放処理前の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_USED_AF

Explicitメモリーブロック解放処理後の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_TOTAL

Explicitメモリーブロック解放処理後の、確保済みExplicitヒープサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

ELAPSED

Explicitメモリーブロック解放処理に要した時間（単位：秒）。

AC_NUM

Explicitメモリーブロック解放処理後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

Explicitメモリーブロック解放処理後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

ED_USED_BF

Explicitメモリーブロック解放処理前の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_USED_AF

Explicitメモリーブロック解放処理後の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_TOTAL

Explicitメモリーブロック解放処理後の、Eden領域確保済みサイズ（単位：キロバイト）。

SV_USED_BF

Explicitメモリーブロック解放処理前の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_USED_AF

Explicitメモリーブロック解放処理後の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_TOTAL

Explicitメモリーブロック解放処理後の、Survivor領域確保済みサイズ（単位：キロバイト）。

TN_USED_BF

Explicitメモリーブロック解放処理前の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_USED_AF

Explicitメモリーブロック解放処理後の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_TOTAL

Explicitメモリーブロック解放処理後の、Tenured領域確保済みサイズ（単位：キロバイト）。

USERCPU

Explicitメモリーブロック解放処理に要したユーザーCPU時間（単位：秒）。

SYSCPU

Explicitメモリーブロック解放処理に要したシステムCPU時間（単位：秒）。

CAUSE

必ずReclaimと出力します。Explicitメモリーブロックの解放で出力したログであることを示します。

normalの場合（Explicitメモリーブロック解放処理時のJavaヒープあふれ）

出力形式

[ENS]ctime[EH: EH_USED_BF->EH_USED_AF(EM_TOTAL/EH_MAX),
ELAPSED secs][E/F/D: AC_NUM/FL_NUM/DA_NUM]
[DefNew::Eden: ED_USED_BF->ED_USED_AF(ED_TOTAL)]
[DefNew::Survivor: SV_USED_BF->SV_USED_AF(SV_TOTAL)]
[Tenured: TN_USED_BF->TN_USED_AF(TN_TOTAL)][User: USERCPU secs]
[Sys: SYSCPU secs][cause:CAUSE]

出力項目

出力項目

説明

ctime

Explicitメモリーブロック解放処理発生の日時。拡張verbosegc機能で出力されるログと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

Explicitメモリーブロック解放処理前の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_USED_AF

Javaヒープがあふれたあとの、Explicitヒープ利用済みサイズ。Javaヒープがあふれた場合は、Explicitメモリーブロックの解放処理を行なわないため、必ずEH_USED_BFと同じ値になります（単位：キロバイト）。

EH_TOTAL

Javaヒープがあふれたあとの、確保済みExplicitヒープサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

ELAPSED

Explicitメモリーブロック解放処理開始から、Javaヒープがあふれるまでの時間（単位：秒）。

AC_NUM

Javaヒープがあふれたあとの、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

Javaヒープがあふれたあとの、サブ状態がDisableである有効なExplicitメモリーブロック数。

ED_USED_BF

Explicitメモリーブロック解放処理前の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_USED_AF

Javaヒープがあふれたあとの、Eden領域利用済みサイズ（単位：キロバイト）。

ED_TOTAL

Javaヒープがあふれたあとの、Eden領域確保済みサイズ（単位：キロバイト）。

SV_USED_BF

Explicitメモリーブロック解放処理前の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_USED_AF

Javaヒープがあふれたあとの、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_TOTAL

Javaヒープがあふれたあとの、Survivor領域確保済みサイズ（単位：キロバイト）。

TN_USED_BF

Explicitメモリーブロック解放処理前の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_USED_AF

Javaヒープがあふれたあとの、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_TOTAL

Javaヒープがあふれたあとの、Tenured領域確保済みサイズ（単位：キロバイト）。

USERCPU

Explicitメモリーブロック解放処理開始から、JavaヒープがあふれるまでのユーザーCPU時間（単位：秒）。

SYSCPU

Explicitメモリーブロック解放処理開始から、JavaヒープがあふれるまでのシステムCPU時間（単位：秒）。

CAUSE

必ずReclaimingと出力されます。Explicitメモリーブロック解放処理時のJavaヒープあふれで出力したログであることを示します。

normalの場合（Explicitメモリーブロックのマイグレート処理）

出力形式

[ENS]ctime[EH: EH_USED_BF->EH_USED_AF(EH_TOTAL>/EH_MAX),
ELAPSED secs][E/F/D: AC_NUM/FL_NUM/DA_NUM]
[DefNew::Eden: ED_USED_BF->ED_USED_AF>(ED_TOTAL)]
[DefNew::Survivor: SV_USED_BF->SV_USED_AF(SV_TOTAL)]
[Tenured: TN_USED_BF->TN_USED_AF(TN_TOTAL)]
[target:EH_MIG_TRG/EH_MIG_DED/EH_MIG_LIV]
[User: USERCPU secs][Sys: SYSCPU secs][cause:CAUSE]

出力項目

出力項目

説明

ctime

Explicitメモリーブロックの自動マイグレート予約発生の日時。拡張verbosegc機能で出力しているものと同一の時刻形式。

HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_USED_AF

Explicitメモリーブロックのマイグレート処理後の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_TOTAL

Explicitメモリーブロックのマイグレート処理後の、確保済みExplicitヒープサイズ（単位：キロバイト）

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

ELAPSED

Explicitメモリーブロックの自動マイグレート予約の処理の開始から、マイグレート処理終了までの時間（単位：秒）。

AC_NUM

Explicitメモリーブロックのマイグレート処理後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

Explicitメモリーブロックのマイグレート処理後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

ED_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_USED_AF

Explicitメモリーブロックのマイグレート処理後の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_TOTAL

Explicitメモリーブロックのマイグレート処理後の、Eden領域確保済みサイズ（単位：キロバイト）。

SV_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_USED_AF

Explicitメモリーブロックのマイグレート処理後の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_TOTAL

Explicitメモリーブロックのマイグレート処理後の、Survivor領域確保済みサイズ（単位：キロバイト）。

TN_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_USED_AF

Explicitメモリーブロックのマイグレート処理後の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_TOTAL

Explicitメモリーブロックのマイグレート処理後の、Tenured領域確保済みサイズ（単位：キロバイト）。

EH_MIG_TRG

Explicitメモリーブロックのマイグレート処理を行ったExplicitヒープの利用済みサイズ（単位：キロバイト）。

EH_MIG_DED

Explicitメモリーブロックのマイグレート処理を行ったことによって減少した、Explicitヒープの利用済みサイズ（単位：キロバイト）。

EH_MIG_LIV

Explicitメモリーブロックのマイグレート処理を行ったことによって減少しなかった、Explicitヒープの利用済みサイズ（単位：キロバイト）。

USERCPU

Explicitメモリーブロックの自動マイグレート予約の処理の開始から、マイグレート処理終了までのユーザーCPU時間（単位：秒）。

SYSCPU

Explicitメモリーブロックの自動マイグレート予約の処理の開始から、マイグレート処理終了までのシステムCPU時間（単位：秒）。

CAUSE

必ずMigrateと出力されます。Explicitメモリーブロックのマイグレート処理で出力したログであることを示します。

normalの場合（Explicitメモリーブロックのマイグレート処理時のJavaヒープあふれ）

出力形式

[ENS]ctime[EH: EH_USED_BF->EH_USED_AF(EH_TOTAL/EH_MAX),
ELAPSED secs][E/F/D: AC_NUM/FL_NUM/DA_NUM]
[DefNew::Eden: ED_USED_BF->ED_USED_AF(ED_TOTAL)]
[DefNew::Survivor: SV_USED_BF->SV_USED_AF(SV_TOTAL)]
[Tenured: TN_USED_BF->TN_USED_AF(TN_TOTAL)]
[target:EH_MIG_TRG/EH_MIG_DED/EH_MIG_LIV]
[User: USERCPU secs][Sys: SYSCPU secs][cause:CAUSE]

出力項目

出力項目

説明

ctime

Explicitメモリーブロックのマイグレート処理発生の日時。

拡張verbosegc機能で出力しているものと同一の時刻形式。

HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_USED_AF

Javaヒープがあふれたあとの、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_TOTAL

Javaヒープがあふれたあとの、確保済みExplicitヒープサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

ELAPSED

Explicitメモリーブロックのマイグレート処理開始から、Javaヒープがあふれるまでの時間（単位：秒）。

AC_NUM

Explicitメモリーブロックのマイグレート処理後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

Javaヒープがあふれたあとの、サブ状態がDisableである有効なExplicitメモリーブロック数。

ED_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Eden領域利用済みサイズ（単位：キロバイト）。

ED_USED_AF

Javaヒープがあふれたあとの、Eden領域利用済みサイズ（単位：キロバイト）。

ED_TOTAL

Javaヒープがあふれたあとの、Eden領域確保済みサイズ（単位：キロバイト）。

SV_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_USED_AF

Javaヒープがあふれたあとの、Survivor領域利用済みサイズ（単位：キロバイト）。

SV_TOTAL

Javaヒープがあふれたあとの、Survivor領域確保済みサイズ（単位：キロバイト）。

TN_USED_BF

Explicitメモリーブロックのマイグレート処理前の、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_USED_AF

Javaヒープがあふれたあとの、Tenured領域利用済みサイズ（単位：キロバイト）。

TN_TOTAL

Javaヒープがあふれたあとの、Tenured領域確保済みサイズ（単位：キロバイト）。

EH_MIG_TRG

Explicitメモリーブロックのマイグレート処理を行ったExplicitヒープの利用済みサイズ（単位：キロバイト）。

EH_MIG_DED

Javaヒープがあふれたあとの、それまでにExplicitメモリーブロックのマイグレート処理を行ったことによって減少した、Explicitヒープの利用済みサイズ（単位：キロバイト）。常に0Kを出力します。

EH_MIG_LIV

Javaヒープがあふれたあとの、それまでにExplicitメモリーブロックのマイグレート処理を行ったことによって減少しなかった、Explicitヒープの利用済みサイズ（単位：キロバイト）。Javaヒープあふれの発生原因となったオブジェクトのサイズは含まれません。

USERCPU

Explicitメモリーブロックのマイグレート処理開始から、JavaヒープがあふれるまでのユーザーCPU時間（単位：秒）。

SYSCPU

Explicitメモリーブロックのマイグレート処理開始から、JavaヒープがあふれるまでのシステムCPU時間（単位：秒）。

CAUSE

必ずMigratingと出力されます。Explicitメモリーブロックのマイグレート処理時のJavaヒープあふれで出力したログであることを示します。

normalの場合（明示管理ヒープ自動配置設定ファイルオープンエラー）

出力形式

[ENA]ctime failed to open file. [file=FILENAME]

出力項目

出力項目

説明

ctime

明示管理ヒープ自動配置設定ファイルのオープンに失敗した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

FILENAME

ファイルのオープンに失敗した自動配置設定ファイルの名前(ディレクトリー名を含まない )。

normalの場合（明示管理ヒープ自動配置設定ファイルパースエラー）

出力形式

[ENA]ctime parsed error line. [file=FILENAME line=LINENO]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能自動配置設定ファイルのパースに失敗した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

FILENAME

ファイルのパースに失敗した自動配置設定ファイルの名前(ディレクトリー名を含まない)。

LINENO

パースに失敗した行数。

normalの場合（明示管理ヒープ自動配置エラー）

出力形式

[ENA]ctime creation
CLASS_LIST class's object in explicit memory is failed.
[target=CLASS_METHOD
detail=MESSAGE]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能が明示管理ヒープ配置化に失敗した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

CLASS_LIST

明示管理ヒープ上へ配置しようとしたオブジェクトの完全限定クラス名のリスト。リストが空の場合があります。

CLASS_METHOD

明示管理ヒープ配置化に失敗したクラスの完全限定名。より詳細な失敗個所を示すメソッド名も出力することがあります。

MESSAGE

明示管理ヒープ配置化に失敗した原因を示す詳細メッセージ。

normalの場合（明示管理ヒープ自動配置のスキップ）

出力形式

[ENA]ctime creation class's object in explicit memory is skipped. [
detail = MESSAGE]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能が明示管理ヒープ配置化をスキップした日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

MESSAGE

明示管理ヒープ配置化をスキップした原因を示す詳細メッセージ。

normalの場合（明示管理ヒープ機能適用除外クラス指定機能の設定ファイルオープンエラー）

出力形式

[ENO]ctime failed to open file. [TYPE] [file=FILENAME]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのオープンに失敗した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。

HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

TYPE

ファイルのオープンや読み込みに失敗した設定ファイルの種類を示します。

SYS:システムが設定している設定ファイル

USR:ユーザーがオプションで指定したファイルパスの設定ファイル

DEF:デフォルト配置場所にあるユーザー用の設定ファイル

FILENAME

ファイルのオープンに失敗した設定ファイルの名前(ディレクトリー名を含まない)。

normalの場合（明示管理ヒープ機能適用除外クラス指定機能の設定ファイルパースエラー ）

出力形式

[ENO]ctime parsed error line. [TYPE] [file=FILENAME line=LINENO]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能適用除外クラス指定機能の設定ファイルのパースに失敗した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

TYPE

ファイルのパースに失敗した設定ファイルの種類を示します。

SYS:システムが設定している設定ファイル

USR:ユーザーがオプションで指定したファイルパスの設定ファイル

DEF:デフォルト配置場所にあるユーザー用の設定ファイル

FILENAME

ファイルのパースに失敗した設定ファイルの名前(ディレクトリー名を含まない)。

LINENO

パースに失敗した行数。

verboseの場合（Explicitメモリーブロックの初期化 ）

出力形式

[EVO]ctime>[Created]["EM_NAME" eid=EID(EM_PTR)/EM_TYPE]

出力項目

出力項目

説明

ctime

Explicitメモリーブロック初期化の日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EM_NAME

初期化したExplicitメモリーブロック名。

Explicitメモリーブロック名にマルチバイト文字を含む場合の出力内容は未定義(通常文字化け)とします。

EID

初期化したExplicitメモリーブロックのID。

EM_PTR

Explicitメモリーブロック内部状態を示す値。

EM_TYPE

Explicit メモリーブロックのJava VM内部での種別を示します。

verboseの場合（Explicitメモリーブロックの初期化失敗 ）

出力形式

[EVO]ctime[Creation failed][EH: EH_USED(EH_GARB)/EH_TOTAL/EH_MAX]
[E/F/D: AC_NUM/FL_NUM/DA_NUM][Thread: TH_PTR]
[EVO][Thread: TH_PTR] at FRAMESOURCE
...

出力項目

出力項目

説明

ctime

Explicitメモリーブロック初期化失敗の日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED

Explicitメモリーブロック初期化失敗時の、Explicitヒープ利用済みサイズ。

EH_GARB

拡張用の出力項目であり、Explicitヒープの内部状態を示す（単位：キロバイト）。

EH_TOTAL

Explicitメモリーブロック初期化失敗時のExplicitヒープ確保済みサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

AC_NUM

Explicitメモリーブロック初期化失敗時の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

Explicitメモリーブロック初期化失敗時の、サブ状態がDisableである有効なExplicitメモリーブロック数。

TH_PTR

Explicitメモリーブロックの初期化に失敗したスレッドのスレッドID。スレッドダンプに出力するtidと同一。

FRAME

Explicitメモリーブロック初期化失敗時のスタックトレース中の1フレーム。完全クラス名とメソッド名がピリオド（.）で区切って出力されます。

SOURCE

FRAMEのメソッドが記述されているソースファイル名とスタックトレースと一致する行番号がコロン（:）で区切って出力されます。

ネイティブメソッドの場合は、(Native Method)、ソースファイル名が取得できない場合は、(Unknown Source)とします。

verboseの場合（Explicitメモリーブロックサブ状態のFreeList化 ）

出力形式

[EVO]ctime[Alloc failed(FreeList)]
[EH: EH_USED(EH_GARB)/EH_TOTAL/EH_MAX]
[E/F/D: AC_NUM/FL_NUM/DA_NUM][cause:CAUSE]
["EM_NAME" eid=EID/EM_TYPE: EM_USED(EM_GARB)/EM_TOTAL]
[Thread: TH_PTR]
[EVO][Thread: TH_PTR] at FRAMESOURCE
...

注

「[Thread: TH_PTR] [EVO][Thread: TH_PTR] at FRAMESOURCE」はNewの場合にだけ出力されます。

出力項目

出力項目

説明

ctime

EIDが示すExplicitメモリーブロックのサブ状態が、FreeList化した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED

EIDが示すExplicitメモリーブロックのサブ状態がFreeList化したときのExplicitヒープ利用済みサイズ（単位：キロバイト）。

EH_GARB

拡張用の出力項目であり、Explicitヒープの内部状態を示します。

EH_TOTAL

EIDが示すExplicitメモリーブロックのサブ状態がFreeList化したときのExplicitヒープ確保済みサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

AC_NUM

EIDが示すExplicitメモリーブロックのサブ状態がFreeList化した後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

EIDが示すExplicitメモリーブロックのサブ状態がFreeList化した後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

CAUSE

サブ状態のFreeList化の原因となった処理。 Newは、newInstance()などのExplicitヒープへのオブジェクト直接生成。GCはCopy GC、Full GCはFull GC時のExplicitヒープへの移動処理が原因であったことを示します。

EM_NAME

サブ状態がFreeListになったExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。また、Explicitメモリーブロックの初期化とほぼ同時に出力した場合やJava VMが内部で生成したExplicitメモリーブロックの場合は、NULLとなることがあります。

EID

サブ状態がFreeListになったExplicitメモリーブロックのID。

EM_TYPE

サブ状態がFreeListになったExplicitメモリーブロックのExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示します。

EM_USED

サブ状態がFreeListになったExplicitメモリーブロックの利用済みサイズ（単位：キロバイト）。

EM_GARB

拡張用の出力項目であり、Explicitメモリーブロックの内部状態を示します。

EM_TOTAL

サブ状態がFreeListになったExplicitメモリーブロックの確保済みサイズ（単位：キロバイト）。

TH_PTR

サブ状態のFreeList化の原因となったExplicitヒープへの生成を行なったスレッドのスレッドID。スレッドダンプに出力するtidと同一。

CAUSEがNewの場合にだけ出力。

FRAME

サブ状態のFreeList化の原因となったExplicitヒープへの直接生成のスタックトレースの1フレーム。完全クラス名とメソッド名がピリオド（.）で区切って出力されます。

CAUSEがNewの場合にだけ出力。

SOURCE

FRAMEのメソッドが記述されているソースファイル名とスタックトレースと一致する行番号をがコロン（:）で区切って出力されます。

ネイティブメソッドの場合は、(Native Method)、ソースファイル名が取得できない場合は、(Unknown Source)とします。

CAUSEがNewの場合にだけ出力されます。

verboseの場合（Explicitメモリーブロックサブ状態のDisable化 ）

出力形式

[EVO]ctime[Alloc failed(Disable)]
[EH: EH_USED(EH_GARB)/EH_TOTAL/EH_MAX]
[E/F/D: AC_NUM/FL_NUM/DA_NUM][cause:CAUSE]
["EM_NAME" eid=EID/EM_TYPE: EM_USED(EM_GARB)/EM_TOTAL]
[Thread: TH_PTR]
[EVO][Thread: TH_PTR] at FRAMESOURCE
...

注

「TH_PTR] at FRAMESOURCE」はNewの場合にだけ出力されます。

出力項目

出力項目

説明

ctime

EIDが示すExplicitメモリーブロックのサブ状態がDisable化した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED

EIDが示すExplicitメモリーブロックのサブ状態がDisable化したときのExplicitヒープ利用済みサイズ（単位：キロバイト）。

EH_GARB

拡張用の出力項目であり、Explicitヒープの内部状態を示します。

EH_TOTAL

EIDが示すExplicitメモリーブロックのサブ状態がDisable化したときのExplicitヒープ確保済みサイズ（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

AC_NUM

EIDが示すExplicitメモリーブロックのサブ状態がDisable化した後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

EIDが示すExplicitメモリーブロックのサブ状態がDisable化した後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

CAUSE

サブ状態のDisable化の原因となった処理。

Newは、newInstance()などのExplicitヒープへのオブジェクト直接生成。GCはCopy GC、Full GCはFull GC時のExplicitヒープへの移動処理が原因であったことを示します。

EM_NAME

サブ状態がDisableになったExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。また、Explicitメモリーブロックの初期化とほぼ同時に出力した場合やJava VMが内部で生成したExplicitメモリーブロックの場合は、NULLとなることがあります。

EID

サブ状態がDisableになったExplicitメモリーブロックのID。

EM_TYPE

サブ状態がDisableになったExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示します。

EM_USED

サブ状態がDisableになったExplicitメモリーブロックの利用済みサイズ（単位：キロバイト）。

EM_GARB

拡張用の出力項目であり、Explicitメモリーブロックの内部状態を示します。

EM_TOTAL

サブ状態がDisableになったExplicitメモリーブロックの確保済みサイズ（単位：キロバイト）。

TH_PTR

サブ状態のDisable化の原因となったExplicitヒープへの生成を行なったスレッドのスレッドID。スレッドダンプに出力するtidと同一。

CAUSEがNewの場合にだけ出力。

FRAME

サブ状態のFreeList化の原因となったExplicitヒープへの直接生成のスタックトレースの1フレーム。完全クラス名とメソッド名がピリオド（.）で区切って出力されます。

CAUSEがNewの場合にだけ出力。

SOURCE

FRAMEのメソッドが記述されているソースファイル名とスタックトレースと一致する行番号がコロン（:）で区切って出力されます。

ネイティブメソッドの場合は、(Native Method)、ソースファイル名が取得できない場合は、(Unknown Source)とします。

CAUSEがNewの場合にだけ出力されます。

verboseの場合（Explicitメモリーブロックへのオブジェクト生成 ）

出力形式

[EVS]ctime[EH: EH_USED_BF->EH_USED_AF(EH_TOTAL/EH_MAX)]
[E/F/D: AC_NUM/FL_NUM/DA_NUM][cause:CAUSE]
["EM_NAME" eid=EID/EM_TYPE: EM_USED_BF->EM_USED_AF(EM_TOTAL)]

出力項目

出力項目

説明

ctime

オブジェクト生成の日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EH_USED_BF

オブジェクト生成前の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_USED_AF

オブジェクト生成後の、Explicitヒープ利用済みサイズ（単位：キロバイト）。

EH_TOTAL

オブジェクト生成後の、確保済みExplicitヒープサイズを示す（単位：キロバイト）。

EH_MAX

Explicitヒープ最大サイズ（単位：キロバイト）。

AC_NUM

オブジェクト生成後の、サブ状態がEnableである有効なExplicitメモリーブロック数。

FL_NUM

拡張用の出力項目であり、常に0を示します。

DA_NUM

オブジェクト生成後の、サブ状態がDisableである有効なExplicitメモリーブロック数。

CAUSE

必ずNewと出力されます。Explicitメモリーブロックへのオブジェクト生成が、Javaプログラムから行われたことを示します。

EM_NAME

オブジェクトを生成したExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。また、Explicitメモリーブロックの初期化とほぼ同時に出力した場合やJava VMが内部で生成したExplicitメモリーブロックの場合は、NULLとなることがあります。

EID

オブジェクトを生成したExplicitメモリーブロックのID。

EM_TYPE

オブジェクトを生成したExplicitメモリーブロックのExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示します。

EM_USED_BF

オブジェクト生成前の、生成先Explicitメモリーブロックの利用済みサイズ（単位：キロバイト）。

EM_USED_AF

オブジェクト生成後の、生成先Explicitメモリーブロックの利用済みサイズ（単位：キロバイト）。

EM_TOTAL

オブジェクト生成後の、生成先Explicitメモリーブロックの確保済みサイズ（単位：キロバイト）。

verboseの場合（Explicitメモリーブロックへの移動の詳細 ）

出力形式

normalの場合（GC時のExplicitヒープの利用状況）の出力情報
[EVS]{["EM_NAME" eid=EID/EM_TYPE: EM_USED_BF->EM_USED_AF(EM_TOTAL)]}{1,5}
...

注

Explicitメモリーブロックの情報が5個出力されるごとに改行されます。

出力項目

出力項目

説明

GC時のExplicitヒープの利用状況の出力情報

normalの場合（GC時のExplicitヒープの利用状況）の出力項目と同じです。

EM_NAME

GCでのオブジェクト移動先となったExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。また、Explicitメモリーブロックの初期化とほぼ同時に出力した場合やJava VMが内部で生成したExplicitメモリーブロックの場合は、NULLとなることがあります。

EID

GCでのオブジェクト移動先となったExplicitメモリーブロックのID。

EM_TYPE

GCでのオブジェクト移動先となったExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示し、RまたはAが出力されます。

EM_USED_BF

GCでのオブジェクト移動先となったExplicitメモリーブロックの、GC前の利用済みサイズ（単位：キロバイト）。

EM_USED_AF

GCでのオブジェクト移動先となったExplicitメモリーブロックの、GC後の利用済みサイズ（単位：キロバイト）。

EM_TOTAL

GCでのオブジェクト移動先となったExplicitメモリーブロックの、GC後の確保済みサイズ（単位：キロバイト）。

verboseの場合（Explicitメモリーブロック解放処理の詳細）

出力形式

normalの場合（Explicitメモリーブロック解放処理）の出力情報
[EVS]{["EM_NAME" eid=EID/EM_TYPE: EM_TOTAL]}{1,5}
...

注

Explicitメモリーブロックの情報が5個出力されるごとに改行されます。

出力項目

出力項目

説明

normalの場合（Explicitメモリーブロック解放処理）の出力情報

normalの場合（Explicitメモリーブロック解放処理）の出力項目と同じです。

EM_NAME

解放したExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。

EID

解放したExplicitメモリーブロックのID。

EM_TYPE

解放したExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示します。

EM_TOTAL

解放したExplicitメモリーブロックの確保済みだったサイズ(解放サイズ)（単位：キロバイト）。

verboseの場合（ファイナライザーによるExplicitメモリーブロックの解放予約）

出力形式

[EVO]ctime[Finalized]["EM_NAME" eid=EID/EM_TYPE: EM_TOTAL]

出力項目

出力項目

説明

ctime

解放予約の日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

EM_NAME

解放予約したExplicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。

EID

解放予約したExplicitメモリーブロックのID。

EM_TYPE

解放予約したExplicitメモリーブロックの種別。

ExplicitメモリーブロックのJava VM内部での種別を示します。

EM_TOTAL

解放予約したExplicitメモリーブロックの確保済みだったサイズ(解放サイズ)（単位：キロバイト）。

verboseの場合（明示管理ヒープ自動配置化）

出力形式

[EVA]ctime creation in explicit memory is succeeded. [class=CLASSNAME]

出力項目

出力項目

説明

ctime

明示管理ヒープ機能が指定のクラスの明示管理ヒープ配置化に成功した日時。拡張verbosegc機能で出力しているものと同一の時刻形式。HitachiOutputMilliTimeオプションが有効な場合、ミリ秒単位まで出力されます。

CLASSNAME

明示管理ヒープ配置化に成功したクラスの完全修飾クラス名。

debugの場合（Explicitメモリーブロック解放によるJavaヒープへのオブジェクト移動）

出力形式

[EDO][eid=EID: Reference to REFED_NAME(REFED_PTR), total R_SIZE]
[EDO]   REF_NAME(REF_PTR)REF_GEN

出力項目

出力項目

説明

EID

Explicitメモリーブロック解放処理時に、解放対象Explicitヒープ以外から参照されているオブジェクトを持つExplicitメモリーブロックのID。

REFED_NAME

Explicitメモリーブロック解放処理時に、解放対象Explicitヒープ以外のオブジェクト(REF_NAME(REF_PTR))から参照されているオブジェクトの完全クラス名。

REFED_PTR

REFED_NAMEが示すオブジェクトのメモリーアドレス(Javaヒープへの移動前)。

R_SIZE

REF_NAME(REF_PTR)からの参照によって、Javaヒープへ戻ることになるオブジェクトの総サイズ。

REF_NAME(REF_PTR)から間接参照している、解放対象Explicitメモリーブロック内オブジェクトを含めた値（単位：キロバイト）。

REF_NAME

REFED_NAME(REFED_PTR)への参照を持つオブジェクトの完全クラス名。ただし、REFED_NAME(REFED_PTR)への参照が、スタックやJava VM内部からの場合は、JVMとします。

REF_PTR

REF_NAMEのメモリーアドレス。

REF_GEN

REF_NAME(REF_PTR)の属する領域名(または世代名)。

Explicitメモリーブロックの場合は、eid出力されます。スタックやJava VM内部から参照されている場合はJVMとします。

New領域については、マイナーGCにシリアルガーベジコレクターを使用している場合はDefNewとなります。

debugの場合（Explicitメモリーブロックの初期化の詳細）

出力形式

verboseの場合（Explicitメモリーブロックの初期化 ）の出力情報
[Thread: TH_PTR]
[EDO][Thread: TH_PTR] at FRAMESOURCE
...

出力項目

出力項目

説明

verboseの場合（Explicitメモリーブロックの初期化 ）の出力情報

verboseの場合（Explicitメモリーブロックの初期化）の出力項目と同じです。

TH_PTR

Explicitメモリーブロックを初期化したスレッドのスレッドID。スレッドダンプに出力するtidと同じです。

FRAME

Explicitメモリーブロック初期化時のスタックトレース中の1フレーム。完全クラス名とメソッド名がピリオド（.）で区切って出力されます。

SOURCE

FRAMEのメソッドが記述されているソースファイル名とスタックトレースと一致する行番号がコロン（:）で区切って出力されます。

ネイティブメソッドの場合は、(Native Method)、ソースファイル名が取得できない場合は、(Unknown Source)とします。

debugの場合（Explicitメモリーブロックのマイグレート処理の詳細）

出力形式

normalの場合（Explicitメモリーブロックのマイグレート処理）の出力情報
[EDO][migrate:(EID_DEL{,EID_DEL}*|)/(EID_MBF{,
EID_MBF}*->EID_MAF|)/(EID_MIG{,EID_MIG}*|)]

出力項目

出力項目

説明

normalの場合（Explicitメモリーブロックのマイグレート処理）の出力情報

normalの場合（Explicitメモリーブロックのマイグレート処理）の出力項目と同じです。

EID_DEL

Explicitメモリーブロックのマイグレート処理で解放されるExplicitメモリーブロックのうち、オブジェクトの移動が発生しなかったExplicitメモリーブロックのID。

EID_MBF

Explicitメモリーブロックのマイグレート処理で解放されるExplicitメモリーブロックのうち、多対１のマイグレートが行われたExplicitメモリーブロックのマイグレート選択される前のID。

EID_MAF

Explicitメモリーブロックのマイグレート処理で生成されるExplicitメモリーブロックのID。

EID_MIG

Explicitメモリーブロックのマイグレート処理で解放されるExplicitメモリーブロックのID。

スレッドダンプログ

Java VM のスレッドダンプ情報の構成を次の表に示します。

出力項目

説明

ヘッダー

日付および時刻、Java VMバージョン情報、起動コマンドラインを出力します。

システム設定

次の情報を出力します。

JDKの実行環境のインストール場所を表すJavaホームパス

JDKを構成するライブラリーのインストールディレクトリーを表すJava DLLパス

システムクラスパス

javaコマンドオプション

動作環境

次の情報を出力します。

ホスト名

OSバージョン

CPU情報

リソース情報

Javaヒープ情報

Javaヒープの各世代のメモリ使用状況を出力します。

Cヒープマップ情報

Java VM自身の確保しているメモリの領域情報を出力します。

Cヒープサイズ情報

Java VM自身の確保しているメモリのサイズ情報を出力します。

アプリケーション環境

次の情報を出力します。

シグナルハンドラー

環境変数

ライブラリー情報

ローディングされているライブラリーの情報を出力します。

スレッド情報

スレッド1

：

スレッドn

スレッドごとにスレッド情報を出力します。

Javaモニターダンプ

Javaモニターオブジェクトの一覧を表示します。

JNIグローバル参照情報

Java VMが保持しているJNIのグローバル参照の数を出力します。

Explicitヒープ情報(-XX:+HitachiUseExplicitMemoryが有効な場合)

明示管理ヒープ機能使用時には、Java プロセスのクラスごとに次の情報を出力します。

Explicit ヒープ全体の利用状況

Explicit メモリーブロックごとの利用状況

また、明示管理ヒープ機能使用時に、eheapprofコマンドを実行すると、Explicitメモリーブロック内のオブジェクトの統計情報、およびExplicit メモリーブロックの解放率情報を出力します。

クラス別統計情報

jheapprofコマンドで指定したJavaプロセスのクラスごとに次の情報を出力します。

インスタンスがメンバーとして持つインスタンスの合計サイズ、およびインスタンスの参照関係

static メンバーが持つインスタンスの合計サイズ

Tenured領域の増加原因となるオブジェクトのクラス、およびインスタンスの合計サイズ

フッター

スレッドダンプが終了した時刻を表示します。

各項目の出力形式を記載します。

ヘッダー

出力形式

EEE MMM dd hh:mm:ss yyyy

Full thread dump Java HotSpot(TM) VM type
(Oracleバージョン情報-Developer's Kit for Javaバージョン情報-ビルド年月日 mixed mode)
コマンドライン

注

EEEは曜日、MMMは月、ddは日を示します。

出力項目

出力項目

説明

VM type

Client VM、Server VMまたは64-Bit Server VM。

Oracleバージョン情報

ベースとなるOracle製JDKのバージョン。

25.20-b23。

Developer's Kit for Javaバージョン情報

Developer's Kit for Javaバージョン情報のバージョン。

HJDK1010ZZ。

(ZZは修正番号。正規版はなし。)

ビルド年月日

製品をビルドした年月日。

コマンドライン

VM起動時のコマンドライン。

システム設定

出力形式

System Properties
-----------------
Java Home Dir	: Developer's Kit for Java実行環境のインストールディレクトリー
Java DLL Dir	: Developer's Kit for Javaライブラリーのインストールディレクトリー
Sys Classpath	: システムクラスパス
User Args	:
コマンドオプション1
コマンドオプション2
…

出力項目

出力項目

説明

Developer's Kit for JavaJDK実行環境のインストールディレクトリー

Developer's Kit for Javaの実行環境のインストール場所を表すJavaホームパスが表示されます。

Developer's Kit for Javaライブラリーのインストールディレクトリー

Developer's Kit for Javaを構成するライブラリーのインストールディレクトリーを表すJava DLLパスを表示されます。

システムクラスパス

システムクラスパスが出力されます。

コマンドオプション

Javaコマンドオプションが出力されます。

動作環境

出力形式

Linux/EM64T 版では次のように出力されます。

Operating Environment
---------------------
Host	: ホスト名:IPアドレス
OS	: OSバージョン
CPU	: CPU種別, 利用可能CPU数/システム全体のCPU数 active

Resource Limits –
        RLIMIT_CPU              : プロセスで使用可能な秒数
        RLIMIT_FSIZE            : 最大ファイルサイズ(単位：バイト)
        RLIMIT_DATA             : malloc可能なサイズ(単位：バイト)
        RLIMIT_STACK            : スタックの最大サイズ(単位：バイト)
        RLIMIT_CORE             : coreの最大サイズ(単位：バイト)
        RLIMIT_RSS              : プロセスの常駐サイズ(単位：バイト)
        RLIMIT_NOFILE           : 最大のファイルディスクリプター値
        RLIMIT_AS               : プロセストータルの利用可能メモリー(単位：バイト)
        RLIMIT_NPROC            : プロセスの最大数
        RLIMIT_MEMLOCK          : ロック可能なメモリーサイズ(単位：バイト)

AIX 版では次のように出力されます。

Operating Environment
---------------------
Host	: ホスト名:IPアドレス
OS	: OSバージョン
CPU	: CPU種別※, 利用可能CPU数/システム全体のCPU数 active

Resource Limits –
        RLIMIT_CPU              : プロセスで使用可能な秒数
        RLIMIT_FSIZE            : 最大ファイルサイズ(単位：バイト)
        RLIMIT_DATA             : malloc可能なサイズ(単位：バイト)
        RLIMIT_STACK            : スタックの最大サイズ(単位：バイト)
        RLIMIT_CORE             : coreの最大サイズ(単位：バイト)
        RLIMIT_RSS              : プロセスの常駐サイズ(単位：バイト)
        RLIMIT_AS               : プロセストータルの利用可能メモリー(単位：バイト)
        RLIMIT_NOFILE           : 最大のファイルディスクリプター値

出力項目

Linux/EM64T版の出力項目を次に示します。

出力項目

説明

ホスト名

マシン名。

IPアドレス

マシンのIPアドレス。複数ある場合は、コンマ（,）で区切って出力されます。

OSバージョン

次の情報を出力します。

OS名バージョンリリース

OS名

Linuxと出力されます。

UNIXコマンドのuname -s-と同等の情報が出力されます。

バージョン

バージョン情報。

UNIXコマンドのuname -vと同等の情報が出力されます。

リリース

リリース情報。

UNIXコマンドのuname -rと同等の情報が出力されます。

CPU種別

CPU名が出力されます。

UNIXコマンドのuname -mと同等の情報が出力されます。

利用可能CPU数

利用可能な論理CPUの数が出力されます。

システム全体のCPU数

搭載している論理CPUの数が出力されます。

AIX 版の出力項目を次に示します。

出力項目

説明

ホスト名

マシン名。

IPアドレス

マシンのIPアドレス。複数ある場合は、コンマ（,）で区切って出力されます。

OSバージョン

次の情報を出力します。

OS名バージョンリリース

CPU種別※

既知のCPUの場合：CPU名が出力されます。

未知のCPUの場合：unknown (ARCH architecture:VER)と出力されます。

ARCH

次のどれかが出力されます。

・Power Classic

・Power PC

・Intel IA64

・unknown

VER

CPUのバージョン番号(_system_configuration.version)が16進数で出力されます。

利用可能CPU数

利用可能な論理CPUの数が出力されます。

システム全体のCPU数

搭載している論理CPUの数が出力されます。

注※

AIXのCPU種別について

AIXで出力するCPU種別は、Power PC 4やPower PC 5のようにCPU名を出力します。しかし、今後開発されるCPUについては、現段階ではCPUを識別するためのバージョン値が不明であるため、CPU名を出すことができません。そこでCPUのバージョン値が不明の場合は、CPU情報の出力を以下にすることで、CPUの種別を判断できる情報を出します。

CPU	: unknown (Power PC architecture:CPUバージョン値),
利用可能CPU数/システム全体のCPU数

CPUバージョン値	: _system_configuration.versionの値を16進数で表した値。

_system_configurationはAIXのシステム変数であり、_system_configuration.versionはプロセッサーのバージョンを表します。_system_configurationは/usr/include/sys/systemcfg.hで宣言されています。

Javaヒープ情報

出力形式

Heap Status
-----------
def new generation   max max size, total capacity, used size
(max usage% used/max, total usage% used/total)
                      [bottom, commit addr, reserve addr)
  eden space capacity,  usage% used [bottom,
top, reserve addr)
  from space capacity,   usage% used [bottom,
top, reserve addr)
  to   space capacity,   usage% used [bottom,
top, reserve addr)
tenured generation   max max size, total capacity>, used size
(max usage% used/max, total usage% used/total)
                      [bottom, commit addr, reserve addr)
   the space capacity,  usage% used [bottom, top,
used block, reserve addr)
Metaspace       max max size, capacity capacity words,
committed committed size,
reserved reserve size, used size
(max usage% used/max, total usage% used/committed)
  class space    max max size, capacity capacity words,
committed committed size,reserved reserve size, used size
(max usage% used/max, total usage% used/committed)
                [bottom, top, commit addr,
reserve addr)

出力項目

出力項目

説明

max size

最大の容量（単位：キロバイト）。Metaspaceについては-XX:MaxMetaspaceSizeが未指定の場合は Metaspaceの最大値は無制限であるため、最大の容量はunlimitedが出力されます。

capacity

現在の容量（単位：キロバイト）。

capacity words

Metaspaceのコミット済みのメモリー領域からフリー領域を除いた合計サイズ（単位：キロバイト）。

committed size

Metaspaceのコミット済みの合計メモリーサイズ（単位：キロバイト）。

reserve size

予約済みのメモリーサイズ（単位：キロバイト）。

size

使用中のメモリーサイズ（単位：キロバイト）。

max usage

最大の容量に対する使用率。Metaspaceについては-XX:MaxMetaspaceSizeが未指定の場合は Metaspaceの最大値は無制限であるため、最大の容量に対する使用率は-%が出力されます。

total usage

現在の容量に対する使用率。

bottom

領域先頭アドレス。

top

使用中領域の先頭アドレス。

commit addr

コミット済み領域の末尾アドレス。

reserve addr

予約済み領域の末尾アドレス。

usage

使用率。

used block

次の空きブロックの先頭アドレス。

Java VM内部メモリーマップ情報

出力形式

JVM Internal Memory Map
-----------------------
メモリー確保関数	:address = 開始アドレス - 終了アドレス ( size: サイズ)
…

出力項目

出力項目

説明

メモリー確保関数

mmap()かmalloc()のどれかです。アドレスは16進数で表記されます。

Java VM内部メモリーサイズ情報

出力形式

JVM Internal Memory Status
--------------------------
  Heap Size	:確保しているメモリーサイズ（単位：バイト）
  Alloc Size	:使用中のメモリーサイズ（単位：バイト）
  Free Size	:未使用のメモリーサイズ（単位：バイト）

アプリケーション環境

出力形式

Application Environment
-----------------------
Signal Handlers -
シグナル種別： [シグナルハンドラーアドレス], sa_mask[0]=シグナルマスク, sa_flags=特殊フラグ
：

Changed Signal Handlers -
シグナル種別： [シグナルハンドラーアドレス], sa_mask[0]=シグナルマスク, sa_flags=特殊フラグ
：

Environment Variables –
環境変数=値

Current Directory –
  /opt/Cosminexus/CC/server/…：カレントディレクトリー

出力項目

出力項目

説明

シグナル種別

/usr/include/sys/signal.hに定義されているシグナル名（例：SIGSEGV、SIGBUSなど）。

シグナルハンドラーアドレス

シグナルハンドラーのアドレス。ライブラリー名＋オフセットという形式で表示されることもある。16進数で出力されます。

シグナルマスク

sigaction()で取り出せる構造のsa_maskフィールド値。16進数で出力されます。

特殊フラグ

sigaction()で取り出せる構造のsa_flagsフィールド値。16進数で出力されます。

ライブラリー情報

出力形式

AIX

Loaded Libraries
----------------
Dynamic libraries:
コマンド
	text	:開始アドレス-終了アドレス (サイズ)
	data	:開始アドレス-終了アドレス (サイズ)
ライブラリー
	text	:開始アドレス-終了アドレス (サイズ)
	data	:開始アドレス-終了アドレス (サイズ)
...

スレッド情報

出力形式

Stack Trace
-----------

"スレッド名" #スレッド識別子 daemon prio=優先度 os_prio=OS優先度 jid=ハッシュ値 tid=スレッドID
nid=native ID status [開始アドレス..終了アドレス][改行]
    java.lang.Thread.State: スレッドの現在のステータス

    stack=[スタック開始アドレス..YellowPageアドレス..
RedPageアドレス..スタック終了アドレス][改行]
    [user cpu time=ユーザー時間ms, kernel cpu time=カーネル時間ms]
[blocked count=ブロック回数, waited count=待機回数][改行]
         at クラス名.メソッド名(メソッド種別)
         ...

出力項目

出力項目

説明

スレッド名

Threadクラスのコンストラクターに指定されたスレッド名。

スレッド識別子

Javaスレッドが作成されたときに生成される一意の数字。

java.lang.Thread.getId()で得られる値と同じです。

daemon

デーモンスレッドである場合にdaemonと出力されます。

優先度

Thread#setPriorityで設定された優先度。

OS優先度

OSレベルの優先度。優先順位が設定できないOSではすべて0が出力されます。

ハッシュ値

16進8桁の数値。スレッドオブジェクトに対して、System.identityHashCode()を呼び出して得られる値と同一の値です。ただし、そのオブジェクトに対してハッシュ値が割りついていない場合には、<N/A>を出力します。非Javaスレッドに対しては出力しません。

スレッドID

スレッドオブジェクトのメモリー上のアドレス。

native ID

OSレベルのスレッドID。

status

スレッドのステータス。

次の値を出力します。

runnable

実行可能状態

waiting on condition

notify待ち

waiting for monitor entry

synchronizedロック取得待ち

suspendまたはsleeping

実行中断状態

スレッドの現在のステータス

スレッドの現在のステータスを表すメッセージが出力されます。メッセージの内容はjava.lang.Thread.State列挙型に対応します。非Javaスレッドに対しては出力しません。

スタック開始アドレス

スタック開始アドレス。16進数で出力されます。非Javaスレッドに対しては出力しません。

YellowPage アドレス

スタックYellowガードページ先頭アドレス。16進数で出力されます。非Javaスレッドに対しては出力しません。

RedPage アドレス

スタックRedガードページ先頭アドレス。16進数で出力されます。非Javaスレッドに対しては出力しません。

スタック終了アドレス

スタック終了アドレス。16進数。非Javaスレッドに対しては出力しません。

開始アドレス

Javaフレームの最高位スタックアドレス。16進数で出力されます。

終了アドレス

JavaLockのある最高位スタックアドレス。16進数で出力されます。

ユーザー時間

スレッド開始からのユーザー時間（単位：ミリ秒）。時間が取得できない環境の場合は出力しません。また、非Javaスレッドに対しても出力しません。

ユーザー時間の取得に失敗した場合は、次のようにunknownを表示します。

[user cpu time=unknown, kernel cpu time=カーネル時間ms]

カーネル時間

スレッド開始からのカーネル時間。単位はミリ秒。時間が取得できない環境の場合、出力しません。また、非Javaスレッドに対しても出力しません。

ブロック回数

スレッド開始からの、処理がブロックされた回数。非Javaスレッドに対しては出力しません。

待機回数

スレッド開始からの、処理が待ち状態にあった回数。非Javaスレッドに対しては出力しません。

クラス名

クラス名。

メソッド名

メソッド名。

メソッド情報

ネイティブメソッドの場合

Native Method

Javaメソッドで行番号付きでコンパイルされている場合

ファイル名：行番号

Javaメソッドで行番号無しでコンパイルされている場合

Unknown Source

Javaモニターダンプ

出力形式

Java monitor
------------
ロックオブジェクト@ハッシュコード オーナー情報
   待機状態:待機スレッド数
      待機スレッド情報

出力項目

出力項目

説明

ロックオブジェクト

ロック対象オブジェクトのクラス名が出力されます。

ハッシュコード

Object.hashCodeで得られるハッシュコード。

オーナー情報

オーナーがある場合

owner スレッド名スレッドオブジェクトアドレス

オーナーが無い場合

no owner

待機状態

synchronizedブロック/メソッド実行待ちの場合

waiting to enter

notify 待ちの場合

waiting to be notified

待機スレッド情報

次のように出力されます。

スレッド名スレッドオブジェクトアドレス

Rawモニターダンプ

出力形式

Raw monitor dump
----------------
モニター名 モニターアドレス owner "スレッド名" スレッドアドレス
　　以下はJavaモニターダンプの出力項目と同じです。

出力項目

出力項目

説明

モニター名

ロック対象モニター名。

モニターアドレス

モニターのアドレス。

スレッド名

モニターのロック取得スレッド名。

スレッドアドレス

オーナースレッドのスレッドアドレス。

JNIグローバル参照情報

出力形式

JNI Information
---------------
JNI global references: JNIグローバル参照数

出力項目

出力項目

説明

JNIグローバル参照数

Java VMが保持しているグローバル参照の数が出力されます。

Explicitヒープ情報(-XX:+HitachiUseExplicitMemoryが有効な場合)

出力形式（Explicitメモリブロックのオブジェクト解放率情報が無効な場合）

Explicit Heap:
 max EH_MAX, total EH_TOTAL, used EH_USED, garbage EH_GARB
(EH_PER1 used/max, EH_PER2
used/total, EH_PER3 garbage/used), EM_NUMS spaces exist
 Explicit Memories(EM_MGR_PTR)・・・・・・・・・・・・・・・・・・・・・・・・※1
  "EM_NAME" eid=EID(EM_PTR)/EM_TYPE, total EM_TOTAL,
used EM_USED, garbage EM_GARB
(EM_PER1 used/total, EM_PER2 garbage/used) EM_STAT・・・・・・・・・・・※2
    deployed objects
    ________________Size__Instances__Class________________
                 ISIZE     INUM CNAME
                 ...
                AISIZE    AINUM total・・・・・・・・・・・※3

注※1

「Explicit Heap：」から「（EM_MGR_PTR）」までがExplicitヒープ情報です。

注※2

「EM_NAME」から「EM_STAT」までがExplicitメモリーブロック情報です。

注※3

ISIZE、INUM、CNAME、AISIZE、AINUMはExplicitメモリブロック内のオブジェクト統計情報です。

出力形式の補足事項

Explicitヒープ情報とExplicitメモリブロック情報の間には、空行が1行あります。

Explicitメモリブロック情報の出力順序(どのExplicitメモリブロックから出力するか)は未定義とします。

EM_NAMEの前には、半角2文字分の空白があります。

deployed objectsの前には、半角4文字分の空白があります。

ISIZEは、________________Size_のeに行末をそろえます。

INUMは、__Instancesの最後のsに行末をそろえます。

最後の行には空行が1行あります。したがって、Explicitメモリブロックごとの出力の間には空行が1行あります。

出力形式（Explicitメモリブロックのオブジェクト解放率情報が有効な場合）

Explicit Heap Status
--------------------
 max EH_MAX, total EH_TOTAL, used EH_USED,
garbage EH_GARB (EH_PER1 used/max, EH_PER2
used/total, EH_PER3 garbage/used), EM_NUMS spaces exist

 Explicit Memories(EM_MGR_PTR)・・・・・・・・・・・・・・・・・・・・・・・・※1

  "EM_NAME" eid=EID(EM_PTR)/EM_TYPE, total EM_TOTAL,
used EM_USED, garbage EM_GARB
(EM_PER1 used/total, EM_PER2 garbage/used, FL_BLOCKS blocks)
EM_STAT・・・・・・・・・・・※2
    deployed objects
    ________________Size__Instances__FreeRatio__Class________________
                 ISIZE     INUM   FRATIO※4 CNAME
                 ...
                AISIZE    AINUM total・・・・・・・・・・・※3

注※1

「Explicit Heap：」から「（EM_MGR_PTR）」までがExplicitヒープ情報です。

注※2

「EM_NAME」から「EM_STAT」までがExplicitメモリーブロック情報です。

注※3

ISIZE、INUM、CNAME、AISIZE、AINUMはExplicitメモリブロック内のオブジェクト統計情報です。

注※4

FRATIOはExplicitメモリブロックのオブジェクト解放率情報です。

出力形式の補足事項

FRATIOは、__FreeRatio__のoに行末をそろえます。

出力項目

Explicitヒープ情報の出力項目を次に示します。

出力項目

説明

EH_MAX

Explicitヒープの最大サイズ（単位：キロバイト）。

EH_TOTAL

確保済みExplicitヒープサイズ（単位：キロバイト）。

EH_USED

利用済みExplicitヒープサイズ（単位：キロバイト）。

EH_GARB

拡張用の出力項目であり、Explicitヒープの内部状態を示します。

EH_PER1

Explicitヒープ利用率(EH_USED/EH_MAX)。

EH_PER2

Explicitヒープ利用率(EH_USED/EH_TOTAL)。

EH_PER3

拡張用の出力項目であり、Explicitヒープの内部状態を示します。

EM_NUMS

有効なExplicitメモリーブロックの数。

EM_MGR_PTR

Explicitヒープ制御のための内部情報があるメモリーアドレス。

Explicitメモリーブロック情報の出力形式を次に示します。

出力項目

説明

EM_NAME

Explicitメモリーブロック名。

Explicitメモリーブロック名に多バイト文字を含む場合の出力内容は未定義(通常文字化け)とします。また、Explicitメモリーブロックの初期化とほぼ同時に出力した場合やJava VMが内部で生成したExplicitメモリーブロックの場合は、NULLとなることがあります。

EID

ExplicitメモリーブロックのID。

EM_PTR

Explicitメモリーブロック内部構造があるメモリーアドレス。

EM_TYPE

Explicitメモリーブロックの種別。

出力される値を次に示します。

R｜B｜A

EM_TOTAL

Explicitメモリーブロックのメモリー確保済みサイズ（単位：キロバイト）。

EM_USED

Explicitメモリーブロックの利用済みサイズ（単位：キロバイト）。

EM_GARB

拡張用の出力項目で、Explicitメモリーブロックの内部状態を示します。

EM_PER1

Explicitメモリーブロック利用率(EM_USED/EM_TOTAL)がパーセント表記されます。

EM_PER2

拡張用の出力項目で、Explicitメモリーブロックの内部状態を示します。

FL_BLOCKS

拡張用の出力項目で、常に0を示します。

EM_STAT

Explicitメモリーブロックのサブ状態。

Explicitメモリブロック内のオブジェクト統計情報の出力形式を次に示します。

出力項目

説明

ISIZE

あるクラスをインスタンス化したオブジェクトの、Explicitメモリブロック内のサイズ。

INUM

あるクラスをインスタンス化したオブジェクトの、Explicitメモリブロック内の個数。

CNAME

ISIZEおよびINUMが示すクラスの完全クラス名。

AISIZE

Explicitメモリブロック内の全オブジェクトの合計サイズ。

AINUM

Explicitメモリブロック内の全オブジェクトの個数。

Explicitメモリブロックのオブジェクト解放率情報の出力形式を次に示します。

出力項目

説明

FRATIO

xplicit メモリブロックの自動解放処理で解放されたオブジェクトの割合（オブジェクト解放率）（単位：%）。

オブジェクト解放率=（自動解放処理前のクラスのオブジェクト数−自動解放処理後のクラスのオブジェクト数）／自動解放処理前のクラスのオブジェクト数×100

なお、オブジェクト解放率情報出力時に、自動解放処理の対象とならなかったExplicitメモリブロックには、「−」が出力されます。

クラス別統計情報

出力形式

Java Heap Profile
-----------------------
________________Size__Instances__Class________________
   total_size       Instance_count   class_name
   total_size       Instance_count   class_name
…

出力項目

出力項目

説明

total_size

インスタンスサイズの合計(単位：バイト)。

Instance_count

インスタンス数。

class_name

クラス名。

フッター

出力形式

Full thread dump completed.   EEE MMM dd hh:mm:ss yyyy

注

EEEは曜日、MMMは月、ddは日を示します。

プロセス起動時ログ

出力形式

メッセージログと同じです。

出力項目

メッセージログと同じです。

WebSocketアクセスログ

WebSocketアクセスログは、asadminユーティリティーコマンドのset-log-attributesサブコマンドのServerInstance.websocket_access_log.formatパラメーターで出力フォーマットを指定できます。

出力形式

デフォルトの設定の場合、次のフォーマットで出力されます。

%TS% %IO% %OPCODE% %URI% %FIN% %CLOSEREASON% %PAYLOADDATALEN% %ROOTAP% %CLIENTAP%

出力項目

出力項目

説明

デフォルト設定時の出力

%TS%

WebSocketフレームの送受信時刻。yyyy/mm/dd hh:mm:ss.sss GMT時差の形式で出力されます。

○

%CLIENTADDR%

WebSocket通信を実施しているサーバインスタンスに接続しているクライアントのIPアドレスおよびポート番号。

−

%SERVERADDR%

WebSocket通信を実施しているサーバインスタンスのIPアドレスおよびポート番号。

−

%IO%

WebSocketフレームの送受信方向。

IN：サーバインスタンスがWebSocketフレームを受信したことを示します。

OUT：サーバインスタンスがWebSocketフレームを送信したことを示します。

○

%URI%

リクエストURI。

○

%ROOTAP%

ルートアプリケーション情報。

○

%CLIENTAP%

クライアントアプリケーション情報。

○

%OPCODE%

WebSocketフレームの種別。

Text、Binary、Ping、Pong、またはCloseが出力されます。

○

%FIN%

WebSocketフレームの終端を示す識別子。

分割されたメッセージを送受信する場合、最後のWebSocketフレームにFINAL（終端）が設定され、最後のWebSocketフレームを送受信するまではCONT（継続）が設定されます。

CONT：WebSocketフレームの継続

FINAL：WebSocketフレームの終端

○

%PAYLOADDATALEN%

ペイロードデータ長。

○

%MASK%

ペイロードデータのマスク有無。

MASK：マスクされる

NOMASK：マスクされない

−

%SESSIONID%

WebSocketセッションのID。

−

%MASKKEY%

ペイロードデータのマスクに使うキー情報。

ペイロードデータがマスクされない場合は-が出力されます。

−

%ISEXTENDED%

送受信中のWebSocketプロトコルの拡張有無。

BASE：基本プロトコル

EXTENDED：拡張プロトコル

−

%RSV%

WebSocketプロトコル拡張時の識別子。

送受信中のWebSocketプロトコルが拡張される際に、拡張を解釈するための識別子がこの領域に設定されます。

−

%FRAMEMAINTYPE%

WebSocket フレームの主な分類。

Date：Dataフレーム

Control：制御フレーム

−

%CLOSEREASON%

WebSocketコネクションが切断された理由。

○

%PAYLOADDATA(n)%

ペイロードデータ。

ペイロードデータがテキスト形式の場合、最初のn文字と最後のn文字が出力されます。%PAYLOADDATA%と同時に指定することはできません。

n：1〜32768

−

%PAYLOADDATA%

ペイロードデータ。

ペイロードデータがテキスト形式の場合、ペイロードデータの内容を出力します。ペイロードデータの文字数が65536を超えるときは、%PAYLOADDATA(n)%でn=32768を指定した場合と同様に出力されます。%PAYLOADDATA(n)% と同時に指定することはできません。

−

（凡例）

○：出力されます。

−：出力されません。

保守ログ

ログレベル

ログレベル

概要

1

製品で異常処理が行われた場合にメッセージを出力します。

2

レベル1のメッセージに加え、正常処理中のメッセージも出力します。

9.2.3　Webサーバのログの出力形式

Webサーバのリクエストログおよびアクセスログの出力形式を次に示します。

リクエストログ

出力形式

[時刻] (サーバプロセスID) client : hws <-- (クライアントIPアドレス:ポート番号,サーバIPアドレス:ポート番号[R])(ルートアプリケーション情報)

出力例

[Tue May 27 10:10:08.045 2014] (564) client : hws --> (10.210.185.27:49222,10.210.185.27:80[A])
[Tue May 27 10:10:08.046 2014] (564) client : hws <-- (10.210.185.27:49222,10.210.185.27:80[R])(10.209.15.47/250/0x0000000000000001)

アクセスログ

アクセスログへのルートアプリケーション情報出力は、ログフォーマットに%{hws_ap_root}nを指定することで出力されます。

ログフォーマットを次のように指定した場合のアクセスログの出力例を示します。

LogFormat "%h %l %u %t ¥"%r¥" %>s %b ¥"%{Referer}i¥" ¥"%{User-Agent}i¥" %I %O" combinedio
LogFormat "%h %l %u %t ¥"%r¥" %>s %b ¥"%{Referer}i¥" ¥"%{User-Agent}i¥"" combined
LogFormat "%h %l %u %t ¥"%r¥" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent
LogFormat "%h %l %u %t ¥"%r¥" %>s %b %P %{hws_ap_root}n %I %O %X %D ¥"%{Referer}i¥" ¥"%{User-Agent}i¥"" hws_trace
LogFormat "%h %l %u %t ¥"%r¥" %>s %b %T %P %{hws_ap_root}n" hws_std

出力例

10.210.185.27 - - [27/May/2014:10:10:08.045 +0900] "GET / HTTP/1.0" 200 52 0.001 564 10.209.15.47/250/0x0000000000000001

WebSocketリクエストログ

WebSocketリクエストログの出力項目と、出力パターンごとの出力形式、および出力例について次に示します。

出力項目

出力項目

説明

ID

prefork MPMの場合：プロセス ID

worker MPMの場合：プロセス ID:スレッド ID

クライアントIP:ポート番号

クライアントのIPアドレスおよびポート番号。

IPアドレス1:ポート番号1

クライアントとの接続で使用しているWebサーバのIPアドレスおよびポート番号。

IPアドレス2:ポート番号2

バックエンドサーバとの接続で使用しているWebサーバのIPアドレスおよびポート番号。

IPアドレス3:ポート番号3

バックエンドサーバのIPアドレスおよびポート番号。

ルートAP情報

ルートアプリケーション情報。

ルートアプリケーション情報が取得できない場合、-が出力されます。

ステータスコード

ステータスコード。

ステータスコードを取得できない場合、-1が出力されます。

-->

クライアントからバックエンドサーバ方向へのデータの流れ。

<--

バックエンドサーバからクライアント方向へのデータの流れ。

-X-

データの送受信でエラー、またはコネクション切断。

---

事象なし。

出力形式

クライアントからバックエンドへのデータ送信に成功した場合

[時刻] (ID) クライアントIP:ポート番号 --> IPアドレス1:ポート番号1 --> IPアドレス2:ポート番号2 --> IPアドレス3:ポート番号3 ( ルートAP情報 )

バックエンドからクライアントへのデータ送信に成功した場合（初回）

[時刻] (ID) クライアントIP:ポート番号 <-- IPアドレス1:ポート番号1 <-- IPアドレス2:ポート番号2 <-- IPアドレス3:ポート番号3 ( ルートAP情報 )( ステータスコード )

バックエンドからクライアントへのデータ送信に成功した場合（2回目以降）

[時刻] (ID) クライアントIP:ポート番号 <-- IPアドレス1:ポート番号1 <-- IPアドレス2:ポート番号2 <-- IPアドレス3:ポート番号3 ( ルートAP情報 )

クライアントからのデータ受信でエラーが起きた場合

[時刻] (ID) クライアントIP:ポート番号 -X- IPアドレス1:ポート番号1 --> IPアドレス2:ポート番号2 --- IPアドレス3:ポート番号3 ( ルートAP情報 )

バックエンドへのデータ送信でエラーが起きた場合

[時刻] (ID) クライアントIP:ポート番号 --> IPアドレス1:ポート番号1 --> IPアドレス2:ポート番号2 -X- IPアドレス3:ポート番号3 ( ルートAP情報 )

バックエンドからのデータ受信でエラーが起きた場合

[時刻] (ID) クライアントIP:ポート番号 --- IPアドレス1:ポート番号1 <-- IPアドレス2:ポート番号2 -X- IPアドレス3:ポート番号3 ( ルートAP情報 )

クライアントへのデータ送信でエラーが起きた場合

[時刻] (ID) クライアントIP:ポート番号 -X- IPアドレス1:ポート番号1 <-- IPアドレス2:ポート番号2 <-- IPアドレス3:ポート番号3 ( ルートAP情報 )

バックエンドとのコネクション切断を検知した場合

[時刻] (ID) クライアントIP:ポート番号 --- IPアドレス1:ポート番号1 --- IPアドレス2:ポート番号2 -X- IPアドレス3:ポート番号3 ( ルートAP情報 )

クライアントとのコネクション切断を検知した場合

[時刻] (ID) クライアントIP:ポート番号 --- IPアドレス1:ポート番号1 -X- IPアドレス2:ポート番号2 --- IPアドレス3:ポート番号3 ( ルートAP情報 )

出力例

時刻、およびID（プロセスIDまたはスレッド ID）は省略しています。

10.210.185.27:49504 --> 10.196.211.205:443 --> 10.196.211.205:35307 --> 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)
10.210.185.27:49504 <-- 10.196.211.205:443 <-- 10.196.211.205:35307 <-- 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)(101)
10.210.185.27:49504 <-- 10.196.211.205:443 <-- 10.196.211.205:35307 <-- 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)
10.210.185.27:49504 --> 10.196.211.205:443 --> 10.196.211.205:35307 --> 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)
10.210.185.27:49504 <-- 10.196.211.205:443 <-- 10.196.211.205:35307 <-- 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)
10.210.185.27:49504 --> 10.196.211.205:443 --> 10.196.211.205:35307 --> 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)
10.210.185.27:49504 --- 10.196.211.205:443 --- 10.196.211.205:35307 -X- 10.210.185.50:80 (10.196.211.205/24805/0x00000000000193b1)

9.2.4　パフォーマンストレーサーのログの出力形式

パフォーマンストレーサーのメッセージは、%PRFSPOOL%¥logディレクトリーに出力されます。

出力ディレクトリーを次に示します。ファイル名はprf_message+番号（01~32）です。

出力種別

出力ディレクトリー

PRFデーモン/PRFコマンド

PRF出力API（CPRF.jar,CPRF.DLL）

$PRFSPOOL/log/PRF識別子

ログファイルの切り替えはシフト方式であり、常にprf_message01ファイルにログが出力されます。prf_message02〜prf_message32ファイルは、シフト先の古いログファイルです。

ログのシフト先は、シフト先のファイルが存在しない場合は02,03…32とprf_message02から順番にログファイル名が選択され、prf_message01ファイルがリネームされます。シフト先のファイルがすべて存在する場合は、ログファイルの更新時刻が古い順に削除またはリネームされます。

出力形式

日付・時刻:メッセージID pid tid:メッセージテキスト

出力項目

項目

説明

日付・時刻

トレースの取得日付・時刻が「aaa bbb dd hh:mm:ss.sss YYYY」の形式で出力されます。

メッセージID

メッセージIDが出力されます。

pid

プロセスIDが出力されます。

tid

スレッドIDが出力されます。

メッセージテキスト

メッセージテキストが出力されます。メッセージテキスト中に改行が含まれることもあります。

9.2.5　アプリケーション開発環境のログの出力形式

アプリケーション開発環境が提供するサーバ構築エラーファイル(BuildEnvironment.err)の出力形式と出力項目を次に示します。

新規インストール時にデバッグ環境の構築に失敗した場合に出力されます。

出力形式

エラーメッセージ
エラー終了メッセージ
日付・時刻

出力項目

項目

説明

エラーメッセージ

エラーが発生したコマンドのエラーメッセージが出力されます。

エラー終了メッセージ

セットアップがエラー終了した旨のメッセージと、エラー発生コマンドの詳細情報が出力されます。

日付・時刻

コマンドの終了日時が yyyy/mm/dd hh:mm:ss.ff形式で出力されます。

9.2.6　性能解析トレースファイルの出力形式

性能解析トレースでは、各機能レイヤーのトレース情報を収集します。

出力形式

ダンプ形式

PRF: レコード状態 Process: プロセスID Thread: スレッドID(ハッシュ値)
Trace: トレース通番
ProcessName: プロセス名
Event: イベントID Time: 年:月:日 時:分:秒 ミリ秒/マイクロ秒/ナノ秒
Rc: リターンコード
ClientAP:クライアントアプリケーションのIPアドレス
クライアントアプリケーションのプロセスID -
クライアントアプリケーションの通信番号
RootAP: ルートアプリケーションのIPアドレス
ルートアプリケーションのプロセスID -
ルートアプリケーションの通信番号
INT: インターフェース名 OPR: オペレーション名
Offset +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f 0123456789abcdef
  ダンプ情報

CSV形式

PRF,Process,Thread(hashcode),Trace,ProcessName,Event,Date,Time,
Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,
RootAP IP,RootAP PID,RootAP CommNo.,INT,OPR,OPT,ASCII
レコード状態,プロセスID,スレッドID(ハッシュ値),トレース通番,プロセス名,
イベントID,年/月/日,時:分:秒,ミリ秒/マイクロ秒/ナノ秒,リターンコード,
クライアントアプリケーションのIPアドレス,
クライアントアプリケーションのプロセスID,
クライアントアプリケーションの通信番号,ルートアプリケーションのIPアドレス,
ルートアプリケーションのプロセスID,
ルートアプリケーションの通信番号,インターフェース名,オペレーション名,
ダンプ情報,ASCII文字情報

出力項目

項目

説明

PRF

そのプロセスレコードの状態。次のどちらかが出力されます。

Rec：レコードの状態は正常です。

ErrRec：レコードの状態は異常です。

Process

トレース情報を取得したプロセスのプロセスID。10 桁以内の10 進数が出力されます。

Thread

トレース情報を取得したプロセスのスレッドID、およびスレッドのハッシュ値。

スレッドID、ハッシュ値は18桁以内の16進数が出力されます。

Trace

該当スレッドでのトレース通番。10桁以内の10進数が出力されます。

ProcessName

プロセス名。32文字以内のプロセスを表わす文字列が出力されます。

Event

イベントID。6桁の16進数が出力されます。

Time

トレース情報を取得した年月日、時間を出力します。次の形式で出力されます。

年/月/日 時:分:秒 ミリ秒/マイクロ秒/ナノ秒

出力例

2000/02/12 13:43:44 363/200/000

Rc

リターンコード。16桁の10進数が出力されます。

ClientAP

クライアントアプリケーションの次の情報が出力されます。

IPアドレス

プロセスID

通信番号

RootAP

ルートアプリケーションの次の情報が出力されます。

IPアドレス

プロセスID

通信番号

INT

インターフェース名。33文字以内の文字列※が出力されます。

OPR

オペレーション名。33文字以内の文字列※が出力されます。

OPT

各イベントで取得した情報。514文字以内のダンプ形式の取得情報が出力されます。

ASCII

各イベントで取得した情報。514文字以内のASCII文字の取得情報が出力されます。

注※

インターフェース名、オペレーション名が33文字を超える場合は、次のどれかの方法で、33文字で出力します。

先頭32文字＋*

先頭16文字＋*＋末尾16文字

*＋末尾32文字

9.3　トレース取得ポイントについて

各レイヤーのトレース取得ポイント とPRFトレース取得レベルについて説明します。

9.3.1　パフォーマンストレーサーのトレース取得ポイントについて

パフォーマンストレーサーのトレース取得ポイントや取得できる情報について説明します。

PRFトレースとは、Java EEサーバの決まった処理のポイントで出力されるトレース情報のことで、PRFトレース取得レベルを設定することで出力できるバイナリー形式のファイルです。

なお、PRFトレースでは、一連の処理をトレースできるようにするため、イベント単位の一連の処理に一貫したキーを設定して管理しています。イベント内のトレース情報が出力されるポイント（トレース取得ポイント）で出力されるトレースには、キー情報を付加します。キー情報を次の表に示します。

表9‒1　PRFトレースのキー情報

項番

PRFトレースのキー情報

説明

1

ルートアプリケーション情報

複数のプロセス間にわたる処理シーケンスで、一意の値として保持しなければならない情報です。

Application Serverがシーケンスの起点であると識別できる個所で、ルートアプリケーション情報を付与します。例えば、アプリケーションクライアントから接続する場合、アプリケーションクライアント開始時に付与し、Webブラウザーなど他のクライアントから接続する場合、Webサーバでのリクエスト受付時に付与します。

2

クライアントアプリケーション情報

クライアント・サーバ間通信の処理のシーケンスで、一意の値として保持しなければならない情報です。

Application Serverがクライアント・サーバ間通信の起点であると識別できる個所で、クライアントアプリケーション情報を付与します。

例えば、Webサービス呼び出し時のHTTP通信、EJB呼び出し時のRMI/IIOP通信などの通信電文の送信処理直前で付与します。

Web Serverのログファイル（リクエストログ、アクセスログ）に、ルートアプリケーション情報が出力されるため、Web Serverのログファイルと性能解析トレースファイル※を突き合わせて調査できます。

注※

PRFトレースをテキスト（CSV）形式に編集したファイルです。

機能レイヤーごとのトレース取得ポイントを次の表に示します。

表9‒2　トレース取得ポイント

項番

機能レイヤー

イベントID※

1

Webコンテナー

0xB100〜0xB101

0xB200〜0xB203

2

EJBコンテナー

0xB300〜0xB307

0xBB00〜0xBB03

3

JNDI

0xB400〜0xB401

4

JTA

0xB500〜0xB507

5

JDBC

0xB600〜0xB665

6

JSF

0xB700〜0xB70D

7

JMS

0xB800〜0xB81F

8

JAX-RS

0xB900〜0xB905

9

JAX-WS

0xBA00〜0xBA0B

10

Concurrency Utilities

0xBC00〜0xBC03

11

WebSocket

0xBD00〜0xBD47

注※

各処理でのPRFトレースの出力ポイントと位置情報です。

メモ

WebSocketのクライアントエンドポイントを利用したJava EE サーバのプロセス間通信

クライアントエンドポイントに対するWebSocket通信の送受信や、クライアントエンドポイントからのWebSocket標準API呼び出しに対しては、PRFトレースが出力されません。

クライアントエンドポイントからサーバエンドポイントに対してアプリケーション情報は引き継がれません。そのため、クライアントエンドポイントがApplication Server内のプロセス（Java EE サーバやアプリケーションクライアント）であっても、プロセス間でアプリケーション情報は紐づけられません。

関連項目

9.3.2　Webコンテナーのトレース取得ポイント

9.3.3　EJBコンテナーのトレース取得ポイント

9.3.4　JNDIのトレース取得ポイント

9.3.5　JTAのトレース取得ポイント

9.3.6　JDBCのトレース取得ポイント

9.3.7　JSFのトレース取得ポイント

9.3.8　JMSのトレース取得ポイント

9.3.9　JAX-RSのトレース取得ポイント

9.3.10　JAX-WSのトレース取得ポイント

9.3.11　Concurrency Utilitiesのトレース取得ポイント

9.3.12　WebSocketのトレース取得ポイント

9.3.2　Webコンテナーのトレース取得ポイント

Webコンテナーでのトレース取得ポイントの詳細について説明します。

同期処理の場合

Webコンテナーでのトレースの取得ポイントを次に示します。

図9‒1　Webコンテナーのトレース取得ポイント（同期処理の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※

リクエストヘッダーにアプリケーション情報が含まれている場合は引き継ぎます。

含まれていない場合はアプリケーション情報を生成します。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒3　Webコンテナーのトレース取得ポイントの詳細（同期処理の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB100

1

標準レベル

リクエスト取得・リクエストヘッダー解析完了直後

HTTPメソッド名

URI

-

0xB101

6

標準レベル

リクエスト処理完了直後

HTTPメソッド名

URI

正常時

ステータスコード

異常時

ステータスコード：例外名

0xB200

2、3

標準レベル

サーブレット/JSP/JAX-RS/JAX-WSなどの呼び出し直前

JSP以外の場合

クラス名

JSPの場合

コンテキストルートを起点とするJSPファイルパス

-

セッションID

0xB201

4、5

標準レベル

サーブレット/JSP/JAX-RS/JAX-WSなどの処理完了直後

JSP以外の場合

クラス名

JSPの場合

コンテキストルートを起点とするJSPファイルパス

-

正常時

セッションID

異常時

セッションID：例外名

0xB202

3

標準レベル

静的コンテンツ呼び出し直前（DefaultServlet）

-

コンテキストルート名

セッションID

0xB203

4

標準レベル

静的コンテンツ処理完了直後（DefaultServlet）

-

コンテキストルート名

正常時

セッションID

異常時

セッションID：例外名

非同期処理の場合

サーブレットの非同期処理でのレスポンス送信時の、Webコンテナーでのトレースの取得ポイントを次に示します。

図9‒2　Webコンテナーの取得ポイント（非同期処理の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※

リクエストヘッダーにアプリケーション情報が含まれている場合は引き継ぎます。

含まれていない場合はアプリケーション情報を生成します。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒4　Webコンテナーのトレース取得ポイントの詳細（非同期処理の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB100

1

標準レベル

リクエスト取得・リクエストヘッダー解析完了直後

HTTPメソッド名

URI

-

0xB101

6

標準レベル

リクエスト処理完了直後

HTTPメソッド名

URI

正常時

ステータスコード

異常時

ステータスコード：例外名

0xB200

2

標準レベル

サーブレット/JSP/JAX-RS/JAX-WSなどの呼び出し直前

JSP以外の場合

クラス名

JSPの場合

コンテキストルートを起点とするJSPファイルパス

-

セッションID

0xB201

5

標準レベル

サーブレット/JSP/JAX-RS/JAX-WSなどの処理完了直後

JSP以外の場合

クラス名

JSPの場合

コンテキストルートを起点とするJSPファイルパス

-

正常時

セッションID

異常時

セッションID：例外名

9.3.3　EJBコンテナーのトレース取得ポイント

EJBコンテナーでのトレース取得ポイントの詳細について説明します。

Session BeanおよびEntity Bean（ローカル呼び出し）の場合

Session BeanおよびEntity Bean（ローカル呼び出し）でのトレースの取得ポイントを次に示します。

図9‒3　Session BeanおよびEntity Bean（ローカル呼び出し）の取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒5　トレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB300

1

標準レベル

EJBコンテナーがEJBのビジネスメソッドを呼び出す直前

EJBの実装クラス名

メソッド名（引数の数）

-

0xB301

2

標準レベル

EJBのビジネスメソッドの呼び出し直後

EJBの実装クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

Message Driven Beanの場合

Message Driven Beanでの、トレースの取得ポイントを次に示します。

図9‒4　Message Driven Beanのトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒6　Message Driven Beanのトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB302

3

標準レベル

Message Driven Beanのメッセージリスナー呼び出し直前

EJBの実装クラス名

メソッド名（引数の数）

-

0xB303

4

標準レベル

Message Driven Beanのメッセージリスナー呼び出し直後

EJBの実装クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

Timer Serviceの場合

Timer Serviceでのトレースの取得ポイントを次に示します。

図9‒5　Timer Serviceのトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒7　Timer Serviceのトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB304

5

標準レベル

EJBタイマーサービスのコールバックメソッド呼び出し直前

EJBの実装クラス名

メソッド名（引数の数）

-

0xB305

6

標準レベル

EJBタイマーサービスのコールバックメソッド呼び出し直後

EJBの実装クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

Session BeanおよびEntity Bean（リモート呼び出し）の場合

Session BeanおよびEntity Bean（リモート呼び出し）でのトレースの取得ポイントを次に示します。

図9‒6　Session BeanおよびEntity Bean（リモート呼び出し）のトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒8　Session BeanおよびEntity Bean（リモート呼び出し）のトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB300

1

標準レベル

EJBコンテナーがEJBのビジネスメソッドを呼び出す直前

EJBの実装クラス名

メソッド名（引数の数）

-

0xB301

2

標準レベル

EJBのビジネスメソッドの呼び出し直後

EJBの実装クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

0xBB00

7

標準レベル

RMI/IIOPリクエスト送信前

RMI/IIOP のオペレーション名

RMI/IIOPのオペレーション名

-

0xBB01

10

標準レベル

RMI/IIOPレスポンス受信後

RMI/IIOPのインターフェース名

RMI/IIOPのオペレーション名

-

0xBB02

8

標準レベル

RMI/IIOPリクエスト受信後

RMI/IIOPのインターフェース名

RMI/IIOPのオペレーション名

-

0xBB03

9

標準レベル

RMI/IIOPレスポンス送信前

RMI/IIOPのインターフェース名

RMI/IIOPのオペレーション名

-

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

非同期EJB呼び出しの場合

非同期 EJB 呼び出しでのトレースの取得ポイントを次に示します。

図9‒7　非同期EJB呼び出しのトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒9　非同期EJB呼び出しのトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB306

11

標準レベル

非同期EJBタスクが非同期EJBのビジネスメソッドを呼び出す直前

EJBの実装クラス名

メソッド名（引数の数）

-

0xB307

12

標準レベル

非同期EJBのビジネスメソッド呼び出し直後

EJBの実装クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

9.3.4　JNDIのトレース取得ポイント

JNDIでのトレース取得ポイントの詳細について説明します。

JNDIでのトレースの取得ポイントを次に示します。

図9‒8　JNDIのトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒10　JNDIのトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB400

1

標準レベル

javax.naming.Context.lookup()呼び出し直後（java: 名前空間検索時）

-

指定された名前

-

0xB401

2

標準レベル

javax.naming.Context.lookup()リターン直前（java: 名前空間検索時）

-

指定された名前

正常時

-

異常時

メッセージ：例外名

9.3.5　JTAのトレース取得ポイント

JTAでのトレース取得ポイントの詳細について説明します。

トランザクションを明示的に決着させる場合

トランザクションを明示的に決着させる場合の、JTAでのトレースの取得ポイントを次に示します。

図9‒9　JTAのトレース取得ポイント（トランザクションを明示的に決着させる場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒11　JTAのトレース取得ポイントの詳細（トランザクションを明示的に決着させる場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB500

1

標準レベル

トランザクション開始処理直前

-

-

-

0xB501

2

標準レベル

トランザクション開始処理直後

-

-

正常時

-

異常時

例外名

0xB502

3

標準レベル

トランザクションコミット処理直前

-

-

-

0xB503

4

標準レベル

トランザクションコミット処理直後

-

-

正常時

-

異常時

例外名

0xB504

3

標準レベル

トランザクションロールバック処理直前

-

-

-

0xB505

4

標準レベル

トランザクションロールバック処理直後

-

-

正常時

-

異常時

例外名

トランザクションがタイムアウトする場合

トランザクションがタイムアウトする場合の、JTAでのトレースの取得ポイントを次に示します。

図9‒10　JTAのトレース取得ポイント（トランザクションがタイムアウトする場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒12　JTAのトレース取得ポイントの詳細（トランザクションがタイムアウトする場合）

イベントID

図中の番号

トレースレベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB500

1

標準レベル

トランザクション開始処理直前

-

-

-

0xB501

2

標準レベル

トランザクション開始処理直後

-

-

正常時

-

異常時

例外名

0xB506

5

標準レベル

トランザクションタイムアウト処理直前

-

-

-

0xB507

6

標準レベル

トランザクションタイムアウト処理直後

-

-

正常時

-

異常時

例外名

9.3.6　JDBCのトレース取得ポイント

JDBCでのトレース取得ポイントの詳細について説明します。

JDBCでのトレースの取得ポイントを次に示します。

図9‒11　JDBCのトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒13　JDBCのトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB600

1

標準レベル

javax.sql.DataSource.getConnection()での、データベースコネクションの確立処理開始

-

-

-

0xB601

2

標準レベル

javax.sql.DataSource.getConnection()での、データベースコネクションの確立処理終了

-

-

正常時

コネクションID

異常時

例外名

0xB602

1

標準レベル

javax.sql.DataSource.getConnection(String username, String password)での、データベースコネクションの確立処理開始

-

-

-

0xB603

2

標準レベル

javax.sql.DataSource.getConnection(String username, String password)での、データベースコネクションの確立処理終了

-

-

正常時

コネクションID

異常時

例外名

0xB604

9

標準レベル

java.sql.Connection.close()での、ConnectionオブジェクトのデータベースとJDBCリソースの解除処理開始

-

-

コネクションID

0xB605

10

標準レベル

java.sql.Connection.close()での、ConnectionオブジェクトのデータベースとJDBCリソースの解除処理終了

-

-

正常時

-

異常時

例外名

0xB606

7

標準レベル

java.sql.Connection.commit()処理開始

-

-

-

0xB607

8

標準レベル

java.sql.Connection.commit()処理終了

-

-

正常時

-

異常時

例外名

0xB608

7

標準レベル

java.sql.Connection.rollback()処理開始

-

-

-

0xB609

8

標準レベル

java.sql.Connection.rollback()処理終了

-

-

正常時

-

異常時

例外名

0xB60A

7

標準レベル

java.sql.Connection.rollback(Savepoint savepoint)処理開始

-

-

-

0xB60B

8

標準レベル

java.sql.Connection.rollback(Savepoint savepoint)処理終了

-

-

正常時

-

異常時

例外名

0xB60C

3

標準レベル

Connection.prepareCall(String sql)処理開始

-

-

SQL文

0xB60D

4

標準レベル

Connection.prepareCall(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB60E

3

標準レベル

Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency)処理開始

-

-

SQL文

0xB60F

3

標準レベル

Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency)処理終了

-

-

正常時

-

異常時

例外名

0xB610

4

標準レベル

Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)処理開始

-

-

SQL文

0xB611

3

標準レベル

Connection.prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)処理終了

-

-

正常時

-

異常時

例外名

0xB612

3

標準レベル

Connection.prepareStatement(String sql)処理開始

-

-

SQL文

0xB613

4

標準レベル

Connection.prepareStatement(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB614

3

標準レベル

Connection.prepareStatement(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB615

4

標準レベル

Connection.prepareStatement(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB616

3

標準レベル

Connection.prepareStatement(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB617

4

標準レベル

Connection.prepareStatement(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB618

3

標準レベル

Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)処理開始

-

-

SQL文

0xB619

4

標準レベル

Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)処理終了

-

-

正常時

-

異常時

例外名

0xB61A

3

標準レベル

Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)処理開始

-

-

SQL文

0xB61B

4

標準レベル

Connection.prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)処理終了

-

-

正常時

-

異常時

例外名

0xB61C

3

標準レベル

Connection.prepareStatement(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB61D

4

標準レベル

Connection.prepareStatement(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB61E

5

標準レベル

Statement.execute(String sql)処理開始

-

-

SQL文

0xB61F

6

標準レベル

Statement.execute(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB620

5

標準レベル

Statement.execute(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB621

6

標準レベル

Statement.execute(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB622

5

標準レベル

Statement.execute(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB623

6

標準レベル

Statement.execute(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB624

5

標準レベル

Statement.execute(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB625

6

標準レベル

Statement.execute(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB626

5

標準レベル

Statement.executeBatch()処理開始

-

-

-

0xB627

6

標準レベル

Statement.executeBatch()処理終了

-

-

正常時

-

異常時

例外名

0xB628

5

標準レベル

Statement.executeQuery(String sql)処理開始

-

-

SQL文

0xB629

6

標準レベル

Statement.executeQuery(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB62A

5

標準レベル

Statement.executeUpdate(String sql)処理開始

-

-

SQL文

0xB62B

6

標準レベル

Statement.executeUpdate(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB62C

5

標準レベル

Statement.executeUpdate(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB62D

6

標準レベル

Statement.executeUpdate(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB62E

5

標準レベル

Statement.executeUpdate(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB62F

6

標準レベル

Statement.executeUpdate(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB630

5

標準レベル

Statement.executeUpdate(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB631

6

標準レベル

Statement.executeUpdate(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB632

5

標準レベル

PreparedStatement.execute()処理開始

-

-

-

0xB633

6

標準レベル

PreparedStatement.execute()処理終了

-

-

正常時

-

異常時

例外名

0xB634

5

標準レベル

PreparedStatement.execute(String sql)処理開始

-

-

SQL文

0xB635

6

標準レベル

PreparedStatement.execute(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB636

5

標準レベル

PreparedStatement.execute(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB637

6

標準レベル

PreparedStatement.execute(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB638

5

標準レベル

PreparedStatement.execute(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB639

6

標準レベル

PreparedStatement.execute(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB63A

5

標準レベル

PreparedStatement.execute(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB63B

6

標準レベル

PreparedStatement.execute(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB63C

5

標準レベル

PreparedStatement.executeBatch()処理開始

-

-

-

0xB63D

6

標準レベル

PreparedStatement.executeBatch()処理終了

-

-

正常時

-

異常時

例外名

0xB63E

5

標準レベル

PreparedStatement.executeQuery()処理開始

-

-

-

0xB63F

6

標準レベル

PreparedStatement.executeQuery()処理終了

-

-

正常時

-

異常時

例外名

0xB640

5

標準レベル

PreparedStatement.executeQuery(String sql)処理開始

-

-

SQL文

0xB641

6

標準レベル

PreparedStatement.executeQuery(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB642

5

標準レベル

PreparedStatement.executeUpdate()処理開始

-

-

-

0xB643

6

標準レベル

PreparedStatement.executeUpdate()処理終了

-

-

正常時

-

異常時

例外名

0xB644

5

標準レベル

PreparedStatement.executeUpdate(String sql)処理開始

-

-

SQL文

0xB645

6

標準レベル

PreparedStatement.executeUpdate(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB646

5

標準レベル

PreparedStatement.executeUpdate(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB647

6

標準レベル

PreparedStatement.executeUpdate(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB648

5

標準レベル

PreparedStatement.executeUpdate(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB649

6

標準レベル

PreparedStatement.executeUpdate(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB64A

5

標準レベル

PreparedStatement.executeUpdate(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB64B

6

標準レベル

PreparedStatement.executeUpdate(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB64C

5

標準レベル

CallableStatement.execute()処理開始

-

-

-

0xB64D

6

標準レベル

CallableStatement.execute()処理終了

-

-

正常時

-

異常時

例外名

0xB64E

5

標準レベル

CallableStatement.execute(String sql)処理開始

-

-

SQL文

0xB64F

6

標準レベル

CallableStatement.execute(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB650

5

標準レベル

CallableStatement.execute(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB651

6

標準レベル

CallableStatement.execute(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB652

5

標準レベル

CallableStatement.execute(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB653

6

標準レベル

CallableStatement.execute(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB654

5

標準レベル

CallableStatement.execute(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB655

6

標準レベル

CallableStatement.execute(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

0xB656

5

標準レベル

CallableStatement.executeBatch()処理開始

-

-

-

0xB657

6

標準レベル

CallableStatement.executeBatch()処理終了

-

-

正常時

-

異常時

例外名

0xB658

5

標準レベル

CallableStatement.executeQuery()処理開始

-

-

-

0xB659

6

標準レベル

CallableStatement.executeQuery()処理終了

-

-

正常時

-

異常時

例外名

0xB65A

5

標準レベル

CallableStatement.executeQuery(String sql)処理開始

-

-

SQL文

0xB65B

6

標準レベル

CallableStatement.executeQuery(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB65C

5

標準レベル

CallableStatement.executeUpdate()処理開始

-

-

-

0xB65D

6

標準レベル

CallableStatement.executeUpdate()処理終了

-

-

正常時

-

異常時

例外名

0xB65E

5

標準レベル

CallableStatement.executeUpdate(String sql)処理開始

-

-

SQL文

0xB65F

6

標準レベル

CallableStatement.executeUpdate(String sql)処理終了

-

-

正常時

-

異常時

例外名

0xB660

5

標準レベル

CallableStatement.executeUpdate(String sql, int autoGeneratedKeys)処理開始

-

-

SQL文

0xB661

6

標準レベル

CallableStatement.executeUpdate(String sql, int autoGeneratedKeys)処理終了

-

-

正常時

-

異常時

例外名

0xB662

5

標準レベル

CallableStatement.executeUpdate(String sql, int[] columnIndexes)処理開始

-

-

SQL文

0xB663

6

標準レベル

CallableStatement.executeUpdate(String sql, int[] columnIndexes)処理終了

-

-

正常時

-

異常時

例外名

0xB664

5

標準レベル

CallableStatement.executeUpdate(String sql, String[] columnNames)処理開始

-

-

SQL文

0xB665

6

標準レベル

CallableStatement.executeUpdate(String sql, String[] columnNames)処理終了

-

-

正常時

-

異常時

例外名

9.3.7　JSFのトレース取得ポイント

JSFでのトレース取得ポイントの詳細について説明します。

カスタムコンバーターが呼び出される場合

カスタムコンバーターが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒12　JSFのトレース取得ポイント（カスタムコンバーターが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒14　JSFのトレース取得ポイントの詳細（カスタムコンバーターが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB700

1

標準レベル

カスタムコンバーターが呼び出される直前

クライアントID

カスタムコンバーターのクラス名とメソッド名です。

-

0xB701

2

標準レベル

カスタムコンバーターの処理が終了した直後

クライアントID

カスタムコンバーターのクラス名とメソッド名です。

正常時

-

異常時

例外名

カスタムバリデーターが呼び出される場合

カスタムバリデーターが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒13　JSFのトレース取得ポイント（カスタムバリデーターが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒15　JSFのトレース取得ポイントの詳細（カスタムバリデーターが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB702

3

標準レベル

カスタムバリデーターが呼び出される直前

クライアントID

カスタムバリデーターのクラス名です。MethodExpressionを利用してカスタムバリデーターを呼び出す場合※はMethodExpressionです。

-

0xB703

4

標準レベル

カスタムバリデーターの処理が終了した直後

クライアントID

カスタムバリデーターのクラス名です。MethodExpressionを利用してカスタムバリデーターを呼び出す場合※はMethodExpressionです。

正常時

-

異常時

例外名

注※

引数を複数記述したMethodExpressionを使用した場合、性能解析トレースファイル（CSV形式）の列がずれることがあります。

ValueChangeListenerが呼び出される場合

ValueChangeListenerが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒14　JSFのトレース取得ポイント（ValueChangeListenerが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒16　JSFのトレース取得ポイントの詳細（ValueChangeListenerが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB704

5

標準レベル

ValueChangeListenerが呼び出される直前

クライアントID

ValueChangeListenerのクラス名です。

MethodExpressionを利用してValueChangeListenerを呼び出す場合、MethodExpressionです。

-

0xB705

6

標準レベル

ValueChangeListenerの処理が終了した直後

クライアントID

正常時

MethodExpressionでValueChangeListenerが呼び出されて正常終了した場合、1つの引数を持つメソッドが呼び出された時はone argumentを出力します。引数のないメソッドが呼ばれた時はno argumentを出力します。

異常時

-

正常時

-

異常時

例外名

ActionListenerが呼び出される場合

ActionListenerが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒15　JSFのトレース取得ポイント（ActionListenerが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベActionListenerル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒17　JSFのトレース取得ポイントの詳細（が呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB706

7

標準レベル

ActionListenerが呼び出される直前

クライアントID

ActionListenerのクラス名です。

MethodExpressionを利用してActionListenerを呼び出す場合、MethodExpressionです。

-

0xB707

8

標準レベル

ActionListenerの処理が終了した直後

クライアントID

正常時

MethodExpressionでActionListenerが呼び出されて正常終了した場合、1つの引数を持つメソッドが呼び出された時はone argumentを出力します。引数のないメソッドが呼ばれた時はno argumentを出力します。

異常時

-

正常時

-

異常時

例外名

AjaxBehaviorListenerが呼び出される場合

AjaxBehaviorListenerが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒16　JSFのトレース取得ポイント（AjaxBehaviorListenerが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒18　JSFのトレース取得ポイントの詳細（AjaxBehaviorListenerが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB708

9

PRFトレース取得レベル

AjaxBehaviorListenerが呼び出される直前

クライアントID

AjaxBehaviorListenerのクラス名です。

MethodExpressionを利用してAjaxBehaviorListenerを呼び出す場合、MethodExpressionです。

-

0xB709

10

標準レベル

AjaxBehaviorListenerの処理が終了した直後

クライアントID

正常時

MethodExpressionでAjaxBehaviorListenerが呼び出されて正常終了した場合、1つの引数を持つメソッドが呼び出された時はone argumentを出力します。引数のないメソッドが呼ばれた時はno argumentを出力します。

異常時

-

正常時

-

異常時

例外名

ActionMethodが呼び出される場合

ActionMethodが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒17　JSFのトレース取得ポイント（ActionMethodが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

表9‒19　JSFのトレース取得ポイントの詳細（ActionMethodが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB70A

11

標準レベル

ActionMethodが呼び出される直前

クライアントID

-

-

0xB70B

12

標準レベル

ActionMethodの処理が終了した直後

クライアントID

-

正常時

-

異常時

例外名

ComponentSystemEventListenerが呼び出される場合

ComponentSystemEventListenerが呼び出される場合の、JSFでのトレースの取得ポイントを次に示します。

図9‒18　JSFのトレース取得ポイント（ComponentSystemEventListenerが呼び出される場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒20　JSFのトレース取得ポイントの詳細（ComponentSystemEventListenerが呼び出される場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB70C

13

標準レベル

ComponentSystemEventListenerが呼び出される直前

クライアントID

ComponentSystemEventListenerのクラス名です。

MethodExpressionを利用してComponentSystemEventListenerを呼び出す場合、MethodExpressionです。

-

0xB70D

14

標準レベル

ComponentSystemEventListenerの処理が終了した直後

クライアントID

正常時

MethodExpressionでComponentSystemEventListenerが呼び出されて正常終了した場合、1つの引数を持つメソッドが呼び出された時は「one argument」を出力します。引数のないメソッドが呼ばれた時は「no argument」を出力します。

異常時

-

正常時

-

異常時

例外名

9.3.8　JMSのトレース取得ポイント

JMSでのトレース取得ポイントの詳細について説明します。

Connectionオブジェクト操作の場合

Connectionオブジェクト操作の場合の、JMSでのトレースの取得ポイントを次に示します。

図9‒19　JMSのトレース取得ポイント（Connectionオブジェクト操作の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒21　JMSのトレース取得ポイントの詳細（Connectionオブジェクト操作の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB800

1

標準レベル

BrokerへCREATE SESSIONを送信する直前

-

-

-

0xB801

2

標準レベル

BrokerからCREATE SESSIONの応答を受信した直後

-

-

-

0xB812

3

標準レベル

BrokerへSTOPを送信する直前

-

-

-

0xB813

4

標準レベル

BrokerからSTOPの応答を受信した直後

-

-

-

Sessionオブジェクト操作の場合

Sessionオブジェクト操作の場合の、JMSでのトレースの取得ポイントを次に示します。

図9‒20　JMSのトレース取得ポイント（Sessionオブジェクト操作の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒22　JMSのトレース取得ポイントの詳細（Sessionオブジェクト操作の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB802

21

標準レベル

BrokerへDESTROY SESSIONを送信する直前

-

-

-

0xB803

22

標準レベル

BrokerからDESTROY SESSIONの応答を受信した直後

-

-

-

0xB804

7

標準レベル

BrokerへCREATE DESTINATIONを送信する直前

-

-

-

0xB805

8

標準レベル

BrokerからCREATE DESTINATIONの応答を受信した直後

-

-

-

0xB806

5

標準レベル

BrokerへVERIFY DESTINATIONを送信する直前

-

-

-

0xB807

6

標準レベル

BrokerからVERIFY DESTINATIONの応答を受信した直後

-

-

-

0xB808

9

標準レベル

BrokerへADD CONSUMERを送信する直前

-

-

-

0xB809

10

標準レベル

BrokerからADD CONSUMERの応答を受信した直後

-

-

-

0xB80A

13

標準レベル

BrokerへDELETE CONSUMERを送信する直前

-

-

-

0xB80B

14

標準レベル

BrokerからDELETE CONSUMERの応答を受信した直後

-

-

-

0xB80C

11

標準レベル

BrokerへADD PRODUCERを送信する直前

-

-

-

0xB80D

12

標準レベル

BrokerからADD PRODUCERの応答を受信した直後

-

-

-

0xB810

19

標準レベル

BrokerへSTARTを送信する直前

-

-

-

0xB811

20

標準レベル

BrokerからSTARTの応答を受信した直後

-

-

-

0xB812

3

標準レベル

BrokerへSTOPを送信する直前

-

-

-

0xB813

4

標準レベル

BrokerからSTOPの応答を受信した直後

-

-

-

0xB814

15

標準レベル

BrokerへCOMMITまたはROLLBACKを送信する直前

-

-

-

0xB815

16

標準レベル

BrokerからCOMMITまたはROLLBACKの応答を受信した直後

-

-

-

0xB81E

17

標準レベル

BrokerへREDELIVERを送信する直前

-

-

-

0xB81F

18

標準レベル

BrokerからREDELIVERの応答を受信した直後

-

-

-

その他のオブジェクト操作の場合

その他のオブジェクト操作の場合の、JMSでのトレースの取得ポイントを次に示します。

図9‒21　JMSのトレース取得ポイント（その他のオブジェクト操作の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒23　JMSのトレース取得ポイントの詳細（その他のオブジェクト操作の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB80E

27

標準レベル

BrokerへDELETE PRODUCERを送信する直前

-

-

-

0xB80F

28

標準レベル

BrokerからDELETE PRODUCERの応答を受信した直後

-

-

-

0xB816

23

標準レベル

BrokerへTEXT MESSAGE、MAP MESSAGE、BYTE MESSAGE、またはOBJECT MESSAGEを送信する直前

-

-

-

0xB817

24

標準レベル

BrokerからTEXT MESSAGE、MAP MESSAGE、BYTE MESSAGE、またはOBJECT MESSAGEの応答を受信した直後

-

-

-

0xB818

25

標準レベル

BrokerへACKNOWLEDGEを送信する直前

-

-

-

0xB819

26

標準レベル

BrokerからACKNOWLEDGEの応答を受信した直後

-

-

-

0xB81A

29

標準レベル

BrokerへBROWSEを送信する直前

-

-

-

0xB81B

30

標準レベル

BrokerからBROWSEの応答を受信した直後

-

-

-

0xB81C

31

標準レベル

BrokerへDELIVERを送信する直前

-

-

-

0xB81D

32

標準レベル

BrokerからDELIVERの応答を受信した直後

-

-

-

9.3.9　JAX-RSのトレース取得ポイント

JAX-RSでのトレース取得ポイントの詳細について説明します。

JAX-RS でのトレースの取得ポイントを次に示します。

図9‒22　JAX-RS のトレース取得ポイント

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※

点線で囲まれた部分は、同期処理の場合のWebコンテナーのトレース取得ポイントと同じです。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒24　JAX-RS のトレース取得ポイントの詳細

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xB900

1

標準レベル

HTTPメッセージを送信するクライアントライブラリーのメソッド入口

クラス名

メソッド名

-

0xB901

6

標準レベル

HTTPメッセージを送信するクライアントライブラリーのメソッド出口

クラス名

メソッド名

正常時

-

異常時

例外名

0xB902

2

標準レベル

クライアントライブラリーのHTTPメッセージ送信前

クラス名

メソッド名

エンドポイントURI

0xB903

5

標準レベル

クライアントライブラリーのHTTPメッセージ受信後

クラス名

メソッド名

正常時

-

異常時

例外名

0xB904

3

標準レベル

リソース呼び出し前

クラス名

メソッド名

呼び出し種別

次の中からどれかを出力します。

ObjectOutInvoker

ResponseOutInvoker

TypeOutInvoker

VoidOutInvoker

VoidToVoidDispatcher

0xB905

4

標準レベル

リソース呼び出し後

クラス名

メソッド名

正常時

-

異常時

例外名

関連項目

9.3.2　Webコンテナーのトレース取得ポイント

9.3.10　JAX-WSのトレース取得ポイント

JAX-WSでのトレース取得ポイントの詳細について説明します。

リモートWSDL取得の場合

リモートWSDL取得の場合の、JAX-WSでのトレースの取得ポイントを次に示します。

図9‒23　JAX-WSのトレース取得ポイント（リモートWSDL取得の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※

点線で囲まれた部分は、同期処理の場合のWebコンテナーのトレース取得ポイントと同じです。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒25　JAX-WSのトレース取得ポイントの詳細（リモートWSDL取得の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBA0A

1

標準レベル

WSDL取得実行前

クラス名

メソッド名（引数の数）

エンドポイント URI

0xBA0B

2

標準レベル

WSDL取得実行後

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名

ローカルWSDL取得の場合

ローカルWSDL取得の場合の、JAX-WSでのトレースの取得ポイントを次に示します。

図9‒24　JAX-WSのトレース取得ポイント（ローカルWSDL取得の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報については、リモートWSDL取得の場合と同じです。

request-responseオペレーション（同期）の場合

request-responseオペレーション（同期）の場合の、JAX-WSでのトレースの取得ポイントを次に示します。

図9‒25　JAX-WSのトレース取得ポイント（request-responseオペレーション（同期）の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※1

点線で囲まれた部分は、同期処理の場合のWebコンテナーのトレース取得ポイントと同じです。

注※2

EJBコンテナーは、EJBをWebサービスとして実装している場合に呼び出されます。

EJBコンテナー以降の取得個所は、Session BeanおよびEntity Beanのローカル呼び出しのときと同じです。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒26　JAX-WSのトレース取得ポイントの詳細（request-responseオペレーション（同期）の場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBA00

3

標準レベル

SOAP クライアントライブラリーのサービスメソッド入口（スタブベース）

クラス名

メソッド名（引数の数）

-

0xBA01

8

標準レベル

SOAP クライアントライブラリーのサービスメソッド出口（スタブベース）

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名

0xBA02

3

標準レベル

SOAP クライアントライブラリーのサービスメソッド入口（ディスパッチベース）

クラス名

メソッド名（引数の数）

-

0xBA03

8

標準レベル

SOAP クライアントライブラリーのサービスメソッド出口（ディスパッチベース）

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名

0xBA04

4

標準レベル

SOAP クライアントライブラリーの HTTP メッセージ送信前

クラス名

メソッド名（引数の数）

エンドポイントURI

0xBA05

7

標準レベル

SOAP クライアントライブラリーの HTTP メッセージ受信後

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名

0xBA06

5

標準レベル

SOAP サービス呼び出し前（Webサービス実装クラス）

クラス名

メソッド名（引数の数）

サービスメソッド名

0xBA07

6

標準レベル

SOAP サービス呼び出し後（Webサービス実装クラス）

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

0xBA08

5

標準レベル

SOAP サービス呼び出し前（プロバイダー実装クラス）

クラス名

メソッド名（引数の数）

-

0xBA09

6

標準レベル

SOAP サービス呼び出し後（プロバイダー実装クラス）

クラス名

メソッド名（引数の数）

正常時

-

異常時

例外名※

注※

トレース取得ポイントで取得した例外がjava.lang.reflect.InvocationTargetExceptionだった場合、java.lang.reflect.InvocationTargetExceptionが保持している例外の例外名が出力されます。

one -wayオペレーションの場合

one -wayオペレーションの場合の、JAX-WSでのトレースの取得ポイントを次に示します。

図9‒26　JAX-WSのトレース取得ポイント（one -wayオペレーションの場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※1

点線で囲まれた部分は、同期処理の場合のWebコンテナーのトレース取得ポイントと同じです。

注※2

EJBコンテナーは、EJBをWebサービスとして実装している場合に呼び出されます。

EJBコンテナー以降の取得個所は、Session BeanおよびEntity Beanのローカル呼び出しのときと同じです。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報については、JAX-WSのトレース取得ポイントの詳細（request-responseオペレーション（同期）の場合）と同じです。

request-responseオペレーション（非同期）の場合

request-response オペレーション（非同期）の場合の、 JAX-WS でのトレースの取得ポイントを次に示します。

図9‒27　JAX-WSのトレース取得ポイント（request-responseオペレーション（非同期）の場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

注※1

点線で囲まれた部分は、Webコンテナーのトレース取得ポイント（同期処理の場合）と同じです。

注※2

EJBコンテナーは、EJBをWebサービスとして実装している場合に呼び出されます。

EJBコンテナー以降の取得個所は、Session BeanおよびEntity Bean（ローカル呼び出し）の場合と同じです。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報については、JAX-WSのトレース取得ポイントの詳細（request-responseオペレーション（同期）の場合）と同じです。

関連項目

9.3.2　Webコンテナーのトレース取得ポイント

9.3.3　EJBコンテナーのトレース取得ポイント

9.3.11　Concurrency Utilitiesのトレース取得ポイント

Concurrency Utilitiesでのトレース取得ポイントの詳細について説明します。

Java EEのExecutorService上でタスクを実行した場合

Java EEのExecutorService上でタスクを実行した場合の、Concurrency Utilitiesでのトレースの取得ポイントを次に示します。

図9‒28　Concurrency Utilitiesのトレース取得ポイント（Java EEのExecutorService上でタスクを実行した場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒27　Concurrency Utilitiesのトレース取得ポイントの詳細（Java EEのExecutorService上でタスクを実行した場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBC00

1

標準レベル

ManagedExecutorServiceまたはManagedScheduledExecutorServiceでタスクを実行する直前

クラス名

‐

-

0xBC01

2

標準レベル

ManagedExecutorServiceまたはManagedScheduledExecutorServiceでタスクを実行した直後

クラス名

-

正常時

-

異常時

例外名

Java EEのScheduledExecutorService上でタスクを繰り返し実行した場合

Java EEのScheduledExecutorService上でタスクを繰り返し実行した場合 の、Concurrency Utilitiesでのトレースの取得ポイントを次に示します。

図9‒29　Concurrency Utilitiesのトレース取得ポイント（Java EEのScheduledExecutorService上でタスクを繰り返し実行した場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報については、Concurrency Utilitiesのトレース取得ポイントの詳細（Java EEのExecutorService上でタスクを実行した場合）と同じです。

Java EEのExecutorService上でManagedTaskを実行した場合

Java EEのExecutorService上でManagedTaskを実行した場合の、Concurrency Utilitiesでのトレースの取得ポイントを次に示します。

図9‒30　Concurrency Utilitiesのトレース取得ポイント（Java EEのExecutorService上でManagedTaskを実行した場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報については、Concurrency Utilitiesのトレース取得ポイントの詳細（Java EEのExecutorService上でタスクを実行した場合）と同じです。

Java SEのExecutorService上でコンテキスト情報を付加したタスクを実行した場合

Java SEのExecutorService上でコンテキスト情報を付加したタスクを実行した場合 の、Concurrency Utilitiesでのトレースの取得ポイントを次に示します。

図9‒31　Concurrency Utilitiesのトレース取得ポイント（Java SEのExecutorService上でコンテキスト情報を付加したタスクを実行した場合）

メモ

この図は、リクエストの延長で取得する流れを示す図です。トレースを取得する契機すべてを示す図ではありません。このほかにも取得する契機はあります。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒28　Concurrency Utilitiesのトレース取得ポイントの詳細（Java SEのExecutorService上でコンテキスト情報を付加したタスクを実行した場合）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBC02

3

標準レベル

コンテキスト情報を付加したタスクを実行する直前

クラス名

-

-

0xBC03

4

標準レベル

コンテキスト情報を付加したタスクを実行した直後

クラス名

-

正常時

-

異常時

例外名

9.3.12　WebSocketのトレース取得ポイント

WebSocketでのトレース取得ポイントの詳細について説明します。

オープニングハンドシェイク要求受信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒32　WebSocketのトレース取得ポイント（オープニングハンドシェイク要求受信時）

注※

Webコンテナーの取得ポイント（0xB100）を示します。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒29　WebSocketのトレース取得ポイントの詳細（オープニングハンドシェイク要求受信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD00

1

標準レベル

オープニングハンドシェイク要求受信後処理開始直前

CONNECT

ハンドシェイク時のURI

-

0xBD01

4

標準レベル

オープニングハンドシェイク要求受信後処理完了直後

CONNECT

ハンドシェイク時のURI

正常時

セッションID

異常時

例外名

0xBD20

2

標準レベル

@OnOpenアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonOpenメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD21

3

標準レベル

@OnOpenアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonOpenメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

メッセージ受信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒33　WebSocketのトレース取得ポイント（メッセージ（データフレーム）受信時）

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

注※2

エンドポイントで@OnMessageが付与されたメソッドまたはjavax.websocket.MessageHandler.Wholeの実装クラスが使用されていて、分割されたメッセージを受信した場合、枠内の取得ポイントは最後のフレームを受信したときだけ呼ばれます。

図9‒34　WebSocketのトレース取得ポイント（ReaderまたはInputStream型の引数を持つメッセージハンドラによる分割メッセージ受信時）

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

注※2

Concurrency Utilitiesの取得ポイント（0xBC00）を示します。

注※3

Concurrency Utilitiesの取得ポイント（0xBC01）を示します。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒30　WebSocketのトレース取得ポイントの詳細（メッセージ受信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD02

5

標準レベル

受信したWebSocketフレームに対する処理開始直前

READ

-

-

0xBD03

12

標準レベル

受信したWebSocketフレームに対する処理完了直後

READ

-

正常時

-

異常時

例外名

0xBD40

6

標準レベル

データフレーム受信後処理開始直前

MESSAGE

次のどれか

onMessage(String)

onMessage(ByteBuffer)

onPartialMessage(String)

onPartialMessage(ByteBuffer)

-

0xBD41

11

標準レベル

データフレーム受信後処理完了直後

MESSAGE

次のどれか

onMessage(String)

onMessage(ByteBuffer)

onPartialMessage(String)

onPartialMessage(ByteBuffer)

正常時

-

異常時

例外名

0xBD22

7

標準レベル

@OnMessageアノテーションが付与されたメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD23

8

標準レベル

@OnMessageアノテーションが付与されたメソッド処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

0xBD24

7

標準レベル

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

-

0xBD25

8

標準レベル

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

正常時

-

異常時

例外名

0xBD26

7

標準レベル

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

-

0xBD27

8

標準レベル

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

正常時

-

異常時

例外名

0xBD28

9

標準レベル

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD29

10

標準レベル

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

データ送信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒35　WebSocketのトレース取得ポイント（データ送信時）

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、sendXXXメソッドの呼び出し元のルートアプリケーション情報が適用されます。

注※2

クライアントアプリケーション情報は、項番13で採番されたクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、データフレーム送信先のルートアプリケーション情報が適用されます。

注※3

ここでWebSocketアクセスログが出力されます。

ルートアプリケーション情報は項番15と同じ値が適用されます。

注※4

クライアントアプリケーション情報は、項番13で採番されたクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、sendXXXメソッドの呼び出し元のルートアプリケーション情報が適用されます。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒31　WebSocketのトレース取得ポイントの詳細（データ送信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD12

14

標準レベル

WebSocketフレームの送信処理開始直前

WRITE

-

-

0xBD13

15

標準レベル

WebSocketフレームの送信処理完了直後

WRITE

-

正常時

-

異常時

例外名

0xBD30

13

標準レベル

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

送信先のセッションID

0xBD31

16

標準レベル

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

正常時

-

異常時

例外名

0xBD32

13

標準レベル

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

送信先のセッションID

0xBD33

16

標準レベル

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

正常時

-

異常時

例外名

0xBD34

13

標準レベル

javax.websocket.RemoteEndpoint.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

送信先のセッションID

0xBD35

16

標準レベル

javax.websocket.RemoteEndpoin.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

正常時

-

異常時

例外名

PING受信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒36　WebSocketのトレース取得ポイント（PING受信時）

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

注※2

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、項番5と同じルートアプリケーション情報が適用されます。

注※3

クライアントアプリケーション情報は、項番13で採番されたクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、項番5と同じルートアプリケーション情報が適用されます。

注※4

クライアントアプリケーション情報は、項番5で採番したクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、項番5と同じルートアプリケーション情報が適用されます。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒32　WebSocketのトレース取得ポイントの詳細（PING受信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD02

5

標準レベル

受信したWebSocketフレームに対する処理開始直前

READ

-

-

0xBD03

12

標準レベル

受信したWebSocketフレームに対する処理完了直後

READ

-

正常時

-

異常時

例外名

0xBD12

14

標準レベル

WebSocketフレームの送信処理開始直前

WRITE

-

-

0xBD13

15

標準レベル

WebSocketフレームの送信処理完了直後

WRITE

-

正常時

-

異常時

例外名

0xBD42

17

標準レベル

PINGフレーム受信後処理開始直前

PING

-

-

0xBD43

18

標準レベル

PINGフレーム受信後処理完了直後

PING

-

正常時

-

異常時

例外名

0xBD30

13

標準レベル

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

送信先のセッションID

0xBD31

16

標準レベル

javax.websocket.RemoteEndpoint.Async.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Async

メソッド名（引数の型）

正常時

-

異常時

例外名

0xBD32

13

標準レベル

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

送信先のセッションID

0xBD33

16

標準レベル

javax.websocket.RemoteEndpoint.Basic.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint.Basic

メソッド名（引数の型）

正常時

-

異常時

例外名

0xBD34

13

標準レベル

javax.websocket.RemoteEndpoint.sendXXXメソッドが呼び出された直後

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

送信先のセッションID

0xBD35

16

標準レベル

javax.websocket.RemoteEndpoin.sendXXXメソッドのリターン直前

javax.websocket.RemoteEndpoint

メソッド名（引数の型）

正常時

-

異常時

例外名

PONG受信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒37　WebSocketのトレース取得ポイント（PONG受信時）

注※

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒33　WebSocketのトレース取得ポイントの詳細（PONG受信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD02

5

標準レベル

受信したWebSocketフレームに対する処理開始直前

READ

-

-

0xBD03

12

標準レベル

受信したWebSocketフレームに対する処理完了直後

READ

-

正常時

-

異常時

例外名

0xBD44

19

標準レベル

PONGフレーム受信後処理開始直前

PONG

-

-

0xBD45

20

標準レベル

PONGフレーム受信後処理完了直後

PONG

-

正常時

-

異常時

例外名

0xBD22

7

標準レベル

@OnMessageアノテーションが付与されたメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD23

8

標準レベル

@OnMessageアノテーションが付与されたメソッド処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

0xBD24

7

標準レベル

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

-

0xBD25

8

標準レベル

javax.websocket.MessageHandler.Wholeの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Wholeの実装クラス名

メソッド名

正常時

-

異常時

例外名

0xBD26

7

標準レベル

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド呼び出し直前

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

-

0xBD27

8

標準レベル

javax.websocket.MessageHandler.Partialの実装クラスのonMessageメソッド処理完了直後

javax.websocket.MessageHandler.Partialの実装クラス名

メソッド名

正常時

-

異常時

例外名

0xBD28

9

標準レベル

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD29

10

標準レベル

@OnErrorアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonErrorメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

クロージングハンドシェイク要求受信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒38　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求受信時（ペイロードデータあり））

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

注※2

Webコンテナーの取得ポイント（0xB101）を示します。

図9‒39　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求受信時（ペイロードデータなし））

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、オープニングハンドシェイク時にクライアントに採番されたルートアプリケーション情報が適用されます。

注※2

Webコンテナーの取得ポイント（0xB101）を示します。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒34　WebSocketのトレース取得ポイントの詳細（クロージングハンドシェイク要求受信時）

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD02

5

標準レベル

受信したWebSocketフレームに対する処理開始直前

READ

-

-

0xBD03

12

標準レベル

受信したWebSocketフレームに対する処理完了直後

READ

-

正常時

-

異常時

例外名

0xBD12

14

標準レベル

WebSocketフレームの送信処理開始直前

WRITE

-

-

0xBD13

15

標準レベル

WebSocketフレームの送信処理完了直後

WRITE

-

正常時

-

異常時

例外名

0xBD46

21

標準レベル

クロージングハンドシェイク要求受信後処理または送信後処理開始直前

CLOSE

切断要因

-

0xBD47

24

標準レベル

クロージングハンドシェイク要求受信後処理または送信後処理完了直後

CLOSE

切断要因

正常時

-

異常時

例外名

0xBD2A

22

標準レベル

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD2B

23

標準レベル

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

クロージングハンドシェイク要求送信時

WebSocketでのトレースの取得ポイントを次に示します。

図9‒40　WebSocketのトレース取得ポイント（クロージングハンドシェイク要求送信時）

注※1

クライアントアプリケーション情報は新規採番されます。

ルートアプリケーション情報は、sendXXXメソッドの呼び出し元のルートアプリケーション情報が適用されます。

注※2

クライアントアプリケーション情報は、項番25で採番されたクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、データフレーム送信先のルートアプリケーション情報が適用されます。

注※3

Webコンテナーの取得ポイント（0xB101）を示します。

注※4

クライアントアプリケーション情報は、項番25で採番されたクライアントアプリケーション情報が適用されます。

ルートアプリケーション情報は、sendXXXメソッドの呼び出し元のルートアプリケーション情報が適用されます。

イベントID、トレースレベル、トレース取得ポイント、取得できる情報について次の表に示します。

表9‒35　WebSocketのトレース取得ポイントの詳細（クロージングハンドシェイク要求送信時

イベントID

図中の番号

PRFトレース取得レベル

トレース取得ポイント

取得できる情報

インターフェース名

オペレーション名

オプション

0xBD12

14

標準レベル

WebSocketフレームの送信処理開始直前

WRITE

-

-

0xBD13

15

標準レベル

WebSocketフレームの送信処理完了直後

WRITE

-

正常時

-

異常時

例外名

0xBD46

21

標準レベル

クロージングハンドシェイク要求受信後処理または送信後処理開始直前

CLOSE

切断要因

-

0xBD47

24

標準レベル

クロージングハンドシェイク要求受信後処理または送信後処理完了直後

CLOSE

切断要因

正常時

-

異常時

例外名

0xBD2A

22

標準レベル

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの呼び出し直前

エンドポイントのクラス名

メソッド名

-

0xBD2B

23

標準レベル

@OnCloseアノテーションが付与されたメソッドまたはjavax.websocket.Endpoint実装クラスのonCloseメソッドの処理完了直後

エンドポイントのクラス名

メソッド名

正常時

-

異常時

例外名

0xBD36

25

標準レベル

javax.websocket.Session.closeメソッドが呼び出された直後

javax.websocket.Session

メソッド名（引数の型）

送信先のセッションID

0xBD37

26

標準レベル

javax.websocket.Session.closeメソッドのリターン直前

javax.websocket.Session

メソッド名（引数の型）

正常時

-

異常時

例外名

用語解説

（英字）

Administration Console

Application Serverを使用したシステムの構築・運用を行うためのGUIです。

CA

Certificate Authorityの略称です。認証局と呼ばれる、SSLを使用するための証明書を発行する機関です。ほかのエンティティのために有効な証明書を発行する、信頼のおけるエンティティです。次に示す種類があります。

ルートCA：上位のCA による認証を受けないで、自分の正当性を自ら証明します。

中間CA：自分の正当性を証明するために、上位のCA による認証を受けています。

CopyGC

SerialGC使用時にNew領域に対して行われるGCのことです。

Explicitヒープ

明示管理ヒープ機能で使用する、GCの対象とならないメモリー領域のことです。

FullGC

Tenured領域に対して行われるGCのことです。

G1GC

GCの処理方式の一つです。New領域にYoungGC、Tenured領域にMixedGCを行います。GCによるアプリケーションの停止時間を重視した処理方式です。

GC

JavaVMが自動で行うメモリの回収処理のことです。

HTTP

HyperText Transfer Protocolの略称です。インターネットで、WebサーバとWebクライアントの間でHTML文書を送受信するための通信プロトコルです。

Java EE RI

Java EE Reference Implementationの略称です。Java EE仕様の参照実装です。

Java EE RIのDD

Java EE仕様の参照実装が提供するDeployment Descriptorです。

SerialGC

GCの処理方式の一つです。New領域にCopyGC、Tenured領域にFullGCを行います。スループットを重視した処理方式です。

SSL

Secure Sockets Layerの略称です。情報を暗号化してネットワークで送受信するためのプロトコルの一つです。TCP 層の上位層です。クライアントとWebサーバの間で、証明書による認証、鍵交換、暗号化およびメッセージ認証をします。

TLS

Transport Layer Securityの略称です。情報を暗号化してネットワークで送受信するためのプロトコルの一つです。SSLを基に改良が加えられたプロトコルです。

URI

Uniform Resource Identifierの略称です。URLのようにWeb上のデータの位置を指定する方法と、Web上の特定のデータを固有の名前で指定する方法を持ち合わせた規格です。URLとURNを組み合わせたもので、XML文書中でインターネット資源を表したり、名前空間を識別したりするときに使用します。URIは一般的概念で、URLの上位集合です。RFC1630で規定されています。

Webサーバ

Webブラウザーからのリクエスト受信およびWebブラウザーへのデータ送信に関連する処理を実行するプログラムです。

Webフロントシステム

Application Serverが主な対象としているシステムパターンです。セキュリティー装置、ロードバランサー、Application Server、データベースサーバ、ジョブ管理サーバ/メッセージ監視サーバで構成されるシステムのことです。

（カ行）

拡張DD

Java EEアプリケーションやJava EEモジュールごとに、Java EE Server固有機能の設定を行うための、XML形式の定義ファイルです。

クラスター

同じアプリケーション、リソース、および設定情報を共有するサーバインスタンスのグループです。

計画停止

実行中のサーバプロセスまたはサーバスレッドを、実行終了後に停止する方法です。

公開鍵

公開鍵暗号で使用する、データの暗号化または電子署名の検証をするための鍵です。公開鍵は、通常ネットワーク上などで公開されています。データを暗号化して送信する場合、送信者は受信者の公開鍵を使用してデータを暗号化します。また、受信した電子署名を検証する場合は、受信者は送信者の公開鍵を使用して電子署名を検証します。

（サ行）

サーバインスタンス

Java EEアプリケーションを稼働させるサーバプロセスのことです。

サーバテンプレート

サーバインスタンス、Webサーバ、およびパフォーマンストレーサーの運用に必要な設定を記述しているもので、ドメイン管理サーバが環境構築時に参照するファイルです。

設定対象識別子

asadmin set/get/listサブコマンドを使用して、設定値を変更または取得できる設定対象に対する識別子のことです。

（タ行）

ドメイン

業務システムを構成するサーバインスタンス、Webサーバ、またはパフォーマンストレーサーといったコンポーネントを管理するグループのことです。

ドメイン管理サーバ

ドメインの運用管理を行うサーバのことです。

（ナ行）

ノード

サーバインスタンス、Webサーバ、およびパフォーマンストレーサーが起動されるホストのことです。

（ハ行）

秘密鍵

公開鍵暗号で使用する、データの復号化または電子署名を作成するための鍵（private key）です。非公開鍵ともいいます。 秘密鍵は、その所有者が安全に管理します。暗号化されたデータを受信した場合、受信者は自分の秘密鍵を使用してデータを復号化します。また、送信するデータに電子署名を付加する場合は、送信者は自分の秘密鍵を使用し電子署名を作成します。

（マ行）

明示管理ヒープ機能

SerialGC使用時に、FullGCの発生を抑止する機能です。

（ラ行）

リモートモード

ドメイン管理サーバと通信してコマンドを動作させるモードです。

ローカルモード

ドメイン管理サーバと通信しないでコマンドを動作させるモードです。

ロードバランサー

バックエンドサーバの負荷を均等にするために、リクエスト転送を調整する装置またはソフトウェアです。

索引

記号

-Xms[1], [2], [3]

-Xmx[1], [2], [3]

-XX:+HitachiUseExplicitMemory[1]

-XX:+UseG1GC[1]

-XX:+UseSerialGC[1]

-XX:CompressedClassSpaceSize[1], [2], [3]

-XX:ConcGCThreads[1]

-XX:HitachiExplicitHeapMaxSize[1]

-XX:MaxGCPauseMillis[1]

-XX:MaxMetaspaceSize[1], [2], [3]

-XX:MetaspaceSize[1], [2]

-XX:NewRatio[1]

-XX:ParallelGCThreads[1]

-XX:SurvivorRatio[1], [2], [3]

数字

1つのJava EEサーバを配置する構成[1]

A

Administration Console[1]

Administration Consoleにログインする[1]

Administration Consoleを利用してApplication Serverの稼働状況を確認する[1]

Administration Consoleを利用してアプリケーションの稼働状況を確認する[1]

Administration Consoleを利用してシステム設定情報を確認する[1]

Administration Consoleを利用してシステムを開始する[1]

Administration Consoleを利用してシステムを停止する[1]

Administration Consoleを利用してデータベースサーバへの接続状況を確認する[1]

AJS3[1]

Application Server V9との互換性・移行性[1]

Application Serverが出力するトラブルシュート資料について[1]

Application Serverが対応する標準仕様について[1]

Application Serverで利用できるアプリケーション認証について[1]

Application ServerにJDBCドライバーをインストールする[1]

Application Serverのインストールの種類について[1]

Application Serverの運用管理について[1]

Application Serverの管理要素とプロセス構成について[1]

Application Serverの周辺環境の設定[1]

Application Serverの接続構成について[1]

Application Serverの設定を変更する[1], [2]

Application Serverのセットアップの流れ[1]

Application Serverのディレクトリー構成[1]

Application Serverをアンインストールする[1]

Application Serverを上書きインストールする[1]

Application Serverを起動する[1]

Application Serverを削除する[1]

Application Serverを新規インストールする[1]

Application Serverをセットアップする[1]

Application Serverをバージョンアップする[1]

Application Serverを複数インストールする[1]

asadminユーティリティーコマンドのプロセスに適用する環境変数を変更する[1], [2]

asenv.conf[1], [2]

B

backup-domain[1], [2], [3]

BASIC認証[1]

C

Concurrency Utilitiesのトレース取得ポイント[1]

Cookie[1]

CopyGC[1]

CORBA[1]

create-cluster[1]

create-domain[1]

create-iiop-listener[1]

create-instance[1], [2]

create-jdbc-connection-pool[1]

create-jdbc-resource[1]

create-jms-host[1]

create-jvm-options[1], [2]

create-node-config[1]

create-node-ssh[1], [2]

create-password-alias[1]

create-prf[1], [2]

create-relation[1], [2], [3]

create-system-properties[1]

create-webserver[1], [2], [3]

D

das.properties[1]

DBMS[1]

DBMSの最大同時接続数の見積もり式[1]

delete-domain[1]

delete-iiop-listener[1]

delete-instance[1], [2]

delete-jms-host[1]

delete-jvm-options[1], [2]

delete-node-config[1]

delete-node-ssh[1]

delete-prf[1], [2]

delete-relation[1], [2]

delete-system-property[1]

delete-webserver[1], [2]

deploy[1], [2]

DIGEST認証[1]

disable[1]

E

EJBコンテナーのトレース取得ポイント[1]

EJBプール[1]

enable[1]

Explicitヒープ[1]

F

FORM認証[1]

FullGC[1]

G

G1GC[1]

G1GCに設定するパラメーター[1]

G1GCのメモリー構造とGCの流れについて[1]

get[1], [2], [3], [4], [5]

H

httpsd.conf@aix.vtl[1], [2]

httpsd.conf@linux.vtl[1], [2]

HTTPサーバ[1]

I

IIOPリスナーのポートをオープンする[1]

IIOPリスナーのポートをクローズする[1]

IPアドレス[1], [2]

IPアドレスおよびホスト名を変更する[1]

J

Java EE 7[1]

Java EEサーバ[1], [2]

Java SE[1]

JavaVMオプションを指定する[1], [2]

JavaVMオプションを変更する[1], [2]

Javaデバッガー用通信ポート番号を変更する[1]

Javaのメモリー管理の方式について[1]

JAX-RSのトレース取得ポイント[1]

JAX-WSのトレース取得ポイント[1]

JDBCコネクションプール[1]

JDBCコネクションプールを作成する[1]

JDBCのトレース取得ポイント[1]

JDBCリソースのターゲットペイン[1]

JDBCリソースを作成する[1]

JMSのトレース取得ポイント[1]

JMSホストのポートをオープンする[1]

JMSホストのポートをクローズする[1]

JNDIのトレース取得ポイント[1]

JP1[1]

JP1/AJS3[1]

JP1/AJS3を使用した運用の自動化を設定する[1]

JSFのトレース取得ポイント[1]

JTAのトレース取得ポイント[1]

L

list-applications[1], [2]

list-instances[1]

list-prfs[1]

list-webservers[1]

M

MixedGC[1]

P

ping-connection-pool[1], [2]

proxy_balancer.conf@.vtl[1], [2]

R

restore-domain[1], [2]

reverse_proxy.conf@.vtl[1], [2]

S

SerialGC[1], [2]

SerialGC と明示管理ヒープ機能の組み合わせ[1]

SerialGCと明示管理ヒープ機能を組み合わせた場合に設定するパラメーター[1]

SerialGCと明示管理ヒープ機能を組み合わせた場合のメモリー構造とGCの流れについて[1]

SerialGCのメモリー構造とGCの流れについて[1]

set[1], [2], [3], [4], [5], [6], [7]

setup-ssh[1]

SSL[1]

SSLを設定する[1]

start-domain[1], [2], [3], [4]

start-servers[1], [2], [3], [4]

stop-domain[1], [2], [3], [4]

stop-servers[1], [2], [3]

stop-webserver[1]

U

undeploy[1]

update-node-config[1]

update-node-ssh[1]

V

V9以前のApplication Serverがインストール済みの環境にApplication Serverを追加インストールする[1]

W

Web Server[1]

Web Service[1]

WebSocketのトレース取得ポイント[1]

WebSphere MQを使用して他システムと接続する構成[1]

Webコンテナーのトレース取得ポイント[1]

Webサーバ[1], [2]

Webサーバの設定を変更する[1], [2]

Webブラウザー[1]

Y

YoungGC[1]

あ

アプリケーション開発環境[1]

アプリケーション実行環境の構築の流れ[1]

アプリケーションの稼働状況を確認する[1]

アプリケーションのターゲットペイン[1]

アプリケーションのデプロイの流れ[1]

アプリケーションを入れ替える[1]

アプリケーションをデプロイする[1]

安定稼働のための構成[1]

い

インストール後の環境設定をする[1]

インストール後のディレクトリー構成について[1]

インストール済みの製品を更新する[1]

う

上書きインストール[1], [2]

運用管理サーバを利用するための設定をする[1]

運用タブ[1], [2], [3], [4]

か

仮想化プラットフォーム[1]

稼働情報ファイル[1]

可用性および性能を確保するための構成[1]

環境情報をバックアップする[1]

環境情報をリストアする[1]

環境変数[1], [2]

関連製品[1]

き

共用メモリーサイズの見積もりについて[1]

く

クライアント認証[1]

クラスター[1]

クラスター構成[1]

クラスローダーの階層構造[1]

クラスローダーの構成について[1]

クラスローダーの内容[1]

グローバルトランザクション[1]

こ

高信頼機能の設定[1]

構成[1]

構成管理タブ[1]

構築するアプリケーション実行環境の概要について[1]

コネクション管理について[1]

コネクション障害検知機能[1]

コマンド[1]

コマンドを利用してApplication Serverの稼働状況を確認する[1]

コマンドを利用してアプリケーションの稼働状況を確認する[1]

コマンドを利用してシステム設定情報を確認する[1]

コマンドを利用してシステムを開始する[1]

コマンドを利用してシステムを停止する[1]

コマンドを利用してデータベースサーバへの接続状況を確認する[1]

さ

サーバ[1]

サーバID[1]

サーバ間関連[1]

サーバテンプレート[1], [2]

サーバテンプレートからWebサーバの設定情報を確認する[1]

最小の構成[1]

サブコマンドのタイムアウト[1]

し

システム情報収集機能[1]

システム設定情報の確認について[1]

システムのステータスペイン[1]

システムの動作状況を確認する[1]

システムの利用状況を確認する[1]

システムをスケールアウトする[1]

自動化[1], [2]

修正パッチ[1]

修正パッチおよび修正版を適用する[1]

修正パッチ適用時のエラーメッセージ[1]

修正版[1]

障害検知の設定[1]

ジョブ[1]

新規インストール[1], [2]

す

スケールアウト[1]

スレッド数の見積もり[1]

スレッドプール[1]

せ

静的コンテンツをWebサーバに配置する[1]

性能解析トレースファイルの出力形式[1]

製品構成[1]

セキュリティー強化の設定[1]

セキュリティー対策について[1]

セキュリティーを確保するための構成[1]

セッションID[1]

セッション管理について[1]

全アプリケーションペイン[1], [2]

全サーバペイン[1], [2]

前提OS[1]

そ

ソフトウェアロードバランサー[1], [2], [3], [4]

ソフトウェアロードバランサーを設定する[1]

た

タイムアウト制御について[1]

他システムと連携するための構成[1]

つ

追加インストール[1]

Application Server[1]

通常運用時の作業の流れ[1]

通信[1]

て

ディスク占有量およびメモリー所要量について[1]

データベースサーバへの接続テストをする[1]

データベースサーバへの接続の流れ[1]

データベースサーバへの接続を設定する[1]

データベース容量の見積もり[1]

テナントごとにJava EEサーバを分ける構成[1]

と

ドメイン[1]

ドメイン管理サーバ[1]

ドメインを削除する[1]

ドメインを作成する[1]

トラブルシュート資料の活用[1]

トラブルシュート資料を一括収集するための設定をする[1]

トラブルシュートの流れについて[1]

トランザクション管理について[1]

ね

ネットワークを設定する[1]

の

ノード[1]

ノードを削除する[1]

ノードを作成する[1]

は

ハードウェアロードバランサー[1], [2], [3], [4]

バックに他システムと接続する構成[1]

パフォーマンストレーサー[1], [2]

パフォーマンストレーサー関連[1]

パフォーマンストレーサーのトレースの取得ポイント[1]

ひ

非同期でオンラインバッチ処理を行う構成[1]

標準仕様[1]

ふ

ファイアーウォール[1]

ファイルディスクリプター数の見積もり[1]

負荷分散[1]

負荷分散について[1]

複数インストール[1], [2]

プロセス監視[1]

プロセス監視について[1]

プロセス数の見積もり[1]

フロントに他システムと接続する構成[1]

ほ

ポート番号[1]

ポート番号を変更する[1]

ポートをオープンする[1]

ポートをクローズする[1]

ホームタブ[1]

保守運用時の作業の概要[1]

ホスト名[1]

ま

マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）[1]

マシンの起動時にシステムを同時に開始する（Red Hat Enterprise Linux Server 7の場合）[1]

マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 6以前およびAIXの場合）[1]

マシンの停止時にシステムを同時に停止する（Red Hat Enterprise Linux Server 7の場合）[1]

マニュアルの読み方について[1]

マルチテナント構成[1]

め

メールサーバ[1]

メッセージ監視[1]

メッセージ監視について[1]

り

リージョン[1]

リソースの見積もりについて[1]

リダイレクト関連[1]

リバースプロキシー[1]

リバースプロキシーを使用した構成[1]

リバースプロキシーを使用しない構成[1]

リバースプロキシーを設定する[1]

リモートホストにApplication Serverをインストールする[1]

リモートホストにApplication Serverをセットアップする[1]

リモートホストに接続するための設定をする[1]

リモートホストへのアプリケーション実行環境の構築の流れ[1]

流量制御について[1]

ろ

ローカルトランザクション[1]

ログファイルの出力形式[1], [2], [3], [4]

ログファイルのローテーション方式[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号