Difference between revisions of "ITrack/Installation"

From ISoft Wiki
Jump to navigationJump to search
 
(53 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.
==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
#* [http://dl.isoftdata.com/ITrack%20Pro%20Setup.exe ITrack Pro]
#* [http://dl.isoftdata.com/ITrack%20Enterprise%20Setup.exe ITrack Enterprise]
#* [http://dl.isoftdata.com/ITrack%20AX%20Setup.exe ITrack AX]
# Run the Installer
# 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
# 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.
# 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
# Put the computer in the [http://isoftdata.com/autoupdate/Auto Update System]
## Add a new customer
# Turn on updates for this computer
## Go to Manage Customers
## Select the computer that you are working on (the company, then the same name as your VNC Connection)
## 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
# Confirm that it downloads the latest updates
# Restart ITrack
# 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==
==Server Side==
#Download [http://dl.isoftdata.com/mysql-essential-5.0.24-win32.msi MySQL 5.0 from dl.isoftdata.com]
===MySQL Installation===
#Install [http://en.wikipedia.org/wiki/Mysql MySQL]
{{Tip| Server side setups only need to be completed for new customers}}
#Run the MySQL Server Instance Configuration Wizard
Go to [[MySQL Server Install]] for complete details on what to do.
##Detailed Configuration
 
##Developer Machine
===Database Setup===
##Non-Transactional Database Only
#[http://tools.isoftdata.com/SQLyog814.exe Download and Install SQLyog]
##Uncheck "Enable Strict Mode"
#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
#Check to make sure port 3306 is allowed in any [http://en.wikipedia.org/wiki/Firewall firewall] that may exist
#Create a directory somewhere on the server and share it so that the "Everyone" group has full read/write privileges
#[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
##Create Reports, Images and Attachments sub directories
##Copy the latest reports from SVN to the reports directory
##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]]
#[[HeavyTruckParts.net/How to install Image Uploader|Setup the Image Uploader]]
#[[Replikwando/Installation|Setup Replikwando]]
#[[Replikwando/Installation|Setup Replikwando]]
==Client Side==
#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%20Car%20Installer%209.1.7351b.exe ITrack Pro Installer (Auto)]
##[http://dl.isoftdata.com/ITrack%20Enterprise%20Installer.exe ITrack Enterprise Installer]
#Run the Installer
#The setup program will install the following:
##ITrack
##Crystal 11
##PDF Creator
##MySQL ODBC connection
##Instant VNC
##ITrack Registration
##PDF Creator does not work on Windows Vista machines. Instead, download Cute PDF Writer. You can find the program at http://www.cutepdf.com/Products/CutePDF/writer.asp
#You will need to generate a code using the Code Generator which is in SVN ...Itrack/General/CodeGenerator/CodeGenerator.html
#When the installer for PDF Creator finishes, there is no need to restart the computer.
#Open up the directory where ITrack is installed
#Open the host.ini file with a text editor
#In the database section set hostname equal to the name of the server
#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
#Turn on updates for this computer
##Go to Manage Customers
##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
#Launch ITrack
#Confirm that it downloads the latest updates
#Restart ITrack
#Setup the [[ITrack/ODBC|MySQL ODBC Connector]]
#Pat yourself on the back

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