Installing the CoLab/Windchill Add-InCoLab supports the CoLab Add-In for Windchill. This guide will help with installation, repairs, and uninstallation of the Add-In.

First Installation

Add-in functionality becomes available upon the installation completion.

Installation

1. Run the installation file. Click Next.
2. Check “I accept the terms in the License Agreement”
3. Click Next.
4. Click Browse... to select the folder for the add-in installation. Alternately you can click Scan to automatically identify all existing Windchill locations.
   

   Note: the Scan option can take time to complete, and many users prefer to Browse... instead.

5. Click Next.
6. Select your preferred installation type:
   1. Automatic will automatically install all add-in features and resolve any potential conflicts with existing Windchill customizations.
   2. Custom will allow users to perform the installation manually.
7. Click Next and the add-in will install.
8. (Custom only) Select Yes or No when asked whether you want the installer to automatically change configuration settings in Windchill.
9. (Custom only) If customization conflicts were detected, you will see the following window that shows the list of detected conflicts:
   
10. (Custom only) Select Yes or No and click Next.
11. When the installation is finished, you will be prompted to restart Windchill Server to apply the changes. Select Yes or No and then click Next.
12. Click Finish to complete the installation.

If all of the installation steps were successfully completed and Windchill has been restarted, the add-in is installed in ready for use.

Installing the add-in to a new Windchill instance

You may want to install the CoLab add-in to a different Windchill instance than one that’s already got it installed.

If you’ve already installed the add-on, when you run the installation file you will see this screen:

You can select the “New installation” checkbox to select a new installation location and continue with the first installation process detailed above.

Update, Repair, and Uninstall

To update, repair, or uninstall the CoLab/Windchill add-in:

1. Run the installation file.
   

   Note: the installer will automatically identify those Windchill application instance(s) where the add-in is installed.

2. Select the instance you want to update, repair, or uninstall.
3. Select the action you would like to take:
1. Repair will repair add-in files by overriding existing files and adding missing files to the selected installation.
2. Update will substitute current add-in version with the installer’s version. Update will not be offered as an option if the installer is for the same version that is already installed.
3. Uninstall will remove the add-in from the selected Windchill application instance.
4. Click Next.

RPM Installation and Uninstallation

For instances running Linux without a graphical interface, you can install through the command line.

1. Type rpm -ivh --prefix=[PATH_TO_WINDCHILL_HOME] [PATH_TO_RPM]
(ex: rpm -ivh --prefix=/opt/ptc/Windchill_11.2/Windchill CoLabWindchill_linux_1_0_81.rpm )
2. The installer will prompt you to choose an installation type as shown:
   
3. (Automatic) All add-in files will be installed, registered via xconfmanager utility, and Windchill will be restarted - no further actions required.
   
4. (Manual) All add-in files will be installed. When complete, the user will need to manually register add-in files via xconfmanager utility using the following commands:
1. cd [PATH_TO_WINDCHILL_BINARY]
2. xconfmanager --add com.ptc.netmarkets.util.misc.defaultActions=config/actions/CoLab-actions.xml -p
3. xconfmanager —add com.ptc.netmarkets.util.misc.defaultActionmodels=config/actions/CoLab-actionModels.xml -p
5. (Manual) Restart Windchill to apply changes with the command cd [PATH_TO_WINDCHILL_BINARY] > ./ windchill stop > ./windchill start
6. (Manual) Check the installation:
1. With the command rpm -ql CoLabWindchill
2. Run the same command as starting the installer (in step 1). If the package is already installed, you will see the following:
   
   And if not, you will see this instead:
   
7. (Manual) To uninstall the CoLab/Windchill add-in, use the command rpm -evv CoLabWindchill

Worker installation and configuration

To convert a Creo drawing into PDF format, and to convert any Creo CAD files into neutral file formats like step, IGES, STL, PDF or more in Windchill, please refer to PTC’s documentation around Worker installation, troubleshooting, and configuration.