Manual Aras Streaming Viewer Installation
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 manual installation of Aras 3DV Streaming Viewer:
- In the unzipped Aras 3D Visualization 39 CD Image package, navigate to the following folder:
Aras 3D Visualization 39 CD Image\Packages\HOOPS Server - Copy the HOOPS Server folder from HOOPS Sever package to a permanent location on a machine. For example, C:\HOOPS Server.
- In the HOOPS Server folder, go to C:\HOOPS Server\server\node and open Config.js file in a text editor run as administrator.
- For publicHostname parameter, replace “localhost” value with the IP Address of the local machine.
For example, publicHostname: “10.188.182.38" For communicatorDir parameter, enter the path to Hoops Server directory created in the third step.
For example, communicatorDir: “C:/Hoops Server”- For modelDirs parameter, enter the path to Aras Innovator instance Vault.
For example, modelDirs: [“C:/Aras/Vault/14SP10",] - Set the windowsServiceRespawnEnabled parameter to true.
NoteIf 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. Copy the Aras.CADConverter3 license from the Feature Licenses. Only copy the content from the <HoopsLicense> tag for the latest available version, for example:
<license id="hoops2025"><HoopsLicense>4E...xeR</HoopsLicense>- In the Config.js file, for the license parameter, replace it with the newest license copied from the previous step.
- Save the Config.js file.
- In the Hoops Server folder, right-click start_service file and select Run as Administrator.
- Open Windows Services and check if InnovatorRenderingService is added and is running.
- Copy the ConversionServer folder from the CADConverter package folder (Aras 3D Visualization 39 CD Image\Packages\CADConverter) to a folder that includes the ConversionServer folder with the installed Conversion Server.
- Open ConversionServerConfig.xml file in a text editor run as administrator. This file is in the root Aras Innovator code tree folder in the case of the default installation.
In the <sectionGroup> tag, add the following:
<section name="ArasCadConverter” type="Aras.ConversionFramework.Converter.Hoops.Configuration.HoopsConverterConfiguration, ArasCadConverter"></section><section name="ArasCadConverterPrc” type="Aras.ConversionFramework.Converter.Hoops.Configuration.HoopsConverterConfiguration, ArasCadConverter"></section>In the <Converters> tag, add the following:
<Converters><Converter name="Aras CAD to PDF Converter” type="Aras.ConversionFramework.Converter.Hoops.HoopsConverter, ArasCadConverter” /><Converter name="Aras PRC to SCS Converter” type="Aras.ConversionFramework.Converter.Hoops.HoopsConverterPrc, ArasCadConverter” /></Converters>In the
<ConverterSettings>tag, add the following:<ConverterSettings><!-- Place here configuration sections for converters --><ArasCadConverter><Application converterPath="C:\Aras\14SP10\HOOPSConverter\bin\converter.exe” /><Command arguments="--sc_compute_bounding_boxes ‘All’ --input_pdf_template_file ‘C:\Aras\ Innovator Server Name\HOOPS Converter\Templates\Blank_Template_L.pdf’ --output_pdf '%filepath%\%filename%.pdf’ --output_png '%filepath%\%filename%.png’ --output_png_resolution ‘150x150' --output_sc '%filepath%\%filename%' --sc_create_scz ‘true’ --sc_compress_scz ‘false’ --output_xml_assemblytree '%filepath%\%filename%.xml’ --output_prc '%filepath%\%filename%.prc’ --background_color ‘1.0, 1.0, 1.0' --output_logfile '%filepath%\%filename%.log’” /><Output><UploadToVault><File extension="prc” argsMarkers="--output_prc” /><File extension="scs” argsMarkers="--output_scs” /><File extension="pdf” argsMarkers="--output_pdf” /><File extension="png” argsMarkers="--output_png” /><File extension="stl” argsMarkers="--output_stl” /><File extension="xml” argsMarkers="--output_xml_assemblytree” /><File extension="scz” argsMarkers="--output_sc” /></UploadToVault></Output><AssemblyCommand arguments="--sc_compute_bounding_boxes ‘All’ --input_pdf_template_file ‘C:\Aras\Innovator Server Name\HOOPS Converter\Templates\Blank_Template_L.pdf’ --output_pdf '%filepath%\%filename%.pdf’ --output_png '%filepath%\%filename%.png’ --output_png_resolution ‘150x150' --sc_create_scz ‘true’ --sc_compress_scz ‘false’ --output_xml_assemblytree '%filepath%\%filename%.xml’ --output_prc '%filepath%\%filename%.prc’ --background_color ‘1.0, 1.0, 1.0' --output_logfile '%filepath%\%filename%.log’” streamingEnabled="True"/></ArasCadConverter><ArasCadConverterPrc><Application converterPath="C:\Aras\ Innovator Server Name \HOOPS Converter\bin\converter.exe” /><Command arguments="--output_scs '%filepath%\%filename%.scs’ --output_xml_assemblytree '%filepath%\%filename%.xml’ --output_logfile '%filepath%\%filename%.log’” /><Output><UploadToVault><File extension="prc” argsMarkers="--output_prc” /><File extension="scs” argsMarkers="--output_scs” /><File extension="pdf” argsMarkers="--output_pdf” /><File extension="png” argsMarkers="--output_png” /><File extension="stl” argsMarkers="--output_stl” /><File extension="xml” argsMarkers="--output_xml_assemblytree” /></UploadToVault></Output></ArasCadConverterPrc></ConverterSettings>- Save and close the ConversionServerConfig.xml file.
- Restart the Internet Information Services (IIS).
- Copy the Innovator folder from the 3DViewers package folder (Aras 3D Visualization 39 CD Image\Packages\3DViewers) to the root Aras Innovator code tree folder where the Innovator folder exists.Replace the files in the destination if the system prompts.
- Copy the Innovator folder from the DPN package folder (Aras 3D Visualization 39 CD Image\Packages\DPN) to the root Aras Innovator code tree folder where the Innovator folder exists.Replace the files in the destination if the system prompts to.
- In the Aras Innovator code tree, navigate to \Innovator\Server and open the method-config.xml file in a text editor run as administrator.
In the
<ReferencedAssemblies>tag, add the following:<ReferencedAssemblies>...<name>$(binpath)/Aras.DynamicModelViewer.Core.dll</name><name>$(binpath)/Aras.DynamicModelViewer.DataModel.dll</name><name>$(binpath)/Aras.DynamicModelViewer.QueryProcessor.dll</name><name>Microsoft.Extensions.Logging.dll</name></ReferencedAssemblies>- Save and close the method-config.xml file.
- Restart the Internet Information Services (IIS).
- Restart Aras Innovator Agent for corresponding instance on Server side on Windows Services.
- Import the Aras 3D Visualization 3D Common database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 39 – Package Import Export Utilities documentation.
- Enable the Super User (root) login.
- Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
- Input the connection information.
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
Click the Login button and enter:- Database: The target Aras Innovator database. By default, it is InnovatorSolutions.
- Username: root
- Password: Password for “root” login (Default is “innovator”)
- Target Release: 3DV 14.9.0
- Description: Aras 3D Visualization 14.9.0 – 3D Common
- Manifest File Path: The manifest file \Packages\CADConverter\Imports\3d_common.mf
- Available for Import: Select All Packages
- Type: Merge
- Mode: Thorough Mode
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
- Click the Import button.
- Import the Aras 3D Visualization CAD Converter database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 39 – Package Import Export Utilities documentation.
- Enable the Super User (root) login.
- Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
- Input the connection information.
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
Click the Login button and enter:- Database: The target Aras Innovator database. By default, it is InnovatorSolutions.
- Username: root
- Password: Password for “root” login (Default is “innovator”)
Target Release: 3DV 14.9.0
- Description: Aras 3D Visualization 14.9.0 – CAD Converter
- Manifest File Path: The manifest file \Packages\CADConverter\Imports\imports.mf
- Available for Import: Select All Packages
- Type: Merge
- Mode: Thorough Mode
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
- Click the Import button.
- Import the Aras 3D Visualization 3D Viewers database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 39 – Package Import Export Utilities documentation.
- Enable the Super User (root) login.
Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
- Input the connection information.
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
Click the Login button and enter:- Database: The target Aras Innovator database. By default, it is InnovatorSolutions.
- Username: root
- Password: Password for “root” login (Default is “innovator”)
- Target Release: 3DV14.9.0
- Description: Aras 3D Visualization 14.9.0 – 3D Viewers
- Manifest File Path: The manifest file \Packages\3DViewers\Imports\imports.mf
- Available for Import: Select All Packages
- Type: Merge
- Mode: Thorough Mode
- Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
- Click the Import button.
- Import the Aras 3D Visualization Dynamic Model Constructor database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 39 – Package Import Export Utilities documentation.
- Enable the Super User (root) login.
- Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
- Input the connection information.
- ·Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
Click the Login button and enter:- Database: The target Aras Innovator database. By default, it is InnovatorSolutions.
- Username: root
- Password: Password for “root” login (Default is “innovator”)
- Target Release: 3DV 14.9.0
- Description: Aras 3D Visualization 14.9.0 – Dynamic Model Constructor
- Manifest File Path: The manifest file \Packages\DPN\Imports\dynamic_model_constructor_imports.mf
- Available for Import: Select All Packages
- Type: Merge
- Mode: Thorough Mode
- ·Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
- Click the Import button.
- Import the Aras 3D Visualization Streaming Viewer database package with the Package Import Export Utilities. For more information using this tool, refer to the Aras Innovator 39 – Package Import Export Utilities documentation.
- Enable the Super User (root) login.
Browse to the \PackageImportExportUtilities\Import\ folder and run the Import.exe file.
Input the connection information.
- · Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
Click the Login button and enter:- Database: The target Aras Innovator database. By default, it is InnovatorSolutions.
- Username: root
- Password: Password for “root” login (Default is “innovator”)
- Target Release: 3DV 14.9.0
- Description: Aras 3D Visualization 14.9.0 – Streaming Viewer
- Manifest File Path: The manifest file \Packages\DPN\Imports\streaming_viewer_imports.mf
- Available for Import: Select All Packages
- Type: Merge
Mode: Thorough Mode
- · Server: The connection URL for Aras Innovator. By default, it is http://localhost/InnovatorServer/.
- Click the Import button.
- Disable the Super User (root) login.
NoteThe Super User (root) login should not be enabled in production.
- This step is optional. Confirm the successful installation. See the Confirming Aras 3DV Installation section.
- For the required setup to get the streaming viewer running, refer to the Administrative Configuration for Streaming Viewer 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.