diff --git a/parameters/dita-command-arguments.dita b/parameters/dita-command-arguments.dita index cfe25873..5eaa5332 100644 --- a/parameters/dita-command-arguments.dita +++ b/parameters/dita-command-arguments.dita @@ -107,6 +107,10 @@ + The dita install command uses a network connection for + installing and downloading content. In environments where an HTTP proxy is used to establish + a network connection, provide the proxy configuration via the ANT_OPTS + environment variable. For more information, see Configuring the proxy. Prior to DITA-OT 3.5, subcommands were specified with the double-hyphen option syntax, which is still supported for backwards compatibility. (For example, dita --install will still work.) diff --git a/resources/source-files.ditamap b/resources/source-files.ditamap index 53916690..813e027d 100644 --- a/resources/source-files.ditamap +++ b/resources/source-files.ditamap @@ -18,6 +18,7 @@ + diff --git a/topics/configuring-the-proxy.dita b/topics/configuring-the-proxy.dita new file mode 100644 index 00000000..e0bae05d --- /dev/null +++ b/topics/configuring-the-proxy.dita @@ -0,0 +1,74 @@ + + + + + Configuring the proxy + + Configuring the proxy + + Certain commands, for example, the dita install command, use a + network connection for installing and downloading content. In environments where an HTTP proxy + is used to establish a network connection, provide the proxy configuration via the + ANT_OPTS environment variable. + + + + macOS configure proxy + Linux configure proxy + Windows configure proxy + command line configure proxy + operating system + Linux + macOS + Windows + Java network + ANT_OPTS + Java + ANT_OPTS + metadata + network connection error + metadata + connection timed out + + + + + + + To configure the proxy for a specific session, from the command prompt, issue the + following command: + + + Platform + Command + + + Linux or macOS  + export ANT_OPTS="-Dhttp.proxySet=true \ + -Dhttps.proxyHost=<HTTPS proxy IP address> \ + -Dhttp.proxyHost=<HTTP proxy IP address> \ + -Dhttp.proxyPort=<HTTP proxy port> \ + -Dhttps.proxyPort=<HTTPS proxy port>" + + + Windows + set ANT_OPTS=%ANT_OPTS% -Dhttp.proxySet=true \ + -Dhttps.proxyHost=<HTTPS proxy IP address> \ + -Dhttp.proxyHost=<HTTP proxy IP address> \ + -Dhttp.proxyPort=<HTTP proxy port> \ + -Dhttps.proxyPort=<HTTPS proxy port> + + + + + To persistently change the value, change the value allocated to the + ANT_OPTS environment variable on your system. + + + If a command has previously failed due to a connection timeout, issue the command + again. For + example:dita install <plug-in> + + + diff --git a/topics/troubleshooting.ditamap b/topics/troubleshooting.ditamap index 842b2e8d..face9e70 100644 --- a/topics/troubleshooting.ditamap +++ b/topics/troubleshooting.ditamap @@ -11,5 +11,6 @@ +