Install TestLink on a different server

Using this option, you can perform a fresh install of TestLink on a separate server, different from the one where TeamForge is installed.

Before you begin the installation process, it is assumed that you have set up the following in the TestLink server:

Java and Apache are installed on the server where TestLink is installed. To install, run the following command:
- yum install httpd java-1.7.0-openjdk java-1.7.0-openjdk-devel
Make sure that Wget is installed; if it is not installed, do it using the following command:
yum install wget

Verify the following pre-requisites in the TeamForge server:

TeamForge is running only with the PostgreSQL database.
Appropriate permissions are granted in PostgreSQL to allow the TestLink server to connect to it.
- Change the listen_addresses in postgresql.conf residing in the location /var/lib/pgsql/9.2/data/postgresql.conf as given below:
  The listen_addresses token in postgresql.conf looks like this: listen_addresses = '127.0.0.1'.
  
  Append the IP address of the TeamForge server where PostgreSQL is running.
  
  For example: listen_addresses = '127.0.0.1,10.2.17.57', where '10.2.17.57' is the IP address of the TeamForge server.
Add an entry like the following in the pg_hba.conf file residing in the location /var/lib/pgsql/9.2/data/pg_hba.conf:
```
host  ctfdb  ctfuser 10.2.17.67 255.255.255.255 md5
```
Note: Replace the value '10.2.17.67' with the IP address where TestLink is installed.
Restart TeamForge.

Download testlink-1.9.11.tar.gz from testlink.org.
Note: Perform steps 1 to 8 in the TestLink server except the instruction to obfuscate TeamForge PostgreSQL database password explained in step 5.
Click https://ctf.open.collab.net/sf/go/projects.ctftestlink/frs and select the appropriate file to download.
Untar the ctf-testlink-2box-installer-2.1.3.tar file to the /opt/ directory.
- cd /opt/testlink-installer

Modify the install.conf file values given in the following table to suit your installation environment.

Option	Description
testlink_download_location=/tmp/testlink-1.9.11.tar.gz	The full name of the TestLink tar file and the location from where it was downloaded.
testlink_dir=/opt/testlink	The path of the directory where the TestLink files and libraries are installed (directory containing index.php)
domain=<domain name or host name>	The TestLink site information. For example, cu064.cloud.maa.collab.net or testlink.collab.net. You need not give the protocol information here.
protocol	The protocol used for TestLink installation (http or https).
database_name	The MySQL database for TestLink.
database_user	The MySQL database user for TestLink.
ctf_host	The host name/IP address where TeamForge is installed.
ctf_protocol	The protocol used for TeamForge (http or https).
ctf_db_name	The database name for TeamForge.
ctf_db_username	The user name for the TeamForge database.
httpd_user=apache	The Apache user information.
httpd_group=apache	The Apache user group information.

Install the TestLink application in the TestLink server.
1. Run the following command:
  - ./install.py -i
2. The following text will appear prompting you to provide the relevant passwords:
  - "Enter mysql password for 'root' user:"
  - "Enter mysql password for testlink database:"
    Note: For both the above-mentioned prompts, if you are a first time user, enter a new password. However, for subsequent upgrades, you must use the same password because you will not be allowed to enter a new password again.
  - "Enter postgres database password to connect to CTF:"
  Important: To obtain the obfuscated TeamForge PostgreSQL database password, run the following command in the TeamForge server:
  - /opt/collabnet/teamforge/runtime/scripts/get-runtime-property.sh DATABASE_PASSWORD
Recreate the runtime. ./install.py -r
Create a namespace for TestLink.
1. Go to the TestLink installer directory.
  - cd /opt/collabnet/testlink-installer/installer/files
  - vi createnamespace.php
2. Change the CTF_BASE_URL to point to the correct host.
3. Provide the user name and password of any user with site administrator privileges.
4. Run the following command: php createnamespace.php
  Note: You must run it only once for a TestLink installation.
5. The following text will appear prompting you to provide the TeamForge administrator user name and password:
  - "Please Enter CTF Username:" <TeamForge administrator user name>
  - "Please Enter CTF Password:" <TeamForge administrator password>
Restart TeamForge.
The newly generated JAR files are found in /opt/testlink-installer/installer/conf of the TestLink server. Copy these files from the TestLink server and upload them to the TeamForge server. These JAR files can be uploaded via Admin > System Tools > Custom event handlers.
The newly generated configuration files testlink-application.xml and testlink-deploy.xml are found in the /opt/collabnet/testlink-installer/installer/conf folder. Copy these files from the TestLink server and upload them onto the TeamForge server. These files enable the TestLink application to work as part of TeamForge. For more information on how to use them, see Configure TestLink for your TeamForge site. You will notice that the integration setup has been completed and is running successfully.
Next, you must migrate TeamForge users to TestLink by running the following script in the TestLink server:
- cd /opt/collabnet/testlink-installer
- python migrate_users.py
All TeamForge users are now available in TestLink.
Note: Once the migration is done, every time new users are added in TeamForge, they are synchronized automatically with TestLink.

When the users are migrated to TestLink, the permission to access TestLink for migrated users has to be manually created in TeamForge.