インストールガイド
Red Hat CodeReady Studio のインストール
Levi Valeeva
levi@redhat.com
Yana Hontyk
yhontyk@redhat.com
devtools-docs@redhat.com
概要
第1章 最小要件
CodeReady Studio 12.16 は、さまざまなオペレーティングシステム、アーキテクチャー、および Java Development Kit の組み合わせと互換性があります。互換性の完全リストは「Supported Configurations and Components」を参照してください。
ハードウェア要件
2 GB の RAM
- 4 GB の RAM の使用を 強く 推奨します。
- 2 GB のハードディスク容量
ソフトウェア要件
OpenJDK がインストールされている必要があります。
- Red Hat OpenJDK の使用を 強く 推奨します。
オペレーティングシステムの要件
For Linux (x86_64)
- Red Hat Enterprise Linux 7 または 8
- Fedora 31 または 32
- Ubuntu 20.04 LTS または 19.10
Windows(x86_64)
- Microsoft Windows 8 または 10
MacOS(x86_64)
- Catalina (10.15) または Mojave (10.14)
Windows で、すべてのユーザーが CodeReady Studio インスタンスを利用できるようにするには、すべてのユーザーがアクセスできるフォルダー (C:\codereadystudio
) にインストールします。指定ユーザーがメインのインストールフォルダーに書き込みできない場合、新たにインストールされた機能や更新はユーザーのホームディレクトリー内に保存されます。
第2章 OpenJDK のインストール
ここでは、Microsoft Windows および Red Hat Enterprise Linux (RHEL) に OpenJDK をインストールする方法を説明します。
2.1. Windows での OpenJDK のインストール
MSI ベースのインストーラーを使用して OpenJDK 1.8.0 を Windows にインストールする方法を説明します。
手順
- Red Hat Developer Portal から MSI ベースのインストーラーをダウンロードします。
- インストーラーを実行し、画面のインストール手順にしたがいます。
- 「Working with Java Runtime Environments」の手順にしたがって、CodeReady Studio が OpenJDK を使用するように設定します。
2.1.1. その他のリソース
- OpenJDK 11 のインストール方法は、『OpenJDK 11 for Windows Getting Started Guide』を参照してください。
2.2. RHEL での OpenJDK のインストール
RHEL に OpenJDK 1.8.0 および OpenJDK 11 をインストールする方法を説明します。
前提条件
-
Root
アクセス。 サブスクリプションがアタッチされた登録済みのシステム。
詳細は『システム登録およびサブスクリプション管理』を参照してください。
2.2.1. RHEL での OpenJDK 1.8.0 のインストール
RHEL に OpenJDK 1.8.0 をインストールする方法を説明します。
手順
OpenJDK RPM をインストールするには、以下のコマンドを実行します。
# yum install java-1.8.0-openjdk-devel
任意で、java-1.8.0-openjdk-src および java-1.8.0-openjdk-demo パッケージをインストールできます。Java-1.8.0-openjdk-src パッケージには、IDE インデクサーおよびデバッガーと使用できる OpenJDK 8 クラスライブラリーのソースコードがすべて含まれています。java-1.8.0-openjdk-demo パッケージには、OpenJDK の Java ランタイム (デモおよび例) が含まれます。
java-1.8.0-openjdk-demo および java-1.8.0-openjdk-src をインストールするには、以下を実行します。
# yum install java-1.8.0-openjdk-src java-1.8.0-openjdk-demo
2.2.2. RHEL での OpenJDK 11 のインストール
RHEL に OpenJDK 11 をインストールする方法を説明します。
手順
OpenJDK RPM をインストールするには、以下のコマンドを実行します。
# yum install java-11-openjdk-devel
任意で、java-11-openjdk-src および java-11-openjdk-demo パッケージをインストールできます。Java-11-openjdk-src パッケージには、IDE インデクサーおよびデバッガーと使用できる OpenJDK 8 クラスライブラリーのソースコードがすべて含まれています。java-11-openjdk-demo パッケージには、OpenJDK の Java ランタイム (デモおよび例) が含まれます。
java-11-openjdk-demo および java-11-openjdk-src をインストールするには、以下を実行します。
# yum install java-11-openjdk-src java-11-openjdk-demo
トラブルシューティング
OpenShift 4.4.0 クラスターにログインできない場合は、SSL プロトコルを default に設定して JDK 8 を使用するか、SSL プロトコルとして TLSv1.2 を使用するように Java を設定します。
TLSv1.2 を使用するよう Java を設定するには、以下を実行します。
$ java -Djdk.tls.client.protocols=TLSv1.2 MyApplication.jar
MyApplication はアプリケーションの名前に置き換えます。
2.2.3. その他のリソース
- RHEL8 に並行してインストールされた 2 つの OpenJDK メジャーバージョンのインストール方法、実行方法、切り替え方法は、「How to install Java 8 and 11 on Red Hat Enterprise Linux 8」を参照してください。
第3章 CodeReady Studio のインストール
本章では、CodeReady Studio のインストール方法を説明します。
複数のバージョンの CodeReady Studio が異なるディレクトリーにあれば、インストーラーまたは Eclipse を使用して複数のバージョンの CodeReady Studio をシステムにインストールできます。
3.1. Eclipse での CodeReady Studio のインストール
Eclipse 用の CodeReady Studio は、既存の Eclipse インスタンスの CodeReady Studio プラグインをパッケージ化します。オンラインの状態であれば、Eclipse Marketplace から CodeReady Studio をインストールできます。このインストール方法は、BYOE (Bring Your Own Eclipse) と呼ばれています。オフラインの場合は、Update Site Zip
を使用して CodeReady Studio をインストールできます。
オンラインまたはオフラインの場合に CodeReady Studio をインストールする方法を説明します。
3.1.1. Eclipse での CodeReady Studio のインストール (オンライン時)
Eclipse Marketplace から CodeReady Studio BYOE をインストールする方法を説明します。
手順
- Eclipse IDE を起動します。
Help → Eclipse Marketplace をクリックします。
Eclipse Marketplace ウィンドウが表示されます。
Red Hat CodeReady Studio 12.16 GA を見つけます。
- Install をクリックします。
画面の手順にしたがってインストールを完了します。
重要インストールする追加機能を選択するプロンプトが表示されたら、インテグレーションアプリケーションの作成、テスト、およびデバッグを行う Fuse Tooling 機能を選択します。
署名なしコンテンツのインストールに関する警告を受け取った場合は、コンテンツの詳細を確認し、問題がなければ Install Anyway をクリックしてインストールを続行します。
Eclipse を再起動します。
Eclipse IDE を再起動するよう要求されたら、Restart Now をクリックします。Eclipse を再起動するまで変更は反映されないため、注意してください。
3.1.2. Eclipse での CodeReady Studio のインストール (オフライン時)
ここでは、Update Site Zip
で CodeReady Studio をインストールする方法を説明します。Update Site Zip
の代わりに、システムにダウンロードしたインストーラーを使用することもできます。
Target Platform Zip
には、CodeReady Studio が依存する機能が含まれているため注意してください。また、含まれるすべてのプラグインのソースも含まれています。
前提条件
- Red Hat Developer Portal から Red Hat CodeReady Studio 12.16 Update Site Zip をダウンロードします。
手順
- Eclipse IDE を起動します。
Help → Install New Software をクリックします。
Available Software ウインドウが表示されます。
Add をクリックします。
Add Repository ウインドウが表示されます。
-
Archive をクリックし、
Update Site Zip
ファイルを見つけます。 - Add をクリックします。
Red Hat CodeReady Studio - Bring Your Own Eclipse および Red Hat Fuse Tooling チェックボックスを選択します。
- Next をクリックします。
画面の手順にしたがってインストールを完了します。
署名なしコンテンツのインストールに関する警告を受け取った場合は、コンテンツの詳細を確認し、問題がなければ Install Anyway をクリックしてインストールを続行します。
Eclipse を再起動します。
Eclipse IDE を再起動するよう要求されたら、Restart Now をクリックします。Eclipse を再起動するまで変更は反映されないため、注意してください。
3.2. インストーラーを使用した CodeReady Studio スタンドアロンのインストール
インストーラーには、Eclipse の CodeReady Studio プラグインや依存するサードパーティープラグインをパッケージ化する CodeReady Studio スタンドアロンが含まれます。インストーラーはすべてのオペレーティングシステムと互換性があり、Red Hat カスタマーポータルなどの複数のソースから入手できます。
ここでは、インストーラーを使用して CodeReady Studio をインストールする方法を説明します。
手順
- Red Hat Developer Portal から Red Hat CodeReady Studio 12.16 Installer をダウンロードします。
-
ダウンロードした
codereadystudio-12.16.0.GA-installer-standalone.jar
ファイルが含まれるディレクトリーに移動します。 インストーラーを起動します。
$ java -jar codereadystudio-12.16.0.GA-installer-standalone.jar
画面の手順にしたがってインストールを完了します。
重要インストールする追加機能を選択するプロンプトが表示されたら、インテグレーションアプリケーションの作成、テスト、およびデバッグを行う Fuse Tooling 機能を選択します。
3.3. 高度なインストールタスクの実行
以下を行う方法を説明します。
- スクリプトを使用した CodeReady Studio のインストール。
- ソースコードから Red Hat CodeReady Studio Installer を構築。
3.3.1. スクリプトを使用した Red Hat CodeReady Studio のインストール
次に、スクリプトを使用して CodeReady Studio をインストールする方法を説明します。
手順
- Red Hat Developer Portal から Red Hat CodeReady Studio 12.16 Installer をダウンロードします。
-
ダウンロードした
codereadystudio-12.16.0.GA-installer-standalone.jar
ファイルが含まれるディレクトリーに移動します。 インストーラーを起動します。
$ java -jar codereadystudio-12.16.0.GA-installer-standalone.jar
画面の手順にしたがってインストールを完了します。
重要インストールする追加機能を選択するプロンプトが表示されたら、インテグレーションアプリケーションの作成、テスト、およびデバッグを行う Fuse Tooling 機能を選択します。
インストールが完了すると、CodeReady Studio インストールディレクトリーに
InstallConfigRecord.xml
ファイルが生成されます。以下のコマンドを実行します。
$ java -jar codereadystudio-12.16.0.GA-installer-standalone.jar \ /path-to/InstallConfigRecord.xml
path-to を
InstallConfigRecord.xml
ファイルへのパスに置き換えます。
生成された InstallConfigRecord.xml
ファイルはマシン固有で、Java Development Kit (JDK) およびシステムのインストールパスを使用します。他のオペレーティングシステム、JDK、またはパスに InstallConfigRecord.xml
ファイルを使用するには、このファイルを手作業で変更する必要があります。
3.3.2. CodeReady Studio スタンドアロンインストーラーをソースからビルド
CodeReady Studio スタンドアロンインストーラーをソースからビルドする方法を説明します。
前提条件
- Maven 3.3 以降と Java 8 がインストールされている必要があります。Maven を取得および設定するには、「Apache Maven Project」を参照してください。
手順
Git リポジトリーのクローンを作成します。
$ git clone https://github.com/jbdevstudio/jbdevstudio-product.git
jbdevstudio-product
ディレクトリーに移動します。$ cd jbdevstudio-product
master
にチェックアウトします。$ git checkout master
- README.adoc ファイルの手順にしたがいます。
ビルドが完了すると、CodeReady Studio スタンドアロンインストーラーの .jar
ファイルは /jbdevstudio-product/installer/target
ディレクトリーに配置されます。
第4章 CodeReady Studio のアップグレード
CodeReady Studio のバージョンを最新のメジャーおよびマイナーバージョンにアップグレードする可能性について説明します。
4.1. CodeReady Studio のメジャーバージョンのアップグレード
CodeReady Studio の各メジャーバージョンは、異なるバージョンの Eclipse をベースにしています。そのため、古いメジャーバージョンの CodeReady Studio を、新しいメジャーバージョンにアップグレードすることはできません。たとえば、CodeReady Studio 10.x インストールを 11.x に更新することはできません。ただし、CodeReady Studio 12.x で CodeReady Studio 11.x を使用して作成したワークスペースを使用することは可能です。
複数のバージョンの CodeReady Studio が異なるディレクトリーにあれば、インストーラーまたは Eclipse を使用して複数のバージョンの CodeReady Studio をシステムにインストールできます。
以下の表は、各メジャーバージョンの Red Hat CodeReady Studio でサポートされる Eclipse のバージョンを示しています。
表4.1 Eclipse バージョンサポート一覧
Red Hat CodeReady Studio のバージョン | ベースの Eclipse バージョン |
---|---|
CodeReady Studio 12.16 | Eclipse IDE 2020‑06 |
CodeReady Studio 12.15 | Eclipse IDE 2020-03 |
CodeReady Studio 12.14 | Eclipse IDE 2019‑12 |
CodeReady Studio 12.13 | Eclipse IDE 2019‑09 |
CodeReady Studio 12.11 | Eclipse SimRel 2019-03 GA |
CodeReady Studio 12.9 | Eclipse SimRel 2018-09 GA |
CodeReady Studio 12.0 | Eclipse 4.8 (Photon) |
CodeReady Studio 11.x | Eclipse 4.7 (Oxygen) |
Red Hat CodeReady Studio 10.x | Eclipse 4.6 (Neon) |
Red Hat CodeReady Studio 9.x | Eclipse 4.5 (Mars) |
4.2. Red Hat CodeReady Studio のマイナーバージョンの更新
Red Hat CodeReady Studio を、メジャーリリースの最新のマイナーバージョンに更新できます。たとえば、Red Hat CodeReady Studio 12.0 インストールを 12.9 に更新できます。
自動更新の IDE 設定によっては、最新の Red Hat CodeReady Studio の更新が利用できるようになったときに IDE によって自動的に通知されます。
更新する前にワークスペースをバックアップします。ワークスペースには、プロジェクトファイルの他に、カスタマイズされた設定に関するメタデータや、IDE の設定が含まれます。ワークスペースをバックアップするには、ワークスペースディレクトリーをバックアップする場所にコピーするか、圧縮ファイルとして保存します。
手順
- Eclipse IDE を起動します。
Window → Preferences をクリックします。
Preferences ウィンドウが表示されます。
Install/Update → Available Software Sites を選択します。
- URL https://devstudio.redhat.com/12/stable/updates/ が有効な場所に表示されていることを確認します。一覧にない場合は追加します。
- Apply and Close をクリックします。
Help → Check for Updates をクリックします。
更新の検索には時間がかかる場合があります。
画面の指示に従って、利用可能な更新を適用します。
署名なしコンテンツのインストールに関する警告を受け取った場合は、コンテンツの詳細を確認し、問題がなければ Install Anyway をクリックしてインストールを続行します。
Eclipse を再起動します。
Eclipse IDE を再起動するよう要求されたら、Restart Now をクリックします。Eclipse を再起動するまで変更は反映されないため、注意してください。
第5章 CodeReady Studio のアンインストール
Eclipse またはインストーラーを使用して CodeReady Studio をアンインストールする方法を説明します。
複数のバージョンの CodeReady Studio が異なるディレクトリーにあれば、複数のバージョンの CodeReady Studio をシステムにインストールできます。
5.1. Eclipse を使用した Red Hat CodeReady Studio のアンインストール
Eclipse Marketplace または Update Site Zip
でインストールされた CodeReady Studio のアンインストール方法を説明します。
手順
- Eclipse IDE を開始します。
Help → Eclipse Marketplace をクリックします。
Eclipse Marketplace ウィンドウが表示されます。
Installed セクションに移動します。
- Red Hat CodeReady Studio を見つけます。
- Change ボタンの近くにある下向き矢印をクリックします。
Uninstall をクリックします。
Confirm Selected Features ウインドウが表示されます。
- Red Hat CodeReady Studio が選択されていることを確認します。
- Confirm をクリックします。
Finish をクリックします。
Software Updates ダイアログボックスが表示され、Eclipse の再起動を要求されます。
Restart Now をクリックします。
Eclipse を再起動するまで変更は反映されないため、注意してください。
5.2. インストーラーを使用した CodeReady Studio のアンインストール
インストーラーでインストールされた CodeReady Studio をアンインストールする方法を説明します。
手順
- CodeReady Studio が実行されていないことを確認します。
/Uninstaller
ディレクトリーに移動します。$ cd /path-to/codereadystudio/Uninstaller
path-to を CodeReady Studio
/codereadystudio/Uninstaller
ディレクトリーへのパスに置き換えます。アンインストーラーを起動します。
$ java -jar uninstaller.jar
IzPack Uninstaller ダイアログボックスが表示されます。
Force the deletion チェックボックスを選択します。
このチェックボックスを選択しないと、一部のファイルがインストールディレクトリーに残されます。
- Uninstall をクリックします。
第6章 問題の報告
JIRA でチケットを作成すると、エラーを報告できます。JIRA チケットを作成する場合は、JBDS または JBIDE プロジェクトのいずれかに対して作成してください。エラーをデバッグできるよう、JIRA チケットにできるだけ細かく詳細を記入してください。また、JIRA チケットにエラーログを添付し、問題の内容を提供することもできます。