Documentation (beta)

Example: installing on Windows

In this example tutorial, we will show how to setup and install SyncRelease on Windows platform. As SyncRelease requires to run on PHP and MySQL, the easiest way to run by using Wamp, a complete software bundle for running PHP applications on Windows, which stands for Windows, Aapche, MySQL and PHP.


To install Wamp, you can simply visit http://www.wampserver.com/en/ and download the one with PHP 5.3 or greater.


NOTE: please download only the 32 bit version because ionCube Loader required by SyncRelease is compatible only with 32 bit version on Windows.


After you completed installing Wamp on your Windows machine and starting all services from Wamp, you can continue to the next section below.


Installing SVN Client + ionCube Loader

SVN Client and ionCube Loader are parts of the System Requirements for installing SyncRelease. So, let’s go ahead with installing them.


To install SVN client, please visit http://www.collab.net/downloads/subversion and download Subversion 1.7.10 or greater. After download, you can simply click and run the installer and follow the installation wizard. It’s very easy to install on Windows, thanks to MSI installer.


To install ionCube Loader, first download ionCube Loader wizard http://www.ioncube.com/loader-wizard/loader-wizard.zip. Then, extract the downloaded zipped file and place the ioncube folder from extracted folder into C:\wamp\www folder.


Next, go to http://localhost/ioncube/loader-wizard.php in a web browser such as Chrome or Firefox. You will see the instructions on what to download and steps to installing ionCube Loader. You will see a screen similar to the one below, and simply follow those instructions.


../_images/9071662965_f96382c250_o.png

After successfully installed ionCube Loader, you will see a screen like below.


../_images/9071794861_94dbd4b464_o.png


Installing SyncRelease

SyncRelease requires to run as a virtual host on Apache. Therefore you will need a public domain name or a “fake” internal domain name. For more information about how to setup internal fake domain name please visit to Hosts file configuration for running SyncRelease locally


Here in this tutorial, we will assume to use “syncrelease.mycompany.com” as domain name for virtual host.


CREATE DATABASE syncreleasedb;
GRANT ALL PRIVILEGES ON syncreleasedb.* TO 'dbuser'@'localhost' IDENTIFIED BY 'dbpassword'

../_images/fig-7.png

  • Next, let’s create a virtual host for SyncRelease. Open C:\wamp\bin\apache\apache2.2.22\conf\httpd.conf in a text editor such as Notepad or Notepad++, then search for the line where it appears as follow:
# Virtual hosts
#Include conf/extra/httpd-vhosts.conf
  • Remove # sign before Include conf/extra/httpd-vhosts.conf text and save it.
  • Open C:\wamp\bin\apache\apache2.2.22\conf\extra\httpd-vhosts.conf file in a text editor such as Notepad or Notepad++ and then add the following content:
<VirtualHost *:80>
        DocumentRoot "C:\wamp\websites\syncrelease\public"
        ServerName syncrelease.mycompany.com
        SetEnv APPLICATION_ENV production

        <Directory "C:\wamp\websites\syncrelease\public">
                Options Indexes MultiViews FollowSymLinks
                AllowOverride All
                Order allow,deny
                Allow from all
        </Directory>

        RewriteEngine off
        <Location />
                RewriteEngine On
                RewriteCond %{REQUEST_FILENAME} -s [OR]
                RewriteCond %{REQUEST_FILENAME} -l [OR]
                RewriteCond %{REQUEST_FILENAME} -d
                RewriteRule ^.*$ - [NC,L]
                RewriteRule ^.*$ /index.php [NC,L]
        </Location>
        ErrorLog "logs/syncrelease-error.log"
</VirtualHost>
  • Save it and enable Apache’s rewrite_module by clicking on wamp service icon at the right-bottom taskbar of your computer screen, as shown below

../_images/9079507649_35214f02ed_o.png

  • then click on “Apache modules” and then click on “rewrite_module” to enable it. And also enable PHP socket extension by clicking PHP > PHP extensions.
  • Restart the Apache by clicking “Restart All Services” from wamp service icon from right-bottom taskbar.
  • Edit C:\wamp\websites\syncrelease\applications\configs\application.ini file in a text editor such as Notepad++. And change those lines as shown below.
;******* required configurations by SyncRelease administrator ******
resources.db.params.host = "localhost"
resources.db.params.username = "dbuser"
resources.db.params.password = "dbpassword"
resources.db.params.dbname = "syncreleasedb"

resources.svnclient.path = C:\Program Files\CollabNet\Subversion Client\svn.exe

;**** Optional settings ******
resources.constants.PHP_CLI_PATH = C:\wamp\bin\php\php5.3.13\php.exe
resources.constants.TEMP_DIR_PATH = C:\wamp\tmp

  • Save it and open http://syncrelease.mycompany.com in a web browser such as Chrome. If your setup has any problem, SyncRelease will pinpoint you and how to fix it as similar to below.
../_images/fig-4.png


  • Otherwise, you are now ready to install SyncRelease, with a screen similar to below.
../_images/fig-5.png


  • Enter your license and administrator information, and click Nex button. Upon successful installation, you will see a screen like this.
../_images/fig-6.png

Congratulations!!! You made it!