How do I manage UniVerse print spooler?

To administer print jobs in UniVerse spooler, first log into the server as root and run the following commands:

Displays the spooler status of all printers.


To reload/refresh the spooler configuration file

 usa -R

To manually start the spooler

cd /u2/uv
bin/usd /usr/spool/uv -t 

Resets the print spooler for this specific printer.

usa +o -p lp# 

Displays the spooler status only for the specified printer.

usa -p lp# 

Displays all active print jobs.

usa -A 

Stops printing current job for the specified printer.

usa -b -p lp# 

Restarts current job for the specified printer.

usa -c -p lp# 

Cancels a specified job in the UniVerse spooler.

usm -k job# 

Cancels all print jobs from a specified UniVerse spooler.

usm -k -p lp# 

How do I find the block size of my database files on Linux?

First, find the block size of your filesystem. On Linux, the default block size for an ext3 filesystem will be 4096 bytes (4 KB):

[root@firestorm ~]# tune2fs -l /dev/datavg/eclipse
tune2fs 1.39 (29-May-2006)
Filesystem volume name:   /u2/eclipse
Last mounted on:          
Filesystem UUID:          996f19ea-80da-477d-b961-2873ebe8181b
Filesystem magic number:  0xEF53
Filesystem revision #:    1 (dynamic)
Filesystem features:      has_journal ext_attr resize_inode dir_index filetype sparse_super large_file
Default mount options:    (none)
Filesystem state:         clean
Errors behavior:          Continue
Filesystem OS type:       Linux
Inode count:              1310720
Block count:              5242880
Reserved block count:     262144
Free blocks:              2651137
Free inodes:              1125318
First block:              0
Block size: 4096 
Fragment size:            4096
Reserved GDT blocks:      1022
Blocks per group:         32768
Fragments per group:      32768
Inodes per group:         8192
Inode blocks per group:   512
Filesystem created:       Fri Sep 23 22:04:10 2011
Last mount time:          Mon Jan  9 13:03:16 2012
Last write time:          Tue Jan 17 13:41:40 2012
Mount count:              8
Maximum mount count:      20
Last checked:             Fri Sep 23 22:04:10 2011
Check interval:           15552000 (6 months)
Next check after:         Wed Mar 21 22:04:10 2012
Reserved blocks uid:      0 (user root)
Reserved blocks gid:      0 (group root)
First inode:              11
Inode size:		  256
Journal inode:            8
Default directory hash:   half_md4
Directory Hash Seed:      e4114643-fdd7-446d-ae9c-4bdea1063657
Journal backup:           inode blocks

Each UniVerse database file has its own setting for block size, which can be found by running the ANALYZE.FILE command from TCL, as in the example below:

File name                               = PRODUCT
File type                               = 18
File style and revision                 = 64BIT Revision 12
Number of groups in file (modulo)       = 30427
Separation = 4 
Number of records                       = 155092
Number of physical bytes                = 70756352
Number of data bytes                    = 52605264

Average number of records per group     = 5.0972
Average number of bytes per group       = 1728.9008
Minimum number of records in a group    = 2
Maximum number of records in a group    = 7

Average number of bytes per record      = 339.1875
Minimum number of bytes in a record     = 176
Maximum number of bytes in a record     = 2424

Average number of fields per record     = 110.3191
Minimum number of fields per record     = 108
Maximum number of fields per record     = 194

Groups   25%     50%     75%    100%    125%    150%    175%    200%  full

Multiply the separation by the filesystem block size for the database file block size. In this example, 4096 bytes * 4 = 16484 bytes (16 K).

How do I authorize UniVerse on Linux?

To authorize UniVerse on Linux:

  • Log out all Eclipse users.
  • Login to the server as root.
  • Stop Eclipse SYSTEM.ADMIN, JBoss and the UV database processes:
service eclipse-jboss stop
service monit stop
service eclipse-system-admin stop
pkill -4 -f phantom
pkill -4 -f uv
service uv.rc stop
  • Update the UV authorization (replace [Install SN#], [Auth Qty] and [Expiration Date] with the numbers from the Rocket|U2 license change confirmation email)
cd /u2/uv
bin/uvregen -s [Install SN#] -u [Auth Qty] -e [Expiration Date]
bin/uvregen -C
  • Note the resulting configuration code for the next step.
  • Open the U2TC authorization website:¬†
  • Fill out the first page with your contact information and select UniVerse 10.2.x and higher and press Continue:
  • Fill out the next page using the information from the Rocket|U2 license change confirmation email and the configuration code from the previous steps, then press Submit. Here’s an example:
  • Note the authorization code given on the confirmation page.
  • On the Eclipse server, authorize UV (replace [authorization code]) :
bin/uvregen -A [authorization code]
  • You may confirm your license count by running the following command:
bin/uvregen -z
  • Start the UV database,¬†Eclipse SYSTEM.ADMIN, and JBoss:
service uv.rc start
service eclipse-system-admin start
service monit start
service eclipse-jboss start


How to Authorize UniVerse 10.2.0 and higher


Before you begin, it may be helpful to watch this short video, which goes over the entire process from start to finish:

Unable to display content. Adobe Flash is required.