protected override void ProcessRecord()
{
var logger = new PSLogger(Host);
var zipFolder = Path.GetDirectoryName(MyInvocation.MyCommand.Module.Path);
var installer = new UnattendServiceControlInstaller(logger, zipFolder);
foreach (var name in Name)
{
var options = new ServiceControlUpgradeOptions {
AuditRetentionPeriod = AuditRetentionPeriod, ErrorRetentionPeriod = ErrorRetentionPeriod, OverrideEnableErrorForwarding = ForwardErrorMessages, SkipQueueCreation = SkipQueueCreation
};
var instance = InstanceFinder.FindServiceControlInstance(name);
if (instance == null)
{
WriteWarning($"No action taken. An instance called {name} was not found");
break;
}
options.OverrideEnableErrorForwarding = ForwardErrorMessages;
// Migrate Value
if (!options.AuditRetentionPeriod.HasValue)
{
if (instance.AppConfig.AppSettingExists(SettingsList.HoursToKeepMessagesBeforeExpiring.Name))
{
var i = instance.AppConfig.Read(SettingsList.HoursToKeepMessagesBeforeExpiring.Name, -1);
if (i != -1)
{
options.AuditRetentionPeriod = TimeSpan.FromHours(i);
}
}
}
if (!options.OverrideEnableErrorForwarding.HasValue & !instance.AppConfig.AppSettingExists(SettingsList.ForwardErrorMessages.Name))
{
ThrowTerminatingError(new ErrorRecord(new Exception($"Upgrade of {instance.Name} aborted. ForwardErrorMessages parameter must be set to true or false because the configuration file has no setting for ForwardErrorMessages. This setting is mandatory as of version 1.12"), "UpgradeFailure", ErrorCategory.InvalidArgument, null));
}
if (!options.ErrorRetentionPeriod.HasValue & !instance.AppConfig.AppSettingExists(SettingsList.ErrorRetentionPeriod.Name))
{
ThrowTerminatingError(new ErrorRecord(new Exception($"Upgrade of {instance.Name} aborted. ErrorRetentionPeriod parameter must be set to timespan because the configuration file has no setting for ErrorRetentionPeriod. This setting is mandatory as of version 1.13"), "UpgradeFailure", ErrorCategory.InvalidArgument, null));
}
if (!options.AuditRetentionPeriod.HasValue & !instance.AppConfig.AppSettingExists(SettingsList.AuditRetentionPeriod.Name))
{
ThrowTerminatingError(new ErrorRecord(new Exception($"Upgrade of {instance.Name} aborted. AuditRetentionPeriod parameter must be set to timespan because the configuration file has no setting for AuditRetentionPeriod. This setting is mandatory as of version 1.13"), "UpgradeFailure", ErrorCategory.InvalidArgument, null));
}
if (!installer.Upgrade(instance, options))
{
ThrowTerminatingError(new ErrorRecord(new Exception($"Upgrade of {instance.Name} failed"), "UpgradeFailure", ErrorCategory.InvalidResult, null));
}
}
}
public void UpgradeInstance()
{
var installer = new UnattendServiceControlInstaller(new TestLogger(), DeploymentCache);
foreach (var instance in InstanceFinder.ServiceControlInstances().Where(p => p.Name.StartsWith("Test.ServiceControl", StringComparison.OrdinalIgnoreCase)))
{
installer.Upgrade(instance, new ServiceControlUpgradeOptions {
AuditRetentionPeriod = TimeSpan.FromDays(30), ErrorRetentionPeriod = TimeSpan.FromDays(15), OverrideEnableErrorForwarding = true
});
}
}
void PerformUpgrade(ServiceControlInstance instance, UnattendServiceControlInstaller installer)
{
var options = new ServiceControlUpgradeOptions
{
SkipQueueCreation = SkipQueueCreation
};
options.UpgradeInfo = UpgradeControl.GetUpgradeInfoForTargetVersion(installer.ZipInfo.Version, instance.Version);
if (!installer.Upgrade(instance, options))
{
ThrowTerminatingError(new ErrorRecord(new Exception($"Upgrade of {instance.Name} failed"), "UpgradeFailure", ErrorCategory.InvalidResult, null));
}
}
static void UpgradeInstances(Session session, ServiceControlZipInfo zipInfo, MSILogger logger, UnattendServiceControlInstaller unattendedInstaller)
{
var options = new ServiceControlUpgradeOptions();
var upgradeInstancesPropertyValue = session["UPGRADEINSTANCES"];
if (string.IsNullOrWhiteSpace(upgradeInstancesPropertyValue))
{
return;
}
upgradeInstancesPropertyValue = upgradeInstancesPropertyValue.Trim();
var forwardErrorMessagesPropertyValue = session["FORWARDERRORMESSAGES"];
try
{
options.OverrideEnableErrorForwarding = bool.Parse(forwardErrorMessagesPropertyValue);
}
catch
{
options.OverrideEnableErrorForwarding = null;
}
var auditRetentionPeriodPropertyValue = session["AUDITRETENTIONPERIOD"];
try
{
options.AuditRetentionPeriod = TimeSpan.Parse(auditRetentionPeriodPropertyValue);
}
catch
{
options.AuditRetentionPeriod = null;
}
var errorRetentionPeriodPropertyValue = session["ERRORRETENTIONPERIOD"];
try
{
options.ErrorRetentionPeriod = TimeSpan.Parse(errorRetentionPeriodPropertyValue);
}
catch
{
options.ErrorRetentionPeriod = null;
}
var confirmDatabaseHasBeenBackedUpValue = session["CONFIRMDATABASEHASBEENBACKEDUP"];
try
{
options.ConfirmDatabaseHasBeenBackedUp = bool.Parse(confirmDatabaseHasBeenBackedUpValue);
}
catch
{
options.ConfirmDatabaseHasBeenBackedUp = false;
}
var allowLargeDatabaseUpgradeValue = session["ALLOWLARGEDATABASEUPGRADE"];
try
{
options.AllowLargeDatabaseUpdate = bool.Parse(allowLargeDatabaseUpgradeValue);
}
catch
{
options.ConfirmDatabaseHasBeenBackedUp = false;
}
//determine what to upgrade
var instancesToUpgrade = new List <ServiceControlInstance>();
if (upgradeInstancesPropertyValue.Equals("*", StringComparison.OrdinalIgnoreCase) || upgradeInstancesPropertyValue.Equals("ALL", StringComparison.OrdinalIgnoreCase))
{
instancesToUpgrade.AddRange(InstanceFinder.ServiceControlInstances());
}
else
{
var candidates = upgradeInstancesPropertyValue.Replace(" ", String.Empty).Split(",".ToCharArray(), StringSplitOptions.RemoveEmptyEntries);
instancesToUpgrade.AddRange(InstanceFinder.ServiceControlInstances().Where(instance => candidates.Contains(instance.Name, StringComparer.OrdinalIgnoreCase)));
}
// do upgrades
foreach (var instance in instancesToUpgrade)
{
if (zipInfo.Version > instance.Version)
{
var upgradeInfo = UpgradeControl.GetUpgradeInfoForTargetVersion(zipInfo.Version, instance.Version);
options.UpgradeInfo = upgradeInfo;
if (!instance.AppConfig.AppSettingExists(SettingsList.ForwardErrorMessages.Name) & !options.OverrideEnableErrorForwarding.Value)
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. FORWARDERRORMESSAGES MSI parameter was required because appsettings needed a value for '{SettingsList.ForwardErrorMessages.Name}'");
continue;
}
if (!options.AuditRetentionPeriod.HasValue)
{
if (!instance.AppConfig.AppSettingExists(SettingsList.AuditRetentionPeriod.Name))
{
//Try migration first
if (instance.AppConfig.AppSettingExists(SettingsList.HoursToKeepMessagesBeforeExpiring.Name))
{
var i = instance.AppConfig.Read(SettingsList.HoursToKeepMessagesBeforeExpiring.Name, -1);
if (i > 0)
{
options.AuditRetentionPeriod = TimeSpan.FromHours(i);
}
}
else
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. AUDITRETENTIONPERIOD MSI parameter was required because appsettings needed a value for '{SettingsList.AuditRetentionPeriod.Name}'");
continue;
}
}
}
if (!instance.AppConfig.AppSettingExists(SettingsList.ErrorRetentionPeriod.Name) & !options.ErrorRetentionPeriod.HasValue)
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. ERRORRETENTIONPERIOD MSI parameter was required because appsettings needed a value for '{SettingsList.ErrorRetentionPeriod.Name}'");
continue;
}
if (upgradeInfo.DataBaseUpdate) //Database is being updated -> recommend DB backup
{
if (!options.ConfirmDatabaseHasBeenBackedUp)
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. This upgrade requires a database update and the database should be backed up prior to updating. CONFIRMDATABASEHASBEENBACKEDUP MSI parameter was required to allow the database upgrade.'");
continue;
}
var dbSize = instance.GetDatabaseSizeInGb();
if (dbSize >= 100) // 100GB
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. Upgrade requires a database update and the database being upgraded is {dbSize:N0} GB. " +
"Migrating this much data could take a long time and ServiceControl will be stopped for that entire duration. It is recommended that you consider one of the other upgrade approaches instead. " +
"ALLOWLARGEDATABASEUPGRADE MSI parameter can be used to allow an unattended database upgrade.'");
continue;
}
}
if (!unattendedInstaller.Upgrade(instance, options))
{
logger.Warn($"Failed to upgrade {instance.Name} to {zipInfo.Version}");
}
}
}
}
static void UpgradeInstances(Session session, ServiceControlZipInfo zipInfo, MSILogger logger, UnattendServiceControlInstaller unattendedInstaller)
{
var options = new ServiceControlUpgradeOptions();
var upgradeInstancesPropertyValue = session["UPGRADEINSTANCES"];
if (string.IsNullOrWhiteSpace(upgradeInstancesPropertyValue))
{
return;
}
upgradeInstancesPropertyValue = upgradeInstancesPropertyValue.Trim();
var forwardErrorMessagesPropertyValue = session["FORWARDERRORMESSAGES"];
try
{
options.OverrideEnableErrorForwarding = bool.Parse(forwardErrorMessagesPropertyValue);
}
catch
{
options.OverrideEnableErrorForwarding = null;
}
var auditRetentionPeriodPropertyValue = session["AUDITRETENTIONPERIOD"];
try
{
options.AuditRetentionPeriod = TimeSpan.Parse(auditRetentionPeriodPropertyValue);
}
catch
{
options.AuditRetentionPeriod = null;
}
var errorRetentionPeriodPropertyValue = session["ERRORRETENTIONPERIOD"];
try
{
options.ErrorRetentionPeriod = TimeSpan.Parse(errorRetentionPeriodPropertyValue);
}
catch
{
options.ErrorRetentionPeriod = null;
}
//determine what to upgrade
var instancesToUpgrade = new List <ServiceControlInstance>();
if (upgradeInstancesPropertyValue.Equals("*", StringComparison.OrdinalIgnoreCase) || upgradeInstancesPropertyValue.Equals("ALL", StringComparison.OrdinalIgnoreCase))
{
instancesToUpgrade.AddRange(InstanceFinder.ServiceControlInstances());
}
else
{
var candidates = upgradeInstancesPropertyValue.Replace(" ", String.Empty).Split(",".ToCharArray(), StringSplitOptions.RemoveEmptyEntries);
instancesToUpgrade.AddRange(InstanceFinder.ServiceControlInstances().Where(instance => candidates.Contains(instance.Name, StringComparer.OrdinalIgnoreCase)));
}
// do upgrades
foreach (var instance in instancesToUpgrade)
{
if (zipInfo.Version > instance.Version)
{
if (!instance.AppConfig.AppSettingExists(SettingsList.ForwardErrorMessages.Name) & !options.OverrideEnableErrorForwarding.Value)
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. FORWARDERRORMESSAGES MSI parameter was required because appsettings needed a value for '{SettingsList.ForwardErrorMessages.Name}'");
continue;
}
if (!options.AuditRetentionPeriod.HasValue)
{
if (!instance.AppConfig.AppSettingExists(SettingsList.AuditRetentionPeriod.Name))
{
//Try migration first
if (instance.AppConfig.AppSettingExists(SettingsList.HoursToKeepMessagesBeforeExpiring.Name))
{
var i = instance.AppConfig.Read(SettingsList.HoursToKeepMessagesBeforeExpiring.Name, -1);
if (i > 0)
{
options.AuditRetentionPeriod = TimeSpan.FromHours(i);
}
}
else
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. AUDITRETENTIONPERIOD MSI parameter was required because appsettings needed a value for '{SettingsList.AuditRetentionPeriod.Name}'");
continue;
}
}
}
if (!instance.AppConfig.AppSettingExists(SettingsList.ErrorRetentionPeriod.Name) & !options.ErrorRetentionPeriod.HasValue)
{
logger.Warn($"Unattend upgrade {instance.Name} to {zipInfo.Version} not attempted. ERRORRETENTIONPERIOD MSI parameter was required because appsettings needed a value for '{SettingsList.ErrorRetentionPeriod.Name}'");
continue;
}
if (!unattendedInstaller.Upgrade(instance, options))
{
logger.Warn($"Failed to upgrade {instance.Name} to {zipInfo.Version}");
}
}
}
}