How to Create a TrakPC Login Script or Batch File

Information

TrakPC is a program that reads the hardware configuration and software information from your computer and records it into an XML file, which can then be imported into Issuetrak (either directly or manually). The easiest way to implement this is via logon script.

Anonymous Authentication needs to be enabled for a single ASP file on your Issuetrak site in order for TrakPC to successfully POST its audits. 

Preparation

You will need to identify a location where the TrakPC executable will reside.  If you wish to use this as part of a login script, then you will need to identify a shared network drive location that all of your users will be able to access.

Copy the TrakPC.exe file found in your Issuetrak web directory's "TrakPC" folder to the location you've found most suitable. 

Steps

  1. Right-click on your Desktop, choose New, and then Text Document
  2. Name the file "TrakPC.txt".
  3. Open the text document, then copy and paste the following:
     
    location\TrakPC.exe /u"https://yoursitename/inv_TrakPC_URLSubmit.asp"
    pause
  4. Keep the structure of the lines above the same.  Spaces and quotes should be retained.
  5. Update location to reflect the location of your TrakPC executable.
  6. Update yoursitename to reflect the URL/hostname of your Issuetrak site.
  7. Rename the text file to TrakPC.bat.
  8. Execute the batch file by double-clicking on it.  You should receive a message similar to the following:
     
    Gathering information
    Posting data to "https://yoursite/inv_TrakPC_URLSubmit.asp"
    POST successful, data sent
    Done
  9. If you do not see a "POST successful" message, then you'll need to troubleshoot the error it specifies. 
  10. If you do see "POST successful", then edit the file and remove the line "pause" and save the batch file again.

Output Location

By default, TrakPC will place the XML file in the current user's temp folder.  For most people, this will be fine.  However, if multiple users use the same computer, then a login script could potentially run multiple times for the same computer even if you have a frequency set.  To set a universal location for the XML file, simply place the universal location after location\trakpc.exe. 

The following example will output the XML file into C:\Temp with the name TrakPC.xml:

C:\Trak\TrakPC.exe c:\Temp\TrakPC.xml /u"https://yoursitename/inv_TrakPC_URLSubmit.asp"

Make sure that your users have permission over this location, otherwise they will receive an error because they don't have the appropriate permissions to create a file there. 

Frequency

It is up to you to determine how often the TrakPC script should run.  We recommend setting the frequency within the batch file itself, using the /f option. 

As a best practice, set a weekly frequency by using the /fw switch.  For detailed information about setting/specifying a frequency for TrakPC, please refer to KB 1560

Examples

These examples provide a few differenct scenarios of frequency, executable location, and XML file output location.  Note that although we are specifying an SSL site to POST to as a best practice, TrakPC will also with non-SSL sites.

Example 1

This runs the TrakPC.exe from the same location as the batch file.

TrakPC.exe /u"https://Issuetrak/inv_TrakPC_URLsubmit.asp"
Example 2

This runs the TrakPC.exe from the root of the C:\ drive and has a frequency set for weekly.

C:\TrakPC.exe /fw /u"https://Issuetrak/inv_TrakPC_URLsubmit.asp"
Example 3

This runs the TrakPC.exe from a shared folder and has a frequency set for monthly.

\\share\TrakPC.exe /fm /u"https://Issuetrak/inv_TrakPC_URLsubmit.asp"
Example 4

This runs the TrakPC.exe from the same location as the batch file, but outputs the XMLfile to the C:\Temp\ folder and has a frequency set for quarterly.

TrakPC.exe C:\Temp\ /fq /u"https://Issuetrak/inv_TrakPC_URLsubmit.asp"