2. Statspack Configuration
---------------------------
2. Statspack設定
2.1. Database Space Requirements
2.1. データベース必要な領域
The amount of database space required by the package will vary considerably
based on the frequency of snapshots, the size of the database and instance,
and the amount of data collected (which is configurable).
このパッケージに必要な領域サイズは主にスナップショットの頻度、
データベース・インスタンスのサイズ、収集データ量（構成によって設定可能）によって異なる。
It is therefore difficult to provide general storage clauses and space
utilization predictions that will be accurate at each site.
従って、共通の記憶域構文及び正確な領域使用予測を提供することは困難です。
Space Requirements
------------------
必要な領域
The default initial and next extent sizes are 100k, 1MB, 3MB or 5MB for all
Statspack tables and indexes. To install Statspack, the minimum
space requirement is approximately 100MB. However, the amount of space
actually allocated will depend on the Tablespace storage characteristics
of the tablespace Statspack is installed in (for example, if your minimum
extent size is 10m, then the storage requirement will be considerably more
than 100m).
全てのStatspackテーブルとインデックスにとってデフォルトの初期及び次のエクステントサイズは
100k、1MB、3MB又は5MBである。Statspackをインストールするには、領域の最小要件は約100MBである。
但し、表領域の特性によって実際割り当てられるサイズが変わる。
（例：最小エクステントサイズを10Mとした場合、所要領域は100Mを超えるかもしれない）
Using Locally Managed Tablespaces
---------------------------------
ローカル管理表領域の使用
If you install the package in a locally-managed tablespace, such as
SYSAUX, modifying storage clauses is not required, as the storage
characteristics are automatically managed.
SYSAUXのようなローカル管理表領域にパッケージをインストールした場合、
特性により自動管理されるため、領域構文が必須ではない。
Using Dictionary Managed Tablespaces
------------------------------------
ディクショナリ管理表領域の使用
If you install the package in a dictionary-managed tablespace, Oracle
suggests you monitor the space used by the objects created, and adjust
the storage clauses of the segments, if required.
ディクショナリ管理表領域を使用するなら、Oracleは領域監視し、
必要の場合、セグメントの領域構文を調整することをお勧めする。
2.2. Installing the Tool
2.2. ツールのインストール
Installation scripts create a user called PERFSTAT, which will own all
PL/SQL code and database objects created (including the STATSPACK tables,
constraints and the STATSPACK package).
インストールスクリプトはPERFSTATユーザを作成し、このユーザに全てのPL/SQLコード及び
作成したデータベースオブジェクトが所属される。
（STATSPACKテーブル、制約及びSTATSPACKパッケージを含む）
During the installation you will be prompted for the PERFSTAT
user's password and default and temporary tablespaces.
インストールする際、PERFSTATユーザのパスワードと既定一時表領域名
が要求される。
The default tablespace will be used to create all Statspack
objects (such as tables and indexes). Oracle recommend using the
SYSAUX tablespace for the PERFSTAT user's default tablespace; the
SYSAUX tablespace will be the tablespace defaulted during the
installation, if no other is specified.
デフォルト表領域に全てのSTATSPACKオブジェクト（テーブルとインデックス）が作成される。
OracleはPERFSTATユーザの既定としてSYSAUX表領域を使用することを提案する。
指定しない場合、SYSAUX表領域はデフォルト表領域となる。
A temporary tablespace is used for workarea activities, such
as sorting (for more information on temporary tablespaces, see
the Oracle10g Concepts Manual). The Statspack user's temporary
tablespace will be set to the database's default temporary tablespace
by the installation, if no other temporary tablespace is specified.
一時表領域は活動ワークエリア（例：ソート（一時表領域について、Oracle10g
概要マニュアルを参照する））として使用される。指定しない場合、データベース
の一時表領域はデフォルト値となる。 NOTE:
注意：
o A password for PERFSTAT user is mandatory and there is no default
password; if a password is not specified, the installation will
abort with an error indicating this is the problem.
・PERFSTATユーザのパスワードは必須であり、指定しない場合この問題を示す
エラーメッセージを表示し、インストールが中断される。
o For security reasons, keep PERFSTAT's password confidential.
・セキュリティ上PERFSTATのパスワードを秘密扱いにする
o Do not specify the SYSTEM tablespace for the PERFSTAT users
DEFAULT or TEMPORARY tablespaces; if SYSTEM is specified the
installation will terminate with an error indicating this is the
problem. This is enforced as Oracle does not recommend using
the SYSTEM tablespace to store statistics data, nor for workareas.
Use the SYSAUX (or a TOOLS) tablespace to store the data, and
your instance's TEMPORARY tablespace for workareas.
・PERFSTATユーザの既定表領域又は一時表領域としてSYSTEM表領域を指定しない
指定した場合この問題を示すエラーメッセージを表示し、インストールが中断される。
OracleがSYSTEM表領域を使用して統計データとワークエリアの保存するのを推奨しない。
SYSAUX（又はTOOLS）表領域を利用しよう。
o During the installation, the dbms_shared_pool PL/SQL package
is created. dbms_shared_pool is used to pin the Statspack
package in the shared pool
dbms_job is no longer created as part of the installation, as
it is already created by catproc.sql (dbms_job can be used by
the DBA to schedule periodic snapshots automatically).
・インストール中にdbms_shared_pool PL/SQL パッケージが作成される。
dbms_shared_poolはstatspackパッケージをshared poolに格納ために利用される。
catproc.sql実行時既にされたため、インストール中にdbms_jobは再度作成されない。
（dbms_jobは期間中に自動的にスナップショットを採取するための
スケジューリングとして利用可能） To install the package, either change directory to the ORACLE_HOME
rdbms/admin directory, or fully specify the ORACLE_HOME/rdbms/admin
directory when calling the installation script, spcreate.
パッケージをインストールするには、インストールスクリプトspcreateを呼び出す時
ディレクトリをORACLE_HOME/rdbms/adminに変更するか、フルパスを指定する
To run the installation script, you must use SQL*Plus and connect as
a user with SYSDBA privilege.
インストールスクリプトを実行する場合、SQL*Plusを使ってSYSDBA権限で接続する必要がある。 e.g. Start SQL*Plus, then:
on Unix:
SQL> connect / as sysdba
SQL> @?/rdbms/admin/spcreate
on Windows:
SQL> connect / as sysdba
SQL> @%ORACLE_HOME%\rdbms\admin\spcreate
The spcreate install script runs 3 other scripts - you do not need to
run these - these scripts are called automatically:
1. spcusr -> creates the user and grants privileges
2. spctab -> creates the tables
3. spcpkg -> creates the package
spcreateインストールスクリプトは他３つのスクリプトを実行している。
自動的に呼び出されるため、マニュアルで実行する必要がない
1. spcusr -> ユーザ作成と権限の付与
2. spctab -> テーブルの作成
3. spcpkg -> パッケージの作成
Check each of the three output files produced (spcusr.lis,
spctab.lis, spcpkg.lis) by the installation to ensure no
errors were encountered, before continuing on to the next step.
次のステップへ進む前に、インストール中エラーないかを確認する。
上記三つのファイルの出力を確認する（spcusr.lis,spctab.lis, spcpkg.lis）
Note that there are two ways to install Statspack - interactively (as
shown above), or in 'batch' mode; batch mode is useful when you do
not wish to be prompted for the PERFSTAT user's password, and default
and temporary tablespaces.
注意：インストール方法は二つある。対話的（上記の通り）又はバッチモード。
PERFSTATユーザのパスワードと表領域を聞かれたくない時にバッチモードが有用である Batch mode installation
~~~~~~~~~~~~~~~~~~~~~~~
バッチモードのインストール
To install in batch mode, you must assign values to the SQL*Plus
variables which specify the password and the default and temporary
tablespaces before running spcreate.
バッチモードでインストールするには、spcreateを実行する前に
パスワード、既定表領域と一時表領域のSQL*Plusの変数を設定する必要がある
The variables are:
perfstat_password -> for the password
default_tablespace -> for the default tablespace
temporary_tablespace -> for the temporary tablespace
関連変数は:
perfstat_password -> パスワード
default_tablespace -> 既定表領域
temporary_tablespace -> 一時表領域 e.g.
on Unix:
SQL> connect / as sysdba
SQL> define default_tablespace='tools'
SQL> define temporary_tablespace='temp'
SQL> define perfstat_password='erg8oiw'
SQL> @?/rdbms/admin/spcreate
SQL> undefine perfstat_password
spcreate will no longer prompt for the above information.
すると、spcreateから対話的に聞かれることなく進める。
2.3. Errors during installation
2.3. インストール時エラー
Specifying SYSTEM tablespace
A possible error during installation is to specify the SYSTEM
tablespace for the PERFSTAT user's DEFAULT or TEMPORARY tablespace.
In such a situation, the installation will fail, stating the problem.
SYSTEM表領域の指定
可能なエラーとしてSYSTEM表領域を指定し、インストールが失敗する
To install Statspack after receiving errors during the installation
To correctly install Statspack after such errors, first run the
de-install script, then the install script. Both scripts must be
run from SQL*Plus.
エラー発生後のStatspackインストール
正しくインストールするため、まずアンインストールのスクリプトを呼び出し、
その後再インストールする。どちらもSQL*Plusで実行する必要がある
e.g. Start SQL*Plus, connect as a user with SYSDBA privilege, then:
SQL> @spdrop
SQL> @spcreate
