Generate Proxy Configuration

URL:
https://<admin-root>/proxyGen
Methods:
POST
Required Capability:
Administrator
Version Introduced:
10.9

Description

Generates an Apache HTTPD configuration file and can set the webContextURL and webSocketContextURL in Properties automatically when the correct topContext , proxyFQDN and setContextUrls are given.

Request Parameters

ParameterDescription

topContext

Required. String. the top level context of a proxy server to generate the proxy directives.

Example: your.proxy.com/thistopcontext

setContextUrls

Optional. Boolean. Sets the WebSocketContextURL and WebContextURL in Properties to the proxyFQDN provided.

proxyFQDN

Required when setContextURLs=true . String. The FQDN of the reverse proxy to be configured with Mission Server.

Example:your.reverse.proxy.com

f

The response format. The default response format is html .

Values: html | json | file

Example usage

Below is a sample POST request for proxyGen :

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
POST /webadaptor/admin/proxyGen HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

topContext=thistopcontext
setContextUrls=true
proxyFQDN=your.reverse.proxy.com
f=html

HTML Response example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
### ArcGIS Mission Server Apache Proxy Configuration
###
### These Apache HTTPD directives configure Apache HTTP server to
### operate as a reverse proxy for ArcGIS Mission Server.
###
### Because 'setContextUrl' was set to true for proxy generation, these Mission Server
### properties have been set in admin/system/properties
### -------------------
### System Properties:
### {
###    "WebContextURL":"https://your.reverse.proxy/thistopcontext",
###    "WebSocketContextURL":"wss://your.reverse.proxy/thistopcontext"
###  }
### -------
###
### Instructions:
###
### Add these configuration directives within a
### <VirtualHost> container configured with SSL.
###
### Refer to the Apache documentation for your platform
### for the location of the Apache configuration files.
###
### For example, on CentOS/Red Hat Linux, add the directives
### below into /etc/httpd/conf.d/ssl.conf.
### For Ubuntu, add the directives
### to /etc/apache2/sites-enabled/default-ssl.conf
###
### Required Apache Version: 2.4.6 and later
###
### Required Apache Modules:
###
### LoadModule ssl_module modules/mod_ssl.so
### LoadModule proxy_module modules/mod_proxy.so
### LoadModule proxy_http_module modules/mod_proxy_http.so
### LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
###
###

## Enable proxy engine for SSL
SSLProxyEngine on

## Required if untrusted (self signed) certificates are in use.
## Can be commented out if certificate trust can be established.
SSLProxyVerify none

## Uncomment the below directive when troubleshooting
# LogLevel proxy:trace3 proxy_wstunnel:trace3

ProxyPass /thistopcontext/missions/ wss://your.reverse.proxy.com:20301/arcgis/missions/ disablereuse=On

ProxyPass /thistopcontext/ https://your.reverse.proxy.com:20443/arcgis/
ProxyPassReverse /thistopcontext/ https://your.reverse.proxy.com:20443/arcgis/

## Optional. Enable balancer manager. Requires mod_status.so
##
## Do not enable balancer manager on a public facing system, unless
## you know what you are doing.
##
## If not already loaded, add
## LoadModule status_module modules/mod_status.so
#<Location "/balancer-manager">
# SetHandler balancer-manager
#</Location>

### End ArcGIS Mission Server Apache Proxy Config

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.