hudson.remoting.jnlp

Class Main

java.lang.Object

hudson.remoting.jnlp.Main

public class Main
extends Object

Entry point to JNLP agent.

See also slave-agent.jnlp.jelly in the core.

Author:

Kohsuke Kawaguchi

Field Summary

Fields

Modifier and Type	Field and Description
File	agentLog Specifies a destination for error logs.
List<String>	args 4 mandatory parameters.
List<String>	candidateCertificates
String	credentials
boolean	disableHttpsCertValidation Disables HTTPs Certificate validation of the server when using JnlpAgentEndpointResolver.
boolean	failIfWorkDirIsMissing Fail the initialization if the workDir or internalDir are missing.
boolean	headlessMode
String	internalDir Specifies a directory within workDir, which stores all the remoting-internal files.
File	jarCache
File	loggingConfigFile Specified location of the property file with JUL settings.
boolean	noKeepAlive
boolean	noReconnect
String	proxyCredentials
String	tunnel
List<URL>	urls
File	workDir Specifies a default working directory of the remoting instance.

Constructor Summary

Constructors

Constructor and Description
Main()

Method Summary

Modifier and Type	Method and Description
static void	_main(String[] args) Main without the argument handling.
Engine	createEngine()
void	main()
static void	main(String[] args)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

tunnel

public String tunnel

headlessMode

public boolean headlessMode

urls

public final List<URL> urls

credentials

public String credentials

proxyCredentials

public String proxyCredentials

noReconnect

public boolean noReconnect

noKeepAlive

public boolean noKeepAlive

candidateCertificates

public List<String> candidateCertificates

disableHttpsCertValidation

public boolean disableHttpsCertValidation

Disables HTTPs Certificate validation of the server when using JnlpAgentEndpointResolver. This option is not recommended for production use.

Since:

TODO

agentLog

@CheckForNull
public File agentLog

Specifies a destination for error logs. If specified, this option overrides the default destination within workDir. If both this options and workDir is not set, the log will not be generated.

Since:

3.8

loggingConfigFile

@CheckForNull
public File loggingConfigFile

Specified location of the property file with JUL settings.

Since:

3.8

workDir

@CheckForNull
public File workDir

Specifies a default working directory of the remoting instance. If specified, this directory will be used to store logs, JAR cache, etc.

In order to retain compatibility, the option is disabled by default.

Jenkins specifics: This working directory is expected to be equal to the agent root specified in Jenkins configuration.

Since:

3.8

internalDir

@Nonnull
public String internalDir

Specifies a directory within workDir, which stores all the remoting-internal files.

This option is not expected to be used frequently, but it allows remoting users to specify a custom storage directory if the default remoting directory is consumed by other stuff.

Since:

3.8

failIfWorkDirIsMissing

@Nonnull
public boolean failIfWorkDirIsMissing

Fail the initialization if the workDir or internalDir are missing. This option presumes that the workspace structure gets initialized previously in order to ensure that we do not start up with a borked instance (e.g. if a filesystem mount gets disconnected).

Since:

3.8

jarCache

public File jarCache

Since:

2.24

args

public final List<String> args

4 mandatory parameters. Host name (deprecated), Jenkins URL, secret key, and agent name.

Constructor Detail

Main

public Main()

Method Detail

main

public static void main(String[] args)
                 throws IOException,
                        InterruptedException

Throws:

IOException

InterruptedException

_main

public static void _main(String[] args)
                  throws IOException,
                         InterruptedException,
                         org.kohsuke.args4j.CmdLineException

Main without the argument handling.

Throws:

IOException

InterruptedException

org.kohsuke.args4j.CmdLineException

main

public void main()
          throws IOException,
                 InterruptedException

Throws:

IOException

InterruptedException

createEngine

public Engine createEngine()