作成者:	EdBrown GregKmethy
作成日:	2011-12-29
ArchiCADバージョン	• ArchiCAD 15 • ArchiCAD 14 • ArchiCAD 13
プラットフォーム:	• Mac OS X • Windows
対象:	• 上級ユーザー • CADマネージャー

Getting Started with the GRAPHISOFT BIM Server
インストール前
インストール手順
トラブルシューティング

Getting Started with the GRAPHISOFT BIM Server

BIMサーバーをインストールするのに必要な事の全体を把握するのに動画をご覧ください。より詳細な内容は以下の記事をご覧ください。

インストール前

ローカルエリアネットワーク（LAN）にBIMサーバーをインストールする際のチェックリスト

推奨動作環境： BIMサーバーをインストールするコンピュータが推奨する動作環境を満たしているかご確認ください：BIMサーバーベストプラクティス
- スタンドアロンコンピュータにBIMサーバーアプリケーション専用としてください。
- クアッドコアCPU、8GBメモリ、64ビットシステム
- 十分な空き容量のある速いローカルハードドライブ
1つのBIMサーバー： 1つのコンピュータにBIMサーバーは1つのみインストールできます。
プライマリ（システム）ドライブ： BIMサーバーはプライマリ（システム）ドライブにインストールできます。BIMサーバーは起動時に一次ファイルを格納するのにシステムドライブに少なくとも5GB以上の空き容量が必要です。（データベースファイルは含みません）
ローカルドライブ： "プロジェクト"と"ライブラリ"フォルダの場所（実際にはBIMサーバーが全てのデータを格納する"データベース"です）はセカンダリドライブに指定できます、ですがローカルドライブを指定してください。画面ではこれらのフォルダにネットワーク上のフォルダを指定できますが、推奨しません。ネットワークドライブを"プロジェクト"や"ライブラリ"に指定すると、起動中にデータを消失するリスクがあります。
注意：BIMサーバーを1度インストールすると、"ライブラリ"フォルダの場所を変更することはできません。"プロジェクト"フォルダの場所は変更できます。
管理者権限： BIMサーバーをインストールするのにコンピュータの管理者権限が必要です。
無線ネットワークを無効化： コンピュータに2つのアクティブなネットワーク接続がある場合、一方を無効にします。これは無線ネットワークの無効化を意味します。またBIMサーバーがローカルネットワークとインターネット間のネットワークのゲートウェイとして機能するコンピュータにインストール出来ないことを意味します。
ウィルスチェックとインデックス検索がBIMサーバーのインストールに干渉することはよくあります（特にWindows7機）。インストール後に起動が拒否された場合、BIMサーバーをアンインストールしウィルス保護を無効にしてから再インストールします。問題が引き続き起きる場合はチームワークサーバーのディレクトリとそれ以下のウィルスチェックから外してください。プロジェクトとライブラリのディレクトリを変更したら、これらも同様にウィルスチェックを無効化します。
IPv4ネットワーク： BIMサーバーはIPv4ネットワークのみをサポートします。ルータがIPv6が（一般的には）有効でありネットワークがWindows7もしくはVistaで開始されている場合、クライアント機はIPv6アドレスを使用してBIMサーバーと通信しようとすることが可能です。
Network Specification（英文）
静的ローカルIPアドレスと恒久的なホスト： BIMサーバーは静的ローカルIPアドレスと恒久的なホスト名を持たなくてはなりません。（これらはDHCPとDNSサーバー設定です）。BIMサーバーが参加していない場合ランダムに起動と停止ができます！
DNS（ドメインネームサーバ）： ネットワークで採用されている正しく機能しているDNS（ドメインネームサーバ）を強く推奨します。これは、コンピュータがホスト名で互いに接続できるようになります。（/etc/hostsファイルは、DNSサーバーはこの問題の欠如を回避するために使用することができますが、推奨できません。この回避策の詳細は以下ご覧ください：Teamwork/BimServerRemoteConnection
コンピュータのホストネームは文字a-z、数字0-9と'-'のみが使用できます。ハイフンはコンピュータ名の最初と最後には使用できません。
ファイアウォール： 全てのファイアウォールはチームワークに使用するポートの通信のネットワークを許可します（デフォルトポートは以下です、ArchiCAD　13：9991、61616、5988、6005。ArchiCAD 14:14001、14002、14004、6005。ArchiCAD 15：15001、15002、15004、6005。BIMサーバーモジュールは全てのポートが開いている必要があります）。ディスカバリーポート6005はudpですが、他は全てTCPです。
"ユニキャスト"および"マルチキャスト": BIMサーバーはクライアント機がアドレスを入力することなくBIMサーバーを”発見する”のを手助けする通信機能があります。動作する準備として、サブネットルータが"ユニキャスト"および"マルチキャスト"を許可するよう設定します、そうしないとこのサービスは失敗します。他のチームワーク機能には影響しません。

リモートアクセス（WAN）での追加チェックリスト

詳細はチームワーク/BIMサーバー遠隔接続の記事をご覧ください。

静的IPアドレス 静的IPアドレスはインターネットプロバイダより有料で購入することができます。上記の記事のステップにより静的IPアドレスを購入する前に動的なパブリックIPアドレスを使用してBIMサーバーのセットアップをテストすることができます。
修飾ドメイン名 は必須ではありませんが、離れたクライアントからBIMサーバーに接続するのを容易にします（例：外部IPアドレスを使用する代わりに、ユーザーがbimserver.company.com等の名前でBIMサーバーに接続することができます）。多くの事務所では、この（サブ）ドメインネームはインターネットプロバイダ（WEBホスティングプロバイダではなく）が提供する社内のインターネット接続の静的パブリックIPアドレスへのホスティングサービスの”ポイント”で設定する必要があります。
ポートアドレス変換（PAT）はルーター（またはDNS）でチームワークポートのトラフィックを受け取り、BIMサーバーの内部IPアドレスに渡すよう設定します。動作する準備として、コンピュータがホストしているBIMサーバーがLAN上で静的ローカルIPアドレスを持っている必要があります - またはルーターがコンピュータのネットワーク名に基づいてポートフォワーディングを実行できる必要があります。
ルーター上のファイアウォールをチームワークのポートを双方向許可するよう設定します。
離れたクライアント機側のファイアウォールもまたチームワークポートの通信を許可します（注意：ほとんどのホームルータは再設定する必要はありません。これは初期設定ではたいてい任意のポートで通信を開始できるようにするためです。）
外部サーバーアドレスは以下で設定します。 BIMサーバーコントロールパネル /設定/詳細設定/完全修飾ドメイン名

バックアップ戦略

BIMサーバーの使用を始める前にバックアップ戦略をすることは不可欠です。BIMサーバーが実行されている場合でもバックアップを作成できる、グラフィソフト社より提供されたバックアップツールがある事に注意してください。もしサードパーティのバックアップツールを使用を計画している場合、BIMサーバーを停止した時にのみBIMサーバーがフルバックアップを作成出来ることにお気をつけください。

詳細はTeamwork project data management（英文）をご覧ください。

インストール手順

ステップ 1 - サーバー名

ユーザーがプロジェクトに参加するとき、BIMサーバーの名前を見ます。
一般的には、これはサーバーのホスト名です、そしてネットワーク上のDNSサーバーに保持された名前と一致します。(小規模なオフィスではサーバーバージョンのOSのコンピューターは起動していなく、ローカルDNSサーバーがありません。その代わりに"hosts"ファイルが使用されます、これについては別の記事にて記載します）
これを変更するための確かな理由がない限り、もっとも良い解決方法は初期のコンピュータ名を受け入れることです。後ほどBIMサーバーがインターネット上のチームワークに開かれる場合、特にあてはまります。ユーザーがインターネットを通してプロジェクトにアクセスするとき、彼らはマシンの完全な修飾名を使用する必要があります。

例として、macbim.graphisoft.comで行いましょう。ローカルネットワーク内ではユーザーは同じくmacbim.graphisoft.comを使用します。このワークフローではライブラリやチームワークのホットリンクの多くの問題を回避できます。さらにDNS名はIPアドレスよりもはるかに視認できる形式です。また、コールドデータベースバックアップでは、常に完全修飾ドメイン名を使用してBIMサーバーをを参照していると、よりスムーズ動作します。
チームワークプロジェクトデータ管理

ステップ 2 - プロジェクトデータフォルダ

プロジェクトデータベースのフォルダはBIMサーバー上のディスクにあるることが読込/書込転送速度からも良いでしょう。

"プロジェクトデータフォルダ"は少し名称に誤りがあり、なぜならば全てのプロジェクトデータまで考慮されてはいないからです。外部リンクされたチームワークではないファイル、チームワークではないPLN、DWGの図面やJPG等BIMサーバーのこのフォルダに配置されていないファイルが配置されないでしょう。ユーザーはこれらの種類のファイルにこのフォルダを使用することと検討すべきではありません。実際のところこれらの種類のファイルはそれらの元のフォルダ、それぞれのサーバー上にとどめる必要があります。BIMの視点からのプロジェクトデータフォルダは共有されていないPLN、PLAやPLPファイルには厳しいですが、現在進行中のチームワークプロジェクトとなります。

プロジェクトデータフォルダは管理者によってのみ読込可能とすべきです。このフォルダは共有する必要がありません、なぜならば、それらの階層とファイルはBIMサーバーによって直接管理されているためです。バックアップ用途としてはBIMサーバーコンポーネントから分かれたライブラリもこれらを検討してください。 Although this location can be changed later from the BIM Server Preferences dialog, the library folder location cannot, so it is wise to have the right placement at installation. It has been noted that virus checkers scanning in the projects folder could interfere with BIM Server operation, so it might be wise to disable them for this directory.

The dialog does not prevent one from hosting the BIM Server project data folder on a different machine even though this mode of operation is not recommended. Hosting the project data folder on a different machine would slow down data transfers from the BIM Server and could cause data corruption if the machine where the folders were hosted were to go offline. In most cases, permission problems will arise between the running BIM Server service and the folder located on a network drive. That is to say, in general, without special setup, this mode of operation will not work. If it is made to work, it is a failure point waiting to trigger. Please do not put your BIM Server databases on a network drive.
Also avoid to use external drives, which needs to be mounted. If you have e.g. an external Raid storage, which requires mounting on startup: disable - Start BIM Server with Operating System - check box in BIM Server Preferences, because if the BIM Server starts before the mounting happens, that can cause problems, so start the server manually after the external drive is mounted.

For a completely consistent backup of the library folder (Attachments) the BIM Server should be stopped.

STEP 3 - Library Data Folder

In the third step the server library folder is entered. On the BIM Server computer this folder is named attachments. This is the location where uploaded libraries are stored.

{i}This folder location cannot be changed later from the BIM Server Preferences dialog, so make sure to get this right at installation.

STEP 4 - Administrator Account

In this step the server administrator data is given. The e-mail address will be checked for validity. Email addresses must have a “@” and “.” and cannot have anything else but alphanumeric characters. If the person who is the administrator will also be working with teamwork projects, that persons name might appear as a user and as an administrator. In a case like this it would be wise to put some sort of distinguishing character(s) in the full name.

Here is a sample of some names. Note that the Administrator and Smith have the same full name.

Later when Smith shares a project, it will be difficult to distinguish "John Smith" the administrator from "John Smith" the user (called "Smith"). A possible solution is to append to the Admin user's full name the words "(admin)". That is, John Smith(Admin).

STEP 5 - Startup and Port options

In the 5th step you can set up whether the BIM Server starts up with the operating system and you have the option to change the port numbers the BIM Server services. If you check the box for starting up the BIM Server with the operating system then, the computer need to only be powered up to have the BIM Server running. That is, nobody has to be logged into it to have it running.

The port settings have significance in light of other firewall and router settings. Most firewalls will have these ports blocked, so after configuring the BIM Server you will need to open up these ports on the firewall. Only the discovery port is udp, all of the other ports are tcp.

There are many reasons to avoid changing the defaults and very few arguments for changing them. If the defaults are taken, remote users only need the DNS name of the BIM Server (e.g. macbim.graphisoft.hu) to add the server to their remote computer. If port defaults have been changed the administrator will have to supply twlink files to remote users so those users can add the BIM Server to their server lists.

Additionally, if you change the discovery port, expect to travel to several client machines and change the setting below so that their server list will be populated.

One weak reason where there might be a need to change port values, is when you have multiple BIM Server machines accessible to the Internet. If your site only has one public IP address then the port numbers are the only way that your gateway can route the communications to the individual BIM Servers on your private network. Even in this case the real solution is to obtain another static public IP address. Serious involvement in BIM Server Internet teamwork should be backed by serious infrastructure.

STEP 6 - Mail Server

The e-mail server data is given in the 6th step.

{i}SSL is not supported currently for mail server communication. If your mail server requires this (for instance gmail uses SSL) you will not be able to use email functionality of the BIM Server.

The main function supported by providing the e-mail server is the optional sending of the login ID and password to a user when a new BIM Server account is created for them. The messaging functions within the Teamwork palette do not use e-mail, but rather communicate directly to active Archicad sessions joined to a project.

The "from" field of email that is sent from the BIM Server cannot be changed. The account name/password are strictly for those users whose mail server requires an account name and password. Most likely these are when the site is using an Internet service provider's mail services instead of an in-house system.

トラブルシューティング

IPv6クライアントからライブラリが見れない

To disable Ipv6 on Windows 7 I found the below in a google search: http://windows-7-help.blogspot.com/2009/10/disable-windows-7-ipv6.html

Here it is quoted: Click Start button --> type regedit in the box and press Enter --> in the registry editor window, navigate to

HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > services > TCPIP6 > Parameters

--> in the left sidebar, right click Parameters to create a new DWORD (32-bit) Value --> name it as DisabledIpv6 and set its value data as 0 --> click ok button --> then restart your computer.

Are there any diagnostic tools I can use to make sure my network and ports are okay

In a terminal window on the Mac or a command prompt in Windows try the following:

nslookup YourBIMServer.yourdomain (for instance company.com company.co.uk etc)
nslookup yourBIMServer
ping YourBIMServer.yourdomain
ping YourBIMServer
tracert YourBIMServer.yourdomain
telnet YourBIMServer.yourdomain 5988 (replace 5988 with the port you use. If no error message show and there is a blank screen then the port is listening. You will have to ctrl-c out of the window)
ifconfig /all

Additionally there is a TeamworkServerConnectionTest.jar java script TeamworkServerConnectionTest.zip

Copy the test program to a machine that cannot connect to your BIM Server
Note what ports are used on the BIM Server, see the Bim Server preferences dialog (the defaults are 5988,61616, 9991). The order is important for step 3
Run the TeamworkServerConnectionTest.jar program in a command prompt window (cmd.exe), see twconnect.jpg
Create a screenshot of its output.

TeamworkServerConnectionTest.jar requires java to run. See the below screenshot.

In the example screenshot, you can see that I needed to include the full path to the java.exe executable, since it was not in the path. Similarly you should include the full path in the command to the folder where TeamworkServerConnectionTest.jar was copied. In place of "macbim.graphisoft.hu" substitute your BIM Server. Finally the number after that are the port numbers of the Management Service Port, Messaging Service Port, and Model Service Port in that order. Those ports are set up in the preferences dialog as shown below. As an example I showed what might happen on your side if a port is not accessible

I checked my preferences and the BIM Server is not set up to use port 10000 but it is, and my program needs that port

The BIM Server might use the 10000 port (or any other for that matter) if it is free when it needs a new port for inter process communication. The use of any specific numbered port is not required, and the BIM Server dynamically searchs for free ports skipping those that are already taken.

If the user is using a backup system like beremote (the 10000 port is somewhat of a dead give away), then here is some advice:

The beremote server can be changed. See, http://seer.entsupport.symantec.com/docs/255498.htm

Additionally, you can coax the BIM Server to search for ports above 10000 by changing the Model Service Port for the BIM Server to a number above 10000 or delay starting the BIM Server until the software needing 10000 has reserved it.