New post

Find

Article
· Jun 6, 2023 4m read

コンテナ版 WebGateway の使用方法

これは InterSystems FAQ サイトの記事です。
 

こちらでは、InterSystems Container Registry(ICR) より入手可能なDockerコンテナイメージを使用する方法をご案内します。

WRCDirectのダウンロードサイト より入手可能なイメージを使用する場合も同じようにできます。
 その際、Name:Web でフィルタリングしていただくと、Web Gateway の Docker イメージが見つけやすくなります。
※インターシステムズが提供する webgateway コンテナイメージには、Web ゲートウェイと Apache Web サーバの両方が含まれています。


【手順】

1. ブラウザより https://containers.intersystems.com/ にアクセスし、インターシステムズWRC認証情報でログインします。

2. Dockerログイントークンかログインコマンドを取得します。


3. 取得した認証情報を使い、Dockerインターフェース(PowerShellウインドウやLinuxコマンドラインなど)でICRへの認証を行います。
    以下の例のように、表示されるDocker ログインコマンドをコピー、ペーストすることで認証できます。

docker login -u="provided_username" -p="provided_password" containers.intersystems.com


4. 利用可能なコンテナイメージを確認します。

 ICRウェブポータル にWRCアカウントでログインし、
  InterSystems IRIS Product Family > webgateway > バージョン(例:2023.1.0.229.0)
 をクリックすると、以下のような pull コマンドを確認できます。
 ※開発者コミュニティで作成されたアカウントの場合は、Communityエディションのみダウンロードすることが可能です。

webgateway2023.1.0.229.0

Linux/amd64: docker pull containers.intersystems.com/intersystems/webgateway:2023.1.0.229.0

Linux/arm64: docker pull containers.intersystems.com/intersystems/webgateway-arm64:2023.1.0.229.0

※キットから直接の場合

docker load -i webgateway-2023.1.0.229.0-docker.tar.gz


5. 次のようなイメージができていることを確認します。

# docker images
REPOSITORY                                            TAG                    IMAGE ID       CREATED         SIZE
containers.intersystems.com/intersystems/webgateway   2023.1.0.229.0         1a690ab8d70c   5 days ago      300MB


6. CSP.ini および CSP.conf ファイルを用意します。

 ※既存の構成を失うことなくコンテナをアップグレードできる 永続的な %SYS 機能 で実行します(オプション)
 ※今回は、Web ゲートウェイの構成が格納されているコンテナ内に /dur と呼ばれる永続的なデータディレクトリを作成します。
  ホストOSは /data/dur 以下に上記構成ファイルを用意します。
 ※ホストディレクトリ所有者は変更をしておく。  #sudo chown -R 51773:51773 /data/dur

サンプルの CSP.conf は以下のようになります。

# CSP config file

CSPModulePath "/opt/webgateway/bin/"
CSPConfigPath "/opt/webgateway/bin/"

<Location "/csp/bin/Systems/">
    SetHandler csp-handler-sa
</Location>
<Location "/csp/bin/RunTime/">
    SetHandler csp-handler-sa
</Location>

<Directory "/opt/webgateway/bin/">
    AllowOverride None
    Options None
    Require all granted
    <FilesMatch "\.(log|ini|pid|exe)$">
         Require all denied
    </FilesMatch>
</Directory>
<Location /csp>
  CSP On
  SetHandler csp-handler-sa
</Location>


7. webgateway コンテナを作成します。
 ※ホストのポート:8080 ににコンテナのポート:80 を割り当てます。

# docker run -d --name wg11 --publish 8080:80 --volume /data/dur:/dur --env ISC_DATA_DIRECTORY=/dur --env ISC_CSP_INI_FILE=/dur/CSP.ini --env ISC_CSP_CONF_FILE=/dur/CSP.conf containers.intersystems.com/intersystems/webgateway:2023.1.0.229.0

※Docker for Windows の場合

docker run -d --name wg11 --publish 8080:80 --volume C:/data/dur:/dur --env ISC_DATA_DIRECTORY=/dur --env ISC_CSP_INI_FILE=/dur/CSP.ini --env ISC_CSP_CONF_FILE=/dur/CSP.conf containers.intersystems.com/intersystems/webgateway:2023.1.0.229.0


8. Webゲートウェイに接続します。
 http://localhost:8080/csp/bin/Systems/Module.cxw
 接続に成功すると、以下のような画面が表示されます。


9. サーバアクセス(Server Access)の設定で、IRISサーバの情報を設定すると、管理ポータルには以下のURLでアクセスできます。
 http://localhost:8080/csp/sys/UtilHome.csp 

詳細は以下のドキュメントをご覧ください。

InterSystems Web ゲートウェイ・コンテナの使用法

 

enlightened【ご参考】
Apache Webサーバ(プライベートWebサーバ: PWS)インストレーションの廃止

Discussion (0)0
Log in or sign up to continue
Discussion (1)1
Log in or sign up to continue
Question
· Jun 2, 2023

Entity Framework Core Support

Hi,

We are developing a .NET6 application using Iris database. We would like to use ORM for easier code maintenance. 

I saw a doc about Entity Framework: https://docs.intersystems.com/iris20231/csp/docbook/DocBook.UI.Page.cls?KEY=BNET_eframe, but even it's newest Iris version, the Entity Framework is very old .NET Framework (2013) and not supported by Microsoft anymore. Are there any plans to support Entity Framework Core?

2 Comments
Discussion (2)2
Log in or sign up to continue
Question
· May 26, 2023

How to view if a mirror member has failed over recently?

How can you tell if a mirror member has failed-over?

4 Comments
Discussion (4)2
Log in or sign up to continue
InterSystems Official
· May 24, 2023

Zen Reports to be removed from InterSystems IRIS and IRIS for Health beginning with (New Target) of 2025.3

InterSystems is announcing an end of maintenance event for Zen Reports beginning in Intersystems IRIS and IRIS for Health 2025.1.  This follows the deprecation notice made when InterSystems IRIS was introduced in 2018 and subsequent inclusion of InterSystems Reports in 2020 to provide replacement reporting functionality.  An overview of the timeline is:

March 2018.   InterSystems IRIS 2018.1:  Announcement of Zen Reports deprecation, continued shipment to provide continuity for existing applications

April 2020.     InterSystems IRIS 2020.1:  Intersystems Reports incorporated as part of user-based InterSystems IRIS and IRIS for Health and Advanced Server licenses

May 2023.      End of maintenance notification for Zen Reports

2H 2024.        Zen Reports available as an ipm module

2H 2025 (InterSystems IRIS 2025.3)   Zen Reports package removed from InterSystems IRIS and IRIS for Health distributions

InterSystems introduced InterSystems Reports, powered by Logi Reports from insightsoftware (formerly Logi Analytics)  as an embedded reporting solution starting with InterSystems IRIS and IRIS for Health 2020.1. InterSystems Reports provide a modern, drag and drop reporting solution for InterSystems customers and partners.  

We expect to transition Zen Reports to an independent package using IPM (InterSystems Package Manager) and to stop shipping Zen Reports with InterSystems IRIS and IRIS for Health version 2025.3. Zen Reports will continue to be available as an ipm module and may be distributed but will not be maintained by InterSystems.  The WRC will continue to provide support on prior versions of Cache and IRIS that contain Zen Reports but no updates are expected to Zen Reports software.

For more information on getting started with InterSystems Reports:
InterSystems Learning Path

InterSystems documentation

Global Summit session: Intersystems Application Services' move from Zen Reports to InterSystems Reports

insightsoftware's Logi Report documentation and tutorial

 

Please comment below or contact dbpprodmgrs@intersystems.com with any questions about this announcement.  

9 Comments
Discussion (9)5
Log in or sign up to continue