Manually Upgrade an Existing Installation

Upgrading an Inedo product installation from an existing installation can be performed by following this installation guide, except it should be much simpler and quicker than the initial installation since the infrastructure is already in place.

This guide may also be used to upgrade an instance that was installed by the installer, but once that has occurred, this manual process must be used going forward.

1. Backup the existing instance

Before upgrading your Inedo product, please make sure to backup your instance. This will allow you to rollback to your previous version in case any issues are encountered during the upgrade process. To backup the instance, refer to our backing up and restoring guide.

2. Stop services

Before upgrading your Inedo product, the existing instance must be taken offline. Ensure that the application pool and Windows Service are both stopped.

Here is an example PowerShell script that performs these operations:

&"C:\Windows\System32\inetsrv\appcmd.exe" stop apppool «Inedo-product»
Stop-Service INEDO«Inedo-product»SVC

3. Copy installation package contents

For the most part, an upgrade is an "XCOPY deployment" of files from the manual installation package. Copy all of the contents of each of the following into the specified target directory while carefully analyzing the differences in configuration files as noted:

BuildMaster

While v6.0.7 and later versions of BuildMaster should not store data in these configuration files, existing installations might contain relevant data such as connection strings that should ultimately be migrated to the BuildMaster Configuration File and removed from the *_appSettings.config file.

ProGet

While v5.1.0 and later versions of ProGet should not store data in these configuration files, existing installations might contain relevant data such as connection strings that should ultimately be migrated to the ProGet Configuration File and removed from the *_appSettings.config file.

Otter

4. Update database schema

Because the tool used to update the database schema is aware of previous scripts that have run, this process is the same as the initial installation process. See the Database Installation from the manual installation guide to perform this step using the existing connection string specified in the Inedo product configuration file. An additional benefit of being aware of previous scripts that have run is that the inedosql.exe command can be applied to a database copy or backup to test the SQL upgrade before running it against a production database.
• BuildMaster Configuration File
• ProGet Configuration File
• Otter Configuration File

5. Start services

Once all files are copied and the database is updated, the services can be started to bring your Inedo product back online.

Here is an example PowerShell script that performs these operations for ProGet:

&"C:\Windows\System32\inetsrv\appcmd.exe" start apppool «Inedo-product»
Start-Service INEDO«Inedo-product»VC