マーケットプレイス版Oracle WebCenter Content For OCIを日本語環境で使いやすくするための追加作業の紹介

# マーケットプレイス版Oracle WebCenter Content For OCI

マーケットプレイス版のOracle WebCenter Contentは、Oracle Cloud Infrastructure上のVMベースのソリューションとして提供されます。マーケットプレイス版のOracle WebCenter Contentを使用すると、顧客は数回クリックするだけで環境をプロビジョニング/セットアップでき、クラウド上でコンテンツ・ソリューションを提供できるようになります。

詳細は製品ドキュメントおよび概要紹介資料をご確認ください

**製品ドキュメント**

https://docs.oracle.com/en/cloud/paas/webcenter-content/webcenter-content-marketplace/index.html

**概要紹介資料(SpeakerDeck)**

https://speakerdeck.com/oracle4engineer/oracle-webcenter-content-for-oci-on-marketplace

# この記事で紹介すること、しないこと

WCC For OCIを**日本語環境**で利用する場合、プロビジョニング後に追加作業をすることで、より便利にWCC環境を利用できます。この記事ではその追加作業を「3つ」を紹介します

1. **ローカライゼーションの設定（WCCのユーザーインタフェースを日本語表示にする）**
1. **日本語フォントの追加（フォント・パスに別途インストールした日本語フォントを追加）**
1. **全文検索機能の有効化（ORACLETEXTSEARCHを構成し、インデクサの再構築を実施）**

なお、WCC For OCIのプロビジョニング手順の紹介は割愛します。具体的なプロビジョニング手順は、上記の製品ドキュメントや以下Qiita記事を参考にしてください

https://qiita.com/shinwata/items/d7b478031ea45f0a3565

# プロビジョニング後の追加作業の紹介

## 1. ローカライゼーションの設定

プロビジョニング直後のWCC環境にブラウザでログインすると、ユーザーインタフェースが **英語(English-US)** で表示されます。ここでは、**日本語** でユーザーインタフェースを表示できるように、ローカライゼーションの設定を変更します。

また、ユーザー・プロファイルからユーザー・ロケールを日本語に変更する方法も説明します

### 1.1 ローカライゼーションの設定変更

1. WCCのネイティブUI `https://<host IP>:16200/cs/` に管理ユーザーでログインします

1. 左ナビゲーションの **Administration**を開き、**Localization** をクリックします

1. WCCの標準UIで利用する言語の一覧が表示されます。Enabled Localesから **日本語** を選択し、**Update** をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/96504b80-b895-e503-60fc-a459d7968972.png)

1. 以上でユーザーインタフェース上で、日本語が選択できるようになりました

### 1.2 ユーザー・ロケールの変更

1. ユーザーインタフェース上の表示言語は、ユーザー毎のプロファイル設定で変更します。右上のユーザー名（ここでは `weblogic`）をクリックします

1. **User Locale:** で **日本語** を選択し、Overrideを**選択**します

1. （※オプション） **User Time Zone:** で **(UTC+09:00) Tokyo - Japan Time (JT)** し、Overrideを**選択**します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/ca6ddd9e-b49a-e2f3-4cb5-6f9e2535eca3.png)

1. **Update** をクリックします

1. ユーザーインタフェースが日本語で表示されます
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/7c5f93e5-2b42-7cec-12ea-11964ba67460.png)


## 2. 日本語フォントの追加

プロビジョニング直後のWCC環境のフォント・パスには `/u01/jdk/jre/lib/fonts/` が設定されています。この設定のまま日本語を含むファイルをチェックイン（アップロード）すると、ファイルのプレビューやPDF変換機能で自動生成されたWeblayoutファイルの日本語が正しく表示されません（文字化けします）

ここでは、WCCコンピュート・インスタンス上に **TrueTypeの日本語フォント** を追加し、UCM_ServerおよびIBR_Serverの **フォント・パス** に追加した日本語フォントへのパスを追加します

### 2.1 日本語フォントの追加

WCCコンピュートインスタンスにSSHでアクセスし、日本語フォントをOS上にインストールします。今回は `/usr/share/fonts/` にVLゴシックフォントファミリ(VLGothic Font Family)をインストールします

https://vlgothic.dicey.org/

```
/* VLゴシックフォントの取得 */
[opc@wccmp-wls-1 ~]$ wget https://rpmfind.net/linux/epel/8/Everything/x86_64/Packages/v/vlgothic-fonts-20141206-15.el8.1.noarch.rpm

/* VLゴシックフォントのインストール */
[opc@wccmp-wls-1 ~]$ sudo rpm -Uvh vlgothic-fonts-20141206-15.el8.1.noarch.rpm

/* VLゴシックフォントのディレクトリ確認 */
[opc@wccmp-wls-1 ~]$ ll /usr/share/fonts/vlgothic/
-rw-r--r--. 1 root root 4066288 12月  6  2014 VL-Gothic-Regular.ttf
```

### 2.2 フォント・パスの変更

1. WCCのネイティブUI（`https://<host IP>:16200/cs/`）に管理ユーザーでログインします

1. 左ナビゲーションの**管理**を開き、**管理サーバ → 一般構成**をクリックします

1. フォント・パスに、日本語フォントをインストールしたディレクトリを追加し、**保存**します（ここでは `/usr/share/fonts/vlgothic/:` を追加）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/5648947b-9e4c-1ba9-8591-e31f26d8fa82.png)

1. **UCM_Server** を再起動します

1. 同じ作業を **IBR_Server** でも実施します（ここでは `/usr/share/fonts/vlgothic/:` を追加）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/7201cbb3-037b-ff15-4d84-d5f91c0917c1.png)

1. **IBR_Server** を再起動します

:::note info
マーケットプレイス版WCC For OCIで作成されたIBR_Serverには、**ロードバランサのプライベートIPアドレス**を介してアクセスします。SSHトンネリングを使用してこのエンドポイントにアクセスする方法は、以下ドキュメントをご確認ください

- [Appendix: How to Access WebCenter Content IBR Endpoint accessible via a Private Loadbalancer IP?](https://docs.oracle.com/en/cloud/paas/webcenter-content/webcenter-content-marketplace/index.html#how-to-access-webcenter-content-ibr-endpoint-accessible-via-a-private-loadbalancer-ip)
:::

**（関連ドキュメント）**
- [3 システム・プロセスの管理 ](https://docs.oracle.com/cd/F17745_01/content/12.2.1.4/webcenter-content-admin/managing-system-processes.html#GUID-F3BCDC95-EA83-4542-844C-31731CFEE65F)  
※UCM_ServerおよびIBR_Serverの停止および起動について

## 3. 全文検索機能の有効化

プロビジョニング直後のWCC環境は「メタデータ検索」が有効化されてます。ここではOracleTextをWCCの全文検索エンジンとして利用するように「全文検索機能」を構成することで、必要なファイルを見つけやすくします

### 3.1 全文検索機能の有効化

1. WCCのネイティブUI（`https://<host IP>:16200/cs/`）に管理ユーザーでログインし、**管理 → 管理サーバ → 一般構成** を開きます

1. **追加の構成変数:** に`SearchIndexerEngineName=ORACLETEXTSEARCH`を追加します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/d25c0d5e-a980-4e53-0004-dff31927e005.png)

1. **保存** します

1. **UCM_Server** を再起動します

### 3.2 リポジトリ・マネージャを起動し、インデクサの再構築を実行する

リポジトリ・マネージャは、管理アプレットもしくは、WebCenter Content Administration Clientから起動します。ここでは **WebCenter Content Administration Client** から起動する手順を紹介します

1. **管理 → 管理アプレット** を開く
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/0e534bf1-22d5-5d31-19d8-d2c96992dc4f.png)

1. **Download Client** をクリックし、WebCenter Content Administration Clientをダウンロードし、インストールします（`インストール済の場合は、この手順をスキップします`）

1. **Launch Client** をクリックします

1. **User Name:** と **Password:** に、WCC管理ユーザーのユーザ名とパスワードを入力します。**Server:** にはWCCネイティブUIのURL（`https://<host IP>:16200/cs/`）を入力します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/123e957e-929d-7625-6ced-1979b5f2f774.png)

1. **OK**をクリックします

1. Warningのダイアログが表示される場合は、その内容を確認し、問題なければ**Yes**をクリックします

1. WebCenter Administrationのクライアントアプリケーションが起動します。**Repository Manager** をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/80e33e69-3518-0711-2738-23563db8d9b3.png)

1. **インデクサ** タブをクリックします

1. コレクション再構築サイクルの**起動**をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/78edd70a-44a3-5ac3-fac1-52b4139d6ca7.png)

1. **高速再構築の使用**の選択を**解除**し、**OK**をクリックします

1. インデクサの再構築が実行されます。コレクション再構築サイクルで、**索引の作成が終了しました。** と表示されるまで待ちます
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/120110/96e6f13b-2c3a-9c8b-d923-f9851b864840.png)


**（関連ドキュメント）**
- [3.5.2 Oracle WebCenter Content管理アプリケーションを介した管理アプリケーションの実行](https://docs.oracle.com/cd/F17745_01/content/12.2.1.4/webcenter-content-admin/managing-system-processes.html#GUID-138AB5C7-1F5F-45D3-BD97-92306ED414E4)
- [10.1 OracleTextSearchの管理](https://docs.oracle.com/cd/F17745_01/content/12.2.1.4/webcenter-content-admin/managing-search-features.html#GUID-2336E176-4943-4AEE-BE21-8FEDF065DEFA)
- [11.3 検索索引の使用](https://docs.oracle.com/cd/F17745_01/content/12.2.1.4/webcenter-content-admin/configuring-search-index.html#GUID-1873F2C7-72E5-4FFD-A19C-0233A1C0291F)


# おわりに

マーケットプレイス版WebCenter Content For OCIプロビジョニング後、日本語環境で利用する場合に推奨する3つの追加作業について説明しました。みなさまのお役にたてば幸いです