Transferring Software Usage Entries on a Client to the Master Log File on the Software Usage Monitoring Server

If software usage monitoring is installed on a client and software usage entries have been recorded on the client, you need to transfer the software usage report entries in the client's local queue to the master log file on the software usage monitoring server. Figure 13-3 provides an illustration of where the data is located.

Figure 13-3 Software Usage Monitoring Files and Locations

The software usage report entries in the local queue are located in the /var/opt/SUNWswusg/swusage directory. The report entries are designated by an alphanumeric string. For example, if you entered the ls command in the local queue, you would see something like the following:

$ cd /var/opt/SUNWswusg/swusage
$ ls
swrepAAAa000Tv  swrepAAAa000UL  swrepBAAa000Tv  swrepBAAa000UL

The software usage report entries are moved from this directory using the swu_queue command.

When the software usage monitoring system was installed, a cron job was added to the host's root crontab. This cron job runs the swu_queue command at a random time between midnight and 7 a.m. This swu_queue command transfers (flushes) the usage reports from the local queue to the master log file (/var/opt/SUNWswusg/swusage.log) on the software usage server specified in the usage entry.

Although this job runs automatically, there may be times when you wish to transfer the data in the local queue to the software usage monitoring server at a time other than when the cron job transfers the data. To do so, see "How to Transfer Software Usage Entries on the Client to the Master Log File on the Software Usage Monitoring Server".

When the swu_queue command is executed and the files are successfully transferred from the local queue to the master log file, the files are removed from the local queue; if the files do not get transferred (for example, the host specified in the entry was not running), the files in the local queue are not removed, which may cause your file system to fill. To prevent this from happening, you can disable the queue using the swu_queue -dcommand, which prevents usage records from being logged.

The following list explains what may happen when transferring software usage entries on the client to the master log file.

• If the swu_svr daemon is running on the host specified in the software usage entry, files will be transferred from the local queue to the master log file.

• If swu_queue can not connect to the software usage server daemon because the host in the record doesn't exist, the record is removed from the local queue.

• If swu_queue can communicate to the software usage server host, but there is no daemon running, then the record is removed.

• If the software usage server host specified in the usage record is not running or if there is an RPC failure, the usage record remains queued for later delivery.

• If the usage record doesn't contain a software usage server host, then the record is removed from the local queue.

How to Transfer Software Usage Entries on the Client to the Master Log File on the Software Usage Monitoring Server

1. Log in to the client that has software usage report entries.

2. Become root.

3. Enter the swu_queue command.

   # swu_queue -F

   In this command,

   -F	Transfers data in the local queue to the swu_svr daemon on the usage monitoring server.