This extension point allows a plugin to register remote servers that will be launched from the client and run on a remote target system. In addition to the payload to run, the extension point specifies the launch command that will be used, and optional command to unpack the payload on the target systems, and a verification command to check that the environment on the target system is valid for execution of the server.
A human readable name for this remote server.
A unique identifier for this remote server.
Flag indicating if the server will be running continously until terminated or runs once to completion. Continuously running servers require a "success string" to indicate that they have successfully started operating.
The fully qualified name of the Java class extending <samp>org.eclipse.ptp.remote.launch.core.AbstractRemoteServerRunner</samp>.
Server payload. This will be copied from the plugin to the working directory on the remote machine prior to launch. The payload is cached on the remote machine and only copied if it is necessary.
The command used to launch the payload on the remote machine. The variable "${payload}" can be used to include the name of the payload (as specified in the "payload" attribute) in the launch command.
Optional command to unpack the payload prior to execution. The unpack command is only run when the payload is first copied to the server (and if re-copied subsequently). If the unpack fails, payload launch is aborted.
This will be used to specify a command to check the desired launch command is available on remote server
This attribute is used to specify a message which will be shown to the user if the launch command verification fails.
This will be used to specify the search pattern in the form of regular expression which will be used to verify the output of the command specified in the verifyLaunchCommand attribute.
This will be used to specify a command to check the unpack command is available on remote server
This attribute is used to specify message which will be shown to the user if the unpack command verification fails.
This will be used to specify the search pattern in the form of regular expression which will be used to verify the output of the command specified in the verifyUnpackCommand attribute.
Used to override the settings of an existing extension. For example, this could be used to change the launch command to specify a different path.
The ID of the server that this extension overrides.
Server payload. This will be copied from the plugin to the working directory on the remote machine prior to launch. The payload is cached on the remote machine and only copied if it is necessary.
The command used to launch the payload on the remote machine. The variable "${payload}" can be used to include the name of the payload (as specified in the "payload" attribute) in the launch command.
Optional command to unpack the payload prior to execution. The unpack command is only run when the payload is first copied to the server (and if re-copied subsequently). If the unpack fails, payload launch is aborted.
This will be used to specify a command to check the desired launch command is available on remote server
This attribute is used to specify a message which will be shown to the user if the launch command verification fails.
This will be used to specify the search pattern in the form of regular expression which will be used to verify the output of the command specified in the verifyLaunchCommand attribute.
This will be used to specify a command to check the unpack command is available on remote server
This attribute is used to specify message which will be shown to the user if the unpack command verification fails.
This will be used to specify the search pattern in the form of regular expression which will be used to verify the output of the command specified in the verifyUnpackCommand attribute.
The following is an example of a remote server extension point:
<p>
<pre>
<extension point="org.eclipse.ptp.remote.core.remoteServer">
<remoteServer
class="org.eclipse.ptp.rdt.server.dstore.core.DStoreServer"
continuous="true"
id="org.eclipse.ptp.rdt.server.dstore.RemoteToolsDStoreServer"
launchCommand="java -Xms64m -Xmx128m -Xss2m -jar ${payload} 0 60000"
name="%RemoteToolsDStoreServer.name"
payload="rdt-server.jar"
verifyLaunchCommand="java -version"
verifyLaunchFailMessage="{0}: Invalid java version or java not installed on "{1}""
verifyLaunchPattern="^(java version )(.)(1\.[5-9]|[2-9]\.).*$">
</remoteServer>
</extension>
</pre>
</p>
The following is an example of a remote server override extension point:
<p>
<pre>
<extension point="org.eclipse.ptp.remote.core.remoteServerOverride">
<remoteServer
id="org.eclipse.ptp.rdt.server.dstore.RemoteToolsDStoreServer"
launchCommand="/other/path/java -Xms64m -Xmx128m -Xss2m -jar ${payload} 0 60000"
</remoteServer>
</extension>
</pre>
</p>