SETTINGS

The server's internal settings are reported on the Settings tab, along with a number of important editable settings.

Administrator Settings

Change Administrator Settings: Use this form to change the current administrator password, this is the password that you provided during installation that is used to log in to the SVN MultiSite Plus browser-based User Interface
See How to change your Administrator Password.

User Interface HTTP Port: Change the port that you want to use to access the User Interface. Just enter a valid port number and clock SAVE.

Resource Monitoring Data

The Resource Monitoring Data settings provide a basic tool for monitoring available disk storage for MultiSite's resources.

Monitor Interval (mins)

If the disk space available to a monitored resource is less than the value you have for a "Severe" event then the event is logged and MultiSite's replicator will shut down after this interval, currently set at 10 minutes by default. You can configure the interval in application.properties file:


/opt/wandisco/svn-multisite-plus/replicator/properties/application.properties

resourcemonitor.period.min=10

Value is in minutes, and only run through the UI, it is not handled directly by the replicator.

Add New Resource Monitor

Enter the path to a resource that you wish to monitor, then click "Add".

Resource Monitors

This section lists all resources currently being monitored. Click on "Configure" to change monitor settings, "Delete" to remove a monitor.

For more information about setting up monitors, read 22. Setting up resource monitoring.

Notifications

The notifications system provides SVN administrators with the ability to create event-driven alert emails. Set up one more more gateway (mail servers), add destination emails to specify recipients, create email templates for the content of the alert emails, then set the rules for which event should trigger a specific email.

Gateways

The Gateways section stores the details of those email relay servers that your organization uses for internal mail delivery. You can add any number of gateways, SVN MultiSite Plus will attempt to delivery notification emails using each gateway in their order on the list, #0, #1, #2 etc.

SVN MultiSite Plus will attempt delivery via the next gateway server once it has attempted delivery a number of times equal to the Tries number. It will repeat a try after waiting a number of settings equal to the Internval setting.

** Alert! ** How SVN MultiSite Plus gives up on delivering to a gateway.
Example. Gateway #0 is offline. With Tries set to 5 and Interval set to 600, MultiSite will attempt delivery using the next gateway (#1) after 600s x 5 = 50 minutes.

IP/Hostname of SMTP Server:: your email server's address.
SMTP Server Port: The port assigned for SMTP traffic (Port 25 etc).
Encryption Type: Indicate your server's encryption type - None, SSL (Secure Socket Layer) or TLS (Transport Layer Security). SSL is a commonly used. For tips on setting up suitable keystore and truststore files see Setting up SSL Key pair.
keystores?
If you're not familiar with the finer points of setting up SSL keystores and truststores it is recommended that you read the following article: Using Java Keytool to manage keystores.
Authentication Required: Indicate whether you need a username and password to connect to the server - requires either "true" or "false".
User Name: If authentication is required, enter the authentication username here.
Password: If authentication is required, enter the authentication password here.
Sender Address: Provide an email address that your notifications will appear to come from. If you want to be able to receive replies from notifications you'll need to make sure this is a valid and monitored address.
Number of Tries Before Failing: Set the number of attempts SVN MultiSite Plus makes in order to send out notifications.
Interval Between Tries (Seconds): Set the time (in seconds) between your server's attempts to send notifications.

Destinations

In the Destinations panel is used to store email address for notification recipients. Add, Edit or remove email addresses.

Templates

The templates panel is used to store email content. You create messaging to match those events for which you want to send user notifications.

Template Subject: Use this entry field to set the subject of the notification email. You'll want this subject to be descriptive of the event for which the email will be triggered. .
Body Text: Enter the actual message that you want to send for a particular situation/event.

Rules

Use the Rules panel to actually setup up your notification emails. Here you'll associate email templates and destination emails with a particular system event. For example, you may create an email message to send to a particular group mailing list in the event that a repository goes into Read-only mode. Selecting descriptive subjects for your templates will help you to select the right templates here.

Event: Choose from the available list of trigger events.
Template
Destination

Logging Setting

The Logging Setting lets you quickly add or modify Java loggers via the admin console, rather than making manual edits to the logger file:

<install-dir>/replicator/properties/logger.properties.

Loggers are usually attached to packages, here, the level for each package is available to modify or delete. The global level is used by default, so changes made here are used to override the default values. Changes are applied instantly but in-memory only and are forgotten after a restart of the replicator (unless they are saved). For information about adding or changing loggers, see 34. Logging Setting Tool.

System Data

The System Data table provides a list of read-only settings that were either provided during setup or have since been applied:

NodeID: The name that you gave the node during installation.
Location ID: A unique string that is used to identify the server during an induction.
Host Name/IP Address: The Hostname / IP address of the server hosting the node.
DConE port: DConE port (actually it's DConE 2) handles agreement traffic between sites. The Default is 6444.
Database Location: The full path to MultiSite's database. By default this will be <install-dir>/replicator/database.
Delegate Port: The delegate port is used by SVN to delegate write operations to the WANdisco Replicator (via the contact.server.port (described below).
Jetty HTTP Port: The HTTP port is used for browser access to the User Interface.
Content Server Port: The port that will be used to transfer replicated content (repository changes). This is different from the port used by WANdisco's DConE agreement engine.
Content Location: The directory in which replication data is stored (prior to it having been confirmed as replicated).
License information: Details concerning SVN MultiSite Plus product license - such as the date of expiry.

View REST API Documentation - This link takes you to your node's local copy of the API documentation. The link goes to the following location: http://<Node IP>:8080/apidocs/. This documentation is generated automatically and ties directly into your server's local resources. There is an only copy of the latest API documenation available in this admin guide, note though that it has been lifted from an installation and will link to resources that will not be available on the website (resulting in dead links).

Module Versions

The module versions provides a list of the component parts of the SVN MultiSite application. This is useful if you need to verify what version of a component you are using - such as if you need to contact WANdisco for support.

SVN MultiSite Plus
Last doc build: 12:48 - 08th January 2014