An operator can use the essensys Platform to decommission an occupier; ending the occupier's occupancies (leased spaces), contracts, and services across all of their sites. Effectively this action:

Ends all of their space occupancies (leases).
Stops their services; ending their consumption of services and stopping any future billing.
Deprovisions their telephony; preventing them from making or receiving calls on their phone numbers and putting those numbers into a temporary cooling off state.
Deallocates their Switch/floor ports.
Deletes details of all of their users; including closing their user's Wi-Fi accounts, and ending their access to essensys occupier experience.
Deletes details of all of their Wi-Fi devices at their sites.
Deprovisions their network.

Note: Some historical data, such as the call charges reports for past months, are retained for future reference. For more information, see What happens to decommissioned data?

Decommissioning an occupier

Important: Are you sure you want to decommission your occupier across all of their sites? This action is not reversible. For details about the rules and effects of decommissioning, see What happens to decommissioned data?

Before you begin

If your occupier has telephony services that are managed by essensys, you need to ensure they are logged out of their handsets prior to decommissioning:

If their phone numbers are logged in to digital devices (such as Polycom Flex), the Logout handset option is enabled on the Occupiers > Telephony page. Click to logout remotely.
If their phone numbers are logged in to non-digital devices, this option is not enabled. You need to log their numbers out of the handsets manually from the handset itself.

If your occupier has services that are currently reporting updates in the Occupiers > Services page, they cannot be decommissioned. Reported updates include:

An Update in progress warning. In this case, you need to wait for the update to complete before you can decommission the occupier.
Tip: Click Refresh to see if the update has completed. If you are concerned that the update is in progress for too long, you should contact us.
A The service could not be updated error. In this case, you need to raise a case to get this error cleared before you can decommission the occupier.
Tip: Click Create support case to raise a case with essensys. Note that the details of the action that failed are visible in the support case description.

Access the Occupier config page

The decommissioning process is run from the Occupier config page. To access the page:

In the main menu, click Occupiers.
Select the occupier you want to decommission.
Click the Occupier config tab.

The Occupier config page contains basic details relating to the occupier across all of their sites.

Decommission the occupier

From the top-right of the Occupier config page, click Decommission occupier.

Important: If you cannot see this option, it is because you do not have appropriate site permissions to be able to decommission this occupier. For more information, see When is decommission allowed?
The Decommission occupier dialog box opens. This dialog box provides detailed information about the effect of decommissioning the occupier; essensys recommends that you read this information in full before you continue.
If you are sure that you want to decommission the occupier:
1. Copy the occupier name into the Decommission text field.
  Tip: The occupier name is shown in 'single quotes' above the field, you can copy and paste it to save time.
2. Select the I understand that decommissioning is irreversible check box.
  The Decommission button is enabled, indicating that you may continue.
3. Click Decommission.
  This dialog box closes, and a confirmation message opens.
Click OK.
The decommissioning process begins.

The decommissioning process takes approximately 60 minutes to complete. While the process is in progress, the occupier is flagged as decommission pending.

Tip: To check the status of the decommission, you can filter the occupier list to show occupiers that are pending decommission, where decommissioning failed, or where the decommission is complete (decommissioned). For more information, see Decommission status.

What next?

If your occupier was successfully decommissioned, there is no further action that you need to take.
If the decommission failed, you should raise a case with essensys to investigate the problem. For more information, see Raise a case (decommission failed).
If the decommission has been pending for too long, you should investigate the problem and raise a case if necessary. For more information, see Investigate long-running pending tasks.

Additional tasks

Raise a case (decommission failed)

If the decommission process fails, you can raise a case with essensys to investigate and complete the decommission process.

From the top-right of the Occupier config page, click Create support case.

The New support case dialog box opens. Note that the subject of the case is "Failed decommission".
Click Submit.

The case is raised with essensys. You can monitor the case in the Operations > Support page.

Investigate long-running pending tasks (decommission pending)

If the decommission process is taking much longer than the expected time to complete, you can investigate and raise a ticket against any pending task that is associated with the decommission operation:

Open the Operations > Tasks page.
Filter the tasks list to show:
1. Tasks from the decommission date.
2. Tasks associated with the occupier you are decommissioning.
3. Tasks in the pending state.
There will be tasks associated with each of the occupier's sites. Identify all tasks that are stuck in pending.
For each pending task that has been running for too long, hover over the row and click Create support case to raise a case.
For more information about raising support cases, see Monitor tasks.

The case is raised with essensys. You can monitor the case in the Operations > Support page.

Decommission reference

Decommission status

An occupier's decommission status is displayed:

In the top-right of any Occupiers page, where the occupier has been or is being decommissioned.
In the occupiers list, where occupiers can be filtered by their current decommission status.

Status	Definition
Active occupiers	These occupiers are not currently decommissioned. This includes: Occupiers that are in use and have not been decommissioned. Occupiers for whom the decommissioning process is underway (decommission pending). Occupiers for whom the decommissioning process has failed (decommission failed).
Decommissioned	These occupiers have been successfully decommissioned across all of their sites. For more information about the effect of decommissioning, see Decommissioning effects.
Decommission pending	These occupiers are currently in the process of being decommissioned. Once the decommission process is started, and the occupier is set into this state, you cannot edit their details.
Decommission failed	The decommission process failed for this occupier. Where the occupier is in this state, you can raise a case for investigation with essensys. For details, see Raise a case.
Decommission scheduled	Coming soon

Decommissioning Effects

When is decommission allowed?

You cannot decommission an occupier when any of the following are true:

The occupier has a contract with a start date of today.
The occupier currently has one or more logged in telephony handsets that cannot be logged out remotely. Digital device types will be logged out remotely, but you need to manually log out of any other devices.
The occupier has services that are either in a failed state or that are currently being updated.
The occupier has already been decommissioned, or is currently in the decommission pending or decommission failed state.
The occupier has contracts (either live or completed) at sites where you are not an admin (where you do not have site access).
Example: If you are an essensys Platform admin at the New York site, but the occupier has occupancies in both New York and London, you will not be offered the option to decommission the occupier.

What happens to decommissioned data?

The following table describes what happens to the different types of data when the decommission process runs (current data), and then what remains visible to operators after the decommission is complete (historical data).

	Current Data	Historical Data
Contracts	Any active contracts and associated occupancies end, and any upcoming (scheduled) contracts are discarded. Notes: If an active contract has a start date of today, you can't decommission the occupier. When an active contract ends, its status is set to COMPLETED with date yesterday.	You can view historical contracts and associated lease information for decommissioned occupiers in the essensys platform. You cannot: View details of changes that were scheduled when the occupier was decommissioned. Create new contracts or leases for the decommissioned occupier.
Services	Active services are deprovisioned and set to inactive, and any services that were scheduled to start or to change quantity in future are deleted.	You can view historical services in the essensys platform. You cannot: View details of services that were scheduled when the occupier was decommissioned. Add new services for the decommissioned occupier. Note: The service information does not include an end date.
Users	Users are deleted from the essensys platform. Any phone numbers that were assigned to the user are unassigned, and the user's Wi-Fi and user accounts are cancelled. Note: The effect of cancelling Wi-Fi and user accounts is that the user is no longer able to access Wi-Fi Secure at any site, nor are they able to access their user portal or mobile app.	You cannot view details of historical users.
Wi-Fi devices	Shared Wi-Fi devices (printers, AV equipment, and so on) are deleted from the essensys platform. Note: The effect of deleting these devices is that they can no longer connect to the Wi-Fi device network.	You cannot view details of historical Wi-Fi devices.
Telephony	Any phone numbers that were allocated to the occupier, including the main number, are deactivated and deallocated. Tip: After a cool down period, the numbers are made available for allocation to other occupiers at the same site.	You cannot view details of historical telephony allocations or assignments.
Call charges	No new call charges are created.	You can view call charges for past months. You can also view historical Bandwidth and Voice reports in the Operations > Billing pages.
Network info	The occupier's network is deprovisioned.	You cannot view historical network information.
Occupier config	You can no longer edit the occupier config.	You can view the decommissioned occupier's basic details.