Evaluate Changelogic without registration!
  

Setting up Development and Integration Environments


If you use Changelogic version 1.x, please follow the link: DevelEnvSetupV-1.x


Why set up environment?
Setting up environment in collaboration with build script integration enables all the command line features that need to be executed in a working directory containing the source code of your project to be useful.

Required third party software

Optional third party software

You need at least one of the following:

  • for accessing CVS servers: CVS client (use latest, but not experimental) from any of the GNU FTP mirrors directory gnu/prep/non-gnu/cvs/binary/stable/x86-woe (use CVSNT client only for accessing CVSNT servers)
  • for accessing Subversion servers: Subversion client
  • for using svn+ssh protocol under Windows: Tortoise Plink? (comes as part of TortoiseSVN package)

Preparing developer environment for working with CVS

  1. Make sure the environment variable “CVSROOT” is set and pointing to correct instance
  2. Type cvs login on command line, enter your CVS password if prompted to do so
  3. Type cvs checkout -r latest myproject on command line

Preparing developer environment for working with Subversion

There is a separate page on setting up JavaHL and Subversion client.

Setting up developer/integrator environment

  1. Prepare working directory according to your version control server and instructions above
  2. Create and configure changelogic-personal.properties file in your working directory's top level (sample can be downloaded from your Changelogic instance's “Supporting files” page available from the personal menu)
  3. Get authentication code from the web interface (project menu -> new authentication code) and put it into changelogic-personal.properties file (property cl.auth-token)
  4. Create new change from web interface
  5. Type ant edit on command line and enter change ID when asked

Using Changelogic client with HTTPS protocol

  • Get your public CA certificate (X.509) in DER format (for instance, example.cer)
  • Run command: keytool -import -trustcacerts -file example.cer -alias ExampleCA -keystore %JAVA_HOME%\jre\lib\security\cacerts
    • default password for the keystore is 'changeit'
  • In file changelogic-personal.properties set the cl.rooturl point to Changelogic over HTTPS, for instance: cl.rooturl=https://changelogic.example.com

Proceed to build script command reference to find out the full command set.

Setting up svn+ssh protocol on Windows

  1. Download and install TortoiseSVN
  2. Set environment variable SVN_SSH to "C:\\Program Files\\TortoiseSVN\\bin\\TortoisePlink.exe" -l myuser -pw mypassword (adjust path according to your installation location; you MUST use double backslashes, otherwise it won't work)

If having the password revealed in the environment variable makes you feel uncomfortable, you may instead set up authentication keys:

  1. Download and run PuTTYgen
  2. Click “Generate” in PuTTYgen, follow instructions to move your mouse above the blank area
  3. Log in to your ssh account, edit file .ssh/authorized_keys (create the directory and/or file if needed)
  4. Append the text from field “Public key for pasting into OpenSSH authorized_keys file” as a line in that file
  5. Save the file
  6. In PuTTYgen, click “Save private key” and save the key to a file
  7. Set environment variable SVN_SSH to "C:\\Program Files\\TortoiseSVN\\bin\\TortoisePlink.exe" -l myuser -2 -i "C:\\Documents and Settings\\myuser\\My Documents\\myprivatekey.ppk" (adjust paths according to your system; again, you MUST use double backslashes for these settings to work)