Install lifecycle
Understand how build installations are managed and deployed across your servers.
Read time 2 minutesLast updated 3 days ago
The install lifecycle is the series of states or statuses a server transitions through when you roll out a release for a build. When you update a build and roll out a new release, the servers using the build go through the install lifecycle. There are six possible states in the install lifecycle: allocated, deallocated, installing, offline, online, and ready, many of which overlap with the server lifecycle.
- A server is in an allocated state when it’s online and allocated.
- A server is in a deallocated state when it’s online and not allocated. This state doesn't appear in the Unity Dashboard.
- A server is in an installing state when it’s applying the release.
- A server is in an offline state when it’s finished shutting down.
- A server is in an online state when it’s online but not yet ready to accept allocations.
- A server is in a ready state when it’s online and has marked itself as ready to accept allocations..
Progressive rollout lifecycle
A progressive rollout is a method of deploying a build update where you update servers only when they're empty. If there are any players connected to a server, Multiplay Hosting performs the update on servers as soon as they're available. If you release an update as a progressive rollout, Multiplay Hosting waits for you to deallocate each server before triggering the installation. As a result, the state flow of a server during a progressive rollout is allocated → deallocated → installing → offline → online.
A flowchart showing the lifecycle of a progressive rollout, cycling from allocated to deallocated to installing to offline to online to ready, back to allocated.
Note
The deallocated state exists but doesn't appear in the Unity Dashboard.
Forced rollout lifecycle
A forced rollout is a method of deploying a build update where you force servers to update even if there are players connected. If players are connected when you start a forced rollout, Multiplay Hosting stops the server, breaking the connection with those players. If you release an update as a forced rollout, Multiplay Hosting triggers the installation irrespective of the server’s allocation status. As a result, the state flow of a server during a forced rollout is allocated → installing → offline → online.
A flowchart showing the lifecycle of a forced rollout, cycling from allocated to installing to offline to online to ready, back to allocated.