Irisの環境設定について

# 目次
1. はじめに
2. ダウンロード方法
2. Irisのインストール
2. 環境設定
2. 最後に


# はじめに
下記記事で紹介した通り、2023年1月10日より
Kony Mobility Platformの製品元が、
Temenos社のQuantumからHCLのVoltMXという製品に変更となります。

https://qiita.com/Kony_Team/items/593a577e30224d5b196e

今回は、Visualizerの後継となるVoltMX Irisの
ダウンロードと起動方法についてご紹介していきたいと思います！

# ダウンロード方法
Irisをダウンロードする場合、アカウントが必要になります。
組織内でVoltMXの契約がある場合は、管理者に招待してもらうようにしてください。
契約がない場合は、トライアルを申し込むことでアカウントの作成が可能です。

それぞれダウンロード方法が異なりますので、
いずれかの方法でダウンロードを行なってください。

## 契約がある場合
管理者にメールアドレスを連絡し環境に招待してもらうようにしましょう。
管理者は、FoundryメニューのSetting->Inviteボタンでアカウントを招待することができます。
![スクリーンショット_0004-12-28_16_03_53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/bcf3d295-dff3-34f3-118a-5773936d759d.png)

招待された人はメールが届いたら、Acceptします。
![image__3_.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/39afa32e-4cbd-629b-6c10-31ff9cb8decf.png)

Irisのダウンロードの際、  
バージョンを指定する場合としない場合で2通りの方法があるため、  
状況に応じてどちらかの方法でダウンロードしてください。  

### バージョン指定がない場合  

特にバージョンの指定がない場合、以下にアクセスしログインします。

https://manage.hclvoltmx.com/

Environments > Volt MX Iris for Mac（またはWindows） をクリックすると、
Irisのダウンロードができます。
![スクリーンショット_0004-12-28_16_15_01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/6ed77b2e-3ead-a628-0847-e99756f0623f.png)

### バージョン指定の場合

特定のIrisバージョンをダウンロードしたい場合、
以下のサイトにアクセスしてログインを行います。

https://community.hclvoltmx.com/downloads

::: note
前提として、特定のバージョンをダウンロードする場合、  
SP（Service Pack）のバージョンが一致しているものを選んでください。  
※上位のSPバージョンを選んだ場合、下位のバージョンにダウングレードできません。
（例： V9SP5をダウンロード後、V9SP3にダウングレードはできない。）

詳細は以下をご覧ください。  
https://qiita.com/Kony_Team/items/9623c054c3f3b122621f#version9%E3%81%AE%E5%A0%B4%E5%90%88  
:::

プルダウンから欲しいバージョンを選択して、ダウンロードすると完了です。  
![スクリーンショット_0005-02-16_10_19_21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/65c99757-6478-595e-95d6-ccef1416e6c3.png)

## 契約がない場合
アカウントを持っていない場合、
30日間のトライアル申し込みページでダウンロードが可能です。

以下にアクセスし必要な情報を入力し、「Start Free Trial」をクリックします。

https://manage.demo-hclvoltmx.com/registration

![スクリーンショット 0004-12-27 17.20.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/39c9cefc-a4af-c5b0-e080-0c320e6987b0.png)

以下のような画面が表示され、入力したアドレスにメールが届きます。

![スクリーンショット_0005-04-05_11_00_47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/726f7020-58a4-3c14-e6b5-6a7bade416d4.png)
メールが届いたら、「Activate Account」をクリックしましょう。
![スクリーンショット_0005-04-05_11_03_33.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/46e1960d-2216-2001-b0a7-3fe209a1a37f.png)

必要事項を入力して「Activate My Account」をクリックします。
![スクリーンショット_0005-04-05_11_43_19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/bc19952a-ffb0-b273-23dc-786f90891d2e.png)

アクティベートが成功すると、以下のような画面が表示され、
自動的にVoltMX Irisがダウンロードされます。
インストーラーでのインストール方法は、[Irisのインストール](#irisのインストール)をご確認ください。

こちらの画面では、Foundryやプレビューアプリ、公式ドキュメントなどのリンクが紹介されているので、
一通り目を通しておくと良いと思います🙆‍♂️
![スクリーンショット 0005-04-05 11.48.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/7bd34140-927d-e56f-4f86-d152ca1e3c7c.png)


以上でIrisのダウンロードは完了です。

# Irisのインストール

ダウンロード完了後Zipファイルを解凍すると、
下記のようにインストーラーが表示されますので、インストーラーを開きましょう。

![スクリーンショット 0004-12-28 16.26.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/f7438816-71b5-5acd-da97-183fcc0f7aa0.png)

インストーラーを開いたら、案内が表示されます。
案内に沿って進めてください。

基本的には、[Visualizerのインストール方法](https://qiita.com/Kony_Team/items/cb012a9b3eeb5832ac9d#2-visualizer%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)と同じですが、
少しだけ画面が異なりますので、不安な方は以下をご確認ください。

案内を読みNextをクリック。
![スクリーンショット 0004-12-28 16.32.53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/852fa5aa-858e-b5dc-1b3e-03ce98009a78.png)

次に、Irisを保存するフォルダのパスを指定します。
<font color = red>※ここには空のフォルダを指定するようにしましょう。</font>  
（空でない場合、次へを押すとエラーが表示されます。）

フォルダを変更する場合、Chooseボタンをクリック
![スクリーンショット_0004-12-28_16_33_02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/1a28a7fa-0f79-ea23-4a75-db125928f7a6.png)

フォルダが開くため、保存したいフォルダを選択。
今回は、アプリケーションフォルダ内に新しくフォルダを作成し
`/Applications/Iris95（バージョン名）`のパスを指定しました。
![スクリーンショット_0004-12-28_16_33_48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/31f10352-d78a-24d6-2185-49415c8207cb.png)

バージョン毎にIrisをダウンロードしたい場合は、バージョン毎にフォルダを作るのがおすすめです。
詳しくは以下記事をご覧ください。

https://qiita.com/Kony_Team/items/41c94e7d8225306eb1b4#5-visualizer%E3%81%AE%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%82%92%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%81%AB%E5%90%88%E3%82%8F%E3%81%9B%E3%82%8B

Irisを保存するフォルダパスが指定できたら、Nextボタンを押します。
![スクリーンショット_0004-12-28_16_33_02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/1ea63812-5290-37d7-6a80-645623767f49.png)

次に、プロジェクトファイルを保存するワークスペースを設定します。
ここは特に変更しなくても大丈夫ですが、変更したい場合はChooseをクリックし、Nextをクリックしましょう。
![スクリーンショット_0004-12-28_16_34_06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/9261892c-9952-c6a5-2de8-2aedb69b7cc9.png)


利用規約をよく読み、同意する場合「I agree~」にチェックを入れてInstallボタンをクリックします。
![スクリーンショット_0004-12-28_16_34_25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/24c1cd7f-d520-a777-0837-8d4318803d78.png)

以下の画面が表示され、しばらくするとインストールが完了します。
![スクリーンショット_0004-12-28_16_34_32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/2fd9d6d8-6dca-97fc-a367-d75be832d26f.png)

これでIrisのインストールは完了です！

トライアル環境の方はこれで設定は以上です。
トライアル環境以外で開発を行う方は、次の環境設定に進んでください。

# 環境設定（トライアル以外の環境で使用する場合）

## Foundry URL設定
[インストール](#irisのインストール)時に指定したIrisのダウンロードパスにアクセスし、Irisを開きましょう。

Preferencesを開きます。
FoundryのURLがデフォルトでデモ環境になっている場合は、
https://manage.hclvoltmx.com/ に変更しましょう。

Validateボタンを押してエラーがなければ、Doneを押して設定を完了してください。
![スクリーンショット_0004-12-28_17_04_07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/ac5ffaf3-88d0-ef49-76ee-d8c76e9e26b6.png)

変更後、右上にあるLoginボタンをクリックします。
VoltMXのアカウント情報を入力してログインしてください。

![スクリーンショット_0004-12-28_17_07_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/59066cf6-b0eb-7c97-2ba2-d762c8a9c8b8.png)

## Cloud環境選択
右上のアカウント名の左側には、
現在アクセスしているクラウド環境の名前が表示されます。
![スクリーンショット_0005-01-05_15_18_29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/4c48ef87-be57-c9fa-3ff0-eae8f7b3166f.png)


もしクラウド環境を変更したい場合、
環境名が表示されている箇所をホバーすると他の環境が一覧で表示されるので、
アクセスしたいクラウド環境をクリックすると、環境を変更することができます。
![スクリーンショット_0004-12-28_17_10_36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/adc5968f-177f-d155-3126-15d863a69693.png)

もしアクセスしたい環境が表示されない場合は、
管理者に権限を追加してもらう必要があります。

依頼された管理者は、
Setting->Users->Manage Cloud Accessをクリックすると、
アクセス権限を編集することができます。
![スクリーンショット_0005-01-05_15_04_07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/61218bc5-5e6f-9db9-cb39-3c35f634bad6.png)


## Foundry詳細設定
Project Settings>Foundryのメニューでは、
クラウドアカウントやクラウド環境の設定変更ができます。

Cloud AccountとEnvironmentの項目が、
対象の環境になっていることを確認しましょう。
（わからない場合は、プロジェクトの管理者に聞いて設定を行うようにしましょう。）

![スクリーンショット_0004-12-28_17_13_56.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/13105410-d9d3-f7fa-0b02-9697b5fb600f.png)

これで初期設定は完了です！
今後ビルドを行う場合は以下のリンクを参考にしてください。

https://qiita.com/Kony_Team/items/3e3c52c379583df57c08


# 最後に
今回はIrisの環境設定方法について紹介しました。
意外と忘れやすいので、参考にしてくださいね！

# 参考
https://opensource.hcltechsw.com/volt-mx-docs/docs/documentation/Iris/iris_starter_install_win/Content/Prerequisites.html#downloading-volt-mx-iris