apache-ignite

1
// Licensed to the Apache Software Foundation (ASF) under one or more
2
// contributor license agreements.  See the NOTICE file distributed with
3
// this work for additional information regarding copyright ownership.
4
// The ASF licenses this file to You under the Apache License, Version 2.0
5
// (the "License"); you may not use this file except in compliance with
6
// the License.  You may obtain a copy of the License at
7
//
8
// http://www.apache.org/licenses/LICENSE-2.0
9
//
10
// Unless required by applicable law or agreed to in writing, software
11
// distributed under the License is distributed on an "AS IS" BASIS,
12
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
// See the License for the specific language governing permissions and
14
// limitations under the License.
15
= Running Client Nodes Behind NAT
16

17
If your client nodes are deployed behind a NAT, the server nodes won't be able to establish connection with the clients because of the limitations of the communication protocol.
18
This includes deployment cases when client nodes are running in virtual environments (like Kubernetes) and the server nodes are deployed elsewhere.
19

20
For cases like this, you need to enable a special mode of communication:
21

22
[tabs]
23
--
24
tab:XML[]
25

26
[source, xml]
27
----
28
include::code-snippets/xml/client-behind-nat.xml[tags=ignite-config;!discovery,indent=0]
29
----
30
tab:Java[]
31
[source, java]
32
----
33
include::{javaCodeDir}/Discovery.java[tags=client-behind-nat,indent=0]
34
----
35
tab:C#/.NET[]
36

37
tab:C++[unsupported]
38
--
39

40
== Limitations
41

42
* This mode cannot be used when `TcpCommunicationSpi.usePairedConnections = true` on both server and client nodes.
43

44
* Peer class loading for link:key-value-api/continuous-queries[continuous queries (transformers and filters)] does not work when a continuous query is started from a client node `forceClientToServerConnections = true`.
45
You will need to add the corresponding classes to the classpath of every server node.
46

47
* This property can only be used on client nodes. This limitation will be addressed in the future releases.
48