Codewarp Home
Login | Site Map
Installation Guide

Codewarp Installation Guide

March 2005

Copyright © 1998-2005, Codewarp Inc. All rights reserved.

Preface

This guide is intended for use by anyone who is responsible for installing or upgrading Codewarp Software.

Installation entails meeting system requirements, copying files to your system, initializing database files, licensing, configuring, and verifying functionality.

Requirements

The Codewarp system contains several core components that you can install on a single host or on multiple hosts. The installation and configuration of these components can cross one or more web, database and browser hosts.

Web Server

  • Microsoft Windows XP/2000/2003 with IIS and .NET Framework 1.1
  • Linux with Apache and Mono

Database

  • Microsoft SQL Server 2000/MSDE
  • Oracle 8/9/10
  • PostgreSQL 7/8

Browser

Setup

There are many combinations of web, database and browser setups that are supported by Codewarp applications. This document steps through only one combination that can setup on one Microsoft Windows machine.

Microsoft .NET Framework 1.1

The .NET Framework can be acquired (at no charge) from msdn.microsoft.com/netframework/downloads/updates/default.aspx.

Microsoft SQL Server 2000 or MSDE 2000

MSDE can be acquired (at no charge) from www.microsoft.com/downloads/details.aspx?familyid=413744D1-A0BC-479F-BAFA-E4B278EB9147.

  1. Unpack MSDE2000A.exe by clicking on the downloaded file in your explorer.
  2. Start a command prompt (Start - Run - Open "cmd" [OK]).
  3. Change directory (cd) to the included unpacked MSDE folder, for example :
  4.   cd \MSDERelA
    

  5. Execute the following command to setup SQL Server with your own password and mixed mode security :
  6.   setup.exe SAPWD=secret SECURITYMODE=SQL
    

Codewarp Application

Application packages can be acquired from www.codewarp.com/downloads.

  1. Unzip Codewarp application package into application folder (C:\Codewarp)
  2. Start a managment console (Start - Run - Open "compmgmt.msc" [OK]).
  3. Create virtual directory in IIS named "com" with a path to the application com folder (C:\Codewarp\com).
  4. Start a command prompt (Start - Run - Open "cmd" [OK]).
  5. Change directory (cd) application data directory for MS SQL Server, for example :
  6.   cd \Codewarp\com\data\mssql
    

  7. Execute the restore command to load the database where 'app' is the product code of the application :
  8.   restore.app.bat
    

Licensing

A software product license grants you the legal right to run a software program. When you purchase licenses for software products, the software license is included either in the box or online when you install the software.

To activate your Codewarp software license you must register your software serial number and system checksum to generate a license key unique for your system. Codewarp designed the registration process to verify licensed software. Codewarp products are licensed "per processor."

Your software serial number is provided to you when you either purchase the software or generate a trial serial number.

  1. Obtain your system's checksum by executing the Codewarp "ppln.exe" program from your software installation folder, for example from the command prompt :
  2.   cd \Codewarp\com\bin
      ppln.exe
    

  3. Register your software serial number and system checksum online at www.codewarp.com/license.
  4. The generated "key" text must be copied to your system in order for your software to run. If you are licensing a Codewarp Web Application, edit the application's config file. For example, from the command prompt :
  5.     notepad \Codewarp\com\config_app.aspx
    

    Or, if you are licensing a Codewarp Component, edit the component's key.txt file. For example, from the command prompt :
        notepad \Codewarp\com\bin\Pipeline.dll.key.txt
    

  6. Copy the generated key over the existing key and save.

Configuring

You can configure Codewarp Applications for your specific use by editing one central configuration file. The configuration file is located in the application's com folder. Open 'config_app.aspx' with notepad or your favorite text editor. For example, from the command prompt :

 notepad \Codewarp\com\config_app.aspx

The following outlines each parameter's use :

KEY
This text is your license key. Each key will only work for one product code on one machine. You can obtain a license key from http://www.codewarp.com/license.
DATABASE_TYPE
This number is used by the system to generate SQL for specific database types. Four database types are currently supported; 1 Access, 2 Oracle, 3 SQLServer, and 4 PostgreSQL.
DATABASE_PROVIDER
This number is used by the system to dynamically utilize specific .Net database providers. Four database providers are currently supported; 0 ODBC, 1 SQLClient, 2 OLEDB, and 3 ORACLEClient.
DATABASE_CONNECTION
This text is used by the system to open it's database. The connection string includes the data source name, and other parameters needed to establish the initial connection.
WWW_HOST
This text is used by the system to build HTTP URLs. The host name should resolve via DNS.
WWW_PORT
This number is used by the system to build HTTP URLs. The port number should match the port your HTTP server is listening. The standard HTTP port number is 80.
MAIL_HOST
This text is used by the system to send e-mail via SMTP. The host name should resolve via DNS.
MAIL_PORT
This number is used by the system to send e-mail via SMTP. The port number should match the port your SMTP server is listening. The standard SMTP port number is 25.
SECURE_HOST
This text is used by the system to build HTTPS URLs. The host name should resolve via DNS.
SECURE_PORT
This number is used by the system to build HTTPS URLs. The port number should match the port your HTTPS server is listening. The standard HTTPS port number is 443.
SENDMAIL_COMPONENT
This text is used by the system to send e-mail via SMTP. There are several components supported; System.Web.Mail, CDO, Persits.MailSender, and CDONTS.NewMail. The default component that is part of the .Net Framework is System.Web.Mail. The other components require additional installation and provide additional capabilities.
CHART_COMPONENT
This text is used by the system to create charts and graphs. Currently, only one charting component is supported and that is the .Net version of ChartDirector.
INCOMING_FOLDER
This text is used by the system to receive files. The folder path must exists and must be writable by the HTTP/HTTPS server user account.
OUTGOING_FOLDER
This text is used by the system to send files. The folder path must exists and must be writable by the HTTP/HTTPS server user account.
VAULT_FOLDER
This text is used by the system to archive sensitive files. The folder path must exists and must be writable by the HTTP/HTTPS server user account.
LOG_FOLDER
This text is used by the system to save log files. The folder path must exists and must be writable by the HTTP/HTTPS server user account.
TEMP_FOLDER
This text is used by the system to save temporary files. The folder path must exists and must be writable by the HTTP/HTTPS server user account.
INCOMING_ALIAS
This text is used by the system to build URLs to send files. The virtual directory should point to the incoming folder.
OUTGOING_ALIAS
This text is used by the system to build URLs to received files. The virtual directory should point to the outgoing folder.
PIPELINE_MEMORY
This boolean toggles whether the Pipeline component executes in-memory (True) or on the file system (False). Pipeline executes faster in-memory, but executing on the file system allows for easier diagostics.
PRODUCT_CODE
This string is used to verify your license key. Each key will only work for one product code. Do not change this string.

Note: Other application specific configurations can be set via the user interface.