OpenText Analytics Database 旧Vertica

技術情報サイト

Analytics Database

サブスクリプションライセンスキーの更新方法

公開日：
更新日：
その他
#ライセンス

はじめに

本記事では、既に適用済みの「旧サブスクリプションライセンス」を「新サブスクリプションライセンス」(*)に更新する方法をご紹介します。
 
(*)ライセンスの詳細は、紹介資料をご参考になさってください。

サブスクリプションライセンスキーの更新方法

サブスクリプションライセンスキーを更新するには、以下の3通りの方法があります。
 

① admintoolsを使用した方法
② SELECT INSTALL_LICENSEを使用した方法
③ Management Consoleを使用した方法

 
「旧サブスクリプションライセンス」が適用済みの環境は、追加で「新サブスクリプションライセンス」を適用することで、有効期限が更新されます。本記事では、以下のサブスクリプションライセンスを例にあげて、手順をご紹介します。
 

 

start_date

end_date

size

旧サブスクリプションライセンス

2024-06-27 09:00:00

2025-06-28 08:59:59

1TB

新サブスクリプションライセンス

2025-06-27 09:00:00

2026-06-28 08:59:59

1TB

admintoolsを使用した方法

1. Verticaのいずれかのノード上にある任意のディレクトリに、「新サブスクリプションライセンス」のキーファイルを配置します。
(例:1号機の/tmp配下に配置)

2. 「新サブスクリプションライセンス」に更新するために、ライセンスキーのファイルを配置したノード上のdbadminユーザーにて、以下のadmintools のコマンドを実行します。

▼コマンド

$ admintools -t upgrade_license_key -d データベース名 -p パスワード -l “<新サブスクリプションライセンスキーのファイル配置場所>”

 
▼実行例

$ admintools -t upgrade_license_key -d test -p test -l "/tmp/new_subscription_license_key_file.xml"
Upgrading the license key for database test
License installed with at least partial success.
Details:
Success: Installing 95669b91-81cb-40aa-9a53-2e6712a1fe06 license:
CompanyName: Vertica Systems, Inc.
start_date: 2025-06-27 09:00:00
end_date: 2026-06-28 08:59:59
grace_period: 30
capacity: 1.00TB
Node Limit: Unlimited

 
3. vsqlでデータベースに接続後、LICENSESシステムテーブルを参照することでライセンスが適用されたことを確認します。以下実行例で★印のとおり、新と旧の2つのサブスクリプションライセンスが適用されて、有効期限が更新されたことを確認します。

▼実行例

$ vsql -w パスワード
test=> \x
Expanded display is on.
test=> SELECT VERSION();
version|Vertica Analytic Database v25.2.0-1
test=> SELECT * FROM LICENSES;
-[ RECORD 1 ]----------+-------------------------------------
★license_id | 95035996273707532  　　　　　　　　　　★旧サブスクリプションライセンスの情報
name | 9191c742-deb8-401b-ab5c-21da6c0d2fb1
licensee | Vertica Systems, Inc.
start_date | 2024-06-27 09:00:00
end_date | 2025-06-28 08:59:59
licensetype | Premium Edition
parent |
size | 1TB
is_size_limit_enforced | f
node_restriction |
core_restriction |
configured_id | 9191c742-deb8-401b-ab5c-21da6c0d2fb1
-[ RECORD 2 ]----------+-------------------------------------
★license_id | 95035996273707538                      ★新サブスクリプションライセンスの情報
name | 95669b91-81cb-40aa-9a53-2e6712a1fe06
licensee | Vertica Systems, Inc.
★start_date | 2025-06-27 09:00:00
★end_date | 2026-06-28 08:59:59
licensetype | Premium Edition
parent |
size | 1TB
is_size_limit_enforced | f
node_restriction |
core_restriction |
configured_id | 95669b91-81cb-40aa-9a53-2e6712a1fe06

 
4. audit_license_size関数の実行結果より、「新サブスクリプションライセンス」が適用されたこと、またライセンスで許可された使用可能なデータサイズを確認します。

▼実行例

test=> \a
Output format is unaligned.
test=> SELECT AUDIT_LICENSE_SIZE();
audit_license_size|Raw Data Size: 0.00TB +/- 0.00TB
★License Size : 2.00TB　　　　★使用可能なデータサイズを確認
 Utilization  : 0%
 Audit Time   : 2025-07-25 11:58:10.645824+09
 Compliance Status : The database is in compliance with respect to raw data size.

 License 4191c742-deb8-401b-ab5c-21da6c0d2fb1 End Date: 2025-06-28 08:59:59 Days Past Expiration: 27.12; grace period expires in 2 days.
★License 95669b91-81cb-40aa-9a53-2e6712a1fe06 End Date: 2026-06-28 08:59:59 Days Remaining: 337.88　　　★新サブスクリプションライセンスの情報が表示されることを確認

（※）License Size は、2.00TB（旧1TB ＋ 新1TB）と表示されます。「旧サブスクリプションライセンス」は失効後30日間は有効です。31日以降は自動的に無効となるので、削除の必要はありません。

SELECT INSTALL_LICENSEを使用した方法

1. Verticaのいずれかのノード上にある任意のディレクトリに、「新サブスクリプションライセンス」のキーファイルを配置します。
(例:1号機の/tmp配下に配置)

2. 「新サブスクリプションライセンス」に更新するために、ライセンスキーのファイルを配置したノード上のdbadminユーザーでvsqlにログイン後、以下のSELECT INSTALL_LICENSE のコマンドを実行します。

▼コマンド

SELECT INSTALL_LICENSE(‘<新サブスクリプションライセンスキーのファイル配置場所>’);

 
▼実行例

$ vsql -w パスワード 
test=> SELECT INSTALL_LICENSE('/tmp/new_subscription_license_key_file.xml');
                                                                                                       INSTALL_LICENSE
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 Success: Installing 95669b91-81cb-40aa-9a53-2e6712a1fe06 license:
CompanyName: Vertica Systems, Inc.
start_date: 2025-06-27 09:00:00
end_date: 2026-06-28 08:59:59
grace_period: 30
capacity: 1.00TB
Node Limit: Unlimited


(1 row)

 
3. LICENSESシステムテーブル を参照することでライセンスが適用されたことを確認します。以下実行例で★印のとおり、新と旧の2つのサブスクリプションライセンスが適用されて、有効期限が更新されたことを確認します。

▼実行例

test=> SELECT VERSION();
version|Vertica Analytic Database v25.2.0-1
test=> SELECT * FROM LICENSES;
-[ RECORD 1 ]----------+-------------------------------------
★license_id | 95035996273707532  　　　　　　　　　　★旧サブスクリプションライセンスの情報
name | 9191c742-deb8-401b-ab5c-21da6c0d2fb1
licensee | Vertica Systems, Inc.
start_date | 2024-06-27 09:00:00
end_date | 2025-06-28 08:59:59
licensetype | Premium Edition
parent |
size | 1TB
is_size_limit_enforced | f
node_restriction |
core_restriction |
configured_id | 9191c742-deb8-401b-ab5c-21da6c0d2fb1
-[ RECORD 2 ]----------+-------------------------------------
★license_id | 95035996273707538                      ★新サブスクリプションライセンスの情報
name | 95669b91-81cb-40aa-9a53-2e6712a1fe06
licensee | Vertica Systems, Inc.
★start_date | 2025-06-27 09:00:00
★end_date | 2026-06-28 08:59:59
licensetype | Premium Edition
parent |
size | 1TB
is_size_limit_enforced | f
node_restriction |
core_restriction |
configured_id | 95669b91-81cb-40aa-9a53-2e6712a1fe06

 
4. audit_license_size関数の実行結果より、「新サブスクリプションライセンス」が適用されたこと、またライセンスで許可された使用可能なデータサイズを確認します。

▼実行例

test=> \a
Output format is unaligned.
test=> SELECT AUDIT_LICENSE_SIZE();
AUDIT_LICENSE_SIZE|Raw Data Size: 0.00TB +/- 0.00TB
★License Size : 2.00TB　　　　★使用可能なデータスサイズを確認
 Utilization  : 0%
 Audit Time   : 2025-07-25 14:22:24.821338+09
 Compliance Status : The database is in compliance with respect to raw data size.

 License 9191c742-deb8-401b-ab5c-21da6c0d2fb1 End Date: 2025-06-28 08:59:59 Days Past Expiration: 27.22; grace period expires in 2 days.
★License 95669b91-81cb-40aa-9a53-2e6712a1fe06 End Date: 2026-06-28 08:59:59 Days Remaining: 337.78　　　★新サブスクリプションライセンスの情報が表示されることを確認

（※）License Size は、2.00TB（旧1TB ＋ 新1TB）と表示されます。「旧サブスクリプションライセンス」は失効後30日間は有効です。31日以降は自動的に無効となるので、削除の必要はありません。

Management Consoleを使用した方法

1. Management Consoleに接続可能なPCにサブスクリプションライセンスキーのファイルを配置します。

2. ブラウザでManagement Consoleに接続し、トップメニューから以下の操作を実施ください。

→画面左側のバーにある「View infrastructure」タブをクリック
→「Database and Cluster View」をクリック後、右側に表示された「Database」のアイコンをクリック
→右側に表示されたポップアップ画面の中の「View」ボタンをクリック
→画面左側のバーにある「License」タブをクリック
→画面上部にある「Install New License」ボタンをクリック
→「Upload a new database license」の項目にある「Browse」ボタンをクリックし、ライセンスキーのファイルを指定
→画面上部にある「Apply」ボタンをクリック
→Accept EULA and Analyticsでライセンス許諾の内容に問題がないければ、「チェックボックス」にチェックを入れ、「OK」ボタンをクリック
→ポップアップした画面で「Success」と表示されていればライセンスを適用できたことなので、「Close」ボタンをクリック
→画面左側のバーにある「License」タブをクリック
→画面上部にある「AUDIT」ボタンをクリック

 
以下画像のとおり、Installed Licensesに表示されている1行目が「旧サブスクリプションライセンス」、2行目が「新サブスクリプションライセンス」です。

（※）上記画像の Latest Audit（total usage）は、2.00TB（旧1TB ＋ 新1TB）と表示されます。「旧サブスクリプションライセンス」は失効後30日間は有効です。31日以降は自動的に無効となるので、削除の必要はありません。

注意事項

新サブスクリプションライセンス適用のタイミング

旧サブスクリプションライセンス失効後の適用

「新サブスクリプションライセンス」は「旧サブスクリプションライセンス」が失効後、30日以内に更新してください。30日間を経過してしまうと、以下の動作になってしまいます。
 
・DDL文
すべてのDDL文の実行時に以下例のとおりWARNINGが出力されます。
 
▼WARNING例

#SAMPLE表を作成/削除した時

test=> CREATE TABLE sample
test-> (no number,
test(> word varchar);
WARNING 8724: All of your Vertica licenses have expired
HINT: To obtain a license please visit https://softwaresupport.softwaregrp.com/
CREATE TABLE
test=> DROP TABLE SAMPLE;
WARNING 8724: All of your Vertica licenses have expired
HINT: To obtain a license please visit https://softwaresupport.softwaregrp.com/
DROP TABLE

 
・DML文
すべてのDML文の実行時に以下例のとおりエラーが発生し実行できません。
 
▼エラー例

#TEST表に対してINSERTやUPDATEを実行した時

test=> INSERT INTO test VALUES(4, 'DDD');
ERROR 8724: All of your Vertica licenses have expired
HINT: To obtain a license please visit https://softwaresupport.softwaregrp.com/
test=> UPDATE test SET no = 0 WHERE word = 'BBB';
ERROR 8724: All of your Vertica licenses have expired
HINT: To obtain a license please visit https://softwaresupport.softwaregrp.com/

 
また、もし上記30日間を経過してしまった場合でも「新サブスクリプションライセンス」への更新は可能です。
その際は、上述の「サブスクリプションライセンスキーの更新方法①②③」のいずれかにて、実施してください。

旧サブスクリプションライセンス失効前の適用

「旧サブスクリプションライセンス」が失効前の時点で「新サブスクリプションライセンス」を適用しようとした場合、以下例のとおりエラーが発生し「新サブスクリプションライセンス」の適用ができません。失効後に適用してください。
 
▼エラー例

#SELECT INSTALL_LICENSEを使用した方法で適用した時

test=> SELECT INSTALL_LICENSE('/tmp/new_subscription_license_key_file.xml');
ERROR 9397: None of the licenses in this file can be installed [/tmp/new_subscription_license_key_file.xml]
Skipping license 95669b91-81cb-40aa-9a53-2e6712a1fe06: Vertica license is not yet valid
HINT: Visit https://softwaresupport.softwaregrp.com/

検証バージョンについて

この記事の内容はVertica 25.2で確認しています。

更新履歴

2025/08/28　本記事を公開

この記事をシェアする