Micro Focus COBOL Server for SOA <Unix/Linux> の Readme

この Readme には製品ヘルプに記載がない情報が含まれている場合があります。 製品をインストールする前に、Readme 全体を必ずご一読ください。

この Readme は、次の項で構成されています。


注: Micro Focus は、ウェブ・サイトの内容またはそのリンク先サイトの内容について責任を負いません。ウェブ・サイトは本質的に短期間で変更される可能性があります。したがって、リンクを最新の状態に保つように努力していますが、必ず期待どおりに機能することを保証することはできません。

システム要件

上へ戻る

ハードウェア要件

オペレーティング・システム:
  • AIX 6.1, 7.1 (Power) - 32/64-bit
  • HP-UX 11.31 (Itanium) - 32/64-bit
  • Oracle Linux - Unbreakable Enterprise Kernel 6.x / 7.x (intel) - 32/64-bit
  • Oracle Linux - Red Hat Compatible Kernel 6.x / 7.x (intel) - 32/64-bit
  • Red Hat 5.x, 6.x, 7.x (intel) 6.x, 7.x (390)- 32/64-bit
  • Solaris 10 11 (SPARC) 11 (intel) - 32/64-bit
  • SUSE 11, 12 (intel) 11, 12 (390) - 32/64-bit
ディスク領域:
プラットフォーム セットアップ ファイル サイズ (MB) インストールに必要なディスク容量 (GB) 製品の実行に必要なディスク容量 (MB) Sentinel RMS ライセンスサーバー (MB)
POWER running AIX 353 1.41 706 36.5
HP IA 685 2.74 1370 69
System Z running Red Hat Linux 284 1.14 568 36
x86-64 running Red Hat Linux 298 1.19 596 46
SPARC running Solaris 342 1.37 684 40
x86-64 running Solaris 313 1.25 626 31
System Z running SuSE SLES 287 1.15 574 34
x86-64 running SuSE SLES 302 1.21 604 46

ソフトウェア要件

  • pax アーカイブユーティリティがセットアップの実行で使用されています。ほぼすべての Linux/Unix システムで提供されているものですが、もしない場合は、別途インストールする必要があります。インストールされているかを確認するには、コマンドプロンプトから pax --help または pax --version を実行します。
  • Red Hat 6.x および Red Hat 7.x では、インストールを実行する前に、以下の OS のパッケージをインストールする必要があります:
    • glibc-*.i686
    • glibc-*.x86_64
    • glibc-devel-*.i686
    • glibc-devel-*.x86_64
    • libgcc-*.i686
    • libgcc-*.x86_64
    • libstdc++-*.i686
    • libstdc++-*.x86_64

    OS のパッケージのインストールに関しては、Red Hat 社のサイトをご確認ください。

  • IBM System z (390) プラットフォームの場合は、以下の OS のパッケージをインストールする必要があります:
    • glibc-*.s390
    • glibc-*.s390x
    • libgcc-*.s390
    • libgcc-*.s390x

    OS のパッケージのインストールに関しては、Red Hat 社のサイトをご確認ください。

  • COBOL JVM コードの実行、およびネーティブ COBOL と Java 相互運用性サポートが動作保証されている Java は、 Java Platform, Enterprise Edition (Java EE) 7 または Java 8 です。 Java EE は、www.oracle.com からダウンロードして、マシン上の任意のディレクトリにインストールできます。

    注:

    • AIX および System Z Linux 上では、IBM の JDK が必要です。 サポートされる IBM JDK の最も初期のリリースは 7.0 Service Refresh 8 です。IBM の AIX の JDK は IBM の Webサイトからを取得できます。
    • HP-UX 上では、HP-UX JDK が必要です。 サポートされる HP-UX JDK の最も初期のリリースは 7.0.11 です。 HP-UX Java JDK は HP の Webサイトからを取得できます。
  • 次の環境変数を設定する必要があります。
    • JAVA_HOME 環境変数を設定します。クライアント製品をインストールする場合は、この変数に 32 ビット Java インストールの場所を設定してください。設定しない場合、インストールは終了します。
    • システムの PATH 変数に $JAVA_HOME/bin を追加します。
    • LANG 環境変数を設定します。これにより、ローカライズされたメッセージを選択します。LANG の設定は、英語および日本語のみをサポートします。
    • Enterprise Server Administration を使用可能にするため、JavaScript やスクリプトのサポートをブラウザで有効にする必要があります。また、アクティブコンテンツを許可してブロックされないようにする必要があります。
追加のソフトウェア要件
製品の一部の機能を活用するには、事前インストールの必要なソフトウェアに加えて サードパーティ製のソフトウェアを入手して追加インストールする必要がある場合があります。 以下は、各機能で必要なサードパーティ ソフトウェアに関する情報です。
  • JVM COBOL の アプリケーション サーバーのサポート

    次のアプリケーション サーバーは、次の JDK を使用してサポートされています:

    アプリケーション サーバー JDK バージョン コンテナ サポート バージョン
    Tomcat 7.0.39 1.7 Servlets 2.5
    JBoss 7.1.1 1.7 Servlets 2.5
    WebLogic 12.1.1 1.7 Servlets 2.5
    WebSphere 8.5 1.7 Servlets 2.5

    注:

    • AIX および System Z Linux 上では、IBM の JDK が必要です。 サポートされる IBM JDK 1.7 の最も初期のリリースは 7.0 Service Refresh 8 です。IBM の AIX の JDK は IBM の Webサイトからを取得できます。
    • HP-UX 上では、HP-UX JDK が必要です。 サポートされる HP-UX JDK 1.7 の最も初期のリリースは 7.0.11 です。 HP-UX Java JDK は HP の Web サイトからを取得できます。
    • 上記以外のすべてのプラットフォーム上では、Oracle の JDK が必要です。 サポートされる Oracle JDK 1.7 の最も初期のリリースは 1.7.027 です。Oracle JDK は Oracle の Web サイトからダウンロードできます。
  • Enterprise Server のアプリケーション サーバー JCA サポート

    Interface Mapping Toolkit で生成された EJB の配置する場合の Java EE 5 および Java EE 6 のサポートは次の通りです:

    • Java EE 5 には、EJB 3.0 および Java Connector Architecture 1.5 のサポートが含まれます。
    • Java EE 6 には、EJB 3.1 および Java Connector Architecture 1.6 のサポートが含まれます。
    次の Java アプリケーション・サーバは、下記の JDK を使用してサポートされます。:

    J2EE アプリケーション サーバー JDK (ベンダ) Java EE COBOL RA
    JBoss 5.1.0 1.5/1.6 (Oracle) 5 X
    JBoss 6.1.0 1.6 (Oracle) 6 X
    JBoss 7.1.1 1.7 (Oracle) 6 X
    Oracle WebLogic 10.3.5 1.6 (Oracle) 5 X
    Oracle WebLogic 12.1.1 1.6/1.7 (Oracle) 6 X
    IBM WebSphere 7.0 1.5 (IBM) 5 X
    IBM WebSphere 8.0 1.6 (IBM) 6 X
    IBM WebSphere 8.5 1.6/1.7 (IBM) 6 X
    これらのアプリケーション サーバー用のリソースアダプタの利用可能な状況は、UNIXプラットフォーム間で異なります。 各プラットフォームのサポート状況は次の表の通りです。
    機能/プラットフォーム JBoss 5.1.0 JBoss 6.1.0 JBoss 7.1.1 WebSphere 7.0 WebSphere 8.0 WebSphere 8.5 WebLogic 10.3.5 WebLogic 12.1.1
    POWER running AIX 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット
    HP IA 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット 64 ビット 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット
    System Z running Red Hat Linux 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット
    x86-64 running Red Hat Linux 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット
    SPARC running Solaris 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット
    x86-64 running Solaris 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット 32 ビット / 64 ビット
    System Z running SUSE SLES 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット
    x86-64 running SUSE SLES 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット 32 ビット
  • データベースアクセス

    OpenESQL や COBSQL などで開発されたSQLアプリケーションを配布する場合は、任意のサードパーティ製ソフトウェアの必須コンポーネントがインストールされ、環境が適切に設定されていることを確認してください。詳細は、お使いの開発製品の Readme のシステム要件にある「追加のソフトウェア要件 > データベースアクセス」を参照してください。

  • Java Bean

    IBM の Java または Oracle の Java Platform, Enterprise Edition (Java EE) 1.6 またはそれ以降。 Java EE は www.oracle.com からダウンロード可能です。

ダウンロードとインストールの手順

上へ戻る

注:
  • インストール実行中に、インストーラは製品の Enterprise Server のシステム管理のプロセス ユーザー IDを設定します。プロセス ユーザー IDは、Micro Focus Directory Server(MFDS)のものを除く、すべての Enterprise Server プロセスのオーナーになります。Directory Server プロセス(Enterprise Server Administration)は rootとして実行されますが、これはシステムファイルやポートにアクセスするためです。

    Enterprise Server Administration から起動される、すべての Enterprise Server プロセスは、ファイルのアクセスと作成の権限のあるプロセス ユーザー ID の下で実行されます。

    デフォルトでは、インストーラはインストーラを実行するユーザーのログインIDをプロセス ユーザー IDとして使用しています。インストール後に、このプロセス ユーザー IDを変更する場合は、 $COBDIR/bin/casperm.sh を実行します。

  • バージョン 2.3 からインストールファイル名の先頭の英文字が変更しました。これに伴いデフォルトのインストール先やアンインストール用のスクリプト名が変更されています。詳細はこの Readme に記載されている通りです。
    変更前(バージョン 2.2.x 以前) ent_server_バージョン_プラットフォーム
    変更後(バージョン 2.3) setup_cobol_server_バージョン_プラットフォーム
  • Red Hat および SUSE プラットフォーム製品には .zip ファイルで提供されているセットアップファイル(setup_ で始まるファイル名の Micro Focus インストーラ) に加えて RPM インストーラが .bin ファイルとして提供されています。

    これらのプラットフォーム製品の場合は、Micro Focus インストーラ(.zip ファイル)か、この RPM インストーラ(.bin ファイル)のうち、いずれかを選択してダウンロードしてお使いください。

    RPM インストーラの場合、次の手順で .rpm ファイルが現行ディレクトリに展開されます。

    1. 次のコマンドを実行して実行権限を与えます。
      chmod +x RPM_installer_name.bin
    2. 次のコマンドを実行すると、使用許諾契約への同意確認メッセージが表示されるので、y を押します。
      ./RPM_installer_name.bin

    rpm コマンドでインストールする場合、インストール先は --prefix で変更可能です。 rpm コマンドによるパッケージ管理については、各 OS のドキュメンテーションをご確認ください。
  • 以下の2種類の製品のセットアップファイルは同一ファイルです。(例えば、COBOL_Server_2.3_SOA_AIX.zip と COBOL_Server_2.3_AIX.zip は同一です。)製品パッケージに同梱されるライセンスが異なるため、使用可能な機能が異なる別製品となっています。

    • 実行環境製品 COBOL Server 2.3J
    • 実行環境製品 COBOL Server 2.3J for SOA

  1. 実行環境製品 COBOL Server 2.3J for SOA ダウンロード」から、 該当するプラットフォーム用のダウンロード ファイルをクリックしてダウンロードし、解凍します。

    インストール先に直接ダウンロードして解凍する場合は、スーパーユーザ権限で次のように unzip コマンドを使って解凍します。

    unzip ./COBOL_Server_2.3_SOA_プラットフォーム名.zip

  2. Windows 環境にダウンロードして解凍したファイルを、インストール先の環境に ftp でバイナリ転送しても同様です。

    (Windows 環境での ZIP ファイルの解凍には Windows に標準搭載されている圧縮ファイルの展開機能や、Windows 用のファイル解凍ユーティリティをお使いください。)

    注:
    • Sun Solaris の場合は、次の手順 2. でインストールを開始する前に、以下を行ってください。それ以外のプラットフォームの場合は、この手順をスキップしてください。

      XPG4 のユーティリティを使っていない場合は、PATH で XPG4 のフォルダを先頭に指定してください。

      例 bsh の場合

      PATH=/usr/xpg4/bin:$PATH
      export PATH

      設定がない場合のインストールエラー例

      tar: /install_image_dir/safenet.tar: ファイルもディレクトリもありません。

      install_image_dir : インストールファイルのあるディレクトリ名

      上記以外で Bad string エラーが発生するケースがあります。

    • License Server

      Linux/Unix 上で License Server が正常に起動されるには、hostname を構成する必要があります。

      動作の不具合を回避するには、localhost と コンピュータの hostname の両方を IPアドレス 127.0.0.1 にマップしてはいけません。 localhost にのみ IPアドレス 127.0.0.1 にマップする必要があります。

      /etc/hosts ファイルでの正しい指定例は次の通りです。

      127.0.0.1 localhost.localdomain localhost
      IP machinelonghostname machineshorthostname
      
      ここで IP は xx.xx.xx.xx フォーマットのコンピュータの一意の IP アドレスを意味します。
  3. スーパーユーザ権限で、次のコマンドを実行します。(この手順以降はスーパーユーザ権限の同一ログイン セッションでおこないます。)
    chmod +x setup_cobol_server_2.3_プラットフォーム名
    ./setup_cobol_server_2.3_プラットフォーム名

    スーパーユーザ権限で実行していない場合は、インストール時にスーパーユーザのパスワードの入力を促すプロンプトが表示されます。

  4. COBOL 環境のデフォルトのインストール先は /opt/microfocus/VisualCOBOL です。このデフォルトを変更するには、
    -installlocation="Location" パラメータを使用して 以下の例のように別のディレクトリを指定します。

    ./setup_cobol_server_2.3_プラットフォーム名 -installlocation="インストール先のフルパス"

    -help オプションを指定すると、インストール・スクリプトに渡すことができる他のパラメータの詳細を確認できます。

    次のオプションを指定して、Enterprise Server の構成を指定することができます:

    [ -ESsysLog="location" ] [ -ESadminID="User ID" ] [ -CASrtDir="location" ]

    それぞれ、次の内容を指定します:

    • -ESsysLog

      Enterprise Server のシステムログの作成場所を指定します。
      例: -ESsysLog="/home/esuser/logs"
      デフォルトの場所は /var/mfcobol/logs です。

    • -ESadminID

      Enterprise Server のシステム管理のプロセス ユーザー IDを指定します。
      例: -ESadminID="esadm"
      デフォルトはインストール実行するユーザIDです。

    • -CASrtDir

      Enterprise Server 実行時システムファイルの場所を指定します。
      例: -CASrtDir="/home/esuser/casrt/es"
      デフォルトの場所は /var/mfcobol/es です。

    注:
    • SafeNet Sentinel ライセンスで保護されている製品が稼動中である場合、この製品のインストールが影響を与える可能性があります。 インストール中はライセンス更新のため、ライセンス機能が停止します。 SafeNet Sentinel ライセンスで保護されている稼動中の製品への影響を防ぐには、以下の例のようにSafeNet のインストールをスキップさせるオプション -skipsafenet を指定する必要があります。
      ./setup_cobol_server_2.3_プラットフォーム名 -skipsafenet
    • インストールされている SafeNet Sentinel への予期しない更新の影響を防ぐには、 以下のコマンドを実行して、/var/microfocuslicensing/ に空のファイル SKIP_SAFENET_INSTALL を作成します。
      touch /var/microfocuslicensing/SKIP_SAFENET_INSTALL
      このファイルが存在すると、SafeNet インストーラはインストールの更新や実行中のライセンスデーモンの停止を行いません。 ライセンスの更新を行うには、このファイルを削除して Sentinel RMS ライセンス・サーバを手動でインストールします。
    • Red Hat Enterprise Linux (RHEL) 7.x にインストールする場合に SafeNet ライセンスのサービス起動を既定の設定以外の方法で管理する場合は、以下を確認してください。

      RHEL 7.x では、/etc/inittab が使用されない等の一部の構成の変更により、SafeNet ライセンス サービスの起動の管理が変更されています。

      既定の設定では、サーバーの起動時に、SafeNet Sentinel ライセンス サービスが自動起動されます。 サーバーの起動時にサービスを自動起動させない場合や、トレースレベルを変更する等、既定の動作を変更する場合は、 次の手順で、OS の systemctl コマンドを使う必要があります。

      1. 以下の既定のインストールにより作成されている /usr/lib/systemd/system/MFSafeNet.service を適宜編集して既定以外の動作を指定します。
        -----------  /usr/lib/systemd/system/MFSafeNet.service の先頭 -----------
            [Unit]
            Description=Micro Focus SafeNet licensing daemons. 
            Documentation=http://supportline.microfocus.com
        
            [Service]
            Type=forking
            ExecStart=/var/microfocuslicensing/bin/startboth.sh
            ExecStop=/var/microfocuslicensing/bin/stopboth.sh
            Restart=no
        
            [Install]
            WantedBy=multi-user.target
        -----------   /usr/lib/systemd/system/MFSafeNet.service の末尾 -----------
        
      2. systemctl コマンドで SafeNet ライセンス サービスを設定します。
        [ asroot ] systemctl  option  MFSafeNet
        

        指定可能なオプションは次の通りです:

        reenable SafeNet サービスを再有効化します。
        is-enabled SafeNet サービスの状態確認を行います。ルート権限は不要です。
        start SafeNet サービスを起動します。
        stop SafeNet サービスを停止します。
        restart SafeNet サービスを再起動します。
        disable サーバー起動時の自動起動しないように SafeNet サービスを無効化します。
        enable サーバー起動時の自動起動するように SafeNet サービスを有効化します。
        systemctl コマンドの詳細については、RHEL の OS のヘルプを参照してください。

サイレント インストール

上へ戻る

以下のコマンド行引数を指定してサイレント インストールを行うことができます。

-silent -IacceptEULA

コマンドの実行例

./setup_cobol_server_2.3_プラットフォーム名 -silent -IacceptEULA

インストール後

上へ戻る

製品のインストール後は、下記の手順で環境を設定する必要があります。

注: 下記のコマンドで設定されるのは、現在のシェルの環境だけなので、新しいシェルを起動するたびに、下記のコマンドを実行する必要があります。

シェル初期化ファイル (/etc/profile/etc/bashrc など) に下記のコマンドを追加すれば、すべてのシェルで cobsetenv を実行する必要はなくなります。

ただし、cobsetenv は bash、ksh、XPG4 sh のように POSIX 系のシェルでのみ動作します。C シェルまたは XPG4 Bourne シェル以前のものとは互換性がないので、ご注意ください。


  1. 製品を設定するには、次のコマンドを実行します。
    . /opt/microfocus/VisualCOBOL/bin/cobsetenv
  2. 製品のインストール状態やバージョンを確認するには、次のコマンドを実行します。
    cob -Version

ライセンス

上へ戻る

ソフトウェアのライセンスを有効にするには、次の管理ツールを実行します。
sh /var/microfocuslicensing/bin/cesadmintool.sh

上記の管理ツールを実行して表示されるメニューから「1. オンライン認証(1. Online Authorization.)」を選択し、認証コード(Authorization Code)を入力してライセンスの認証をおこなうことができます。

認証コード(Authorization Code)は、16桁の英数字の文字列で、製品パッケージに同梱されている「ライセンス証書」に記載されています。

Product Detail: COBOL Server Version 』で始まる項に記載されているコードを使用します。

注: Micro Focus ライセンスシステムは、インストール・プロセスの一部として /var/microfocuslicensing ディレクトリにインストールされます。

ライセンス・ポリシーの内容または必要なライセンスの種類がわからない場合は、システム管理者または製品の購入元に連絡し、有効なライセンスを取得してください。

アンインストール

上へ戻る

COBOL Server for SOA を削除するには、$COBDIR/bin ディレクトリの以下のスクリプトを実行します。 Uninstall_COBOLServer2.3.sh

警告:
このスクリプトを実行すると、 COBOL Server for SOA が完全に削除されます。

COBOL Server for SOA をアンインストールしても、Micro Focus Licensing Manager または必須ソフトウェアのアンインストールは自動的には行われません。

Micro Focus ライセンス・マネージャをアンインストールするには、/var/microfocuslicensing/bin ディレクトリUnInstallMFLicenseServer.sh スクリプトを実行します。このスクリプトを実行しても、特定のシステム設定またはライセンスが含まれる一部のファイルは削除されません。

オプションで、必須ソフトウェアを削除できます。手順については、各ソフトウェア・ベンダのマニュアルを参照してください。

既知の問題点

上へ戻る

製品ヘルプの『製品情報』のトピック『既知の問題点と制限事項』、 および、お使いのバージョンの開発環境製品の ReadMe の「既知の問題点」を参照してください。

製品ヘルプ

上へ戻る

  • 日本語のマニュアルは、Micro Focus のサイト上の製品マニュアルのページから、このリリースの Visual COBOL のリンクをクリックすると表示されます。
  • 英語版のマニュアルは、以下の手順で表示されます。
    1. Micro Focus Documentation をクリックして、英語版マニュアルのサイトを表示します。
    2. 左側のペインから[Micro Focus Developer > Micro Focus COBOL Server for UNIX]を選択します。(選択する製品名にバージョン情報が含まれている場合があります。)
注: 英語版マニュアルには製品の保守サポートやアップデートに関する記述が含まれていますが、ご購入製品のシリアル番号が MFK で始まる場合は、Micro Focus のサイト上の製品の保守サービスについてをご参照ください。

保守サポート

上へ戻る

製品の保守サポートに関する情報は Micro Focus のサイト上の製品の保守サービスについてをご参照ください。

免責条項

上へ戻る

本ソフトウェアは、いかなる保証もなしに「現状有姿」で提供されます。Micro Focus は、市場性または特定の目的への適合性に関する保証を含む明示的または黙示的保証を一切否認します。Micro Focus またはそのサプライヤは、直接的、間接的、付随的、結果的、営業利益的、または特別な損害を含むいかなる損害に関して、たとえ事前にそのような損害の可能性を通知されていたとしても、一切の責任を負わないものとします。一部の州では、結果的または付随的な損害の責任の除外または制限を許可していないため、上述の制限が適用されない可能性があります。

Micro Focus は登録商標です。

Copyright © Micro Focus IP Development Limited 1984-2015. All rights reserved.