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 #1766: BuildMaster 6.2 Upgrade Notes

Last Updated: November 14, 2019

What’s in this Update? BuildMaster 6.2 is a major upgrade, with a number of breaking changes and significant new features. Review this article carefully before deciding when and how to upgrade. Beta Note: BuildMaster 6.2 is still in-development and is considered a pre-release; while we’ve been using it on our public instance for a while, […]

KB #1758: Automatic License Activation Not Working

Last Updated: November 11, 2019

To jump straight to the simple workaround, click here: Simple Workaround Recently we’ve had an increase in support tickets related to automatic license key activation failing across all our products. This post provides a solution to the issue and some background on the problem. Background On September 28, 2019, we migrated the inedo.com website from […]

KB #1109: A Comparison: Puppet vs Otter

Last Updated: September 13, 2019

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. Moreover, there’s nothing wrong with having and using both – in fact, many organizations have Puppet, Chef, […]

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

Last Updated: August 20, 2019

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. If it’s Signed by Inedo, It’s Guaranteed Safe Rest assured that if the package is signed by Inedo, you can be […]

KB #1151: Upgrading from BuildMaster v3 and v4

Last Updated: October 22, 2019

BuildMaster v3 and v4 are semi-retired , which means that we will provide very limited support to users who have not yet upgraded, and will provide assistance in performing upgrades. However, we will no longer ship maintenance releases, patches, or other changes. This means you should upgrade when possible, and this article provides guidance on […]

KB #1156: BuildMaster 6.0 Upgrade Notes

Last Updated: August 19, 2019

Users who choose to upgrade an existing instance should upgrade to the latest v5.8 version first before upgrading to v6.0+. Upgrade Notes BuildMaster 6.0 is a major version with the following changes: .NET 4.5.2+ is required (previous installs required v4.5.0+) (major configuration change) Free edition now grants unlimited users, but all users are full administrators […]

KB #1163: BuildMaster 6.1 Upgrade Notes

Last Updated: August 19, 2019

Upgrade Notes BuildMaster 6.1 is a minor version with the following changes: add Git repository monitors and hooks (new feature) (details) add variable value renderers (new feature) (details) add CI Badge API (new feature) (details) add opt-in Loupe integration (new feature) (details) rename “release packages” to “builds” (major UI change) (details) Legacy BuildMaster SDK change […]

KB #1168: Migrating a ProGet Feed

Last Updated: June 11, 2019

Migrating a Feed Between ProGet Instances It may be necessary to migrate all of the packages you have stored in a ProGet feed from one instance to another. There’s a few different ways to do this depending on the feed type, and this document will describe the various approaches. Prefered Method: Migrate using Feed Replication […]

KB #1167: SQL Server Implementations With Inedo Tools

Last Updated: May 27, 2019

Recommended SQL Edition All Inedo software merely requires you to have at SQL Server 2008 or newer. We keep our tools flexible so that you can keep the version best suited for your systems. Here are some minimum system requirements for SQL versions that we support. SQL Server 2016 SQL Server 2014 SQL Server 2017 […]

KB #1164: Azure DevOps and BuildMaster Compared

Last Updated: May 9, 2019

BuildMaster and Azure DevOps are both CI/CD process tools that aim to model and automate end-to-end CI/CD, starting by building source code and ending with the software release. Both programs are popular and are often used together as part of a modern DevOps toolchain. But, there are significant differences between the programs that impact developers’ […]

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

Last Updated: May 1, 2019

Octopus Deploy and BuildMaster are two different products that can both be used to automate deployments. There are a lot of technical differences, but the overall approach to the problem is the best starting point for comparing the two. Packages vs Applications Octopus Deploy uses a package-based approach for release automation. This means that your […]

KB #1166: Upgrade Notes for ProGet 5.2

Last Updated: April 24, 2019

ProGet 5.2 is a minor release with the following changes: add PyPI, Debian, and Helm feed types (new feature) (details) add APIs for Feed Management and Connector Health (new feature) (details) add one-way replication and replication dashboard (new feature) (details) support for Azure SQL databases (new feature) (details) support for SQL Server on Linux (new […]

KB #1165: Upgrade Notes for Otter 2.2

Last Updated: April 17, 2019

Upgrade Notes Otter 2.2 is minor release with the following changes: major performance improvements (details) add opt-in Loupe integration (new feature) (details) For the complete listing of issues added to this release, see the release notes on the All Versions page. New Features Major Performance Improvements We’ve removed many performance bottlenecks including SQL database access, […]

KB #1005: This Machine Cannot Be Uniquely Identified

Last Updated: February 12, 2019

Once in a blue moon, your Inedo product might suddenly stop working and give this fairly unhelpful message. It’s happened to us three times over the past two years, and a single customer in a year of use. We cannot reproduce it, but we know exactly what code is causing it: the activation module. Like […]

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

Last Updated: February 12, 2019

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. The question of which to choose comes down to simplicity or robustness. The Integrated Web Server is easy to install (and obviously doesn’t require IIS installed), while an IIS Web Application […]

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

Last Updated: November 14, 2019

If you installed an Inedo Product using Inedo Hub, you can change the URL in the Configuration tab of the Inedo Hub desktop application. 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 […]

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

Last Updated: November 14, 2019

The example screenshots are from BuildMaster, but the process will be exactly the same no matter which one of our products you’re using. 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], [service], or [XX]. The Inedo […]

KB #1023: A Comparison Between BuildMaster vs. TeamCity

Last Updated: November 15, 2019

TeamCity and BuildMaster are different products that solve different problems, and both are commonly used as part of a modern DevOps Toolchain.A side-by-side comparison would be a bit like Word and Excel: Both can be used to create forms that you’ll print out, but if that’s the only thing your business uses Microsoft Office for, […]

KB #1040: Securing Self-Hosted Agents using SSL

Last Updated: February 12, 2019

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. Installing the Certificate To use SSL, you must have an appropriate certificate installed to the machine store on the […]

KB #1046: SQL Server Requirements

Last Updated: November 14, 2019

Otter, BuildMaster, and ProGet for Windows all require any supported version of Microsoft SQL Server. Installation We recommend installing and configuring SQL Server yourself, but the installer does provide the option of downloading and installing SQL Express for you if you would like to get started quickly and don’t have an existing instance to use. […]

KB #1053: Troubleshooting Installations

Last Updated: February 12, 2019

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). SQL Server Problems Since all but one of the installer error reports we have received are due to some issue with SQL […]

KB #1056: A Comparison Between BuildMaster vs. Jenkins

Last Updated: February 12, 2019

Jenkins and BuildMaster are different products, that solve different problems, and both are commonly used as part of a modern DevOps Toolchain. A side-by-side comparison would be a bit like Word and Excel: both can be used to create forms that you’ll print out, but if that’s the only thing your business uses Microsoft Office […]

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

Last Updated: February 12, 2019

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 […]

KB #1072: ProGet vs. NuGet.Server

Last Updated: February 12, 2019

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 […]

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

Last Updated: November 14, 2019

The example screenshots are from BuildMaster, but the process will be exactly the same no matter which one of our products you’re using. 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]. The Inedo Product […]

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

Last Updated: November 14, 2019

IMPORTANT: using the built-in service command (i.e. ProGet.Service.exe AllowServiceControl) to allow service control has been deprecated because it does not work reliably on all versions of Windows, and may cause undesired affects (see troubleshooting). Granting Service Control via subinacl.exe Download and install subinacl.msi from: https://www.microsoft.com/en-us/download/details.aspx?id=23510 Once installed, invoke the tool specifying the {service-name} and {user-account} […]

KB #1110: A Comparison: Chef vs Otter

Last Updated: February 12, 2019

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. Moreover, there’s nothing wrong with having and using both – in fact, many organizations have Puppet, Chef, […]

KB #1115: A Comparison: Artifactory vs ProGet

Last Updated: February 12, 2019

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 […]

KB #1118: Legacy Plans in BuildMaster 5.0

Last Updated: February 12, 2019

The below applies to BuildMaster users upgrading to v5 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. To mitigate upgrade risk, the […]

KB #1119: Wildcard Masking in Inedo prouducts

Last Updated: November 14, 2019

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. Rules A single asterisk (*) represents a matching file name within a specific directory A double asterisk (**) […]

KB #1120: Permission Updates in BuildMaster 5.0

Last Updated: February 12, 2019

The below applies to BuildMaster users upgrading to v5 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 […]

KB #1128: Legacy Configuration and Release Variables

Last Updated: February 12, 2019

In BuildMaster 5.3, we introduced two new features that expanded-on and replaced existing features: Release Templates – a template for an entire release definition (including variables, among other things), these replace “template variables”, which instead applied to every new release, package, or deployment created within an application Configuration Variables – effectively a redux of the […]

KB #1140: Disabling WebDAV in IIS

Last Updated: February 12, 2019

Some ProGet feed endpoints use PUT or DELETE requests. If the WebDAV module is enabled in IIS, these requests can result in a 405 Method Not Allowed error. This article details several methods of disabling the WebDAV module. 1. Disable the WebDAV Publishing feature in Windows This is the easiest solution if WebDAV is not […]

KB #1144: BuildMaster Legacy Features

Last Updated: November 14, 2019

With the inclusion of the Inedo Execution Engine and the Inedo Agent in BuildMaster v5, several existing features were replaced with newer features that were a better fit for the new model. We consider these since-rebuilt features to be “legacy features”, and this document will describe the impact of using these features as well as […]

KB #1145: Accessing a PostgreSQL Database in a Docker Container

Last Updated: February 12, 2019

If you used the official installation instructions for ProGet on Linux, and for one reason or another, you need to access the ProGet database directly, you can use these commands: Backup and Restore Backing up a PostgreSQL database uses the pg_dump command, and restoring it uses the psql command. The commands below will work as-is, […]

KB #1146: Installing Multiple Instances of InedoAgent on a Single Machine

Last Updated: February 12, 2019

Sometimes it is helpful to have multiple instances of InedoAgent on the same machine, such as having different instances that run as different user accounts. Although the installation wizard and the manual install process do not support this, it is possible to run multiple instances of InedoAgent as long as they have separate working directories […]

KB #1153: Upgrading from ProGet v2 and v3

Last Updated: February 12, 2019

ProGet v2 is retired and v3 is semi-retired. We will only provide very limited product support for v3, but we will no longer ship any maintenance releases, patches, or other changes (including for security vulnerabilities). This means you should upgrade as soon as possible. Most of the releases in v2 and v3 were additive and […]

KB #1157: NuGet version number formatting restrictions

Last Updated: February 12, 2019

SemVer2 versions SemVer2, or Semantic Versioning 2.0.0 version numbers are supported only in SemVer2 (ProGet 5+) NuGet feeds. A formal description is available in the Semantic Versioning 2.0.0 specification. A SemVer2 version number is three decimal integers (digits 0–9) separated by dots (.). Each component of the version number must not begin with a zero […]

KB #1159: Support Ticket Process

Last Updated: February 12, 2019

When you submit a ticket using the ticket submission form, it will automatically create an issue in Inedo’s YouTrack instance, in a non-public project intended for support. While you won’t be able to see the status of your tickets using YouTrack, you can see the status or add comments on my.inedo.com/tickets, or add comments by […]

KB #1161: TLS v1.2 Configuration and Connection Errors

Last Updated: February 12, 2019

To jump straight to the fix, click here: Registry Workaround Recently, there have been an increasing number of issues for our support staff that involve our products connecting to servers that require TLS v1.2 for security reasons. Common examples include connecting to the following services: GitHub – https://githubengineering.com/crypto-deprecation-notice/ Azure DevOps (formerly Visual Studio Team Services […]

KB #1114: A Comparison: Octopus Deploy vs Otter

Last Updated: February 12, 2019

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 […]

KB #1039: The Inedo Agent and Legacy BuildMaster Agents

Last Updated: February 12, 2019

The below applies to BuildMaster users upgrading to v5 Both BuildMaster and Otter need to be able to communicate with servers in order to configure, orchestrate, or deploy applications to them. For Windows servers, this is generally accomplished using a lightweight agent that’s installed on the server. Alternatively, SSH/SFTP could be used for agent-less communication, […]

KB #1117: Upgrade Notes for BuildMaster v5

Last Updated: February 12, 2019

Upgrading from a v3 or v4? This document is for informational purposes only, and you should upgrade directly to v6; please see Upgrading from BuildMaster v3 and v4 first. Upgrading from a 5.x? You should directly upgrade to the latest BuildMaster 5.8 prior to upgrading to v6. This article is a rollup of all upgrade […]

KB #1121: Upgrade Notes for Otter 1.1

Last Updated: February 12, 2019

Otter 1.1 is minor release with the following changes: Support for SSH-based Servers Git-based Rafts Various bug fixes New SDK New API Upgrade Impact Because the changes are additive, the upgrade risks are negligible: there is a minor database schema change, and you can mitigate this risk by backing-up your Otter instance prior to upgrade. […]

KB #1124: Upgrade Notes for Otter 1.2

Last Updated: February 12, 2019

Otter 1.2 is minor release with the following changes: API Keys (new feature) Configuration Import/Export (new feature) Infrastructure Synchronization (new feature) Minor improvements and bug fixes Upgrade Impact Because most of the changes are additive, the upgrade risks are minimal. There is a minor database schema change, and you can mitigate this risk by backing-up […]

KB #1127: Upgrade Notes for Otter 1.3

Last Updated: February 12, 2019

Otter 1.3 is minor release with the following changes: Inedo Den Integration (new feature) Minor improvements and bug fixes Upgrade Impact Because most of the changes are additive, the upgrade risks are negligible. There are no database schema change, but you should always back up your Otter instance just in case. Core Functionality to “Extensions” […]

KB #1132: Upgrade Notes for Otter 1.4

Last Updated: February 12, 2019

Otter 1.4 is minor release with the following changes: Agentless (PowerShell) Windows Communication (new feature) Variable Enhancements OtterScript/Execution Engine Changes New API Endpoints Upgrade Impact Because most of the changes are additive, the upgrade risks are minimal. Risk Mitigation Because both variables and the execution engine have been updated, there is a potential for unintentional […]

KB #1139: Upgrade Notes for Otter 1.5

Last Updated: February 12, 2019

Otter 1.5 is minor release with the following changes: OtterScript/Execution Engine Changes New SDK New API Endpoints Upgrade Impact Because most of the changes are additive, the upgrade risks are minimal. Risk Mitigation Because both variables and the execution engine have been updated, there is a potential for unintentional changes/bugs to be introduced. To mitigate […]

KB #1142: Upgrade Notes for Otter 1.6

Last Updated: February 12, 2019

Otter 1.6 is minor release with the following changes: Server Packages (New Feature) Role Dependencies (New Feature) New SDK New API Endpoints Upgrade Impact Because most of the changes are additive, the upgrade risks are minimal. Risk Mitigation Because configuration plan logic has been updated, there is a potential for unintentional changes/bugs to be introduced. […]

KB #1143: Upgrade Notes for Otter 1.7

Last Updated: February 12, 2019

Otter 1.7 is minor release with the following changes: Advanced Templating (New Feature) Enhanced LDAP directory (New Feature) New SDK New API Endpoints Upgrade Impact Because most of the changes are additive, the upgrade risks are minimal. Risk Mitigation Because configuration plan logic has been updated, there is a potential for unintentional changes/bugs to be […]

KB #1154: Upgrade Notes for Otter 2.0

Last Updated: February 12, 2019

Otter 2.0 is major release with the following changes: Automatic Agent Updates (new feature) Installed Universal Packages shown in Packages Tab (new feature) Plan & Asset Versioning (new feature) Updated UI Custom Extensions should use Inedo.SDK instead of Inedo.Otter.SDK Breaking Changes The changes from Otter v1 to Otter v2 are minimal; however there are breaking […]

KB #1162: Upgrade Notes for Otter 2.1

Last Updated: February 12, 2019

Otter 2.1 is minor release with the following changes: Pipeline Raft Support Breaking Changes There are no breaking changes in this release. While there are no expected breaking changes, the context behavior of Orchestration Jobs has been specified as of v2.1 where previously it was undefined, and it is possible that executing plans with via […]

KB #1111: Upgrade Notes for ProGet v4

Last Updated: February 12, 2019

Upgrading from a v2 or v3? This document is for informational purposes only, and you should upgrade directly to v5; please see Upgrading from ProGet v2 and v3 first. Upgrading from a 4.x? You should upgrade to the latest v5. This article is a rollup of all upgrade notes from ProGet 4.0 through 4.8, and […]

KB #1150: Upgrade Notes for ProGet 5.0

Last Updated: February 12, 2019

ProGet 5.0 is a major release with the following changes: New UI (new feature) Webhooks (new feature) NuGet feeds support SemVer 2.0 Targets .NET Framework 4.5.2 (configuration change) New SDK Upgrade Impact Although this is a major release, the upgrade represents little risk for most users. Please see the Upgrade from v2 and v3 if […]

KB #1160: Upgrade Notes for ProGet 5.1

Last Updated: February 12, 2019

ProGet 5.1 is a minor release with the following changes: Support for Docker connectors Virtual packages New installer Shared configuration Upgrade Impact This is a minor release with new features and nontrivial bugfixes. Risk is minimal, but there is a higher chance of regression than with a maintenance release. Please see the Upgrade from v2 […]

KB #1064: Upgrading Agents for BuildMaster 4.0

Last Updated: February 12, 2019

This document only applies to users upgrading from BuildMaster v3, and is a companion to Upgrading from BuildMaster v3 and v4. 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: BuildMaster Agents now require .NET 4.0 instead of .NET […]