Skip to main content
Skip table of contents

HaloCAD in Linux Environment

This section describes setting up HaloCAD and HaloENGINE parameters in a Linux environment using the HaloCAD Config tool and the command line.

Configuration Using Tool (GUI)

Using the HaloCAD Configuration Tool, you can set up HaloCAD and HaloENGINE parameters.

Follow the steps below to configure settings using the GUI.

Step 1. Enter the command ./windchill stop to terminate Windchill and press Enter.

Step 2. Run the HaloCAD Configuration Tool.

  1. Open the Terminal, navigate to the installation package directory where the tool is located, and then enter the following syntax.
    For example:

    CODE
    cd /opt/ptc/Windchill_12/Windchill/bin
    ./windchill shell
    cd /opt/HaloCAD for Windchill/Linux/config-tool
    java -jar halocad-windchill-config-<version>.jar
  2. The HaloCAD for Windchill Config Tool window will appear as shown below: 

    Linux_Setting up configuration path.png

    Setting up configuration path

  3. Under the HaloCAD Config Path tab, the default path /etc is set to save the configuration files. Alternatively, you can change it by clicking the Choose Path button.

  4. When you are finished, click Apply.

    Results:

    1. A confirmation message dialog is displayed if the configuration is successful. Click OK on the confirmation dialog box.

    2. The Terminal displays a message prompting you to close and reopen the current shell.

  5. Click Close to close the configuration window.

  6. Close the Terminal window.

  7. Related task: You can manually set the environment variables using the following command.

    CODE
    export HALOCAD_WINDCHILL_CONFIG_PATH=<configuration folder path>
    For example, export HALOCAD_WINDCHILL_CONFIG_PATH=/opt

Step 3. Configure properties

  1. Reopen the Terminal window and run the tool as mentioned in step 2. Note: The HaloCAD Config Path tab does not appear as it is a one-time step that was done in the previous step.

  2. Windchill Configuration tab

    1. The Windchill Configuration tab is similar to the Windows Windchill Configuration tab.

    2. Enter the required information as instructed in step 2a Windchill Configuration tab.

  3. Primary HaloENGINE Configuration tab

    1. The HaloENGINE Configuration tab is similar to the Windows Primary HaloENGINE Configuration tab.

    2. Enter the required information as instructed in step 2b Primary HaloENGINE Configuration tab.

    3. Please note that the local mode is not supported in the current version because HaloENGINE Service installation on the Linux Server is not supported.

  4. Secondary HaloENGINE Configuration tab

    1. The HaloENGINE Configuration tab is similar to the Windows Secondary HaloENGINE Configuration tab.

    2. Enter the required information as instructed in step 2c Secondary HaloENGINE Configuration tab.

  5. JAR Deployment tab: Click the browse button to select a location to store the JAR files. For example: .../opt/Linux

  6. Others tab

    1. The Others tab is similar to the Windows Others tab.

    2. Enter the required information as instructed in step 2d Others tab.

    3. Additionally, the Uninstall button is shown in the UI. Please be aware to use the Uninstall button only if you want to remove HaloCAD-related files from your system.

    4. For information on how to remove a CAD component, please refer to the section "Uninstalling the HaloCAD Component from Linux".

Step 4. Enter the command ./windchill start to start Windchill and press Enter.

Configuration Using the Command Line

This section describes setting up HaloCAD and HaloCORE settings through the command line.

  1. Open the Terminal window.

  2. Run the syntax as shown in this example.

    CODE
    WINDCHILL CONFIGURATION:
    [root@UXLU0363 ~]# cd /opt/ptc/Windchill_12.0/Windchill/bin/
    [root@UXLU0363 bin]# ./windchill shell
    [root@UXLU0363 bin]# cd /opt/HaloCAD for Windchill/Linux/config-tool
    [root@UXLU0363 config-tool]# java -jar halocad-windchill-config-<version>.jar -shell
  3. For instructions on using the command line, refer to the section “Configuration Using the Command Line” under Windows.

  4. Click Close to close the terminal.

Next Steps

HaloCAD has been set up in your environment and is ready to protect file downloads. Please refer to the Operations Manual for more details. If you are not yet familiar with labels, you might need to consult the Microsoft online reference at this point.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.