Appendix: Sending Reports Manually

Realizing that not every customer wants a completely automated system, Altair provides two methods to manually send license usage reports. Method 1 takes the automated sending out of the loop, and allows the customer to start the URT by hand. It still utilizes the totally automated system for collecting, zipping, communicating, and moving the logs. Method 2 is completely manual, requiring some work on the administrator’s part to gather logs, etc. and deliver them manually via email or web upload to Altair.

The current, open log file is in the processing directory. All closed, finished logs are stored in pending, and successfully sent zip files are kept in sent. The directory bin contains the file that is used to start the URT (urt.bat or urt.sh). All log files are plain text and digitally signed to prevent tampering.

The current URT utilizes a Java program (lib/altairURT.jar) to send the data from the host to Altair. The configuration file for the program is alus.conf. This is where things such as proxy settings and HTTP vs. HTTPS are configured.

In the end, the license server simply executes the file bin/urt.bat (or urt.sh) once a week. This is a simple script that launches the URT. It is the easiest way of knowing that information is being sent to the correct location during the correct time period.

Method 1: Manual Usage of Existing URT Software

All that is required to implement this method is to copy/backup the urt.sh or urt.bat file to another name, such as urt_original.bat or urt_original.sh and change the original file to be empty. The file resides in bin/urt.bat.

For Linux/Unix:
cp urt.sh urt_original.sh
For Windows:
copy urt.bat urt_original.bat

Then, edit the urt.bat or urt.sh and remove all lines, leaving the file completely empty. When the license server ‘starts’ the URT, nothing happens and the UMT continues normally.

When you are ready to send your data, go to the bin directory and use urt_original script. Simply type ./urt_original.sh or urt_original.bat. This processes all the logs and sends the data. During this process, detailed output provides information on what is happening. If you would like to examine all the logs before they are sent, they are located in the pending directory.

Method 2: Completely Manual Processing and Email/upload of Data

This method is a completely manual way to collect the log files and sending them to Altair for processing. The administrator should inspect the files (if desired), then use the provided utilities to process the files and prepare them to be emailed to Altair.

First, follow the steps in Method 1 to move the urt.bat or urt.sh file aside and have an empty script in its place.

Assuming you copied the original file to urt_original.bat you will need to edit that file. Simply invoke the old script with the –M option. This option prepares the files to be sent and places the final file in the directory pointed to in the alus.conf file (ALUS_MANUAL_DIRECTORY, by default …/data/manual). Running ./urt_original.bat –M creates a file(s) in the manual directory with a name like YYYYMMDD######_#.zip. Find the correctly dated file and send it to Altair via email (as an attachment) to usagereporting@altair.com.

Please contact your Altair support organization if you have any questions.