Difference between revisions of "ITrack/Installation"

From ISoft Wiki
Jump to navigationJump to search
 
(51 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This guide will help you setup ITrack for a new user.  It is meant for both Pro and Enterprise.
This guide will help you setup ITrack for a new user.  It is meant for both Pro and Enterprise.
==Server Side==
Note: These setups only need to be completed for new customers
#Download [http://dl.isoftdata.com/mysql-essential-5.0.24-win32.msi MySQL 5.0 from dl.isoftdata.com]
#Install [http://en.wikipedia.org/wiki/Mysql MySQL]
#Run the MySQL Server Instance Configuration Wizard
##Detailed Configuration
##Developer Machine
##Non-Transactional Database Only
##Uncheck "Enable Strict Mode"
#Check to make sure port 3306 is allowed in any [http://en.wikipedia.org/wiki/Firewall firewall] that may exist
#[http://dl.isoftdata.com/SQLyog511.exe Download and Install SQLyog]
#Run the SQL scripts in [http://en.wikipedia.org/wiki/Subversion_(software) SVN] to create/populate/update the database
#Create a directory somewhere and share it so that everyone has read/write privileges
##Create Reports, Images and Attachments sub directories
##Copy the latest reports from SVN to the reports directory
#[[HeavyTruckParts.net/How to install Image Uploader|Setup the Image Uploader]]
#[[Replikwando/Installation|Setup Replikwando]]
==Client Side==
==Client Side==
* If this is a new customer, you should do the [[#Server_Side|server side]] setup first.
===Installing ITrack===
# Download the ITrack installer for the specific product
# Download the ITrack installer for the specific product
## [http://dl.isoftdata.com/ITrack%20Pro%20Truck%20Installer%209.1.7351b.exe ITrack Pro Installer (HT)]
#* [http://dl.isoftdata.com/ITrack%20Pro%20Setup.exe ITrack Pro]
## [http://dl.isoftdata.com/ITrack%20Pro%20Car%20Installer%209.1.7351b.exe ITrack Pro Installer (Auto)]
#* [http://dl.isoftdata.com/ITrack%20Enterprise%20Setup.exe ITrack Enterprise]
## [http://dl.isoftdata.com/ITrack%20Enterprise%20Installer.exe ITrack Enterprise Installer]
#* [http://dl.isoftdata.com/ITrack%20AX%20Setup.exe ITrack AX]
# Run the Installer
# Run the Installer
# The setup program will install the following:
# The setup program will install the following:
## ITrack
#* ITrack
## Crystal 11
#* Crystal 11
## PDF Creator (On Vista, use [http://www.cutepdf.com/Products/CutePDF/writer.asp Cute PDF]).
#* PDF Creator
## MySQL ODBC connection
#* 3 of 9 Barcode font
## Instant VNC
#* MySQL ODBC connection
## ITrack Registration
#* Instant VNC
# You will need to generate a code using the Code Generator which is available in SVN: ITrack/General/CodeGenerator/CodeGenerator.html
#* ITrack Registration
# When the installer for PDF Creator finishes, there is no need to restart the computer.
#* Microsoft Visual C++ 2005 Redistributable Package and SP1
# Open up the directory where ITrack is installed
# When the ITrack Registration program runs, it will generate a random product code for that computer.  This code is not guaranteed to be unique on our autoupdate server!  You should make sure it is unique by adding it to our autoudate system as soon as possible. If it is not unique, you should clear the product code out of the registry(HKEY_LOCAL_MACHINE\SOFTWARE\ISoft Data Systems\ITrack <Enterprise or Pro> on x86 and HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ISoft Data Systems\ITrack <Enterprise or Pro> on 64bit Windows) and run ITrack Registration to generate a new one.
# Open the host.ini file with a text editor
# To finish registering ITrack, enter a release code into the ITrack Registration program. You can generate a release code using the Code Generator <svnroot>\ITrack\trunk\General\CodeGenerator
# In the database section set hostname equal to the name of the server
# Put the computer in the [http://isoftdata.com/autoupdate/Auto Update System]
# In the general section set the reportsdir, imagesdir, and attachdir to their corresponding directory created on the server (see step 7.1 in the "Server Side" section)
# Put the computer in the [http://isoftdata.com/autoupdate/ Auto Update System]
## Add a new customer
## Add a new customer
# Turn on updates for this computer
# Turn on updates for this computer
## Go to Manage Customers
## Go to Manage Customers
## Select the computer that you are working on (the company, then the same name as your VNC Connection)
## Select the computer that you are working on (the company, then the same name as your VNC Connection)
## Highlight All of the updates EXCEPT Master Test, New Update Test, and QB Extension List
## Select all of the appropriate extensions. For example, if you are installing ITrack for a customer who doesn't need the QuickBooks extension... don't select the QuickBooks extension. This section is being rapidly changed/updated, but using common sense will help you get the job done.
## Possible ITrack Pro Extensions that may not need to be selected: Enable HTP Export, HT Extension List, Quickbooks Extension List, Quickbooks Toolkit
# Launch ITrack
# Launch ITrack
# Confirm that it downloads the latest updates
# Confirm that it downloads the latest updates
# Restart ITrack
# Restart ITrack
# Setup the [[ITrack/ODBC|MySQL ODBC Connector]]
# Pat yourself on the back
# Pat yourself on the back
<b>Note</b>: If you want to run ITrack with a different configuration file, create a shortcut and change "Target" in its properties to have a -i <config file name>.ini at the end (where <config file name> is the name of the new ini file). Example: "C:\Program Files\ISoft Data Systems\ITrack Pro\itrack.exe" -i host2.ini
===Configuration===
# Open up the directory where ITrack is installed
# If ITrack won't be run as an admin, you will need to give full permissions to everyone for the ITrack directory for updating purposes
<b>Note</b>: If its on a XP Home machine, run this command to set the correct permissions for the installation directory so updating works:
<source lang="dos">
cacls "C:\Program Files\ISoft Data Systems\ITrack Pro" /T /P Everyone:F
</source>
==Server Side==
===MySQL Installation===
{{Tip| Server side setups only need to be completed for new customers}}
Go to [[MySQL Server Install]] for complete details on what to do.
===Database Setup===
#[http://tools.isoftdata.com/SQLyog814.exe Download and Install SQLyog]
#Run the SQL scripts in [http://en.wikipedia.org/wiki/Subversion_(software) SVN] (SVN/Trunk/ITrackPro/Databases) in the correct order to create/populate/update the database
#Create a directory somewhere on the server and share it so that the "Everyone" group has full read/write privileges
##Create Reports, Images and Attachments sub directories
##Copy the latest reports from SVN to the reports directory
===And Don't forget===
#[[HeavyTruckParts.net/How to install Image Uploader|Setup the Image Uploader]]
#[[Replikwando/Installation|Setup Replikwando]]

Latest revision as of 12:40, 15 December 2015

This guide will help you setup ITrack for a new user. It is meant for both Pro and Enterprise.

Client Side

  • If this is a new customer, you should do the server side setup first.

Installing ITrack

  1. Download the ITrack installer for the specific product
  2. Run the Installer
  3. The setup program will install the following:
    • ITrack
    • Crystal 11
    • PDF Creator
    • 3 of 9 Barcode font
    • MySQL ODBC connection
    • Instant VNC
    • ITrack Registration
    • Microsoft Visual C++ 2005 Redistributable Package and SP1
  4. When the ITrack Registration program runs, it will generate a random product code for that computer. This code is not guaranteed to be unique on our autoupdate server! You should make sure it is unique by adding it to our autoudate system as soon as possible. If it is not unique, you should clear the product code out of the registry(HKEY_LOCAL_MACHINE\SOFTWARE\ISoft Data Systems\ITrack <Enterprise or Pro> on x86 and HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ISoft Data Systems\ITrack <Enterprise or Pro> on 64bit Windows) and run ITrack Registration to generate a new one.
  5. To finish registering ITrack, enter a release code into the ITrack Registration program. You can generate a release code using the Code Generator <svnroot>\ITrack\trunk\General\CodeGenerator
  6. Put the computer in the Update System
    1. Add a new customer
  7. Turn on updates for this computer
    1. Go to Manage Customers
    2. Select the computer that you are working on (the company, then the same name as your VNC Connection)
    3. Select all of the appropriate extensions. For example, if you are installing ITrack for a customer who doesn't need the QuickBooks extension... don't select the QuickBooks extension. This section is being rapidly changed/updated, but using common sense will help you get the job done.
    4. Possible ITrack Pro Extensions that may not need to be selected: Enable HTP Export, HT Extension List, Quickbooks Extension List, Quickbooks Toolkit
  8. Launch ITrack
  9. Confirm that it downloads the latest updates
  10. Restart ITrack
  11. Pat yourself on the back

Note: If you want to run ITrack with a different configuration file, create a shortcut and change "Target" in its properties to have a -i <config file name>.ini at the end (where <config file name> is the name of the new ini file). Example: "C:\Program Files\ISoft Data Systems\ITrack Pro\itrack.exe" -i host2.ini

Configuration

  1. Open up the directory where ITrack is installed
  2. If ITrack won't be run as an admin, you will need to give full permissions to everyone for the ITrack directory for updating purposes

Note: If its on a XP Home machine, run this command to set the correct permissions for the installation directory so updating works:

cacls "C:\Program Files\ISoft Data Systems\ITrack Pro" /T /P Everyone:F

Server Side

MySQL Installation

Tip
Server side setups only need to be completed for new customers

Go to MySQL Server Install for complete details on what to do.

Database Setup

  1. Download and Install SQLyog
  2. Run the SQL scripts in SVN (SVN/Trunk/ITrackPro/Databases) in the correct order to create/populate/update the database
  3. Create a directory somewhere on the server and share it so that the "Everyone" group has full read/write privileges
    1. Create Reports, Images and Attachments sub directories
    2. Copy the latest reports from SVN to the reports directory

And Don't forget

  1. Setup the Image Uploader
  2. Setup Replikwando