How do I install U2 UniVerse on Ubuntu or Debian?

Question

You can download a copy of a trial version of U2 UniVerse 10.3 page, but as implied in the file name it only works with Red Hat Enterprise Linux 5.2. There are no instructions in the zip, just a bunch of cpio archives. How do I get it to work?

Answer 1

Installation

1. Download the zip file for the demo install

2. Unzip the demo into a subdirectory

   unzip demo.zip -d UniVerse

3. Go into the subdirectory

   cd UniVerse

4. Un-cpio the contents of the installer

   cpio -ivdum < STARTUP

5. Pretend like the current directory is a cdrom for the install script (uv.load)

   sudo mount --bind . /cdrom

6. Change lines 17 and 18 of the uv.load install script, remove the -B and -c arguments:

       tapewrite='find $file -print | cpio -ovcB > $tape/$uvcdi'
       taperead='cpio -ivcdumB $file < $tape/$uvcdi'
   

   should read,

       tapewrite='find $file -print | cpio -ov > $tape/$uvcdi'
       taperead='cpio -ivdum $file < $tape/$uvcdi'
   

7. sudo sh uv.load

8. sudo umount /cdrom

Configuration

1. UV.VI will not work unless you symlink /bin/vi to vim

   sudo ln -s /etc/alternatives/vim /bin/vi
   

2. None of the binary UniVerse utilities will be in your $PATH unless you add /usr/ibm/uv/bin

Starting the Daemon

You must have the UniVerse daemon started or you will receive the following error:

An error has occurred during uniVerse initialization
Please contact the system administrator
Error code:  2   2

From here you have two options, you can either start the daemon when you need it, or you can start the daemon with the system processes:

• In order to start up UniVerse you must execute the daemon you can find it in /usr/ibm/uv/sample/uv.rc

  $ sudo sh /usr/ibm/uv/sample/uv.rc
  uniVerse has been brought up.
  uniVerse Log Daemon started 
  
  
  Deadlock Daemon has been started
  

• If you want UniVerse to start as a system process in Debian based systems you will want to:

  $ sudo cp /usr/ibm/uv/sample/uv.rc /etc/init.d/
  $ sudo chown root:root /etc/init.d/uv.rc
  $ sudo chmod 755 /etc/init.d/uv.rc
  $ sudo update-rc.d uv.rc defaults 99
  

This method will render a warning that the script is lacking LSB information and isn't an LSB script, that is ok. I believe it should still work but you won't have the extra restart|reload|force-reload|status functionality that most other init scripts provide

update-rc.d: warning: /etc/init.d/uv.rc missing LSB information
update-rc.d: see <http://wiki.debian.org/LSBInitScripts>
 Adding system startup for /etc/init.d/uv.rc ...
   /etc/rc0.d/K99uv.rc -> ../init.d/uv.rc
   /etc/rc1.d/K99uv.rc -> ../init.d/uv.rc
   /etc/rc6.d/K99uv.rc -> ../init.d/uv.rc
   /etc/rc2.d/S99uv.rc -> ../init.d/uv.rc
   /etc/rc3.d/S99uv.rc -> ../init.d/uv.rc
   /etc/rc4.d/S99uv.rc -> ../init.d/uv.rc
   /etc/rc5.d/S99uv.rc -> ../init.d/uv.rc

Caveats

1. Linux operating systems support lowercase; however, by convention universe doesn't, and it doesn't know lowercase is uppercase. When you use $uv_root/bin/create.file _arg_, make sure arg is uppercase. The TCL command CREATE.FILE will already have shifted your default characters to uppercase, but bash makes no such consideration with the binary command create.file. You'll still be able to use the file you'll just have to remember your system supports mix case even though uvsh really wants uppercase.

Answer 2

Shared Objects
If you want to run any of the shared objects such as the XML extensions you will also need to tell Ubuntu where the shared library lives.
- change to directory /etc/ld.so.conf.d
- create a file called ibmu2.conf
- put one line in it to the shared object directory, most likely, /usr/ibm/uv/bin
- run command sudo ldconfig

Uppcase/Lowercase
Following on from the "Caveat" above if you want to stop the automatic upper/lower case conversion you can type the command
PTERM CASE NOINVERT
or put it into the LOGIN proc