Installing the AssetTrack 4 Web API
Before you can install the AssetTrack 4 WebAPI, you need to have done the following:
- Installed the AssetTrack Server.
- Created the AssetTrack database. See Installing the AssetTrack database for more information.
On this page:
Required installer arguments
You will need to determine the values below prior to running the Web API installer.
Argument | Descritpion | Default | Example |
---|---|---|---|
APPPOOLNAME | Specifies the name of the IIS application pool to be used by the web application | ATApi | APPPOOLNAME=ATApi |
VDIR | Specifies the name of the virtual directory | ATApi | VDIR=ATApi |
INSTALLDIR | Specifies the path for the install files | C:\Program Files (x86)\AMI\AssetTrack 4\Api | INSTALLDIR="C:\Program Files (x86)\AMI\AssetTrack 4\Api" |
DBUSERID | Specifies the Databases User ID | assettrackuser | DBUSERID=assettrackuser |
DBPASSWORD | Specifies the password for the Database User ID specified above | h@mm0nd | DBPASSWORD=h@mm0nd |
DBNAME | Specifies the name of the Database | assettrack | DBNAME=assettrack |
DBSERVER | Specifies the name of the Server | localhost | DBSERVER=localhost |
CLIENTVDIR | Specifies the client virtual directory | ATClient | CLIENTVDIR=ATClient |
USESSL | Specifies if the server hosting the api is using SSL (use 0 for false) | true | USESSL=true |
PORT | Specifies the port the server is listening on (For the client app) | -1 | PORT=80 |
HOSTNAME | Specific the host name of the server hosting the api and client | localhost | HOSTNAME=demo.amitracks.com |
*Note: The INSTALLDIR will need " " if there is spaces in the file pathway, like in the example above.
To install AssetTrack 4 WebAPI
Your AMI sales representative should have sent you an email containing a link to the AssetTrack 4 WebAPI Installer, which is an Microsoft Installer file named AssetTrackWebApi_x.x.x.x.msi. Please submit a request through the AMI Support Help Desk if you did not receive it.
Installer must be run on the IIS machine
Note that AssetTrack 4 WebAPI cannot be installed from a remote machine. The installer must be run on the IIS machine. Also the logged in user must have adequate permissions that will allow them to install software on the machine.
- Open a command line as Administrator.
- Navigate to the location of the AssetTrackWebApi_x.x.x.x.msi
Run the msi from the command line with the required parameters in the above table. Below is an example of what it should look like using our defaults.
Web API Installer Command Template with DefaultsAssetTrackWebApi_x.x.x.xxx.msi APPPOOLNAME=ATApi VDIR=ATApi INSTALLDIR="C:\Program Files (x86)\AMI\AssetTrack 4\Api" DBUSERID=assettrackuser DBPASSWORD=h@mm0nd DBNAME=assettrack DBSERVER=localhost CLIENTVDIR=ATClient USESSL=true PORT=-1 HOSTNAME=demo.amitracks.com
- Open the Internet Information Services (IIS) Management console
- Under Sites > Default Web Site, verify the API web application exists
- Under Application Pools, verify the application pool has been created for the web application