CollapseAll image

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

SDK Sample

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

 

See Also:

   Detailed Description

Copyright © 2006-2022, Intel Corporation. All rights reserved.