Use this method to return a JNLP file or URL to open a remote-control session to a specific managed server.
For System x servers, this method returns a JNLP file that you can open using Java Web Start.
For ThinkSystem servers, this method returns a URL that you can use to launch the HTML5-based remote control page.
For ThinkServer servers:
Each remote control session can managed only one ThinkServer server.
This method returns a JNLP file that you can open using Java Web Start.
For ThinkServer servers, each remote control session can managed only one ThinkServer server.
Authentication with user name and password is required.
GET https://{management_server_IP}/remoteaccess/remoteControl
Parameters | Required / Optional | Description |
---|---|---|
uuid={uuid} | Optional | UUID of server to which to open the remote-control
session. To obtain the node UUID, use the GET /chassis or GET /nodes method. If a UIUD not specified, the remote-control session opens untargeted. Note: Untargeted sessions
are not supported for ThinkServer and ThinkSystem servers.
|
userMode={mode} | Optional | (ThinkSystem servers only) User session mode. This can be one
of the following values.
|
GET https://192.0.2.0/remoteaccess/remoteControl?uuid=425AF828DF7D11D4B0F8E76767BBBBBB
GET https://192.0.2.0/remoteaccess/remoteControl?uuid=425AF828DF7D11D4B0F8E76767BBBBBB&userMode=singleUser
None
Code | Description | Comments |
---|---|---|
200 | OK | The request completed successfully. |
409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
For System x and ThinkServer servers, a JNLP file of type application/x-java-jnlp-file is returned.
For ThinkSystem servers, the following JSON is returned.
Field | Type | Description | ||
---|---|---|---|---|
url | String | Link to open a remote-control session |
{
"url": "https://192.0.2.10"
}
<?xml version="1.0" encoding="UTF-8"?>
<jnlp spec="6.0+" codebase="https://drsbandol.labs.lenovo.com:443/remoteaccess/remoteControl/"
href="remotecontrol.jnlp?loggedInUser=USERID&userPassword=G5Dl05zEEarfIN204L9sjA==">
<information>
<title>Remote Control - drsbandol.labs.lenovo.com<title>
<vendor>Lenovo</vendor>
<icon href="../console/RemoteConsole.ico" width="32" height="32" kind="shortcut" />
<icon href="../console/RemoteConsole.ico" width="64" height="64" kind="default" />
</information>
<security>
<all-permissions/>
</security>
<update check="always" policy="always" />
<resources> <j2se version="1.6+ 1.7+" href="http://java.sun.com/products/autodl/j2se"
max-heap-size="768m"/>
<jar href="../console/lxcarpz-1.0.jar" main="true" download="eager"/>
<jar href="../console/lxcarpz-mri-1.0.jar" main="true" download="eager"/>
<jar href="../console/lib/wink-json4j-1.1.2-incubating.jar" download="lazy"/>
<extension name="rplib" href="rplib.jnlp?serverName=drsbandol.labs.lenovo.com&serverPort=443"/>
</resources>
<resources os="Windows"> <nativelib href="../console/lib/remotedriveWin-1.0.jar"/>
<nativelib href="../console/lib/remotedriveWin64-1.0.jar"/>
</resources>
<application-desc
name="Remote Control - drsbandol.labs.lenovo.com"
main-class="com.lenovo.lxca.rpz.launcher.RemoteControl">
<argument>loggedInUser=USERID</argument>
<argument>userPassword=<<ENCRYPTED_PASS>>/argument>
<argument>serverName=drsbandol.labs.lenovo.com</argument>
<argument>serverPort=443</argument>
<argument>cryptoMode=SSL</argument>
</application-desc>
</jnlp>