Version 20 (modified by ibaldin, 5 years ago)

--

Notes on ORCA Eastsound 5.0

The major enhancement of Eastsound5.0 is the addition of state recovery for actors and controllers which allow them to be restarted without losing slice state information. Also added were

  • Support for CouchDB for actor registry
  • Support for legacy VLAN provisioning on BNT G8264
  • OVS 'pseudo wire' support
  • Boot console logging on boot failures
  • Various fixes to bare-metal node provisioning

Migration Notes

ORCA 5.0 requires that MySQL be modified - table structure and limits need to be changed. The mysql schema files have already been modified (for creating new tables). Existing tables in ORCA actor databases have to be dropped and recreated.

$ mysql -u orca < $ORCA_SRC/core/schema/mysql/full.schema.sql
$ mysql -u orca < $ORCA_SRC/core/schema/mysql/full.data.sql

You also have to change the /etc/my.cnf file:

Under the [mysqld] section add this line:

max_allowed_packet=32M

Also, you need to change the schemas for both mysql databases (for both containers). Drop and rebuild the tables using full.schema.sql files as described here.

CouchDB

ORCA 5.0 includes integration with CouchDB to support a distributed actor registry. The code for CouchDB is located here. Orca will default to RemoteRegistryCache? if the properties below are not set. In order to enable the DistributedRemoteCacheRegistry? a few properties must be set in orca.properties file:

###############################################
# ORCA distributed actor registry with CouchDB backend
###############################################

registry.class=orca.shirako.container.DistributedRemoteRegistryCache
registry.url.1=https://slookup.exogeni.net,https://slookup2.exogeni.net
registry.certfingerprint.1=df:5c:1d:99:46:9a:5f:a8:92:8e:15:e4:b9:82:d8:ad
registry.certfingerprint.2=df:5c:1d:99:46:9a:5f:a8:92:8e:15:e4:b9:82:d8:ad
registry.couchdb.username=admin
registry.couchdb.password=exoadmin

#################

Note that in absence of these properties ORCA will default to the original RemoteCacheRegistry?.

Procedure for updating an actor document, e.g., adding a field is as follows: 1-update ektorp actor class (mark fields to ignore) 2-update repository if an additional query method is required for interacting with the new field

Webfront of DistributedRemoteRegistry? Webfront of the distributed actor registry can be found at: (Insert valid URL) It is back by Couchdb so code also resides in Couchdb at: located here