Installing new versions

Kurt Lingohr
- January 04, 2017 03:20

This help article is for Enterprise customers and explains how to install the latest version onto their servers using the "command line" approach. There is another approach - fully automated - which requires installing an agent on your server which polls our repository server for updates. This does require, however, firewall changes as non-standard ports are used.

Nuget

Every time we release a new version, we create a "nuget" package. Think of this like a zip file, which contains all the files and folders in a special format developed by Microsoft.

To download a version of PoolCar you will need to use the nuget.exe command line tool. Yes, the good 'ol command line!

This is a one-time download and needs to be installed on your server, or a staging server:

The remainder of this document explains how to use the nuget.exe command line program. The URL as specified with the "-source" option is not shown here below for obvious reasons, nor is the username and password to access the repository. Please contact us for these details if you haven't already.

List of all Versions

From the command line:

nuget list PoolCar -source http://secret -allversions

Examples

To install the latest version to the c:\inetpub\wwwroot\PoolCar directory:

As the package name is "PoolCar" it will always create a sub-directory called "PoolCar" underneath the outputdirectory, if it doesn't exist. Your IIS website should point to this PoolCar sub dir. Some customers may have called sub-dir by another name, such as FleetBookings or similar. It is recommended that you rename this folder to "PoolCar" and update IIS accordingly.

If you do not want to write directly to the app root folder, then we suggest an outputdirectory that is out of the way, such as a temp folder or staging area. You can then copy or xcopy the files from staging to the production folder.

Avoid version numbers that do not end in a zero as these are test releases destined for QA. Stick to versions that end in a zero as these are considered stable. For example - test 4.8.1.1, stable 4.8.2.0

If you have a formal UAT process, use pulls only to your UAT server, not production. 'Bubble-up' the UAT candidate once it has passed to your production box via copy or xcopy.

If your booking receipt emails do not have .ics calendar attachments (and you have enabled this in Application Settings) then you may not have modify permissions on the TempFiles folder. Grant access permission to "Network Service" and "IIS_IUSER" users to this folder.

The UploadedFiles folder also needs access permission to "Network Service" and "IIS_IUSER" users. This folder is used for exporting Excel files from PoolCar (Booking Search, Vehicle/Driver/Servicing Registers, etc).