How to Deploy Pipeline Components

  • Article

After you develop your pipeline components, you must deploy them so that you can register, test, and then debug them. This topic shows how to deploy your pipeline components.

To deploy a pipeline component

  • Copy the assembly to the destination computer and register the component using Regasm.exe. You can deploy the component into the global assembly cache by using Gacutil.exe, or by using Regasm.exe with the /codebase option to deploy your new pipeline component without putting it in the global assembly cache.

You should know the following important items:

  • Although strong name signing is not required when you use Regasm.exe with the /codebase option, it is required for all assemblies in the global assembly cache. Strong name signing is recommended in both cases.

  • When you add your new component to a pipeline using the Pipeline Editor, a common error that you may encounter is an error dialog box stating, "Unable to create the component" with an error code of 0x80040154 (REGDB_E_CLASSNOTREG, "Class not registered"). This may indicate that you did not deploy the assembly to the global assembly cache or that you did not use the /codebase option of Regasm.exe when you registered the assembly with COM.

  • If you must debug your component on a computer other than the one on which it was built, be sure to also copy the program database (PDB) symbols into the same location where you registered the pipeline component, or to another location where Visual Studio 2008 on the destination computer will look for it. For more information about how to set the locations in which Visual Studio 2008 will look for symbol files, see https://go.microsoft.com/fwlink/?LinkId=65101. If you are debugging the pipeline component on the same computer on which you built the component, Visual Studio 2008 will be able to find your symbols even if you moved the assembly before registering it.

  • If you are using a 64-bit computer you must use the 64-bit version of Regasm.exe.

See Also

Other Resources

How to Debug Pipeline Components

How to Register Pipeline Components

Building Pipeline Components