Key Considerations and Prerequisite Setup
Before installing VDS (Application and Web Server):
-
The installation and usage of VDS is on a per product basis. Do not use the same installation of VDS for two Hexagon product applications.
-
Review the VDS Platform Recommendations to determine the best approach for your implementation. For example, you can install all software on a single server or spread the software out onto multiple servers to improve performance.
-
Select the authorization server to use. We recommend using the same authorization service throughout your solution. For example, if you use Smart API Manager (SAM) for authenticating your application Web Client users, then use SAM for authenticating the VDS.
-
The setup and configuration of your selected authorization service for VDS in later sections must be linked to the authorization configuration you have done for the application. This includes determining the use of either IWA/SSO or Named User authentication.
-
VDS requires access to HTTPS (port 443), and is the default port setting. Other ports might be required by other software applications installed on the system. See Port Considerations.
-
Select the message broker to use. For VDS, instructions for the setting up RabbitMQ are provided.
Servers, Components, and Implementation Options
VDS consists of two logical servers, the VDS Web Server and the VDS Application Server. These servers can be set up to support the following implementations with Hexagon applications. Determine the option that meets your requirements.
Implementation Option 1: VDS Web Server Only to Support File-based (2D and 3D) Graphics
The VDS Web Server provides the software that handles authorization of client connections, 2D drawing graphics, and 3D file services for the corresponding Hexagon client application. Installed VDS Web Server components include:
-
HxGN 2D Graphic Data Service
-
HxGN 2D Graphic Data Service Web API
-
HxGN 3D File Service
-
HxGN 3D Graphic Data Service Web API (installed but not used)
-
HxGN Visualization Edge Gateway Service
-
HxGN VDS Configuration Utility
-
HxGN Visualization Diagnostic Utility
You select to only install the VDS Web Server.
Implementation Option 2: VDS to Support Granular 3D Graphics and File-based (2D and 3D) Graphics
The VDS Web Server and Application Server combine to support Hexagon applications that require 3D graphics to be persisted in a database. The VDS Web Server and Application Server can be hosted on the same or separate physical servers.
-
Installed VDS Web Server components are the same as those listed in Option 1.
-
Installed Application Server components include:
-
HxGN 3D Graphic Data Service
-
HxGN VDS Configuration Utility (if installed on a separate system)
-
-
HxGN Visualization Diagnostic Utility (if installed on a separate system)
Where to go from here