Question:
外部データベースをDocuWareに接続するには、どのガイドラインを満たす必要がありますか?
Answer:
DocuWareは、3種類のデータベースエンジンをサポートしています:MySQL、Microsoft SQL、Oracleです。ソフトウェアに付属しているデフォルトのデータベースはMySQL Engineです。DocuWareをインストールまたは使用する前に、データベースサーバーを準備するためのガイドラインを以下に示します。
注意: インストールに外部データベース(AutoindexまたはSelect List)を使用する場合も、同じ前提条件が適用されます。
インストールに外部MySQL(DocuWare内部データベースではない)
- DocuWareのバージョンとサポートされているデータベースの詳細については、システム要件を参照して ください。
- www.mysql.com からMySQL GUIツールをダウンロードします(オプション)。このツールを使用すると、バックアップ、リストア、およびデータベースのメンテナンスを作成できます。
- ユーザ root アカウントと同じ権限を持つ新しいユーザを作成します。MySQL Administration Toolで、ユーザrootを右クリックし、"Clone user "オプションを選択する。
- このデータベースのデフォルトポートは3306です。
Microsoft SQL (MSSQL) for DocuWare Installation
- 特に古いバージョンのMicrosoft SQL Serverを使用している場合は、MSSQLサーバーのサービスパック(SP)が最新であることを確認してください。
- Microsoft SQL Serverは、インストール時に固定ポート番号で設定する必要があります。DocuWareでは、インストール時の動的ポーティングはサポートしていません。また、MSSQL Express EditionはDocuWareではサポートされていません。MSSQLのデフォルトのポートは1433です。
- SQLサーバーインスタンスが静的ポートまたは動的ポートで構成されているかどうかを確認するには、"SQL Server 20xx Configuration Manager "というツールを使用できます。
- また、DocuWareの各バージョンの「システム要件」をご覧ください。
- Microsoft SQLサーバーは、SQL認証とWindows認証を受け付けるように設定する必要があります。DocuWareのインストール中、SQL認証が使用されます。これは通常、SQL Server Management Studioで行います。
- SQL Server Management Studio "を開き、SQLサーバーにログインし、SQLユーザーを作成します:
- Securityadminロールの権利
- Sysadminロールの権限
- このSQLユーザは、データベースとデータベース・オブジェクト(テーブル、トリガ、インデックスなど)を作成できなければなりません。
- このSQLユーザは、tempdbデータベースのsecurityadminロールとしてもマッピングされなければなりません。
- SQLサーバーが複数のインスタンスを実行している場合、インストール時にDocuWareから完全なインスタンス名(例: ServerName︓InstanceName)を使用して接続する必要があります。
注: データベースの準備が完了すると、DocuWare Authenticationサーバーのインストールは、そのデータベースに接続し、DocuWareソフトウェアに必要なすべてのコンポーネントを作成します。DocuWareを別のサーバーにインストールする場合は、そのDocuWareサーバーからMicrosoft SQL DatabaseサーバーへのテストODBC接続を作成することで、接続をテストできます(テストのみ)。
Oracle Database for Installation / Direct Connection (No longer supported in DocuWare 7.10)
まず、WindowsでOracleを動かしている場合、DocuWareとOracle Database Engineを同じサーバーにインストールする ことはできません。
Oracle Database Engineを使用してDocuWareをインストールするには、データベースを準備する必要があります。これは、新規インストールでも、古いバージョンのDocuWareから新しいバージョンへのアップグレードでも有効です。場合によっては、古いOracle Clientを削除し、新しいバージョンのOracle Clientをインストールする必要があります。
Oracle環境では、インストールによって作成されたすべてのオブジェクトは、単一のOracleユーザースキーマの下に存在します。
DocuWare 6.11まで:
Oracle Clientは、DocuWare Serversがインストールされるマシンにインストールする必要があります。Oracleクライアントは、DocuWareサービスを実行するWindowsアカウント(ローカルまたはドメイン)の下にインストールしてください。
- 少なくともインストール時には、DBA権限を持つOracleユーザーが必要です(推奨)。このユーザーは、データベース・スキーマ内のデータベース・オブジェクトを作成および操作できなければなりません。インストールが完了したら、このユーザーの権限を制限することができます。
- 32 ビッ ト Oracle Data Access Components (ODAC) を イ ン ス ト ールす る 必要があ り ます:ODAC 11.2 Release 5
以下のコンポーネントをインストールします:- Oracle Data Provider for .NET 4 - 11.2.0.3.0
- Oracle Data Provider for .NET 2 - 11.2.0.3.0
- Oracle Providers for ASP.NET 4 - 11.2.0.3.0
- ASP.NET 2用オラクル・プロバイダ - 11.2.0.3.0
- Oracle Database Extensions for .NET 4 - 11.2.0.3.0 - アップグレード専用
- Oracle Database Extensions for .NET 2 - 11.2.0.3.0 - アップグレード専用
- Oracle Providers for OLE DB - 11.2.0.3.0
- OLE用オラクル・オブジェクト - 11.2.0.3.0
- Oracle Services for Microsoft Transaction Server - 11.2.0.3.0
- Oracle ODBCドライバ - 11.2.0.3.0
- Oracle SQL Plus - 11.2.0.3.0
- Oracle Instant Client - 11.2.0.3.0
- TNSNAMES.ORA ファイル(インストールまたは使用時に必要)
tnsnames.ora ファイルは、ローカル命名法の接続記述子にマップされたネットサービス名、またはリスナー・プロトコル・アドレスにマップされたネットサービス名を含む構成ファイルです。
ネットサービス名は、接続記述子に含まれるデータベース・ネットワーク・アドレスにマップされたエイリアスです。接続記述子には、プロトコル・アドレスによるリスナーの位置と、接続先のデータベースのサービス名が含まれる。クライアントと(他のデータベース・サーバーのクライアントである)データベース・サーバーは、アプリケーションとの接続を行うときにネット・サービス名を使用します(出典:https://docs.oracle.com)。
「tnsnames.ora」ファイルには、Oracleサーバーとその接続に関する情報が含まれています。このファイルは DBA から入手できる。このファイルは、DocuWareがインストールされるマシンで、Oracle Client Pathディレクトリの下に配置する必要があります(例:C:◆appappproduct◆11.2.0◆Administrator)。 - Windowsシステム環境変数の作成
- runコマンド([Windows]+[R])を開いて、sysdm.cplと入力する。
- タブ "Advanced "を開き、メニュー "Environment Variables... "を開く。
- 新しいシステム変数を作成する
- 名前とtnsnames.oraファイルがあるパスを入力する。
- Oracleクライアントをインストールしたマシンを再起動する。
- runコマンド([Windows]+[R])を開いて、sysdm.cplと入力する。
- SQLPlus+によるOracle接続のテスト
DocuWareをインストールする前に、ユーザーがOracleサーバーに接続できることを確認する必要があります。これは、Oracleユーザースキーマがデータベースに存在することも確認します。任意の Oracle ツールを使用して接続し、テストテーブルを作成できます。こ の例では、 DOS で実行で き る SQLPlus を使用 し ます。DOS で実行する場合、認証情報が提供されていることを確認し、テストテーブルを作成し、ユーザーのテストオブジェクトを表示します。 - 認証サーバーがデータベース・サーバーへの接続を要求してきたら、tnsnames.ora ファイルにある設定名を入力しなければならない。通常、データベースのサーバー名を入力するが、Oracleでは構成名を入力する必要がある。この情報はローカルのtnsnames.oraファイルにあります。Oracle の deafult ポート番号は 1521 です。
注: OracleクライアントがDocuWareサーバーに設定されると、認証サーバーのインストールによって、DocuWareサービスに必要なすべてのデータベース・オブジェクトが作成されます。Oracleサーバーで追加設定する必要はありません。
Oracleクライアントのトラブルシューティング
- セットアップまたはアプリケーションによって生成されたすべてのログを%programdata%にあるDocuWareで確認してください。
- DocuWareはOracleクライアントの32bitのみをサポートしています。
- データベースのバージョンがOracle 12cの場合、Oracle 12c ODACクライアントをインストールしてみてください。
- TNS_NAMEパスが無効です
- Oracleユーザーに権限がないか、十分な権限がない。
- Oracleクライアントのインストール後、サーバーが再起動されていない
- DocuWareサーバーからOracleサーバーにポート番号が開かれていません。Oracleサーバーのポートまたはファイアウォールを確認してください。
DocuWare 6.12以降、ODACは不要です。
KBAはオンプレミス組織にのみ適用されます。
ご注意:この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。