Installation Instructions

Prior to proceeding with the following instructions, please ensure that your system complies with the prerequisites detailed in the installation requirements.

[Note]Note

The following instructions assume that a Java Runtime Environment (JRE) is installed. If you have downloaded an installation package that contains the JRE, please note that the package will automatically install a JRE prior to execution of the application but this JRE will be used on your computer only for running Syncro SVN Client , it will be invisible to other applications.

[Note]Note

The installation kits and the executable files packaged inside the installation kits were checked before publication with an antivirus program to make sure they are not infected with viruses, trojan horses or other malicious software.

 

Procedure 2.1. Windows Installation

  1. Download the syncroSVNClient.exe installation kit and run it.

  2. Follow the instructions presented in the installation program.

    [Note]Note

    In order to specify another Java virtual machine to be used by Syncro SVN Client you have to set the home folder of the desired JVM in the Windows variable JAVA_HOME or in the Windows variable JDK_HOME. If JAVA_HOME and JDK_HOME are not set the application launcher will try to detect a JVM installed in a standard location on the computer and use it for running the application.

 

Procedure 2.2. Mac OS X Installation

  1. Create a folder called syncroSVNClient on your local disk.

  2. Within the syncroSVNClient folder, create child folder named in accordance with the version number of the application. The directory structure looks as follows: /../syncroSVNClient/2.5/

  3. Download the Mac OS X Installation package ( syncroSVNClient.tar.gz ) to this folder.

  4. Extract the archive to the same folder.

  5. Execute the file named syncroSVNClient

    [Note]Note

    Syncro SVN Client uses the first JVM from the list of preferred JVM versions set on your Mac computer that has the version number not less than 1.5.0. To change the version of the Java virtual machine that runs the application you must move your desired JVM version up in the preferred list by dragging it with the mouse on the first position in the list of JVMs available from Applications -> Utilities -> Java -> Java Preferences.

 

Procedure 2.3. Linux Installation

  1. Download the syncroSVNClient-v9.0.sh installation kit and run it.

  2. Follow the instructions presented in the installation program.

    [Note]Note

    In order to specify another Java virtual machine to be used by Syncro SVN Client you have to set the home folder of the desired JVM in the environment variable JAVA_HOME or in the environment variable JDK_HOME. If JAVA_HOME and JDK_HOME are not set the application launcher will try to detect a JVM installed in a standard location on the computer and use it for running the application.

 

Procedure 2.4. All Platforms Installation

  1. Create a folder called syncroSVNClient on your local disk.

  2. Within the syncroSVNClient folder, create child folder named in accordance with the application version number. The directory structure looks as follows: /../syncroSVNClient/2.5/

  3. Download the All Platforms Installation package ( syncroSVNClient-v9.0.tar.gz ) to this folder.

  4. Extract the archive to the same folder.

  5. Run from a command line the script syncroSVNClient.bat on Windows, syncroSVNClientMac.sh on Mac OS X, syncroSVNClient.sh on Unix/Linux.

    [Note]Note

    To change the version of the Java virtual machine that runs the application you have to specify the full path to the java executable of the desired JVM version in the Java command at the end of the script file, for example:

    "C:\Program Files\Java\jre1.5.0_09\bin\java" -Xmx256m 
    -Dsun.java2d.noddraw=true ...

    on Windows,

    /System/Library/Frameworks/JavaVM.framework/Versions/
    1.5.0/Home/bin/java "-Xdock:name=SyncroSVNClient" ...

    on Mac OS X.

 

Procedure 2.5. Windows NT Terminal Server

  1. Install the application on the server, making its shortcuts available to all users.

  2. Edit the syncroSVNClient.vmoptions file located in the install folder, adding the parameter "-Dcom.oxygenxml.MultipleInstances=true" so that the file content looks like: -Xmx256m -Dcom.oxygenxml.MultipleInstances=true The "Xmx" value represents the maximum memory for each application instance. Please make sure you tune them in a way that the multiple editor instances won't use all the available physical memory.

 

Procedure 2.6. Unix Server

  1. Install the editor on the server, making sure the syncroSVNClient.sh script is executable and the installation directory is in the PATH of the users that need to use the editor.

  2. Create a file called syncroSVNClient.vmoptions in the install folder where the syncroSVNClient2.5 file is located. The content of the file must be:

    -Xmx256m -Dcom.oxygenxml.MultipleInstances=true

    The "-Xmx" value represents the maximum memory for each editor instance. Please make sure you tune it in a way that the multiple editor instances won't use all the available physical memory.

  3. Make sure the X server processes located on the workstations allow connections from the server host. For this use the xhost command.

  4. Telnet (or ssh) on the server host.

  5. Start an xterm process, with display on the workstation. Ex: xterm -display workstationip:0.0

  6. Start the application by typing syncroSVNClient.sh

 Setting a parameter in the startup script

On the Windows platform if you start the application by double-clicking on the Start menu shortcut/Desktop shortcut in order to set a startup parameter you have to add a line with the parameter to the file syncroSVNClient.vmoptions located in the installation directory together with the launcher file called syncroSVNClient.exe . If the file syncroSVNClient.vmoptions does not exist yet in the folder of the launcher file you have to create it there. For example for setting the maximum amount of Java memory to 600 MB the content of the file syncroSVNClient.vmoptions must be:

-Xmx600m

If you start the application with the script syncroSVNClient.bat you have to add or modify the parameter to the java command at the end of the script. For example for setting the maximum amount of Java memory to 600 MB the java command should start with:

java -Xmx600m -Dsun.java2d.noddraw=true ...

On the Mac OS X platform to add or modify a startup parameter you have to right-click on the Syncro SVN Client application icon in Finder, in the pop-up menu select Show Package Contents, then in the Contents directory you edit the file Info.plist: in the key VMOptions you modify the parameter if it already exists in that key or you add it after the model of the existing parameters inside that key.

On the Linux platform you have to create a file called syncroSVNClient.vmoptions if it does not exist already and specify the parameter exactly as in the case of the .vmoptions file on the Windows platform.

If you use the All platforms distribution you have to add or modify the startup parameter that you want to set in the java command line at the end of the startup script syncroSVNClient.bat on Windows, syncroSVNClientMac.sh on Mac OS X and syncroSVNClient.sh on Linux. All these files are located in the installation directory. For example for setting the maximum amount of Java memory to 600 MB on Windows the -Xmx parameter must be modified in the java command at the end of syncroSVNClient.bat like this:

java -Xmx600m -Dsun.java2d.noddraw=true ...

on Mac OS X the java command at the end of syncroSVNClientMac.sh should look like:

java "-Xdock:name=SyncroSVNClient"\
 -Dcom.oxygenxml.editor.plugins.dir="$OXYGEN_HOME/plugins"\
 -Xmx600m\

and on Linux the java command at the end of syncroSVNClient.sh should look like:

java -Xmx600m\
 "-Dcom.oxygenxml.editor.plugins.dir=$OXYGEN_HOME/plugins"\