2 LinuxまたはUNIXでのTimesTen Classicのインストール
この章はTimesTen Classicのみを対象としています。LinuxおよびUNIXホストでTimesTen Classicのインストール環境およびインスタンスを作成および管理する方法について説明します。
TimesTen Classicをインストールする前に、用語を確認し、前提条件を満たしていることを確認してください。詳細は、TimesTen Classicでのインストール・プロセスの概要を参照してください。
TimesTen Scaleoutの詳細は、Oracle TimesTen In-Memory Database Scaleoutユーザーズ・ガイドのTimesTen Scaleoutの概要を参照してください。
この章では、主に、完全インストールと完全インスタンスを重点的に取り上げます。クライアントのみのインストール環境とインスタンスの詳細は、クライアントのみのインストール環境およびインスタンスを参照してください。
この章の例は、Linuxホストで実行しますが、完全インストールおよび完全インスタンスをサポートするプラットフォームにも該当します。
内容は次のとおりです。
この章の最後には、インストール環境の作成ステップ、インスタンスの作成、インスタンスの変更、インスタンスの破棄、およびインストール環境の削除のステップを示す例があります。この例は、インストール手順のすべての概念を1つにまとめています。参照:
詳細は、TimesTen Classicのインストールおよび削除の完全な例を参照してください。
Oracle Clusterwareのインストールに関する情報もあります。詳細は、TimesTenで使用するOracle Clusterwareのインストールを参照してください。
TimesTen Classicのインストールおよび削除の完全な例
この例は、インストール環境を作成し、インスタンスを操作する手順を示しています。この例では、System V initメカニズムを選択したことを前提としています。System V initメカニズムの詳細は、Linux/UNIXでのインスタンスの作成についてを参照してください。
完全インストールの作成
この例では、timesten2211290.server.linux8664.zipディストリビューションから完全インストールを作成します。
インスタンス管理者として指定したオペレーティング・システム・ユーザーが、インスタンスを持つことになるホストにTimesTenディストリビューションをダウンロードして最初にインストールを作成します。たとえば、timesten2211290.server.linux8664.zipをダウンロードします。
この例では、インスタンス管理者がディストリビューションをダウンロードした後に実行するステップを示します。詳細は、Linux/UNIXでのインストール環境の作成を参照してください。
この例では、installation1インストール・ディレクトリを作成し、そのディレクトリにディストリビューションを解凍します。
% mkdir installation1 % cd installation1 % unzip /timesten2211290.server.linux8664.zip [...UNZIP OUTPUT...]
完全インスタンスの作成
ttInstanceCreateユーティリティを対話形式で実行して、インストール環境から完全インスタンスを/installation1に作成します。/installation1ディレクトリは/installation_dirとして参照されています。詳細は、Linux/UNIXでのインスタンスの作成: 基本を参照してください。
この例では、完全インスタンスを対話形式で作成する方法を示します。インストール・ディレクトリの/bin領域に移動し、そのディレクトリにあるttInstanceCreateユーティリティを実行します。ttInstanceCreateユーティリティは、インストール・ディレクトリから実行する必要があります。ユーザーの入力は太字で示されています。
ノート:
Oracle Clusterwareを使用したTimesTenのレプリケーションは、Oracle Linux for Armシステムではサポートされていません。Oracle Linux for Armを使用している場合、Oracle ClusterwareのメッセージがttInstanceCreate出力に表示されません。
% installation_dir/tt22.1.1.29.0/bin/ttInstanceCreate NOTE: Each TimesTen instance is identified by a unique name. The instance name must be a non-null alphanumeric string, not longer than 255 characters. Please choose an instance name for this installation? [ tt221 ] fullinstance1 Instance name will be 'fullinstance1'. Is this correct? [ yes ] Where would you like to install the fullinstance1 instance of TimesTen? [ /home/ttuser ] /scratch/ttuser Creating instance in /scratch/ttuser/fullinstance1 ... INFO: Mapping files from the installation to /scratch/ttuser/fullinstance1/install NOTE: If you are configuring TimesTen for use with Oracle Clusterware, the daemon port number must be the same across all TimesTen installations managed within the same Oracle Clusterware cluster. NOTE: All installations that replicate to each other must use the same daemon port number that is set at installation time. The daemon port number can be verified by running 'ttVersion'. The default port number is 6624. Do you want to use the default port number for the TimesTen daemon? [ yes ] The daemon will run on the default port number (6624). In order to use the cache features in any TimesTen databases created within this instance, you must set a value for the TNS_ADMIN environment variable. It can be left blank, and a value can be supplied later using <install_dir>/bin/ttInstanceModify. Please enter a value for TNS_ADMIN (s=skip)? [ ] s What is the TCP/IP port number that you want the TimesTen Server to listen on? [ 6625 ] Would you like to use TimesTen Replication with Oracle Clusterware? [ no ] NOTE: The TimesTen daemon startup/shutdown scripts have not been installed. The startup script is located here : '/scratch/ttuser/fullinstance1/startup/tt_fullinstance1' Run the 'setuproot' script : /scratch/ttuser/fullinstance1/bin/setuproot -install This will move the TimesTen startup script into its appropriate location. The 2211290 Release Notes are located here : '/installation_dir/tt22.1.1.29.0/README.html' Starting the daemon ... TimesTen Daemon (PID: 20396, port: 6624) startup OK.
環境変数の設定
TimesTenを使用できるようにするには、環境変数を設定する必要があります。特に、TIMESTEN_HOMEが設定されていることを確認します。詳細は、TimesTenの環境変数の設定を参照してください。
次の例では、環境変数をソースにする方法を示します。インスタンス・ディレクトリ(インスタンス・ホーム)の/bin領域に移動し、ttenvスクリプトを実行します。この例では、ttenv.cshを使用します。
% source /scratch/ttuser/fullinstance1/bin/ttenv.csh [...ttenv.csh output...]
Linux/UNIXのprintenvコマンドを実行して、TIMESTEN_HOME変数が設定されていることを確認します。
% printenv TIMESTEN_HOME /scratch/ttuser/fullinstance1
Linuxカーネル・パラメータの構成
完全インスタンスを作成し、環境変数をソースにした後、Linuxカーネル・パラメータを構成する必要があります。詳細は、Linuxカーネル・パラメータの構成を参照してください。
ttStatusユーティリティの実行
必要に応じて、ttStatusユーティリティを実行して、TimesTenデーモンが実行されていることを確認できます。このユーティリティの詳細は、Oracle TimesTen In-Memory DatabaseリファレンスのttStatusを参照してください。
次の例では、ttStatusユーティリティを使用してデーモンが実行中であることを確認する方法を示します。
% ttStatus TimesTen status report... Daemon pid 20396 port 6624 instance database1 TimesTen server pid 20403 started on port 6625 ------------------------------------------------------------------------ ------------------------------------------------------------------------ Accessible by group g900 End of report
データベースの作成およびデータベースへの接続
次の例では、データベースを作成して接続する方法を示します。これは、Linuxのviエディタを使用して$TIMESTEN_HOME/conf/sys.odbc.iniファイルを変更し、database1 DSNを追加し、DSNの接続属性を指定します。次に、ttIsqlユーティリティを実行し、database1のDSNを作成して接続します。最後のステップとして、簡単な問合せを実行します。
DSNの詳細は、Oracle TimesTen In-Memory Databaseオペレーション・ガイドのTimesTenデータベースを識別するためのデータソース名の指定を参照してください。接続属性の詳細は、Oracle TimesTen In-Memory Databaseリファレンスの接続属性を参照してください。
% vi $TIMESTEN_HOME/conf/sys.odbc.ini
[database1]
DataStore=/disk1/databases/database1
LogDir=/disk2/logs
DatabaseCharacterSet=AL32UTF8
PermSize=1280
TempSize=640
LogBufMB=1024
sys.odbc.iniファイルを保存してviエディタを終了した後に、ttIsqlユーティリティを実行してデータベースを作成し、database1のDSNに接続します。(インスタンス管理者が新しく作成されたdatabase1のDSNに最初に接続したときに、データベースが作成されます)。
% ttIsql database1
Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.
connect "DSN=database1";
Connection successful: DSN=database1;UID=ttuser;DataStore=/databases/database1;
DatabaseCharacterSet=US7ASCII;ConnectionCharacterSet=US7ASCII;
DRIVER=fullinstancedir/fullinstance1/install/lib/libtten.so;
(Default setting AutoCommit=1)
簡単な問合せを実行します。
Command> SELECT * FROM dual; < X > 1 row found.
ttStatusの実行による接続の表示
ttStatusを実行して、database1データベースへの接続を表示できます。このユーティリティの詳細は、Oracle TimesTen In-Memory DatabaseリファレンスのttStatusを参照してください。
この例では、ttStatusユーティリティを実行してデータベースへの接続を表示します。
% ttStatus TimesTen status report... Daemon pid 20396 port 6624 instance database1 TimesTen server pid 20403 started on port 6625 ------------------------------------------------------------------------ ------------------------------------------------------------------------ Data store /databases/database1 Installation will expire after... Daemon pid 20396 port 6624 instance database1 TimesTen server pid 20403 started on port 6625 There are 14 connections to the data store Shared Memory KEY 0x02100497 ID 4292609 PL/SQL Memory KEY 0x03100497 ID 4325378 Address 0x5000000000 Type PID Context Connection Name ConnID Process 20766 0x00007f06f4ccf010 database1 1 Subdaemon 20401 0x00007f92b40008c0 Checkpoint 2041 Subdaemon 20401 0x00007f92bc0008c0 Monitor 2042 Subdaemon 20401 0x00007f92c40008c0 Deadlock Detector 2044 Subdaemon 20401 0x00007f92dc0008c0 Flusher 2045 Subdaemon 20401 0x00007f92e485d010 Garbage Collector 2036 Subdaemon 20401 0x00007f92e4c78010 XactId Rollback 2037 Subdaemon 20401 0x00007f92e5194010 IndexGC 2035 Subdaemon 20401 0x00007f92e56b0010 HistGC 2040 Subdaemon 20401 0x00007f92e5bcc010 AsyncMV 2038 Subdaemon 20401 0x00007f92e60e8010 Log Marker 2039 Subdaemon 20401 0x00007f92e6503010 Aging 2043 Subdaemon 20401 0x00007f92e77ca010 Rollback 2046 Subdaemon 20401 0x00007f92e7be5010 Manager 2047 Replication policy : Manual Cache Agent policy : Manual PL/SQL enabled. ------------------------------------------------------------------------ Accessible by group g900 End of report
完全インスタンスの変更
この例では、ttInstanceModifyユーティリティを実行してデーモンのポート番号を変更します。変更されるインスタンスは、$TIMESTEN_HOMEで参照されるインスタンスです。このコマンドの実行では:
- 確認を求められます
- インスタンスのTimesTenデーモンを停止します
- 更新された情報で
$TIMESTEN_HOME/conf/timesten.confファイルを編集します - インスタンスのTimesTenデーモンを起動します
詳細は、Linux/UNIXでのインスタンスの変更を参照してください。
この例では、Linux/UNIX echoコマンドを実行して、$TIMESTEN_HOMEが参照するインスタンスを表示し、$TIMESTEN_HOME/conf/timesten.confファイルを確認して現在のポート番号の設定を確認します。次に、ttInstanceModifyを実行してポート番号を6524に変更します。この例では、$TIMESTEN_HOME/conf/timesten.confファイルを確認し、ポート番号が変更されていることを確認します。最後のステップとして、デーモンが起動します。
% echo $TIMESTEN_HOME
/scratch/ttuser/fullinstance1
% cat $TIMESTEN_HOME/conf/timesten.conf
# TimesTen Instance Configuration File
# Created by ttInstanceCreate
# Commented values are default values
hostname=host1
timesten_release=22.1
instance_name=fullinstance1
daemon_port=6624
server_port=6625
admin_user=myadminuser
admin_uid=4738
group_name=timesten
instance_guid=9EEF0277-21C0-45F1-AB63-F0C5F48B6FE0
verbose=1
ttInstanceModifyを実行して、ポート番号を6524に変更します。
% $TIMESTEN_HOME/bin/ttInstanceModify -port 6524
The daemon will now run on port 6524 ...
You must restart the daemon for these changes to take effect.
$TIMESTEN_HOME/conf/timesten.confファイルを確認して、ポート番号が変更されたことを確認します。このファイルの詳細は、インスタンスの構成ファイル(timesten.conf)を参照してください。
% cat $TIMESTEN_HOME/conf/timesten.conf
# TimesTen Instance Configuration File
# Created by ttInstanceCreate
# Commented values are default values
hostname=host1
timesten_release=22.1
instance_name=fullinstance1
daemon_port=6524
server_port=6625
admin_user=myadminuser
admin_uid=4738
group_name=timesten
instance_guid=9D37C711-DF86-4007-A959-2AB52DA46035
verbose=1
デーモンを再起動します
% ttDaemonAdmin -start -force TimesTen Daemon (PID: 11635, port: 6524) startup OK.
完全インスタンスの破棄
インスタンスを破棄するには、ttInstanceDestroyユーティリティを対話形式で使用します。この例では、オプションなしでユーティリティを実行します。このユーティリティは、インストール・ディレクトリのbin領域から実行する必要があります。詳細は、Linux/UNIXでのインスタンスの破棄を参照してください。
% installation_dir/tt22.1.1.29.0/bin/ttInstanceDestroy
** WARNING **
The uninstallation has been executed by a non-root user.
If the TimesTen daemon startup scripts were installed,
you must run $TIMESTEN_HOME/bin/setuproot -uninstall
to remove them. If you proceed with this uninstallation, you
will have to remove the startup scripts manually.
** WARNING **
All files in the directory:
/scratch/ttuser/fullinstance1
will be removed, including any file that you or other users
may have created.
Are you sure you want to completely remove this instance? [ yes ] yes
Installation will remove all the files from /scratch/ttuser/fullinstance1.
Do you want to continue? [ yes ]
NOTE: /scratch/ttuser/fullinstance1/info contains information
related to the data store that have been created with this release.
If you remove /scratch/ttuser/fullinstance1/info
you will no longer be able to access your data stores,
nor would you be able to restore nor migrate your data.
NOTE: /scratch/ttuser/fullinstance1/conf contains information
related to the instance configuration.
/scratch/ttuser/fullinstance1 Removed
The TimesTen instance fullinstance1 has been destroyed.