2.5.3.1 Create and Delete a Media Pool
Goal
Create and delete a media pool.
Context of Use
The administrator is setting up a storage server, and in this process, the administrator needs to create and delete a media pool.
Actors
Admin Tool: A Microsoft Management Console (MMC) component, which is used by the administrator to configure the storage on the server.
Admin Client: The Admin Client is the primary actor. The Admin Client is code that is running on the administrator's computer. The Admin Client implements client-side protocol components and consumes the storage services that are offered by the storage server. The Admin Client's interest is to correctly interpret, execute, and display the results of the commands that are issued by administrator.
RSMP service: The RSMP service is the server-side implementation of the protocols specified in [MS-RSMP].
Stakeholders
Administrator: The administrator is the person who administers the storage. The administrator is interested in organizing the storage and setting access rights. The administrator is external to the Storage Services protocols and interacts with the Storage Services protocols through the Admin Client.
Preconditions
The administrator has configured the RSMP service on the storage server and has the appropriate access privileges to the removable media pool.
Main success scenario
Trigger: The administrator requests to set up a media library by using the Admin Tool.
The Admin Tool requests that the Admin Client establish a communication channel to the RSMP service of the Storage Services protocols.
The Admin Client contacts the RSMP service to create a media pool by using the INtmsMediaServices1::CreateNtmsMediaPoolW method, as described in [MS-RSMP] section 3.2.5.2.2.10.
The RSMP service creates the requested media pool.
The administrator requests to delete the media library by using the Admin Tool.
The Admin Client contacts the RSMP service to delete a media pool by using the INtmsMediaServices1::DeleteNtmsMediaPool method, as described in [MS-RSMP] section 3.2.5.2.2.14.
The RSMP service deletes the requested media pool.
Postcondition
The required creation and the deletion of the media pool have finished successfully.
Extension
If the communication channel for the Removable Storage Manager (RSM) Remote Protocol cannot be established, or it becomes disconnected, the Admin Client attempts to establish a connection multiple times until it fails. The media pool creation or deletion depends on when the connection failed.