Aras CAD Converter Installation

6 min read

Copy
Link copied
Print
Download

The following steps outline the process of installing Aras CAD Converter:

Download the Aras 3D Visualization 35 CD Image from Aras File Sharing site.
Unzip the Aras 3D Visualization 35 CD Image on the local machine, in its own folder.
Create a folder with subfolders in the local work repository: GIT_REPO_PATH\CodeTree\ConversionServer\customExtensions\Hoops\
Copy the HOOPS Communicator Linux package (i.e. HOOPS_Communicator_2025.4.0_Linux.tar.gz) into the Hoops folder created above.
Copy the shell script GIT_REPO_PATH\AutomatedProcedures\tools\Aras.BDS.SaaS2\tools\ThirdPartyDependencies\onbuild.sh into the folder: GIT_REPO_PATH\CodeTree\ConversionServer\customExtensions\
Copy the shell script GIT_REPO_PATH\AutomatedProcedures\tools\Aras.BDS.SaaS2\tools\ThirdPartyDependencies\installHoops.sh into the folder: GIT_REPO_PATH\CodeTree\ConversionServer\customExtensions\Hoops\
Make sure that the copied file installHoops.sh contains the correct name and version number of the Hoops Communicator package:
- Open the file installHoops.sh with a text editor that supports Unix line endings (e.g. VIM, Notepad++, VS Code, or other).
- Change the INSTALLATION_PACKAGE_NAME to the required Hoops Package:
  INSTALLATION_PACKAGE_NAME="HOOPS_Communicator_2025.4.0_Linux.tar.gz”
- Change the INSTALLATION_PACKAGE_VERSION to the correct version:
  INSTALLATION_PACKAGE_HOOPS_VERSION="HOOPS_Communicator_2025.4.0"
- Ensure all script line endings are Unix line endings (LF).
- Save the file.
If HOOPS templates are required, create a folder GIT_REPO_PATH\CodeTree\ConversionServer\customExtensions\Hoops\HoopsConverterTemplates\ local Work.git repository.
Add the template files.
Navigate to the \Packages\CADConverter\ConversionServer\ folder of the Aras 3D Visualization 35 CD Image.
Copy the “bin” folder into the GIT_REPO_PATH\CodeTree\ConversionServer\ folder of the local Work.git repository.
Add a configuration transformation file for the ConversionServerConfig.xml in the \TransformationsOfConfigFiles\ folder of the Work.git repository with the following content:
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="">
<configSections xdt:Transform="Replace” xdt:Locator="XPath(/configuration/configSections)">
<section name="oauth” type="Aras.OAuth.Configuration.OAuthSection, Aras.OAuth.Configuration” />

<section name="ConversionServer” type="Aras.ConversionFramework.ConversionServer.Configuration.ConversionServerConfigurationSection, Conversion.Base” />
<sectionGroup name="ConverterSettings">
<section name="ArasCadConverter” type="Aras.ConversionFramework.Converter.Hoops.Configuration.HoopsConverterConfiguration, ArasCadConverter” />
<section name="ArasCadConverterPrc” type="Aras.ConversionFramework.Converter.Hoops.Configuration.HoopsConverterConfiguration, ArasCadConverter” />
<section name="DpnCadConverterStepJt” type="Aras.ConversionFramework.Converter.Hoops.Configuration.HoopsConverterConfiguration, ArasCadConverter” />
</sectionGroup>
</configSections>
<ConversionServer>
<Converters>
<Converter name="Aras CAD to PDF Converter” type="Aras.ConversionFramework.Converter.Hoops.HoopsConverter, ArasCadConverter” xdt:Transform="Insert” />
<Converter name="Aras PRC to SCS Converter” type="Aras.ConversionFramework.Converter.Hoops.HoopsConverterPrc, ArasCadConverter” xdt:Transform="Insert” />
<Converter name="JT Step CAD Converter” type="Aras.CadConverter.StepJtCadConverter, ArasCadConverter” xdt:Transform="Insert"/>
</Converters>
</ConversionServer>
<ConverterSettings xdt:Transform="Replace">
<ArasCadConverter>
<Application converterPath="/usr/bin/xvfb-run"/>
<Command arguments="'--auto-servernum’ '-s’ '-screen 0 640x480x24' /opt/ts3d/bin/linux64/converter --sc_compute_bounding_boxes ‘All’ --load_all_configurations ‘True’ --input_pdf_template_file '/app/HOOPS Converter/Templates/Blank_Template_L.pdf’ --output_pdf '%filepath%/%filename%.pdf’ --output_png '%filepath%/%filename%.png’ --output_png_resolution ‘150x150' --output_scs '%filepath%/%filename%.scs’ --output_xml_assemblytree '%filepath%/%filename%.xml’ --output_prc '%filepath%/%filename%.prc’ --background_color ‘1.0, 1.0, 1.0' --output_logfile '%filepath%/%filename%.log’” />
<AssemblyCommand dynamicEnabled="True” arguments="'--auto-servernum’ '-s’ '-screen 0 640x480x24' /opt/ts3d/bin/linux64/converter --load_all_configurations ‘True’ --input_pdf_template_file '/app/HOOPS Converter/Templates/Blank_Template_L.pdf’ --output_pdf '%filepath%/%filename%.pdf’ --output_png '%filepath%/%filename%.png’ --output_png_resolution ‘150x150' --output_scs '%filepath%/%filename%.scs’ --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"/>
</UploadToVault>
</Output>
</ArasCadConverter>
<ArasCadConverterPrc>
<Application converterPath="/usr/bin/xvfb-run"/>
<Command arguments="'--auto-servernum’ '-s’ '-screen 0 640x480x24' /opt/ts3d/bin/linux64/converter --sc_compute_bounding_boxes ‘All’ --load_all_configurations ‘True’ --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>
<DpnCadConverterStepJt>
<Application converterPath="/opt/exchange/bin/linux64"/>
<Parameters>
<Parameter key="JTVersion” value="8.1" /> 
</Parameters>
</DpnCadConverterStepJt>
</ConverterSettings>
</configuration>

Note

The ConversionServerConfig.xml is available from the Baselines Artifact feed of the SDE for reference when building configuration transformation files.
Copy the folders 3d_common, ArasCadToPdfConverter, com, and PLM from the Aras 3D Visualization 35 CD Image\Packages\CADConverter\Imports\ folder into the AML-packages folder of the Work.git repository.

Note

Do not copy the imports.mf file, as it will overwrite the existing imports.mf file in the Work.git repository.
Open the imports.mf file.
Copy the following <package> elements:
<imports>
<package name="hoops_converter” path="ArasCadToPdfConverter">
<dependson name="com.aras.innovator.conversion” />
<dependson name="3d_common” />
</package>
<package name="com.aras.innovator.cui_default” path=".\" />
<package name="com.aras.innovator.solution.PLM” path="PLM” />
</imports>
Paste the <package> elements into the imports.mf file of the Work.git repository.
Open the file Aras 3D Visualization 35 CD Image\Packages\CADConverter\Imports\3d_common.mf
Copy the following <package> element:
<imports>
<package name="3d_common” path="3d_common” />
</imports>
Paste the <package> element into the imports.mf file of the Work.git repository, at the top of the list of packages to import:
<imports>
<package name="3d_common” path="3d_common” />
<package name="hoops_converter” path="ArasCadToPdfConverter">
<dependson name="com.aras.innovator.conversion” />
<dependson name="3d_common” />
</package>
<package name="com.aras.innovator.cui_default” path=".\" />
<package name="com.aras.innovator.solution.PLM” path="PLM” />
</imports>
Stage and review the changes to ensure that no customizations are overwritten.
Commit the changes.
Run the “continuous-integration” pipeline.
Run the “deploy-innovator” pipeline to complete the installation.