Enabling the SOL Interface

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

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

• 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.