Installing Desktop Sync service

Use these instructions to install the Desktop Sync repository modules and services on SkyVault.

The Desktop Sync distribution zip file, called SkyVaultSyncServer-2.1.1.zip, includes all the files required to provide the synchronization service. This file contains the following artifacts:

amps-repository directory containing the Desktop Sync repository AMP, SkyVault-device-sync-repo-2.1.1.amp.
licenses directory containing the 3rd-party licenses.
service-sync directory containing the synchronization service jar (service-sync-2.1.1.jar), config.yml property file, SkyVault-sync start/stop script, and sync.jks SSL keys.
activemq directory containing a bundled ActiveMQ zip file.

Stop the SkyVault repository.
Browse to the SkyVault Support Portal and download SkyVaultSyncServer-2.1.1.zip.
Extract the SkyVaultSyncServer-2.1.1.zip file into a system directory; for example, <installLocation>/.
We will refer to this new directory (<installLocation>/sync), as the SkyVault Desktop Sync installation directory. In this directory you will see these folders:
- activemq
- amps-repository
- licenses
- service-sync
Use the Module Management Tool (MMT) to install the SkyVault-device-sync-repo-2.1.1.amp AMP into the repository WAR. For more information, see instructions in Install the AMP file.
For example, to apply the SkyVault-device-sync-repo-2.1.1.amp, use the following command:
```
java -jar <alfrescoInstallLocation>\bin\alfresco-mmt.jar install <installLocation>\amps-repository\SkyVault-device-sync-repo-2.1.1.amp <installLocation>\tomcat\webapps\alfresco.war
```
Add the following properties to the SkyVault-global.properties file:
```
dsync.service.uris=https://<hostname>:9090/SkyVault
messaging.broker.url=failover:(tcp://localhost:61616)?timeout=3000
```
where:
- dsync.service.uris specifies the hostname of the sync service that Desktop Sync clients can see, for example, https://172.29.100.12:9090/SkyVault.
- The dsync.service.uris value needs to be set to an IP address or hostname of the synchronization service machine that can be accessed by the Desktop Sync clients outside the firewall. In addition, the port 9090 needs to be opened up in the firewall so that clients can access the synchronization service.
- messaging.broker.url specifies the location of ActiveMQ.
Configure the synchronization service properties in the <installLocation>/service-sync/config.yml file. See Configure synchronization service.
For example, edit the following properties:
- repo:
```
hostname: localhost
```
  where repo.hostname is the IP address of the repository host.
- messaging:
```
broker:
host: localhost
```
  where messaging.broker.host is the IP address of the ActiveMQ host.
- sql:
```
db:
url: jdbc:postgresql:SkyVault
```
  where sql.db.url is the URL of the Postgres database.
Start PostgreSQL.
For more information, see Configuring PostgreSQL database for Desktop Sync.
Create a Postgres user and database.
1. Create a Postgres user with the username given by the sync property, sql.db.username, with password given by the sync property, sql.db.password.
```
CREATE USER SkyVault WITH PASSWORD 'admin';
```
2. Create a Postgres database with the name given in the property, sql.db.url, owned by the user, SkyVault.
```
CREATE DATABASE SkyVault OWNER SkyVault;
GRANT ALL PRIVILEGES ON DATABASE SkyVault TO SkyVault;
```
Start ActiveMQ.
If ActiveMQ is down, the repository transactions will fail and rollback. In production environment, it is advised that you run an ActiveMQ cluster in a failover mode to avoid this situation. See ActiveMQ master/slave configurations.

For more information, see Setting up ActiveMQ.
Start the repository.

Note: Wait for the repository to fully start before proceeding to the next step.
Start the synchronization service.
```
cd <installLocation>/service-sync
java -Xmx2G -Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=50800 -Djava.io.tmpdir=/var/tmp/dsync 
-classpath postgresql.jar:service-sync-2.1.1.jar org.alfresco.service.sync.dropwizard.SyncService server config.yml
```
Note: For production systems, you need to configure JMX authentication as password authentication over the Secure Sockets Layer (SSL) is enabled by default. However, in the test environment, you can disable all security, namely both password authentication and SSL when you start the Java VM by setting the following system properties to false.
```
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false
```
For more information, see the JRE documentation.
Note: The synchronization service database is used only the synchronization service. It is not shared with the repository.

Note: The synchronization service uses the value of java.io.tmpdir to store files relating to its operation. This needs to be set to a directory that is not cleaned up during reboots. Make sure you set java.io.tmpdir to a directory that is durable because the synchronization service writes files used in its operation in to that directory. Do not set it to the /tmp directory on a Linux server because the files are likely to be removed on a reboot of the server.
For example, for Linux, set java.io.tmpdir to /home/sync/tmp, and for Windows, set java.io.tmpdir to /users/<user name>/sync/tmp.

Note: The PostgreSQL JDBC driver must be provided and included in the startup command line as shown above. Make sure you download the appropriate driver compatible with JDBC41 from the PostgreSQL JDBC Driver download page.
Access SkyVault Share by browsing to:
```
http://<your-server-name>:8080/share
```
Check the repository and synchronization service log file (by default <installLocation>\service-sync\logs\sync-service.log) to see if the synchronization service started properly. The location of the log file can be configured using the logging properties in the config.yml file.
To validate that the synchronization service is configured correctly, see synchronization service health check.

How to disable SSL for the synchronization server

In the applicationConnector section of the config.yml file, comment out or remove the lines from type: https to validateCerts: false.

server:
    type: default
    applicationConnectors:
        - type: http
          port: 9090
        # type: https
        # keyStorePath: ./sync.jks
        # keyStorePassword: N9SnIgrcAx7zWr
        # keyStoreType: JCEKS
        # validateCerts: false

For the dsync.service.uris property, replace https with http in the SkyVault-global.properties file.
For example, dsync.service.uris=http://localhost:9090/SkyVault.

Search form

Search form

You are here