BUGS.rst 3.65 KB
Newer Older
Julien Muchembled's avatar
Julien Muchembled committed
Although NEO is considered ready for production use in most cases, there are
2 3
a few bugs to know because they concern basic features of ZODB (marked with Z),
or promised features of NEO (marked with N).

Julien Muchembled's avatar
Julien Muchembled committed
5 6
All the listed bugs will be fixed with high priority.

7 8
(Z) Conflict resolution not fully implemented
Julien Muchembled's avatar
Julien Muchembled committed

Even with a single storage node, so-called 'deadlock avoidance' may
Julien Muchembled's avatar
Julien Muchembled committed
11 12 13
happen to in order to resolve conflicts. In such cases, conflicts will not be
resolved even if your _p_resolveConflict() method would succeed, leading to a
normal ConflictError.

Julien Muchembled's avatar
Julien Muchembled committed
15 16 17 18
Although this should happen rarely enough not to affect performance, this can
be an issue if your application can't afford restarting the transaction,
e.g. because it interacted with external environment.

19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
(Z) Storage nodes rejecting clients after other clients got disconnected from the master

Client nodes ignore the state of the connection to the master node when reading
data from storage, as long as their partition tables are recent enough. This
way, they are able to finish read-only transactions even if they can't reach
the master, which may be useful for high availability. The downside is that the
master node ignores their node ids are still used, which causes "uuid"
conflicts when reallocating them.

Since an unused NEO Storage should not insist in staying connected to master
node, solutions are:

- change the way node ids are generated (either random or always increasing),
- or make storage nodes reject clients that aren't known by the master, but
  this drops the ability to perform read-only operations as described above
  (a client that is not connected to the master would be forced to reconnect
  before any query to the storage).

Workaround: restart clients that aren't connected to the master

40 41
(N) Storage failure or update may lead to POSException or break undoLog()
Julien Muchembled's avatar
Julien Muchembled committed
42 43 44 45

Storage nodes are only queried once at most and if all (for the requested
partition) failed, the client raises instead of asking the master whether it
had an up-to-date partition table (and retry if useful).

Julien Muchembled's avatar
Julien Muchembled committed
In the case of undoLog(), incomplete results may be returned.

49 50
(N) Storage does not discard answers from aborted replications
51 52 53 54 55 56 57 58 59 60 61 62 63 64

In some cases, this can lead to data corruption (wrong AnswerFetch*) or crashes
(e.g. KeyError because self.current_partition is None at the beginning of

The assumption that aborting the replication of a partition implies the closure
of the connection turned out to be wrong, e.g. when a partition is aborted by a
third party, like CORRUPTED/DISCARDED event from the master.

Workaround: do not replicate or tweak while checking replicas.

Currently, this can be reproduced by running testBackupNodeLost
(neo.tests.threaded.testReplication.ReplicationTests) many times.

65 66
(N) A backup cell may be wrongly marked as corrupted while checking replicas
67 68 69 70 71 72 73 74 75 76 77 78 79

This happens in the following conditions:

1. a backup cluster starts to check replicas whereas a cell is outdated
2. this cell becomes updated, but only up to a tid smaller than the max tid
   to check (this can't happen for a non-backup cluster)
3. the cluster actually starts to check the related partition
4. the cell is checked completely before it could replicate up to the max tid
   to check

Workaround: make sure all cells are up-to-date before checking replicas.

Found by running testBackupNodeLost many times.