How to create an installer for your custom extension

How to create an installer for your custom extension

  • Comments 7

The simplest way to create an installer for your custom SSIS extension is by using a Setup Project in Visual Studio. Here are the steps we take when we’re creating installers for our Codeplex projects.

1. In Visual Studio, create a new Setup Project – File -> New Project…

2. Under Other Project Types | Setup and Deployment, select Setup Project

clip_image002

3. Delete User’s Desktop and User’s Project Menus folders from File System (Setup) screen

clip_image004

4. On Application Folder, set the DefaultLocation property to the root DTS directory:

Ex. [ProgramFilesFolder]Microsoft SQL Server\100\DTS

5. Right click on the Application Folder and add the sub folder you need to put your sample in (ie. Tasks, PipelineComponents, Connections)

6. Right click on the new folder, and add “Project Output” to the folder to place binaries from your sample.

clip_image006

clip_image008

7. If you need to place files in the GAC, right click on File System on Target Machine -> Add Special Folder -> Global Assembly Cache Folder

clip_image010

It will now show up as an additional folder, and you can add project output to it.

8. Exclude all dependencies by highlighting all of the files under the Detected Dependencies Folder, and selecting Exclude

clip_image012

9. If you’d like to add a readme .rtf file, place it in the Application Folder.

10. You’ll need to edit the UI pages to display a readme after the install. Right click on the Setup project, View -> User Interface to bring up the UI page.

clip_image014

11. For both the Install and Administrative Install, right click on End and select Add Dialog. Select the Read Me dialog. Drag the “Read Me” page to be above the “Finished” page.

clip_image016

12. Set the ReadmeFile property to your readme file.

clip_image018

Leave a Comment
  • Please add 4 and 8 and type the answer here:
  • Post
  • Hi Matt,

    Thanks for the primer - it will help tons.

    One more favor to ask though - is there any way you could walk over to the Visual Studio Extensibility guys and have them help with the "last mile" of making an installer?  How can an installer place the component into the BIDS toolbox?

    I've tried myself by looking at archives of Chetan Chudasama's blog, and a derivative of that work on CodePlex (the Visual Studio Toolbox Manager) that is so tantalizingly close to working... but doesn't.

    Thanks!

  • If you'd like to know how to add an SSIS custom Task or Component to the VS toolbox with an installer (so you don't have to Add Items), vote for this Connect issue: https://connect.microsoft.com/SQLServer/feedback/ViewFeedback.aspx?FeedbackID=407817

  • Matt,

    Thanks, this was extremely helpful.  However, I would suggest one change.  As per the MSDN's advice on deploying custom SSIS objects(http://msdn.microsoft.com/en-us/library/ms403356.aspx#deploying), we should check the registry for the proper installation folder.  With tips from KB article 827026 (http://support.microsoft.com/kb/827026), I was able to use a Launch Condition to search the registry for the key I needed (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTS\Setup\DtsPath for SQL Server 2005) and store it in a variable I named DTS_PATH.  Then, in my ApplicationFolder's DefaultLocation property, I put [DTS_PATH]\Tasks (since I was installing a custom task).  Now my installer will work even if SQL Server isn't installed in the default location.

    Thanks again for the post - it was a huge help!

  • This is a great point - using the registry keys is definitely a good idea. In 2008, the key was moved from the MSDTS hive to the main Microsoft SQL Server path -

    HKLM\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DTSPath

    When I have time, I'll update the blog post with this information, as well as any tips about controlling the Toolbox I can dig up.

  • What about 64 bit installs. I want to be able to install to both the Program files and the Program Files (x86) folders (so that the component is available to VS on 64bit machines as VS is 32bit) but there doesn't seem to be a way to do it as if you set Program Files 64 bit in windows installer? Any tips?

  • I have answered my own question: The 32 bit path is in this regkey: HKLM\SOFTWARE\Wow6432Node\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DTSPath

    I assume that adding all of these, assigning the installer to target 64bit then doing conditional copies based on if these paths actually exist or not would probably work. Wisk me luck.

  • Any suggestion on how to use the registry value (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DTSPath) as a Launch Conditions - Registry Search?

    Or will [ProgramFilesFolder]Microsoft SQL Server\100\DTS work for both 32 and 64bit?

Page 1 of 1 (7 items)