Installation

Install Perforce

Download Perforce from the Perforce website and install it on your system according to the instructions provided on the Perforce website. ExtraView Corporation does not support this step. Please refer to Perforce Software for support. The Perforce P4 command-line interface must be installed on the same machine as the Integration Daemon listed below. The Perforce server and P4 command-line interface may be installed on the same server or on separate machines.

Install Java

Download the latest Java runtime from the Oracle website and install it according to the installer and instructions provided on the website. You may download either the J2SE SDK or JRE.

Environment Variables

Set JAVA_HOME as an environment variable in your operating system. The value for JAVA_HOME should be the name of the folder that contains the Java runtime environment

Download and Install the Integration Daemon

The Integration Daemon files are available from the ExtraView Support Download page. This is at http://www.extraview.com/site/content/extraview-download-upgrades. (If you do not have a password to access downloads, please email ExtraView support at support@extraview.com) Extract the files from the download into a folder on your server. The path to this folder is known in the documentation as INTEGRATION_HOME.

INTEGRATION_HOME/
    configuration/
    data/
    lib/
    logs/
    JavaService.exe
    installIntegrationDaemonService.bat
    start_commands.txt
    start_daemon.bat
    start_daemon.sh
    uninstallIntegrationDaemonService.bat

On Windows, edit the start_daemon.bat script with a text editor and make sure that the following lines are configured properly for your environment. For example, the following lines configure the integration daemon to run the Perforce integration instead of the Salesforce integration:

set integration=p4
rem set integration=sf

On Linux, edit the start_daemon.sh script with a text editor and make sure that the JAVA_HOME and integration variables are configured properly for your environment. For example:

JAVA_HOME=/usr/local/extraview/java
integration=p4
#integration=sf

Next, make the start_daemon.sh script executable with the chmod command. For example:

chmod +x start_daemon.sh

Lastly, ensure that file permissions allow the Linux user executing the start_daemon.sh script to read all the files extracted and have write permission to the following directories and files:

INTEGRATION_HOME/logs/
INTEGRATION_HOME/logs/error.log
INTEGRATION_HOME/data/Perforce/
INTEGRATION_HOME/data/Perforce/state.properties

64 Bit Versus 32 Bit Versions

The installation instructions assume you are working on a 64 bit operating system version.  If you are installing the daemon on a 32 bit operating system, substitute installIntegrationDaemonService_32bit.bat wherever installIntegrationDaemonService.bat is referenced.

Installing Integration Daemon as a Windows Service

This section only applies if you are installing the Integration Daemon on a Microsoft Windows server, and wish to run it as a service.

  1. Edit the installIntegrationDaemonService.bat file in the INTEGRATION_HOME folder
  2. Set the JAVA_DLL_HOME variable to the path of the server directory of the JVM, e.g.,

    set JAVA_DLL_HOME=C:\ExtraView\jdk1.5.0_22\jre\bin\server
     

  3. Set the INTEGRATION_HOME variable to the path of your INTEGRATION_HOME folder, e.g.,

    set INTEGRATION_HOME=C:\ExtraView\integrationdaemon
     

  4. Ensure the line set integration=p4 is uncommented (i.e., remove rem) and that the line set integration=sf is commented (i.e., add rem), e.g.,
     
    set integration=p4 rem set integration=sf
     
  5. Save the edited batch file, and run it one time. This will create a new service in Windows called ExtraViewIntegrationDaemon. It defaults to starting automatically, but you can change its startup parameters by using the Services control panel in Windows.