Installing the HaloCAD for Autodesk Vault

This chapter explains the requirements, prerequisites, and how to install HaloCAD for Autodesk Vault.

System Requirements

The following system requirements table specifies the minimum and recommended technical specifications, such as software and network resources, necessary to run the product.

Requirements

Prerequisites

The following preparatory steps or conditions must be met before installing the product.

1. Make sure you have administrative access before performing the most of system and dataset tasks.

2. Make sure the client computer running the HaloCAD Add-on for AutoCAD/Inventor can connect to the Autodesk Vault Server.

3. Make sure that the HaloENGINE Service is installed in MPIP mode.

4. Make sure your HaloENGINE complies with the requirements listed below:

   1. License file (enabled with AUTODESK_VAULT system type).

   2. Proper action rules

   3. Client certificate (.JKS)

5. Make sure to have a user account with document-consuming rights in the Vault Server.

   1. You can add an existing user account to the specific Autodesk Vault.

   2. Or create a new user account and add it to the specific Autodesk Vault by logging in Autodesk Vault > Tools > Administration > Global Settings > Security > Users > in the User Management window, click New User (enter required details) and click on the Vaults button to select all the Vaults listed.

6. If you want to implement a failover mechanism in HaloENGINE, please refer to the section “Failover Mechanism for HaloENGINE in HaloCAD for PLM”.

Installation Modes

You can install the HaloCAD component in the following modes:

1. Graphical Mode
   Graphical mode installation is an interactive, graphical user interface-based method that is driven by a wizard.

2. Silent Mode
   Silent-mode installation is a non-interactive method of installing the HaloCAD component using command lines.

Graphical Mode

Install the HaloCAD component using the GUI-based setup program that is provided in the installation package.

1. To begin the interactive installation, double-click the installer HaloCAD_Autodesk_Vault_Setup.exe file. 

2. Depending on your Windows security settings, you may get a warning such as "Do you want to allow the following program to make changes to this computer?". If you get this security warning, click the Yes button to continue the installation.

3. When the installer starts, you will see the startup dialog followed by the welcome dialog:

   

   Startup Dialog

   

   Welcome Dialog

4. Click Next to continue the installation.

5. The end-user license agreement dialog will appear: 

   

   End-User License Agreement Dialog

6. Read the End-User License Agreement. If you agree, select I accept the terms in the License Agreement and click Next.

7. The Tomcat memory pool size configuration dialog will appear:

   

   Tomcat pool size configuration dialog

8. Enter the amount of memory you want to allocate to change the Initial Memory Pool and Total Memory Pool preset values. Note: Ensure that the Total Memory Pool does not exceed the System's available 3/4th RAM. The default Tomcat port is 8383. You can, however, change the port number; it must be greater than 999 and less than or equal to 65535.

9. Click Next. The destination folder selection dialog will appear:

   

   Destination folder selection dialog

10. By default, application files are stored in the program files directory (C:\Program Files\Secude\). If you would like to choose an alternate location, click the Browse button and select your location preference. Note: If HaloENGINE Service and/or HaloENGINE are already installed, you cannot change the destination folder. The browse button becomes disabled. Click Next to allow the Setup program to install the HaloCAD component. To return to any point in the installation process, click the Back button (optional).

11. The installation begins and progress is shown in the dialog.

    

    Installation progress dialog

12. When the installation is completed, you will see a message confirming that the HaloCAD component has been successfully installed.

    

    Installation completed dialog

13. On the setup wizard, you can see the Installation Summary option. To view the summary, select the Installation Summary check box. The installation details will be summarized in the right side pane.

    

    Summary with preinstalled HaloENGINE dialog

14. Please note that the HaloENGINE information will not be included in the summary if it is not already installed.

15. Click Close to close the installation wizard.

Post Installation files:
The following files and directories can be found in both the default and user-specified installation locations:

1. Configuration Tool—C:\Program Files\Secude\HalocadVault\config\HaloCAD-for-Autodesk-Vault-config-<version>.jar. This tool is explained in the next section “Configuring the HaloCAD Proxy”.

2. Log file—HaloCAD component-related activities are logged in C:\Program Files\Secude\Tomcat\logs\haloproxy.log.

Silent Mode

Besides graphical mode, the HaloCAD component can be installed in silent mode, which does not require user involvement or display a user interface. It is a convenient way to streamline the installation process using commands at once.

1. Open the Command Prompt with elevated rights (Run as Administrator).

2. Navigate to the directory of the HaloCAD component installer.

3. To know the list of options available in silent mode, follow the steps given below:
   Type HaloCAD_Autodesk_Vault_Setup.exe -help
   Press Enter
   Output
   ...
   HaloCAD_Autodesk_Vault_Setup.exe -install -initmempool <Initial memory pool size in MB(s).
Minimum size is 128 MB> -totalmempool <Total memory pool size in MB(s).
Maximum size is 3/4 of total RAM size.> -dir <destination_directory> -port <range_1_to_65535>
HaloCAD_Autodesk_Vault_Setup.exe -uninstall

4. The following command illustrates how to install the HaloCAD component.
   SECUDE_HALOCAD_AUTODESK_VAULT_X64.EXE -install -initmempool 1024 -totalmempool 2048 -dir "C:\Program Files\Secude" -port 4444

5. Press Enter.

6. Installation gets completed.