Sign in

Automated Aras 3DV Installation for Streaming Viewer

3 min read
Warning
Please note that the output files of Dynamic/Monolithic Viewer and Streaming Viewer are incompatible with one another. If the Streaming 3D Viewer is installed in an environment where the Monolithic or Dynamic 3D Viewers have been previously installed and used, all existing native files of existing CAD Documents need to be re-converted. There is no automated means to perform this reconversion.
Note
Only one Streaming Viewer can be installed on one machine at a time.
Warning
The Streaming Viewer currently cannot be deployed in a cloud environment. The HOOPS Server must be deployed with networked file access to a single vault containing view files for rendering.

The following steps outline the process of Aras 3DV installation for Streaming Viewer:

  1. Download the Aras 3D Visualization 35 CD Image from the Aras File sharing site, and unzip the file on the local computer.
  2. Enable the Super User (root) login.
  3. Please confirm that the Aras.CADConverter3 license is activated.
  4. Launch the ArasUpdate.exe file as an administrator.
    If default options were selected during installation, the ArasUpdate.exe file is found in the directory C:\Program Files (x86)\Aras\Aras Update\.
  5. On the Local tab, click Add package reference and navigate to the folder where the Aras 3D Visualization package was extracted in the first step.
  6. Expand the Aras 3D Visualization package and click Install.

  1. Select the installation modules of the Aras 3D Visualization components that will be installed on the given machine and click Next.

  1. Select the Detailed logging option and click Next.

The logging option records the installation attempt and can be used to troubleshoot issues.

  1. Specify the connection information for the installation modules of the components to be installed:

Component CAD Converter Updates:

  • Path to root folder where Aras Innovator Server is installed: The physical path to the Aras Innovator code tree. See the Aras Innovator Code Tree section.
  • Specify local directory where HOOPS Converter should be installed: The physical path to a local folder where HOOPS Converter files will be installed; for example, C:\HOOPS Converter.
Note
When installing the Streaming Viewer, the Use streaming SCZ by default field should be checked otherwise leave it unchecked.
Warning
If the Use streaming SCZ by default checkbox is checked, and the Streaming Service is not installed, none of the other viewers will work.

Component Database Updates:

  • Server URL: The URL for connecting to a given Aras Innovator instance. By default, it is http://localhost/InnovatorServer/.
  • Database Name: The name of a target Aras Innovator database. By default, it is InnovatorSolutions.
  • Username: root
  • Password for ‘root’ User: The password for the root User. By default, it is innovator.

Hoops Server:

  • Path to the folder where HOOPS Server should be installed: The physical path to a local folder where HOOPS Server files will be installed; for example, C:\HOOPS_Server.
  • Hostname of the machine where HOOPS Server should be installed: The hostname of a local machine where HOOPS Server will be installed.
  • Path to the vault folder corresponding Aras Innovator instance: The physical path to the vault folder of the Aras Innovator instance.
Note
The Streaming Viewer is supported only with a single vault. The Streaming Viewer service must be installed on a machine with a direct network access to the vault.

If multiple Aras 3D Visualization components are installed, connection settings for the following components are automatically inherited from the preceding ones. For example, if Aras 3D Viewers is installed with Aras CAD Converter, the Aras 3D Viewers modules inherit connection settings from the Aras CAD Converter modules.

  1. Once the connection information is provided, click Install. The installation process begins.

  1. Once the installation is successfully completed, close Aras Update.

  1. On the C drive in the Hoops Server file, right-click start_service and select Run as Administrator.

  1. Open Windows Services and ensure that InnovatorRenderingService is added and running.

  1. Disable the Super User (root) login.
  2. For the required setup to get the streaming viewer running, refer to the Administrative Configuration for Streaming Viewer section.
  3. This step is optional. Confirm the successful Aras 3D Visualization installation. See the Confirming Aras 3DV Installation section.

If the installation fails, restore the Aras Innovator code tree, Conversion Server, and database with the backups done before the installation and contact Aras Support at support@aras.com.

Administrative Configurations for Streaming Viewer

The following steps outline the administrative setup to get the Streaming Viewer running:

  1. Login into the Aras Innovator as Administrator.
  2. From Table of Contents, expand Administration and select Variables.
  3. Click Search Variables and search for HOOPS_ServerURL.

The HOOPS_ServerURL form appears.

  1. In Value field, replace http://localhost with http://IP_Address:11182

where,

  • IP_Address: IP Address of the machine where the Streaming Viewer is installed.

  • 11182: Default Hoops Server Port Number.

Note
The port number 11182 in HOOPS_ServerURL should be the same as the spawnServerPort parameter value in the HOOPS Server\server\node\Config.js.

There is no change to the Default Value field.

  1. Click Done to save the changes.
Note
If the server where Streaming Viewer is installed has Graphic Processing Unit (GPU), then the windowsServiceRespawnEnabled parameter in the Config.js file should be set to False.