TargetProcess: Installation & Upgrade From Archive Guide

If you use Linux or Mac OS X, then consider TargetProcess On-Demand service with full support and good price. The other option is to install Windows on a Virtual Machine.

We strongly don't recommend to install TargetProcess from archive. It is much harder and you will have to upgrade from archive as well which is quite time-consuming. Use Automatic Installation instead if possible.

TargetProcess Installation

You downloaded TargetProcess and have TP-2.x.x.xxxxx-archive.zip file. Extract it into any folder, let's say into D:\TargetProcess_archive.

Create Application

First, it is required to create a folder. Open Windows Explorer and create the folder C:\inetpub\wwwroot\TargetProcess2.

Run IIS Manager (Control Panel → System and Security → Administrative Tools) and create Application Pool:

Create TargetProcess2 application:

Copy all files from D:/TargetProcess_archive/wwwroot folder into C:\inetpub\wwwroot\TargetProcess2 folder.

Create and Configure Database

Run SQL Server 2008 Management Studio, connect to SQL Server (use 'sa' as a login). Open Install_2.19.x.x file from D:/TargetProcess_archive/sql folder and Execute it.

TargetProcess database will be created.

Open web.config file in C:\inetpub\wwwroot\TargetProcess2 folder and change the connection string in the following key

<property name="connection.connection_string">Server=.\SQLEXPRESS;initial catalog=TargetProcess;user id=sa;password=ComplexPassword_99;Connection Timeout=3600</property>
If you install TargetProcess on Windows XP or Windows 2003, give full permissions for several folders to ASPNET user (or IIS_WPG or NETWORK SERVICE in Windows 2003):
C:\inetpub\wwwroot\TargetProcess2\upload
C:\inetpub\wwwroot\TargetProcess2\img

Now open your web browser and run TargetProcess http://localhost/TargetProcess2

Configure (optional)

Configure Culture

If you want to change default culture (en-US), open web.config file and change the following parameter:

<globalization requestEncoding="utf-8" responseEncoding="utf-8" culture="en-US" uiCulture="en-US" enableClientBasedCulture="false"/>

For example, to set Italian culture, it looks like that:

<globalization requestEncoding="utf-8" responseEncoding="utf-8" culture="it-IT" uiCulture="it-IT" enableClientBasedCulture="false"/>

Check complete list of cultures.

Database user and TargetProcess application should have the same language setting, otherwise there will be problems with date conversions. For example, if TargetProcess accesses database with sa user and configured for Italian culture in Web.config, 'sa' user should have Italian as Default Language (to check that, open SQL Server Enterprise Manager, click Security → Logins, find 'sa' user and check it Default Language setting)

Configure Files Storage

TargetProcess stores uploaded files on hard drive by default, but you can change the setting and store files in database. Open web.config and set the following parameter to true:

<add key="Attachment.UseDatabase" value="True"/>

How to Apply Licenses

You have just one license after installation (1 license = 1 active user that may login into TargetProcess) and now it's time to apply more licenses.

You should receive License Key by Email, it looks like 8D5B1FDD-2515-45B2-ACF5-AAE9398F9D2D. If you don’t have License Key, please contact support@targetprocess.com to resolve the problem

Go to Admin → License and click “Register your copy of TargetProcess”.

Automatic Activation

  1. Select Automatic activation.
  2. Enter your License Key and click Next.

Now you've applied your License Key.

Apply license

Manual Activation

If automatic activation failed, try manual activation.

  1. Download License Key File from Customer Center at https://customercenter.targetprocess.com. You should login into Customer Center using your License Key.
  2. Select Manual activation.
  3. Upload the License Key File.

Now you've applied your License Key.

TargetProcess Upgrade

Visit your account in Customer Center, login with your license key and download the latest version of TargetProcess.

Now you've got TP-2.x.x.xxxxx-archive.zip file. Extract it into any folder, let's say into D:\TargetProcess_archive.

Create database backup

Here is the article that reveals database backups magic.

Create application backup

Copy all the files from TargetProcess folder (most likely the folder is C:\inetpub\wwwroot\TargetProcess2) to the safe location.

Stop Application

Stop TargetProcess web site in IIS Administration Console.

Update files

Copy all the files from unzipped D:/TargetProcess_archive/wwwroot directory into C:/Inetpub/wwwroot/TargetProcess2/wwwroot folder.

Restore database connection string

Open old Web.config file and find database connection string. It may look like that:

<property name="connection.connection_string">Server=.\SQLEXPRESS;initial catalog=TargetProcess;user id=sa;password=ComplexPassword_99;Connection Timeout=3600</property>

Copy this connection string. Open new Web.config file and replace this key with the old key.

Restore Uploads

Copy old Upload folder into C:/Inetpub/wwwroot/TargetProcess2/wwwroot

Update Database

Run all required sql files Update_2.x.x.sql one by one from D:/TargetProcess_archive/sql folder. Updates should be run incrementally, e.g. Update_2.11.2.sql, Update_2.11.3.sql, etc. For example, if you have installed 2.18.1, you should run all scripts with 2.18.2 or higher.

Each sql file has USE "@Database"; line. You should delete it or replace @Database with the correct database name.

Run Application

Run TargetProcess web site in IIS Administration Console.


Chapters

  1. TargetProcess Installation from Archive
  2. TargetProcess Upgrade

Last updated: 31 May 2010

If you have any problems with installation, please email us, or
visit Help Desk.