Web App プレビュー、サムネイル、および表示専用共有用のStorage Zone Controller を構成する
オンプレミスのファイルプレビューは、オンプレミスの Microsoft Office Web Apps (OWA) サーバーによってレンダリングされます。Citrix が管理するストレージゾーンに保存されているファイルをプレビューすると、Citrix が管理するまたは Microsoft が管理するOWA サーバーによってプレビューがレンダリングされます。
重要:
ホワイトリストの要件:
*.sf-api.com
は、バージョン 5.0 以降のストレージゾーンでプレビューおよび編集が適切に機能するためには、Office Online Server からアクセスできる必要があります。
要件
オンプレミスファイルプレビューでサポートされるファイルタイプ
- doc, .docm, .docx, .dot, .dotm, .dotx, .odt
- .ods, .xls, .xlsb, .xlsm, .xlsx
- .odp, .pot, .potm, .potx, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx
- 画像ファイル(bmp、gif、jpg、jpeg、png、tif、tiff)
オンプレミスのファイル編集でサポートされるファイルの種類
- .docm、.docx、.odt
- .ods、.xlsb、.xlsm、.xlsx
- .odp、.ppsx、.pptx
サポートされる環境
- 標準ゾーン
- マルチテナントゾーン
- Webアプリケーション
ホワイトリスト作成/ネットワークに関する考慮事項
- OOSサーバは
https://\*.sf-api.com
(または.eu)に到達できる必要があります - SZC Server は、
https://\*.sf-api.com
およびhttps://\*.sharefile.com
(または.eu)に到達できる必要があります。 - SZC サーバーが OOS サーバーにアクセスできる必要があります
https://\<Customer OOS / OWA Endpoint\>/hosting/discovery
(例:https://oos.sharefileexample.com/hosting/discovery
)。
オンプレミスのファイルを編集するには、ShareFile アカウントでファイルのバージョン管理が有効になっている必要があります。
ShareFile Web Appの詳細設定メニューでMicrosoft Officeオンライン編集を有効にする設定は、オンプレミスのファイルを編集する機能には影響しません。オンプレミスファイルの編集機能は制御されませんが、パブリッククラウドに保存されているファイルの編集に適用されます。オンプレミスファイルの編集を有効にするには、以下の手順でStorage Zone Controller 管理者によって排他的に制御されます。
Microsoftサーバーの互換性
-
Microsoft Server 2016: ファイルの編集とプレビューの両方の機能をサポートしています。編集を無効にすることもできます。
-
Microsoft Server 2013: ファイルのプレビュー機能のみをサポートしています。
建築図とネットワーク図
- 認証されたユーザーは、ShareFile でファイルプレビューを要求します。
- ShareFile は、Office オンラインサーバーの FQDN を持つクライアントデバイスへのリダイレクトを発行します。
- クライアントデバイスが Office オンラインサーバーの FQDN にリダイレクトします。注: HTTPS 接続の場合、DNS は内部サーバー IP 用の A レコード、または Load Balancer VIP 用の A レコード、クライアントデバイスとポート 443 のファイアウォール間のルーティングを適用する必要があります。
- Office Online Server は要求を処理し、Storage Zone Controller サーバーへの API 呼び出しを行います。注: HTTPS 接続、DNS には、内部サーバー IP 用の A レコード、または Load Balancer VIP 用の A レコード、クライアントデバイスとポート 443 のファイアウォール間のルーティングを適用する必要があります。
- Storage Zone Controller チェック
https://\<DNSname\>/hosting/discovery
は到達可能です。到達可能な場合にのみ、SZC は API 応答を Office オンラインサーバーに送信します。注: Storage Zone Controller は、Office Online サーバーに接続する必要があります。内部でホストされている両方のサーバー間の HTTPS 接続。 - Storage Zone Controller は、ShareFile API(sf-api.com)へ送信方向に接続します。注:これは、ファイアウォール、プロキシ、または送信ルーティングアプライアンスを経由する必須の送信接続です。Storage Zone Controller サーバーが、HTTPS/443 経由で、上記の文書化された IP アドレスに送信方向に通信できることを確認します。
- Office オンラインサーバーは、ShareFile API への送信に接続します。注:これは、ファイアウォール、プロキシ、または送信ルーティングアプライアンスを経由する必須の送信接続です。Office Online Server が HTTPS/443 経由で上記の文書化された IP アドレスに送信通信できることを確認します。
- プレビューが発生します。
Storage Zone Controller は、コンテンツをダウンロードするためにOOSがShareFileコントロールプレーンを呼び出すのではなく、OOSにファイルバイトをストリームします。Storage Zone Controllerの構成ファイルの1つでキーを更新する必要があります。
C:\inetpub\wwwroot\Citrix\StorageCenter\WopiServer\AppSettingsReleaseOnPrem.config を更新する必要があります。
この設定ファイルには、現在false のキー downloadFileFromSCがあります。キーを true に変更し、IIS を再起動します。
これにより、設定が更新されます。また、OOS は ShareFile コントロールプレーンを呼び出してファイルの内容をダウンロードしなくなりました。
このオプションを使用する場合、コントロールプレーンから OOS への受信トラフィックがないことを示すのは正しいでしょうか。
上記のオプションを使用すると、OOSはShareFile コントロールプレーンへの送信接続を確立しなくなります。
ただし、ShareFile コントロールプレーンは、上記のオプションが使用されているかどうかにかかわらず、OOSへの送信接続を行います。
1つの方法と他の方法を使用することの長所と短所はありますか?
このアプローチでは、OOSはファイルの内容を直接ダウンロードしません。Storage Zone Controller は、ファイルバイトをOOSにダウンロードし、ストリームします。したがって、Storage Zone Controllerサーバーの負荷が増大します。
ファイルのバイトのダウンロードとストリーミングは、リソースを大量に消費するタスクです。ユーザーの数とプレビューおよび編集操作の数に応じて、Storage Zone Controllerサーバーの負荷が増大します。
オンプレミスのプレビューと編集を有効にする
ブラウザー内のドキュメントと画像のプレビュー、サムネイル、顧客管理のストレージゾーンに格納されたデータの表示専用共有、およびオンプレミスのファイル編集をサポートするには、Storage Zone Controller を次のように構成します。
-
Storage Zone Controllerコンソールで、[ShareFile Data] タブをクリックします。
-
[ ローカルネットワーク共有の構成 ] セクションで、[ オフィス Web アプリのプレビューを構成する] を有効にします。
- Microsoft Office Web アプリケーション (OWA) サーバーの外部 URL を入力します。
- ユーザーは、Microsoft Office MSDN サブスクリプションを使用して OWA サーバーソフトウェアをダウンロードして構成する必要があります。
-
[ Office オンライン編集を有効にする (必要な場合)] を選択します。
-
OWA URL が外部からアクセス可能であることを確認します。
-
Office Online サーバーが
*.sf-api.com
と通信できることを確認します。 -
Storage Zone Controller コンソールで、[Monitoring] タブをクリックします。
- OWA サーバー接続 に緑色のチェックマークが付いていることを確認します。
注:
オンプレミスのファイルを編集するには、ShareFile アカウントに対してファイルのバージョン管理を有効にする必要があります。アカウントに対してファイルのバージョン管理が無効になっている場合、オンプレミスの編集は機能しません。
重要:
クロック同期の設定:
- Storage Zone Controllerの時刻が time.windows.com または別の NTP サーバーと同期されていることを確認します。 クロック同期の設定については、ここをクリックしてください。
OWA URAL の変更またはプレビューの無効化:
- 上記のいずれかの操作では、プライマリコントローラとセカンダリ Controller ごとに IIS サービスを再起動する必要があります。
制限事項
- モバイルアプリは、ブラウザ内編集をサポートしていません。
- コネクタは、ブラウザ内プレビューをサポートしていません。
WOPI プレビューは、VDR アカウントではサポートされていません。
Citrix ADCを読み取り専用共有用に構成する方法については、[Storage Zone Controller 用のCitrix ADC を構成します。]を参照してください。(/ja-jp/storage-zones-controller/5-0/install/configure-netscaler.html)
OWA および OOS の問題のトラブルシューティング
オンプレミスのファイルのプレビューや編集で問題が発生した場合は、次の手順で特定の問題を特定して修正できます。
構成のトラブルシューティングを行うには、まず OWA または OOS マシンにサインインします。
-
services.msc 内で OOffice WebAppsまたは OfficeOnline Windows サービスが実行されていることを確認します。
-
新しいブラウザで、
http://localhost/hosting/discovery
ページを開きます。このページが正常にロードされた場合は、XML 応答が返されます。 -
管理者としてPowerShell を実行し、次のコマンドを実行します。
Get-OfficeWebAppsFarm
応答に WARNING または ERROR メッセージが表示された場合は、エラーや間違いがないか構成設定を確認してください。
ネットワークに関する考慮事項:
- OOSサーバは
https://*.sf-api.com
(または.eu)に到達できる必要があります - SZC Server は、
https://*.sf-api.com
およびhttps://*.sharefile.com
(または.eu)に到達できる必要があります。 - SZC サーバが OOS サーバ
https://<CustomerOOS/OWAEndpoint\>/hosting/discovery
に到達できる必要があります。たとえば、https://oos.sharefileexample.com/hosting/discovery
のようになります。