Riva Multinode Deployment Folder Structures Explained

• Multi-node folder structure
  • \Sync\ folder
  • \Sync\logs\ folder
  • \Sync\pod\ folder

Multi-node Folder Structure

Multi-node deployments of Riva have a different installation folder structure than that of standalone deployments to single servers. 

Caution is advised when working with Riva in a multi-node deployment. Here is an outline of the folder structure, and an explanation of its components.

\Sync\ Folder 

The root folder is \Sync\, which is usually stored in the root of any drive on the machine.

In the example below, Riva is deployed in D: drive.

The \Sync\ folder consists of 4 subfolders:

1. CommonConfig: Contains the common configuration consolidated in one place.
    

2. Logs: Stores activity and diagnostics logs for the users syncing on that sync node. RSS (Riva Shared Service) and gather logs can also be found on the server on which the respective service is installed.
   
   Note: Use Windows Services to determine which Riva services are installed.
    
3. Pod: Stores the configuration, Riva application, customizations, licenses, and user transactions.
    
4. Trace: This is a maintenance folder managed by the Riva Success Team.
    

\Sync\logs\ Folder

Expanded \logs\ folder structures:
 

The \logs\ folder is mostly used by Riva administrators to view logs.

The ~\Sync\logs\ folder has 5 subfolders:

1.  app: Stores logs for the Riva application.
    
2. gather-a1: Stores activity and diagnostic logs for the gatherer service.
    
3. main: Stores Riva main logs when Riva is launched from the ~\Sync\pod\main folder.
    
4. rss: Contains RSS service logs.
    
5. sync-a1: Stores logs for the sync-a1 service.
    
   1. CRM Synchronization Policy: User activity logs.
       
   2. Logs: User diagnostic logs. These logs have crmex in the filename.

\Sync\pod\ Folder

Expanded \pod\ folder structures:

 
   

The \pod\ folder houses Riva configuration and services.
 

The folder has 6 subfolders: 

1.    app: Holds the Riva Manager application. 

2.    cfg: Stores the multi-node configuration files.

3.    data

1. Application: Stores settings & runtime configuration for the Riva sync service. Also holds archived application files from previously used versions of Riva.
    
2. Configuration: Stores Riva sync policies and connections.
    
3. Custom: Contains any advanced configuration applied to connections, directives, and customizations.
    
4. GlobalSyncConfiguration: Stores global metadata for the sync policy.
    
5. Transactions: Stores user metadata transactions.
   • Common transaction folder configuration is held in \Sync\pod\Transactions\CrmModuleEx\Common.