This chapter introduces the notion of operations and briefly describes sections dedicated to operations as well as operation specificities.
All actions performed on entities of the AirVantage Operating Portal generate operations.
Once it has been generated, an operation enters process phases characterized by proper statuses:
|INITIALIZING||The different tasks of the operation are being created.|
|SCHEDULED||The operation has been created with a scheduled process date and time.|
|IN PROGRESS||The operation is being processed. An operation is processed immediately after initialization.|
|FINISHED||The operation has been processed. Can end either in failure, in success, or in aborted, or in a mix of those 3, if the operation includes several tasks.|
Immadiately after an operation has been launched, and also when the status changes, a block rises at the bottom right of the page to confirm the change of status of the operation:
Operations can be reviewed in details in three dedicated Operations sections of the Inventory, Monitor and Develop activities, depending on whether they relate to an activity or another.
Operations are listed in similar tables for each activity (here, the Monitor activity), with their Type, Progress (i.e, status), Start time, End time and Creator:
Operations can be filtered using different criteria such as Type, Date, Entity, System, etc…
Operation details can be reviewed by clicking on an operation in the list. The content of the operation details is split into two parts: a first part containing all the general information relevant to the Operation itself, and a second part including information specific to each entity (System, Gateway, Subscription, Application, Alert, …) involved in the Operation.
A progress bar and a filter capability are also present in case of multi – entities operations, to give a high level progress information. The filter permits to easily spot an entity by searching in the search field, or filtering all entities for which operation failed or succeeded using State entry.
Clicking on the entity of interest in the list of involved entities will reveal additional details about progress of the operation for this selected entity. Details can be an ERROR, a WARNING or an INFO message.
An operation details is accessible from an URL formatted as: https://na.airvantage.net/operation?uid=
. If an operation is set to send an e-mail upon operation completion, this link is displayed in the body of the notification mail. This is useful to quicly check the operation status.
As Advanced settings, operations can be scheduled to be processed either:
Operations can also be set with a Timeout:
During communication with a device, the AirVantage waits for a reply from the device for a certain amount of time, usually few minutes (exact value depends on the type of the operation and on the protocol). In case there is no reply from the device, the operation ends in “timeout” error.
Labels can be applied on systems / subscriptions / applications or gateways via the operation results.
Before completing an action which will generate an operation (for example, change a label on the screenshot below), the action creator can choose to be notified upon operation completion by checking the Send notification when operation completed checkbox at the bottom of operation dialog boxes:
If you decide to be notified of the operation result, you will receive an email including all operation details.
An operation in status Initializing, Scheduled, or In Progress state can be aborted.
For operations implying communication with a remote system, the cancel of an operation may occur while the remote system is processing the request. In that case, the operation will still appear as cancelled, while the device will pursue the requested task.
An operation has failed and after a quick check you want to give it another chance? From the operation details screen, it is possible to retry an operation. The retry will be launched on all entities for which the previous operation has failed or been aborted. The parameters taken as entry will be the same as the previous operation. Same functionality is also available from the operations grid or operations notification popups.
Operations such as transfer gateway generate a request to partners or other users of the company, either as an e-mail or as a pending request notification, which is accessible from anywhere in the AirVantage Management Service:
Only users with the proper profile and rights can view pending request notifications.
Accepting or rejecting a request is quite simple. Just click on the mail icon at the top of any page, then on Accept or Reject. In some cases, you can also be asked to set parameters and/or send a reply to the request initiator (for instance in a request partnership operation):