mirror of
https://github.com/openvswitch/ovs
synced 2025-08-28 04:47:49 +00:00
00dda78ed4
If a new database server added to the cluster, or if one of the database servers changed its IP address or port, then you need to update the list of remotes for the client. For example, if a new OVN_Southbound database server is added, you need to update the ovn-remote for the ovn-controller. However, in the current implementation, the ovsdb-cs module always closes the current connection and creates a new one. This can lead to a storm of re-connections if all ovn-controllers will be updated simultaneously. They can also start re-dowloading the database content, creating even more load on the database servers. Correct this by saving an existing connection if it is still in the list of remotes after the update. 'reconnect' module will report connection state updates, but that is OK since no real re-connection happened and we only updated the state of a new 'reconnect' instance. If required, re-connection can be forced after the update of remotes with ovsdb_cs_force_reconnect(). Acked-by: Dumitru Ceara <dceara@redhat.com> Acked-by: Han Zhou <hzhou@ovn.org> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
153 lines
6.1 KiB
C
153 lines
6.1 KiB
C
/*
|
||
* Copyright (c) 2009, 2010, 2012, 2013, 2017 Nicira, Inc.
|
||
*
|
||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
* you may not use this file except in compliance with the License.
|
||
* You may obtain a copy of the License at:
|
||
*
|
||
* http://www.apache.org/licenses/LICENSE-2.0
|
||
*
|
||
* Unless required by applicable law or agreed to in writing, software
|
||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
* See the License for the specific language governing permissions and
|
||
* limitations under the License.
|
||
*/
|
||
|
||
#ifndef JSONRPC_H
|
||
#define JSONRPC_H 1
|
||
|
||
/* This is an implementation of the JSON-RPC 1.0 specification defined at
|
||
* http://json-rpc.org/wiki/specification. */
|
||
|
||
#include <stdbool.h>
|
||
#include <stddef.h>
|
||
#include "openvswitch/types.h"
|
||
|
||
struct json;
|
||
struct jsonrpc_msg;
|
||
struct pstream;
|
||
struct reconnect_stats;
|
||
struct stream;
|
||
struct svec;
|
||
|
||
/* API for a JSON-RPC stream. */
|
||
|
||
/* Default port numbers.
|
||
*
|
||
* OVSDB_OLD_PORT defines the original port number used by OVS.
|
||
* OVSDB_PORT defines the official port number assigned by IANA. */
|
||
#define OVSDB_OLD_PORT 6632
|
||
#define OVSDB_PORT 6640
|
||
|
||
int jsonrpc_stream_open(const char *name, struct stream **, uint8_t dscp);
|
||
int jsonrpc_pstream_open(const char *name, struct pstream **, uint8_t dscp);
|
||
|
||
struct jsonrpc *jsonrpc_open(struct stream *);
|
||
void jsonrpc_close(struct jsonrpc *);
|
||
|
||
void jsonrpc_run(struct jsonrpc *);
|
||
void jsonrpc_wait(struct jsonrpc *);
|
||
|
||
int jsonrpc_get_status(const struct jsonrpc *);
|
||
size_t jsonrpc_get_backlog(const struct jsonrpc *);
|
||
void jsonrpc_set_backlog_threshold(struct jsonrpc *, size_t max_n_msgs,
|
||
size_t max_backlog_bytes);
|
||
|
||
unsigned int jsonrpc_get_received_bytes(const struct jsonrpc *);
|
||
const char *jsonrpc_get_name(const struct jsonrpc *);
|
||
|
||
int jsonrpc_send(struct jsonrpc *, struct jsonrpc_msg *);
|
||
int jsonrpc_recv(struct jsonrpc *, struct jsonrpc_msg **);
|
||
void jsonrpc_recv_wait(struct jsonrpc *);
|
||
|
||
int jsonrpc_send_block(struct jsonrpc *, struct jsonrpc_msg *);
|
||
int jsonrpc_recv_block(struct jsonrpc *, struct jsonrpc_msg **);
|
||
int jsonrpc_transact_block(struct jsonrpc *, struct jsonrpc_msg *,
|
||
struct jsonrpc_msg **);
|
||
|
||
/* Messages. */
|
||
enum jsonrpc_msg_type {
|
||
JSONRPC_REQUEST, /* Request. */
|
||
JSONRPC_NOTIFY, /* Notification. */
|
||
JSONRPC_REPLY, /* Successful reply. */
|
||
JSONRPC_ERROR /* Error reply. */
|
||
};
|
||
|
||
struct jsonrpc_msg {
|
||
enum jsonrpc_msg_type type;
|
||
char *method; /* Request or notification only. */
|
||
struct json *params; /* Request or notification only. */
|
||
struct json *result; /* Successful reply only. */
|
||
struct json *error; /* Error reply only. */
|
||
struct json *id; /* Request or reply only. */
|
||
};
|
||
|
||
struct jsonrpc_msg *jsonrpc_create_request(const char *method,
|
||
struct json *params,
|
||
struct json **idp);
|
||
struct jsonrpc_msg *jsonrpc_create_notify(const char *method,
|
||
struct json *params);
|
||
struct jsonrpc_msg *jsonrpc_create_reply(struct json *result,
|
||
const struct json *id);
|
||
struct jsonrpc_msg *jsonrpc_create_error(struct json *error,
|
||
const struct json *id);
|
||
|
||
struct jsonrpc_msg *jsonrpc_msg_clone(const struct jsonrpc_msg *);
|
||
|
||
const char *jsonrpc_msg_type_to_string(enum jsonrpc_msg_type);
|
||
char *jsonrpc_msg_is_valid(const struct jsonrpc_msg *);
|
||
void jsonrpc_msg_destroy(struct jsonrpc_msg *);
|
||
|
||
char *jsonrpc_msg_from_json(struct json *, struct jsonrpc_msg **);
|
||
struct json *jsonrpc_msg_to_json(struct jsonrpc_msg *);
|
||
|
||
char *jsonrpc_msg_to_string(const struct jsonrpc_msg *);
|
||
|
||
/* A JSON-RPC session with reconnection. */
|
||
|
||
struct jsonrpc_session *jsonrpc_session_open(const char *name, bool retry);
|
||
struct jsonrpc_session *jsonrpc_session_open_multiple(const struct svec *,
|
||
bool retry);
|
||
struct jsonrpc_session *jsonrpc_session_open_unreliably(struct jsonrpc *,
|
||
uint8_t);
|
||
void jsonrpc_session_close(struct jsonrpc_session *);
|
||
|
||
struct jsonrpc *jsonrpc_session_steal(struct jsonrpc_session *);
|
||
void jsonrpc_session_replace(struct jsonrpc_session *, struct jsonrpc *);
|
||
|
||
void jsonrpc_session_run(struct jsonrpc_session *);
|
||
void jsonrpc_session_wait(struct jsonrpc_session *);
|
||
|
||
size_t jsonrpc_session_get_backlog(const struct jsonrpc_session *);
|
||
const char *jsonrpc_session_get_name(const struct jsonrpc_session *);
|
||
size_t jsonrpc_session_get_n_remotes(const struct jsonrpc_session *);
|
||
|
||
int jsonrpc_session_send(struct jsonrpc_session *, struct jsonrpc_msg *);
|
||
struct jsonrpc_msg *jsonrpc_session_recv(struct jsonrpc_session *);
|
||
void jsonrpc_session_recv_wait(struct jsonrpc_session *);
|
||
|
||
bool jsonrpc_session_is_alive(const struct jsonrpc_session *);
|
||
bool jsonrpc_session_is_connected(const struct jsonrpc_session *);
|
||
unsigned int jsonrpc_session_get_seqno(const struct jsonrpc_session *);
|
||
int jsonrpc_session_get_status(const struct jsonrpc_session *);
|
||
int jsonrpc_session_get_last_error(const struct jsonrpc_session *);
|
||
void jsonrpc_session_get_reconnect_stats(const struct jsonrpc_session *,
|
||
struct reconnect_stats *);
|
||
|
||
void jsonrpc_session_enable_reconnect(struct jsonrpc_session *);
|
||
void jsonrpc_session_force_reconnect(struct jsonrpc_session *);
|
||
|
||
void jsonrpc_session_set_max_backoff(struct jsonrpc_session *,
|
||
int max_backoff);
|
||
void jsonrpc_session_set_probe_interval(struct jsonrpc_session *,
|
||
int probe_interval);
|
||
void jsonrpc_session_set_dscp(struct jsonrpc_session *,
|
||
uint8_t dscp);
|
||
void jsonrpc_session_set_backlog_threshold(struct jsonrpc_session *,
|
||
size_t max_n_msgs,
|
||
size_t max_backlog_bytes);
|
||
const char *jsonrpc_session_get_id(const struct jsonrpc_session *);
|
||
|
||
#endif /* jsonrpc.h */
|