/// <summary>
/// Update nPod firmware to specified package
/// </summary>
/// <param name="nPodGuid">
/// The unique identifier of the nPod to update
/// </param>
/// <param name="packageName">
/// The package name to install
/// </param>
/// <param name="scheduleAt">
/// Allows scheduling the installation of a package at the specified
/// date and time. If omitted, the package will be installed immediately
/// </param>
/// <param name="ignoreWarnings">
/// If specified warnings that are discovered during the update
/// pre-check are ignored (not recommended). If omitted or set to
/// <c>false</c> will cause the update to stop.
/// </param>
/// <returns></returns>
public bool UpdateNPodFirmware(
Guid nPodGuid,
string packageName,
DateTime?scheduleAt = null,
bool ignoreWarnings = false)
{
Issues issues = RunUpdatePreCheck(nPodGuid, packageName);
issues.AssertNoIssues(ignoreWarnings);
// setup parameters
GraphQLParameters parameters = new GraphQLParameters();
parameters.Add(@"podUID", nPodGuid, false);
parameters.Add(@"packageName", packageName, false);
parameters.Add(@"scheduled", scheduleAt, true);
TokenResponse tokenResponse = RunMutation <TokenResponse>(
@"updatePodFirmware",
parameters
);
return(DeliverToken(tokenResponse));
}
/// <summary>
/// Allows creation of a new nPod
///
/// <para>
/// A nPod is a collection of network-connected application servers
/// with SPUs installed that form an application cluster. Together, the
/// SPUs in a nPod serve shared or local storage to the servers in the
/// application cluster, e.g.a hypervisor cluster, container platform,
/// or clustered bare metal application.
/// </para>
/// </summary>
/// <param name="name">
/// Name of the new nPod
/// </param>
/// <param name="nPodGroupGuid">
/// The unique identifier of the nPod group this nPod will be added to
/// </param>
/// <param name="nPodSpuInputs">
/// List of SPU configuration information that will be used in the new
/// nPod
/// </param>
/// <param name="templateGuid">
/// The unique identifier of the nPod template to use for the new nPod
/// </param>
/// <param name="note">
/// An optional note for the new nPod
/// </param>
/// <param name="timezone">
/// The timezone to be configured for all SPUs in the nPod
/// </param>
/// <param name="ignoreWarnings">
/// If specified and set to <c>true</c> the nPod creation will proceed
/// even if nebulon ON reports warnings. It is advised to not ignore
/// warnings. Consequently, the default behavior is that the nPod
/// creation will fail when nebulon ON reports validation errors.
/// </param>
/// <returns>The new nPod</returns>
public NPod CreateNPod(
string name,
Guid nPodGroupGuid,
NPodSpuInput[] nPodSpuInputs,
Guid templateGuid,
string note,
string timezone,
bool ignoreWarnings)
{
// check for potential issues that nebulon ON predicts
Issues issues = GetNewNPodIssues(nPodSpuInputs);
issues.AssertNoIssues(ignoreWarnings);
CreateNPodInput input = new CreateNPodInput();
input.Name = name;
input.NPodGroupGuid = nPodGroupGuid;
input.Spus = nPodSpuInputs;
input.NPodTemplateGuid = templateGuid;
input.Note = note;
input.Timezone = timezone;
// setup parameters for nPod creation
GraphQLParameters parameters = new GraphQLParameters();
parameters.Add("input", input, true);
// make the request and deliver token
TokenResponse tokenResponse = RunMutation <TokenResponse>(
@"createNPod",
parameters
);
RecipeRecordIdentifier identifier = DeliverTokenV2(tokenResponse);
if (identifier == null)
{
throw new Exception("Uncomprehensive information returned from server");
}
// wait for recipe completion
DateTime start = DateTime.UtcNow;
// recipe filter
NPodRecipeFilter filter = new NPodRecipeFilter();
filter.NPodGuid = identifier.NPodGuid;
filter.RecipeGuid = identifier.RecipeGuid;
while (true)
{
Thread.Sleep(5000);
// query for recipes
RecipeRecordList recipes = GetNPodRecipes(filter);
// if there is no record in the cloud wait a few more seconds
// this case should not exist. TODO: Remove in next version.
if (recipes.Items.Length == 0)
{
continue;
}
// based on the query there should be exactly one
RecipeRecord recipe = recipes.Items[0];
// execution failed
if (recipe.State == RecipeState.Failed)
{
string error = string.Concat("nPod creation failed", recipe.Status);
throw new Exception(error);
}
// execution completed
if (recipe.State == RecipeState.Completed)
{
NPodFilter nPodFilter = new NPodFilter();
nPodFilter.NPodGuid = new GuidFilter();
nPodFilter.NPodGuid.MustEqual = identifier.NPodGuid;
NPodList nPods = GetNebNPods(
PageInput.First,
nPodFilter,
null
);
return(nPods.Items[0]);
}
// still ongoing
double duration = (DateTime.UtcNow - start).TotalSeconds;
double timeRemaining = NPOD_CREATE_WAITTIME_SEC - duration;
if (timeRemaining <= 0)
{
throw new Exception("nPod creation timed out");
}
}
}