Sign in

Aras CAD Converter Installation

June 10, 2026 05:24 AM
7 min read

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

  1. Download the Aras 3D Visualization 39CD Image from Aras File Sharing site.
  2. Unzip the Aras 3D Visualization 39 CD Image on the local machine, in its own folder.
  3. Create a folder with subfolders in the local work repository: GIT_REPO_PATH\CodeTree\ConversionServer\customExtensions\Hoops\
  4. Copy the HOOPS Converter Linux package (./Packages/CADConverter/HOOPS Converter Linux/HOOPS_Converter_Linux.tar.gz) into the Hoops folder created above.
  5. 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\
  6. 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\
  7. Make sure that the copied file installHoops.sh contains the correct name and version number of the Hoops Communicator package:
  8. Open the file installHoops.sh with a text editor that supports Unix line endings (e.g. VIM, Notepad++, VS Code, or other).
  9. Change the INSTALLATION_PACKAGE_NAME to the required Hoops Package:
    10. INSTALLATION_PACKAGE_NAME="HOOPS_Converter_Linux.tar.gz”
  10. Change the INSTALLATION_PACKAGE_VERSION to the correct version:
    11. INSTALLATION_PACKAGE_HOOPS_VERSION="HOOPS_Converter_Linux”
  11. Replace line SOURCE_HOOPS_TEMPLATES_PATH="$INSTALLATION_PACKAGE_FOLDER/HoopsConverterTemplates”
  12. with
  13. SOURCE_HOOPS_TEMPLATES_PATH="$INSTALLATION_PACKAGE_FOLDER/Templates”
  14. Replace lineSOURCE_HOOPS_FOLDER_NAME="/tmp/$INSTALLATION_PACKAGE_HOOPS_VERSION/authoring/converter/bin”withSOURCE_HOOPS_FOLDER_NAME="/tmp/$INSTALLATION_PACKAGE_HOOPS_VERSION/converter/bin”
  15. Replace line HOOPS_BINARIES_PATH="$TARGET_HOOPS_BIN_FOLDER_NAME/linux64/libboost_*"withHOOPS_BINARIES_PATH="$TARGET_HOOPS_BIN_FOLDER_NAME/linux64/converter”
  16. Replace lineSOURCE_HOOPS_TEMPLATES_PATH="$INSTALLATION_PACKAGE_FOLDER/HoopsConverterTemplates”withSOURCE_HOOPS_TEMPLATES_PATH="/tmp/$INSTALLATION_PACKAGE_HOOPS_VERSION/Templates”
  17. Navigate to the \Packages\CADConverter\ConversionServer\ folder of the Aras 3D Visualization 39 CD Image.
  18. Copy the “bin” folder into theGIT_REPO_PATH\CodeTree\ConversionServer\ folder of the local Work.git repository.
  19. Add a configuration transformation file for the ConversionServerConfig.xml in the \TransformationsOfConfigFiles\ConversionServer\folder of the Work.git repository with the following content:
    20. <?xml version="1.0" encoding="utf-8"?>
    <configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
     <configSections xdt:Transform="Replace” xdt:Locator="XPath(/configuration/configSections)">
     <section name="oauth” type="Aras.OAuth.Configuration.OAuthSection, Aras.OAuth.Configuration” />
     <!-- Common converter service 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" /> <!-- Optional. Possible values: 8.1|9.5|10.0 -->
     </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.

  20. Copy the folders 3d_common, ArasCadToPdfConverter, com, and PLM from the Aras 3D Visualization 39CD Image\Packages\CADConverter\Imports\ folder into the AML-packages folder of the Work.git repository.
    21. Note
    Do not copy the imports.mf file, as it will overwrite the existing imports.mf file in the Work.git repository.

  21. Open the imports.mf file.
  22. Copy the following <package> elements:
    23. <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>
  23. Paste the <package> elements into the imports.mf file of the Work.git repository.
  24. Open the file Aras 3D Visualization 39CD Image\Packages\CADConverter\Imports\3d_common.mf
  25. Copy the following <package> element:
    26. <imports>
    <package name="3d_common” path="3d_common” />
    </imports>
  26. Paste the <package> element into the imports.mf file of the Work.git repository, at the top of the list of packages to import:
    27. <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>
  27. Stage and review the changes to ensure that no customizations are overwritten.
  28. Commit the changes.
  29. Run the “continuous-integration” pipeline.
  30. Run the “deploy-innovator” pipeline to complete the installation.