新しい投稿
記事
· 2024年1月25日 12m read

ApacheをWebサーバとする場合のプライベートWebサーバ（PWS）を使用しないバージョンの新規インストール／アップグレード

#Web Gateway #システム管理 #ヒントとコツ #InterSystems IRIS #InterSystems IRIS for Health

この記事は、「プライベートWebサーバ（PWS）を使用しないバージョンの新規インストール／アップグレード：概要」の続きの記事で、ApacheをWebサーバとする場合の設定概要をご紹介します。（先に「概要」の記事をお読みいただくことをお勧めします。）

同一サーバ上にApacheとInterSystems製品をインストールする場合、事前にApacheをインストールしておくとApacheに必要なWebゲートウェイのインストールとIRISへの接続設定をインストーラーが自動で行います。

以降の説明では、以下のインストール方法について解説します。

※ 図解では、InterSystems IRISを使用していますが、InterSystems製品で操作は共通です。

1. Apacheを事前に準備しない状態での新規インストール

ローカルにWebサーバ（Apache）を検出できないため、以下の選択肢を表示します。

No local web server found. Would you like to abort the installation <Yes>?

実行時の表示は以下の通りです（Ubuntuを利用しています）。

$ sudo ./irisinstall
Your system type is 'Ubuntu 22.04 LTS (x64)'.

Enter instance name <IRIS>: IRIS

Enter a destination directory for the new instance.
Directory: /usr/iris
Directory '/usr/iris' does not exist.
Do you want to create it <Yes>?

Select installation type.
    1) Development - Install InterSystems IRIS server and all language bindings
    2) Server only - Install InterSystems IRIS server
    3) Custom
Setup type <1>? 1

How restrictive do you want the initial Security settings to be?
"Minimal" is the least restrictive, "Locked Down" is the most secure.
    1) Minimal
    2) Normal
    3) Locked Down
Initial Security settings <1>? 2

What user should be the owner of this instance? root
An InterSystems IRIS account will also be created for user root.

Install will create the following InterSystems IRIS accounts for you:
_SYSTEM, Admin, SuperUser, root and CSPSystem.
Please enter the common password for _SYSTEM, Admin, SuperUser and root:
Re-enter the password to confirm it:

Please enter the password for CSPSystem:
Re-enter the password to confirm it:

What group should be allowed to start and stop
  this instance? root

Do you want to install IRIS Unicode support <Yes>?

No local web server found. Would you like to abort the installation <Yes>?

 

Yesと回答するとインストールを中止します。

No local web server found. Would you like to abort the installation <Yes>?`
 
** Installation aborted **
 
 
No packages will be installed.

 

Noと回答した場合、Webゲートウェイをインストールしないでインストールを継続するオプションとなるため、Webアクセスが行えません（＝管理ポータルを開く方法がありません）。

  • バージョン2023.2以降、新規インストール時にプライベートWebサーバはインストールされません。 そのため、このオプションを選択した場合、Webサーバがローカルの構成に存在しないためWebアクセスに必要な設定（Webゲートウェイのインストールと設定）が行われないため、Webアクセスが行えません。

Webアクセスを行うためには、ApacheなどのWebサーバをインストールし、別途Webサーバに対してWebゲートウェイのインストールとIRISへの接続設定が必要となります。

詳細はドキュメント：Web ゲートウェイのインストールをご参照ください。

実際の表示は以下の通りです。

No local web server found. Would you like to abort the installation <Yes>?  no

InterSystems IRIS did not detect a license key file

Do you want to enter a license key <No>?

Please review the installation options:
------------------------------------------------------------------
Instance name: IRIS
Destination directory: /usr/iris
InterSystems IRIS version to install: 2023.3.0.254.0
Installation type: Development
Unicode support: Y
Initial Security settings: Normal
User who owns instance: root
Group allowed to start and stop instance: root
Effective group for InterSystems IRIS processes: irisusr
Effective user for InterSystems IRIS SuperServer: irisusr
SuperServer port: 1972
JDBC Gateway port: 53773
Web Gateway: not using local web server
------------------------------------------------------------------

Confirm InterSystems IRIS installation <Yes>?

Starting installation
Starting up InterSystems IRIS for loading...
../bin/irisinstall -s . -B -c c -C /usr/iris/iris.cpf*IRIS -W 1 -g2
Starting Control Process
Allocated 498MB shared memory
32MB global buffers, 80MB routine buffers
Creating a WIJ file to hold 32 megabytes of data
IRIS startup successful.
System locale setting is 'C.UTF-8'
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

^^/usr/iris/mgr/>

^^/usr/iris/mgr/>
Start of IRIS initialization
Loading system routines
Updating system TEMP and LOCALDATA databases
Loading system classes
Installing National Language support

Setting IRISTEMP default collation to IRIS standard (5)
Updating Security database
Loading system source code
Building system indices
Updating Audit database
Updating Journal directory
Updating User database
Updating Interoperability databases
Scheduling inventory scan
IRIS initialization complete
259 lines written to /usr/iris/mgr/filecheck.isc
See the 'iboot.log' file for a record of the installation.

Starting IRIS
Using 'iris.cpf' configuration file

Starting Control Process
Global buffer setting requires attention.  Auto-selected 25% of total memory.
Allocated 1529MB shared memory
976MB global buffers, 97MB routine buffers
Creating a WIJ file to hold 99 megabytes of data
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

1 alert(s) during startup. See messages.log for details.

Installation completed successfully
$

 

2. Apacheを事前に準備しない状態でのアップグレード

インストール時、「1. Apacheを事前に準備しない状態での新規インストール」と同様に、

No local web server found. Would you like to abort the installation <Yes>?

と表示されます。

No を選択するとアップグレードが継続されます。

ローカルにWebサーバがない状況ですが、アップグレード前から使用しているプライベートWebサーバを使用して、アップグレード前と同じ方法で管理ポータルやWebアクセスが行えます。

管理ポータルのアドレス：　http://localhost:52773/csp/sys/UtilHome.csp

また、インスタンス名（例ではiris）のパスが付いたアドレスも用意されるため、以下のURLでも管理ポータルにアクセスできます。

例）http://localhost:52773/iris/csp/sys/UtilHome.csp

 

3. Apacheをインストールした後の新規／アップグレードインストール

事前にApacheをインストールした場合、インストーラーがWebサーバを検出し、以下の選択肢を表示します。

Local web server detected. Would you like to use the web server to connect to this installation <Yes>?

$ sudo ./irisinstall
Your system type is 'Ubuntu 22.04 LTS (x64)'.


Currently defined instances:


Enter instance name: IRIS
Do you want to create InterSystems IRIS instance 'IRIS' <Yes>?

Enter a destination directory for the new instance.
Directory: /usr/iris
Directory '/usr/iris' does not exist.
Do you want to create it <Yes>?

------------------------------------------------------------------
NOTE: Users should not attempt to access InterSystems IRIS while
      the installation is in progress.
------------------------------------------------------------------

Select installation type.
    1) Development - Install InterSystems IRIS server and all language bindings
    2) Server only - Install InterSystems IRIS server
    3) Custom
Setup type <1>? 1

How restrictive do you want the initial Security settings to be?
"Minimal" is the least restrictive, "Locked Down" is the most secure.
    1) Minimal
    2) Normal
    3) Locked Down
Initial Security settings <1>? 2

What user should be the owner of this instance? root
An InterSystems IRIS account will also be created for user root.

Install will create the following InterSystems IRIS accounts for you:
_SYSTEM, Admin, SuperUser, root and CSPSystem.
Please enter the common password for _SYSTEM, Admin, SuperUser and root:
Re-enter the password to confirm it:

Please enter the password for CSPSystem:
Re-enter the password to confirm it:

What group should be allowed to start and stop
  this instance? root

Do you want to install IRIS Unicode support <Yes>?

Local web server detected. Would you like to use the web server to connect to this installation <Yes>?

 

3-1. 「Yes」を選択した場合

Webサーバに必要な設定を自動的に行います。

Local web server detected. Would you like to use the web server to connect to this installation <Yes>?

InterSystems IRIS did not detect a license key file

Do you want to enter a license key <No>?

Please review the installation options:
------------------------------------------------------------------
Instance name: IRIS
Destination directory: /usr/iris
InterSystems IRIS version to install: 2023.3.0.254.0
Installation type: Development
Unicode support: Y
Initial Security settings: Normal
User who owns instance: root
Group allowed to start and stop instance: root
Effective group for InterSystems IRIS processes: irisusr
Effective user for InterSystems IRIS SuperServer: irisusr
SuperServer port: 1972
WebServer port: 80
JDBC Gateway port: 53773
Web Gateway: installed into /opt/webgateway
Apache web server will be configured for Web Gateway
Apache web server configuration file: /etc/apache2/apache2.conf
------------------------------------------------------------------

Confirm InterSystems IRIS installation <Yes>?

Starting installation
    Updating Apache configuration file ...
    - /etc/apache2/apache2.conf

Starting up InterSystems IRIS for loading...
../bin/irisinstall -s . -B -c c -C /usr/iris/iris.cpf*IRIS -W 1 -g2
Starting Control Process
Allocated 498MB shared memory
32MB global buffers, 80MB routine buffers
Creating a WIJ file to hold 32 megabytes of data
IRIS startup successful.
System locale setting is 'C.UTF-8'
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

^^/usr/iris/mgr/>

^^/usr/iris/mgr/>
Start of IRIS initialization
Loading system routines
Updating system TEMP and LOCALDATA databases
Loading system classes
Installing National Language support

Setting IRISTEMP default collation to IRIS standard (5)
Updating Security database
Loading system source code
Building system indices
Updating Audit database
Updating Journal directory
Updating User database
Updating Interoperability databases
Scheduling inventory scan
IRIS initialization complete
260 lines written to /usr/iris/mgr/filecheck.isc
See the 'iboot.log' file for a record of the installation.

Starting IRIS
Using 'iris.cpf' configuration file

Starting Control Process
Global buffer setting requires attention.  Auto-selected 25% of total memory.
Allocated 1529MB shared memory
976MB global buffers, 97MB routine buffers
Creating a WIJ file to hold 99 megabytes of data
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

1 alert(s) during startup. See messages.log for details.

You can now access InterSystems IRIS, to access the management portal point your browser to:
http://localhost/iris/csp/sys/UtilHome.csp

Installation completed successfully
$

 

管理ポータルに「http://Webサーバ/インスタンス名/csp/sys/UtilHome.csp」 でアクセスできることが最後に案内されます。

（アップグレードした場合は、アップグレード前まで利用していたプライベートWebサーバは無効化されます。）

 

3-2. アップグレード時「No」を選択した場合

プライベートWebサーバを使用した環境が残るため、アップグレード前と同じ方法で管理ポータルやWebアクセスが行えます。

管理ポータルのアドレス：　http://localhost:52773/csp/sys/UtilHome.csp

 

3-3. 新規インストール時「No」を選択した場合

インストールは完了しますが、Webアクセスが行えません＝管理ポータルを開く方法がありません。

Webアクセスを行うためには、手動でApacheにWebゲートウェイをインストールし、IRISに接続するための設定が必要となります。

詳細はドキュメント：Web ゲートウェイのインストールをご参照ください。

以下、「No」を選択した後のインストール表示例です。 

Local web server detected. Would you like to use the web server to connect to this installation <Yes>?  no

InterSystems IRIS did not detect a license key file

Do you want to enter a license key <No>?

Please review the installation options:
------------------------------------------------------------------
Instance name: IRIS
Destination directory: /usr/iris
InterSystems IRIS version to install: 2023.3.0.254.0
Installation type: Development
Unicode support: Y
Initial Security settings: Normal
User who owns instance: root
Group allowed to start and stop instance: root
Effective group for InterSystems IRIS processes: irisusr
Effective user for InterSystems IRIS SuperServer: irisusr
SuperServer port: 1972
JDBC Gateway port: 53773
Web Gateway: not using local web server
------------------------------------------------------------------

Confirm InterSystems IRIS installation <Yes>?

Starting installation
Starting up InterSystems IRIS for loading...
../bin/irisinstall -s . -B -c c -C /usr/iris/iris.cpf*IRIS -W 1 -g2
Starting Control Process
Allocated 498MB shared memory
32MB global buffers, 80MB routine buffers
Creating a WIJ file to hold 32 megabytes of data
IRIS startup successful.
System locale setting is 'C.UTF-8'
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

^^/usr/iris/mgr/>

^^/usr/iris/mgr/>
Start of IRIS initialization
Loading system routines
Updating system TEMP and LOCALDATA databases
Loading system classes
Installing National Language support

Setting IRISTEMP default collation to IRIS standard (5)
Updating Security database
Loading system source code
Building system indices
Updating Audit database
Updating Journal directory
Updating User database
Updating Interoperability databases
Scheduling inventory scan
IRIS initialization complete
260 lines written to /usr/iris/mgr/filecheck.isc
See the 'iboot.log' file for a record of the installation.

Starting IRIS
Using 'iris.cpf' configuration file

Starting Control Process
Global buffer setting requires attention.  Auto-selected 25% of total memory.
Allocated 1529MB shared memory
976MB global buffers, 97MB routine buffers
Creating a WIJ file to hold 99 megabytes of data
This copy of InterSystems IRIS has been licensed for use exclusively by:
No local key detected, trying license server.
Copyright (c) 1986-2023 by InterSystems Corporation
Any other use is a violation of your license agreement

1 alert(s) during startup. See messages.log for details.

Installation completed successfully
$

 

4.Apacheの設定

ApacheをWebサーバとして利用し、VSCodeでデバッグを行う場合、ApacheのWebSocket用モジュールを有効化する必要があります。

詳細は、デバッグ時の注意点のApacheの場合をご参照ください。をご参照ください。

ディスカッション (0)1
続けるにはログインするか新規登録を行ってください