Connection Settings

BIMcloud/BIM Server offers a very flexible method to set up and establish the connection between the different components. The identification of the BIMcloud/BIM Server component, and the address used to access it, are completely separated. This allows the users to use different addresses to connect to the same server and at the same time maintain the internal project links (even if it was added using a different address).
It is possible to prepare the server for all possible connections in advance and set up the different addresses centrally. This ensures that ARCHICAD users will not have to worry about how to connect, because the Server Administrator has set up everything. If the connection was not configured in all details on the server in advance, then the users are also able to add alternative addresses and connect using a custom address.
Terms:
•
Primary address: This is the unique identification of the server, set up by the person installing the BIMcloud/BIM Server.
•
Alternative addresses: Predefined alternative addresses defined on the server, which can be used to connect to this server as well.
•
Local addresses: Alternative address entered by the user in ARCHICAD.
•
Automatic address: Automatic addresses are generated automatically based on the active address.
•
Fallback: ARCHICAD is not able to communicate with the BIMcloud Server, so it uses the BIMcloud/BIM Server Manager as a bridge to connect.
•
Lookup order: Priority-based list of all available addresses. ARCHICAD picks the active address from this list
•
Active address: The address currently used by ARCHICAD to connect to the BIMcloud Manager.
•
Automatic/Manual address selection: The method ARCHICAD uses to pick the Active address.
Primary address
This is the unique identification of the server, set up by the person installing the BIMcloud/BIM Server. There is only one primary address for each BIMcloud/BIM Server component.
ARCHICAD uses this address to uniquely identify the server – even if it is communicating using a different address at the moment. This addresses is also used when placing references to the server (e.g. placing a hotlinked module from a Teamwork project).
When ARCHICAD opens a project which contains a reference to a BIMcloud not yet known by ARCHICAD, then ARCHICAD will use the primary address stored in the hotlink reference to find the server:
•
If the address is working, then ARCHICAD will download all the alternative addresses and pick the most suitable one based on priorities.
•
If the address is not working, then it will prompt the user to enter a currently working address to the new server. Once a working address is entered, ARCHICAD will download the list of alternative addresses based on the pre-defined priorities.
Set up the Primary address on the Settings panel of each BIMcloud/BIM Server component.
It is recommended not to change the Primary address of the BIMcloud/BIM Server. In case it must be changed, it is a good practice to add the old Primary address to the list of alternative addresses – even if it is not working any more. This ensures that ARCHICAD will be able to identify links placed by the old Primary address and keep the references alive in projects.
Alternative addresses
The list of alternative addresses is a ‘menu’ for ARCHICAD. It will go through this list in a certain order (see Lookup order) and connect to the server using the first functioning one.
Alternative addresses can be pre-set on the BIMcloud/BIM Server Manager for every server/module component.
Automatic address
Automatic addresses are available for BIMcloud Servers and Modules. Automatic addresses are not absolute addresses, but rather relative addresses. They are able to dynamically create an address based on the currently used address of the BIMcloud/BIM Server Manager. An example:
•
ARCHICAD uses the http://server-computer:1228 address to connect to the server
The Automatic address is $protocol://$host:1229
ARCHICAD will automatically use http://server-computer:1229 to connect to the Server/Module.
The user goes home and uses a different address to connect to the server through the internet:
https://bimcloud.company.com:1228
ARCHICAD will automatically use https://bimcloud.company.com:1229 to connect to the Server/Module.
There are two automatic fields to generate automatic addresses:
•
‘$protocol’: the protocol part of the url; in the above example, this is ‘http’ and ‘https’
•
‘$host’: the address part of the url without the protocol and the port. In the above example, this is: ‘server-computer’ and ‘bimcloud.company.com’
Fallback
In case ARCHICAD is not able to directly communicate with a BIMcloud Server or a BIMcloud Studio/BIM Server Module, yet the BIMcloud/BIM Server Manager is accessible, then it will use the BIMcloud Manager as a ‘bridge’ to the BIMcloud Server and send all traffic through it. (Keep in mind that this kind of communication can affect the overall performance of BIMcloud, depending on the locations of the different components.)
Fallback communication might be a good choice when accessing the BIMcloud/BIM Server from outside the office, because it requires the IT administrator to open only one port on the company firewall.
Lookup order
When ARCHICAD tries to connect to a BIMcloud/BIM Server, it will go through the addresses in a certain order. This order can be set on the BIMcloud/BIM Server Manager. Alternative addresses added locally from ARCHICAD will always be at the end of the lookup order.
Automatic / Manual address selection
It is possible to override the address selected automatically by ARCHICAD, and force it to use a specific address instead. Use ARCHICAD’s Network Diagnostic tool to override the automatically selected address. Keep in mind that manually selecting an address might force ARCHICAD into an offline state even if there is a different – currently working – alternative address available.