Enabling the Storage Redirection Interface

Setup and Configuration of Intel AMT > Configuration Settings > Redirection (SOL and Storage Redirection) > Use Cases > Enabling the Storage Redirection Interface

Enabling the Storage Redirection Interface

The following steps describe how to remotely enable the Storage Redirection interface.

1. Retrieve the instance of AMT_RedirectionService, where the “Name” key equals “Intel(r) AMT Redirection Service”.

2. Examine the value of the AMT_RedirectionService.EnabledState property.

• If the value is one of the following, the Storage Redirection interface is already enabled:

Value	Description
32769	Storage Redirection is enabled and SOL is disabled
32771	Storage Redirection and SOL are enabled

• If the value is one of the following, the Storage Redirection interface or the setting in the MEBx is disabled:

Value	Description
32768	Storage Redirection and SOL are disabled
32770	Storage Redirection is disabled and SOL is enabled

If the Storage Redirection interface is not already enabled, continue to step 3.

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

$redirectionServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_RedirectionService WHERE Name='Intel(r) AMT Redirection Service'")

$redirectionServiceInstance =$redirectionServiceRef.Get()

$enabledState =$redirectionServiceInstance.GetProperty("EnabledState")

3. Invoke AMT_RedirectionService.RequestStateChange with one of the following values:

If the EnabledState value is….	Use this value.	Description
32768 (Both Storage Redirection and SOL are disabled)	32769	Enable Storage Redirection and leave SOL disabled
32770 (Storage Redirection is disabled and SOL is enabled)	32771	Enable Storage Redirection and leave SOL enabled

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

# The $enabledState property returned from step 2, above.

if($enabledState -like "32768")

{

$requestedState ="32769"

}

elseif($enabledState -like "32770")

{

$requestedState ="32771"

}

$redirectionServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_RedirectionService WHERE Name='Intel(r) AMT Redirection Service'")

$inputObject =$redirectionServiceRef.CreateMethodInput("RequestStateChange")

$inputObject.SetProperty("RequestedState",$requestedState)

$outputObject =$redirectionServiceRef.InvokeMethod($inputObject)

$returnValue =$outputObject.GetProperty("ReturnValue")

4. Repeat steps 1 through 2 to check if the EnabledState property has changed to the value you sent in the RequestStateChange method:

• If the value has changed, the Storage Redirection interface is now enabled.

•If the value has NOT changed this means that the Storage Redirection interface setting in the MEBx is disabled. After the Storage Redirection interface is physically enabled in the MEBx menu, the value of the EnabledState property will automatically change to the value you sent in the RequestStateChange method, and the Storage Redirection interface will be enabled.

Note:

If this flow is used to disable Storage Redirection (changing either to 32768 or 32770), and there is currently an Storage Redirection session and KVM is enabled, only future Storage Redirection sessions will be blocked. The current session will remain open until it is terminated by some other means.

If KVM is not enabled, changing to 32768 will shut down a current session, as this will shut down the redirection listener. Changing to 32770 will not shut down the listener and the current Storage Redirection session. Only future sessions will be blocked.

Instance Diagram

Not applicable

Classes Used in This Flow

• AMT_RedirectionService

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.