Knowledge Base

Welcome to the Inedo Knowledge Base

The knowledge base is a collection of small articles that are BuildMaster, ProGet, or Inedo related. Use the search box below to search for articles.

All Articles

KB #1116: BuildMaster 5.0 Beta Notes

Last Updated: 4/28/2016

The all versions page details the individual work items and changes, this article will document known issues and cautions.

Make sure to also see the upgrade notes before upgrading.

KB #1117: Upgrade Notes for BuildMaster 5.0

Last Updated: 4/25/2016

BuildMaster 5.0 is currently in beta. See the Beta Notes for more information.

KB #1115: A Comparison: Artifactory vs ProGet

Last Updated: 3/31/2016

Artifactory and ProGet are both enterprise level Universal Package (artifact) Repositories and are quite similar in function; in fact, if you read the marketing bullets they’d probably sound identical. Before we developed ProGet we were Artifactory users, which gave us the unique ability to learn from JFrog’s tool and take into consideration some of the challenges when building our own product.

KB #1114: A Comparison: Octopus Deploy vs Otter

Last Updated: 3/4/2016

Although Octopus Deploy and Otter are different types of products, they can both be used to automate ASP.NET Sites and Windows Services. A side-by-side comparison would be a bit like Air Jordan vs Tesla: they’re different tools that can help you get to the same place, albeit in different manner. Moreover, there's nothing wrong with having and using both.

KB #1110: A Comparison: Chef vs Otter

Last Updated: 3/4/2016

Chef and Otter are both infrastructure automation products, and if you only read the marketing bullets, they'd probably sound identical. But they're quite different products, and this article compares and contrasts the products and the philosophies behind them.

KB #1109: A Comparison: Puppet vs Otter

Last Updated: 3/4/2016

Puppet and Otter are both infrastructure automation products, and if you only read the marketing bullets, they'd probably sound identical. But they're quite different products, and this article compares and contrasts the products and the philosophies behind them.

KB #1113: Anti-malware False Positives, Code Signing, and Safety of Inedo Products

Last Updated: 2/18/2016

Malware protection is meant to ensure that our systems and sensitive information aren't compromised. Occasionally, this protection doesn't quite work as intended and flags a secure download; this is known as a false positive.

KB #1059: When should I update an Inedo Tool?

Last Updated: 2/11/2016

Updating any software to a newer version requires users to weigh the costs associated with the update process against the value and benefits of the new features or bug fixes added – and this is no different with any of our tools. As a DevOps company, we take great care to design and release our tools through a process that permits a super-agile deployment methodology. Which allows many releases to occur in a short time frame.

KB #1111: Upgrade Notes for ProGet 4.0

Last Updated: 2/5/2016

TLDR; ProGet 4.0 is major release. Please read these notes to see how this will impact you and what you can do to mitigate risks.

KB #1112: API Keys in ProGet

Last Updated: 1/28/2016

An API Key is used by NuGet client tools (such as nuget.exe and NuGet Package Explorer) as an authentication mechanism for publishing packages. It makes a lot of sense for the NuGet Gallery, as it's a community-run site where anyone can publish packages they own.

KB #1108: BuildMaster 4.9 Upgrade Notes

Last Updated: 1/4/2016

TLDR;BuildMaster 4.9 has a lot of nonfunctional changes. Please read these notes to see how this will impact you and what you can do to mitigate risks.

KB #1107: Importing BuildMaster v4 Deployment Plans

Last Updated: 1/4/2016

As of v4.9, BuildMaster includes a preview of the BuildMaster v5 execution engine, which is effectively the same execution engine that is used by Otter.

KB #1072: ProGet vs. NuGet.Server

Last Updated: 9/18/2015

NuGet.Server is designed with the primary goal of being the website hosted at NuGet.org, which is the definitive source for open source packages submitted by multiple authors that are available to the public. With a bit of set up and some customization, it can be adapted to become a private server. If you want to host open source packages on the public internet, or create a similarly purposed project like Chocolatey, then NuGet.Server is a perfect fit.

KB #1061: Connecting BuildMaster to Subversion over SSH

Last Updated: 9/18/2015

Creating a Subversion provider requires that the Subversion extension v3.5 or later is installed. Once the extension is installed, select "Admin" (the small gear icon) > "Source Control Providers"(under Extensibility) and "Create New Source Control Provider". This will bring up the familiar provider editing dialog.

KB #1047: SQL Server 2005 and Windows 8

Last Updated: 9/18/2015

Inedo Products require any SQL Server from 2005 to 2012 to be installed. As a database-based applications, there’s no getting around that. To make installation simpler for users that would just like to quickly get started using or evaluating the software, we distribute an installer with SQL Express 2005 included, and provide the option of automatically installing an instance as part of installation.

KB #1044: Which API Should I Use (SOAP, JSON, SQL)?

Last Updated: 9/18/2015

There are three primarily channels for communicating with our products via our APIs:

KB #1040: Securing Self-Hosted Agents using SSL

Last Updated: 9/18/2015

BuildMaster Agents exposed to the Internet should include additional security compared to agents running on a secure local network. The self-hosted agents in BuildMaster support the use of SSL encryption just like agents hosted using IIS.

KB #1015: Running an Inedo Product's Services Interactively

Last Updated: 9/18/2015

The example screenshots are from BuildMaster, but the process will be exactly the same no matter which one of our products you're using.

KB #1100: Getting Started with ProGet for Linux

Last Updated: 9/9/2015

Starting with ProGet 4.0, we plan to officially support Linux installations.

KB #1090: Granting Service Control Privileges for Inedo Product's Web Applications

Last Updated: 9/8/2015

Refer to this table - depending on which product you are using, enter the coinciding name, or abbreviation, into each space that has a red [product's name] or [xx].

KB #1077: Configuring Your Inedo Product to Run As a Windows Domain Account

Last Updated: 9/8/2015

The example screenshots are from BuildMaster, but the process will be exactly the same no matter which one of our products you're using.

KB #1014: Changing an Inedo Product's URL with the Integrated Web Server

Last Updated: 9/8/2015

All Inedo products can run using an Integrated Web Server instead of IIS. While this offers a simpler configuration and installation, the integrated web server lacks many of the advanced features of a full-fledged web application server, and certain configuration is far from obvious. For example, this post will cover binding the integrated web server to a host name.

KB #1053: Troubleshooting Installations

Last Updated: 9/3/2015

We try to make installation as simple as possible, and while it usually installs with no issues, once in a while something goes wrong (which is probably why you are here reading this).

KB #1046: Supported SQL Server Editions

Last Updated: 9/3/2015

Inedo products all have the same database requirements. This table summarizes the options available:

KB #1019: Workaround for Chrome File Uploading Bug

Last Updated: 9/3/2015

This article is now deprecated, Chrome has fixed the bug since v19.

KB #1013: Hosting Through IIS Instead of the Integrated Web Server

Last Updated: 9/3/2015

When you install any of our products using the installer, you’re presented with two application hosting options: Integrated Web Server or IIS Web Application.

KB #1005: This Machine Cannot Be Uniquely Identified

Last Updated: 9/3/2015

Once in a blue moon, your Inedo product might suddenly stop working and give this fairly unhelpful message.

KB #1038: Scriptable BuildMaster Agent Deployment

Last Updated: 9/2/2015

As of BuildMaster v4.0, this article is deprecated. Agent silent installation can be accomplished by running the installer from the command line. See the following documentation for more information: BuildMaster Silent Agent Installation

KB #1018: Automatically Promoting Builds to Environments

Last Updated: 9/2/2015

As of BuildMaster v4.4, this article is deprecated because automatic promotions are a core component of workflows. Simply add a Automotically Promote Build to the Next Environment post-deployment step to any workflow or build step achieve this behavior.

KB #1106: Upgrade Notes for ProGet 3.8

Last Updated: 8/26/2015

ProGet v3.8 is a minor release, and introduces the following changes/additions:

KB #1104: Upgrade Notes for ProGet 3.7

Last Updated: 8/26/2015

ProGet v3.7 is a minor release, and introduces the following changes/additions:

KB #1102: Upgrade Notes for ProGet 3.6

Last Updated: 8/26/2015

ProGet v3.6 is a minor release that introduces the Feed Retention feature, adds a unified system for scheduling tasks, and updates the UI for feed administration.

KB #1099: Upgrade Notes for ProGet 3.5

Last Updated: 8/26/2015

ProGet v3.5 is a minor release that introduces the Feed Sync feature, adds better support for tracking events, and has a few other minor performance and security enhancements.

KB #1105: BuildMaster 4.8 Upgrade Notes

Last Updated: 8/7/2015

TLDR; application groups can now be grouped within other groups, application navigation and overview has changed, and error logging is handled and filtered differently. Please read these notes to see how this will impact you and what you can do to mitigate risks.

KB #1103: BuildMaster 4.7 Upgrade Notes

Last Updated: 6/5/2015

TLDR; new operations for the 5 most popular Source Control Providers and the 3 most popular Issue Tracking Providers. Please read these notes to see how this will impact you and what you can do to mitigate risks.

KB #1063: A Comparison: BuildMaster vs. Octopus Deploy

Last Updated: 1/30/2015

Octopus Deploy and BuildMaster are different products that can both be used to automate .NET deployments. There are several difference between the two products, but the largest is in the scope and problem space the products are designed to solve:

KB #1097: BuildMaster 4.6 Upgrade Notes

Last Updated: 1/15/2015

TLDR; new operations for BuildMaster administration. Please read these notes to see how this will impact you and what you can do to mitigate risks. 

KB #1096: Upgrade Notes for ProGet 3.4

Last Updated: 1/15/2015

ProGet v3.4 is a minor release that introduces some performance and indexing enhancements, and adds support for Bower feeds.

KB #1094: About ProGet Legacy Feeds

Last Updated: 11/24/2014

ProGet 3.3 changes the way NuGet feeds are stored and indexed. If you have upgraded from an earlier version, you will see a notice on existing feeds about migrating to the new type. For instructions on performing this migration, please see KB#1092. This article describes the changes that were made and the reason for the changes.

KB #1093: Upgrade Notes for ProGet 3.3

Last Updated: 11/21/2014

ProGet v3.3 is a minor release that introduces many performance and indexing enhancements, changing the way packages are stored on disk for the default package store, and changing the way they are served by the ProGet server.

KB #1092: Migrating Legacy ProGet Feeds

Last Updated: 11/21/2014

ProGet 3.3 supports a new, more efficient method for storing NuGet packages. If you've upgraded an existing installation to 3.3 or newer, you will need to migrate your existing feeds to the new format if you want to take advantage of all of the performance improvements. Note that your legacy feeds will still work; they will just continue to consume system resources for large numbers of packages as in previous versions.

KB #1091: BuildMaster 4.5 Upgrade Notes

Last Updated: 11/5/2014

TLDR; major configuration file module changes. Please read these notes to see how this will impact you and what you can do to mitigate risks. 

KB #1086: BuildMaster 4.4 Upgrade Notes

Last Updated: 11/5/2014

TLDR; major promotion workflow changes. Please read these notes to see how this will impact you and what you can do to mitigate risks.  Or as Abe Lincoln once said, give me six hours to chop down a tree and I will spend the first four sharpening the axe.

KB #1089: Upgrade Notes for ProGet 3.2

Last Updated: 10/3/2014

ProGet v3.2 is a minor release that introduces npm registry support and adds support for high-availability installations and load-balancing options. This version essentially replaces what would have been the v3.1.8 maintenance release, and all users who were planning to upgrade to v3.1.8 for bugfixes should upgrade to v3.2.X instead.

KB #1073: Load-balanced and High-availability Installation of ProGet

Last Updated: 10/3/2014

For environments that need load-balancing or high-availability, a single ProGet installation can utilize multiple servers.

KB #1088: Using PowerShell to Install and Configure ProGet

Last Updated: 9/29/2014

Since ProGet supports silent installation, it is pretty straightforward to automatically deploy it as part of a script. However, it is also possible to use the SQL API to add some standard initial configuration.

KB #1085: Upgrade Notes for ProGet 3.1

Last Updated: 6/20/2014

ProGet v3.1 is a minor release that introduces some helpful features regarding symbol serving, and connector improvements. This version essentially replaces what would have been the v3.0.4 maintenance release, and all users who were planning to upgrade to v3.0.4 for bugfixes should upgrade to v3.1.X instead.

KB #1084: Upgrade Notes for BuildMaster 4.3

Last Updated: 6/20/2014

TLDR; major deployment plan and deployment execution changes. It’s another big one. Please read these notes to see how this will impact you and what you can do to mitigate risks.  Or as Benjamin Franklin would say, by failing to prepare, you are preparing to fail.

KB #1083: Upgrade Notes for ProGet 3.0

Last Updated: 6/20/2014

ProGet 3.0 is a major release that introduces a new suite of deployment features for ProGet. These features have been added side-by-side, such that upgrading to v3.0 from v2.2 should introduce very little risk beyond that of a typical maintenance release upgrade. If you are upgrading from a version before v2.2, make sure to view the upgrade notes for all minor versions prior to this one.

KB #1082: Upgrade Notes for BuildMaster 4.2

Last Updated: 6/20/2014

TLDR; major variable and deployment plan changes - if you are upgrading to 4.2, you  really should spend a few moments to read this article to see how this upgrade may impact your configuration. You know what they say about an ounce of preparation…

KB #1081: Upgrade Notes for BuildMaster 4.1

Last Updated: 6/20/2014

BuildMaster 4.1 is a minor release with the following changes:

KB #1074: Upgrade Notes for ProGet 2.2

Last Updated: 6/20/2014

ProGet 2.2 is a minor release of ProGet with the following changes and bug fixes:

KB #1066: Upgrade Notes for BuildMaster 4.0

Last Updated: 6/20/2014

Please read this document carefully as there are several changes which may impact your installation, configuration, and customizations of BuildMaster.

KB #1052: Troubleshooting Failed Builds and Deployments

Last Updated: 4/8/2014

While BuildMaster is designed to automate your entire build and deploy process without error, there are times when errors do occur when a build is executed. While most errors will be self-documenting in the deployment log, others may be a little trickier to track down. This article will present some of the most common troubleshooting ideas for any failed build.

KB #1078: Using the Loupe Live Session Viewer to Debug the Service

Last Updated: 12/19/2013

The BuildMaster service ships with an instance of the live logging product named Loupe from Gibraltar Software. Loupe allows you to view all log information written out by the BuildMaster service in real time. It can be used to troubleshoot bugs or other oddities that can arise from an automated deployment scenario.

KB #1071: Upgrade Notes for BuildMaster 3.7

Last Updated: 11/21/2013

BuildMaster 3.7 exists only to provide support to for users who cannot yet upgrade to BuildMaster 4.x; we advise upgrading directly to BuildMaster 4.0 or later.

KB #1067: BuildMaster 4.0 Beta Notes

Last Updated: 11/21/2013

This article is outdated, as BuildMaster 4.0 is no longer in beta.

KB #1064: Upgrading Agents for BuildMaster 4.0

Last Updated: 11/21/2013

For BuildMaster 4.0, we have taken advantage of the major version change to make several breaking changes that prevent BuildMaster from automatically updating 3.x agents:

KB #1075: Upgrading Extensions in BuildMaster 4.0

Last Updated: 11/12/2013

Because of the .NET Platform and SDK changes, all extensions built against pre-4.0 SDK versions must be updated. Your custom-built extensions must be recompiled against the new SDK. After upgrading to BuildMaster 4.0, you'll be presented with an upgrade checklist that will look similar to:

KB #1070: Writing an Agent-based Action

Last Updated: 10/10/2013

As of BuildMaster 4.0, there is a new base class for custom actions called AgentBasedActionBase. Like RemoteActionBase, AgentBaseActionBase is intended for actions which execute against a specific server. However, unlike RemoteActionBase, there is no automatic proxying performed. Instead, you request access to various services using the GetServicemethod accessible from the AgentBasedActionBase.Context.Agent property.

KB #1069: BuildMaster 4.0 SDK Changes

Last Updated: 10/4/2013

BuildMaster 4.0 makes a number of significant breaking changes with previous SDK versions. This article will help prepare you for updating any custom extensions you may have.

KB #1068: BuildMaster 4.0 UI and UX Tour

Last Updated: 9/26/2013

While the new UI for BuildMaster 4.0 may look completely different from the < 4.0 versions, we’ve tried to maintain much of the same functionality, and only make improvements where they were needed most. This article will describe the differences between both the UX and UI in each version.

KB #1065: Running the UTC date fix tool

Last Updated: 9/26/2013

Note: This article only applies to users who have upgraded a BuildMaster installation from a pre-4.0 version to a 4.0+ version.

KB #1062: Upgrade Notes for ProGet 2.1

Last Updated: 9/26/2013

ProGet 2.1 is a minor release of ProGet with the following changes and bug fixes:

KB #1060: Upgrade Notes for BuildMaster 3.6

Last Updated: 9/26/2013

BuildMaster 3.6 is a minor release of BuildMaster with the following changes:

KB #1057: A Comparison Between BuildMaster vs. Hudson

Last Updated: 9/26/2013

Hudson and BuildMaster are different products, the main difference being that Hudson is a Continuous Integration server (i.e. it will automatically take code from SCM, build it, then put artifacts on an integration server), while BuildMaster can perform Continuous Integration related tasks, and additionally set up plans for your builds to be deployed through various environments (development, test, production, etc.) while also:

KB #1056: A Comparison Between BuildMaster vs. Jenkins

Last Updated: 9/26/2013

Jenkins and BuildMaster are different products, the main difference being that Jenkins is a Continuous Integration server (i.e. it will automatically take code from SCM, build it, then put artifacts on an integration server), while BuildMaster can perform Continuous Integration related tasks, and additionally set up plans for your builds to be deployed through various environments (development, test, production, etc.) while also:

KB #1051: Upgrade Notes for ProGet 2.0

Last Updated: 9/26/2013

ProGet 2.0 is a major release of ProGet with the following changes:

KB #1042: Upgrade Notes for BuildMaster 3.5

Last Updated: 9/26/2013

BuildMaster 3.5 is a semi-major release of BuildMaster with the following changes:

KB #1039: Comparison of BuildMaster Agents

Last Updated: 9/26/2013

For BuildMaster to orchestrate a remote server, an Agent is required. Currently, BuildMaster has four types of agents:

KB #1037: Upgrade Notes for BuildMaster 3.3

Last Updated: 9/26/2013

BuildMaster 3.3 is a minor release of BuildMaster with the following changes:

KB #1036: Using ProGet's Symbol Server

Last Updated: 9/26/2013

ProGet Enterprise includes an integrated symbol/source server that makes .pdb symbol files stored in a Feed's packages accessible directly from a debugger such as Visual Studio.

KB #1034: Uploading Files to Windows Azure Blob Storage in BuildMaster

Last Updated: 9/26/2013

Windows Azure is a cloud service, so your BuildMaster server must have access to the internet for this extension to work properly. The Azure extension includes an action for uploading files to Azure blob storage and must be installed from the Extension Gallery for the action to be available within BuildMaster.

KB #1032: The Difference Between Deployables and Applications

Last Updated: 9/26/2013

From the BuildMaster Documentation, we know that an application is defined as:

KB #1026: Upgrade Notes for BuildMaster 3.2

Last Updated: 9/26/2013

BuildMaster 3.2 is a minor release of BuildMaster, and focused on the following changes:

KB #1023: A Comparison Between BuildMaster vs. TeamCity

Last Updated: 9/26/2013

TeamCity and BuildMaster are different products, the main difference being that TeamCity is a Continuous Integration server (i.e. it will automatically take code from SCM, build it, then put an artifact on an integration server), while BuildMaster can perform Continuous Integration related tasks, and additionally set up plans for your builds to be deployed through various environments (development, test, production, etc.) while also: