CollapseAll image

Enabling the SOL Interface

The following steps describe how to remotely enable the SOL 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 SOL interface is already enabled:

Value

Description

32770

SOL is enabled and Storage Redirection is disabled

32771

SOL and Storage Redirection are enabled

   If the value is one of the following, the SOL interface or the setting in the MEBx is disabled:

Value

Description

32768

SOL and Storage Redirection are disabled

32769

SOL is disabled and Storage Redirection is enabled

 

If the SOL 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 SOL and Storage Redirection are disabled)

32770

Enable SOL and leave Storage Redirection disabled

32769 (SOL is disabled and Storage Redirection is enabled)

32771

Enable SOL and leave Storage Redirection 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 ="32770"

}

elseif($enabledState -like "32769")

{

    $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 SOL interface is now enabled.

   If the value has NOT changed this means that the SOL interface setting in the MEBx is disabled. After the SOL 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 SOL interface will be enabled.

 

 Note:

If this flow is used to disable SOL (changing either to 32768 or 32769), and there is currently an SOL session and KVM is enabled, only future SOL 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 32769 will not shut down the listener and the current SOL 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-2021, Intel Corporation. All rights reserved.