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 #1123: Upgrade Notes for BuildMaster 5.1

Last Updated: 6/21/2016

Upgrading from BuildMaster v4? It is strongly recommended that you first upgrade to BuildMaster 4.9, and then upgrade directly to this release or later

KB #1122: Upgrade Notes for ProGet 4.1

Last Updated: 6/21/2016

ProGet 4.1 is minor release with the following changes:

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

Last Updated: 6/21/2016

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 #1117: Upgrade Notes for BuildMaster 5.0

Last Updated: 6/20/2016

Upgrading from BuildMaster v4? It is strongly recommended that you first upgrade to BuildMaster 4.9, and then upgrade directly to BuildMaster 5.1 or later

KB #1039: The Inedo Agent and Legacy BuildMaster Agents

Last Updated: 6/20/2016

Both BuildMaster and Otter need to be able to communicate with servers in order to configure, orchestrate, or deploy applications to them.

KB #1118: Legacy Plans in BuildMaster 5.0

Last Updated: 6/2/2016

One of the major features of BuildMaster 5.0 is a brand new execution engine. It's a complete rewrite and takes into account years of experience supporting complex, multi-server orchestrations with easy-to-use deployment plans, and incorporates a tremendous amount of technological advancements.

KB #1109: A Comparison: Puppet vs Otter

Last Updated: 6/2/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 #1072: ProGet vs. NuGet.Server

Last Updated: 6/2/2016

NuGet.Server is a free and open-source package that's designed to be incorporated into a .NET web application and host a single, NuGet feed. With a bit of set-up and some customization, you can use NuGet.Server to build a lightweight, standalone NuGet Server that hosts a single feed. It's like a network share drive for your packages, but hosted over HTTP/S.

KB #1121: Upgrade Notes for Otter 1.1

Last Updated: 5/31/2016

Otter 1.1 is minor release with the following changes:

KB #1116: BuildMaster 5.0 Beta Notes

Last Updated: 5/26/2016

BuildMaster 5.0 has been released, so this article is relevant only if you are upgrading from a previous beta. Make sure to read the upgrade notes before upgrading.

KB #1120: Permission Updates in BuildMaster 5.0

Last Updated: 5/13/2016

Permissions in BuildMaster v5.0 are simpler than in previous versions, but in most cases, will be the same granularity. Previous versions had up to 66 "tasks", many of which were either conflated (Builds_ViewExecutionDetails & Builds_ViewPromotionDetails) or simply non-sensical individually (Admin_ManageExtensions without Admin_ControlService). In this version, there are only 27 individually-securable permissions.

KB #1088: Using PowerShell to Install and Configure ProGet

Last Updated: 5/7/2016

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 #1119: Wildcard Masking in BuildMaster and Otter

Last Updated: 5/6/2016

Wildcard masks in BuildMaster and Otter are used to include and/or exclude file/directory paths in the context of an operation. Typically, masks are used for file-based operations. The values for the masks are similar to ant-style masks.

KB #1107: OtterScript Deployment Plans in BuildMaster 4.9

Last Updated: 5/5/2016

This article is deprecated, as BuildMaster 5.0 has been released.

See KB#1118: Legacy Plans in BuildMaster 5.0 for the more information about OtterScript Deployment Plans and Legacy Plans.

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

Last Updated: 5/2/2016

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 #1075: Upgrading Extensions in BuildMaster 4.0

Last Updated: 5/2/2016

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.

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

Last Updated: 5/2/2016

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 #1057: A Comparison Between BuildMaster vs. Hudson

Last Updated: 5/2/2016

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: 5/2/2016

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 #1034: Uploading Files to Windows Azure Blob Storage in BuildMaster

Last Updated: 5/2/2016

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 #1023: A Comparison Between BuildMaster vs. TeamCity

Last Updated: 5/2/2016

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:

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

Last Updated: 5/2/2016

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 #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 #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 #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 #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 #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 #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 #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 #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 #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 #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 #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 #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: