Installing / Configuring Unanet Software

Once you have a properly installed and configured database ready for your Unanet system, you should install the actual Unanet software.  

Please note that these instructions are for a new install of Unanet -- if you are attempting to migrate from an existing version of Unanet, please click here.

The topics covered on this page include:

Obtaining the Unanet Software

Once you have purchased Unanet, you will be able to access our Support site (  Once at this site, you will need to request a support id.  These IDs are usually created very quickly and you will receive your id/password confirmation email shortly after the ID is created.  

Log into the support site using your new ID/password and click on the downloads link on the left-hand side.  You will be presented with a list of software components to download.  What you choose will depend on your platform:


Save these files to your server somewhere -- you may need to access them again.

Note: Occasionally, the downloaded file will have an extra ".zip" file extension appended to the file.  Should this occur, simply rename the file without the .zip extension (do not attempt to unzip the file).

Note:  Once you get your support site id, take some time and browse the support site -- it contains many useful links for configuring and maintaining your Unanet system.  Also available on the support site are additional training files, Export templates, and a change log so that you can stay updated on the latest point releases and builds.

Note regarding subsequent patch release downloads:  In the future, you may need to download patches for your current version of Unanet.  This download site is the same place you will download the patch or point releases but do note that when downloading a point release -- you will not download the entire New Install package -- but rather you will simply download the war file from the "Point Release Upgrade" section.

Installing the Unanet Software

Once you have obtained the Unanet Software you need to install it on the machine you have designated as your Unanet server.  

Double-click on the unanet103-install.exe (for Windows) or run the (for Unix/Linux) installer file that you downloaded above.  This will begin the installation process.  Follow the instructions to install the Unanet files on your server.  By default, your software will be installed at c:\unanet (for Windows) or $HOME/unanet (for Unix/Linux), but you can change this to any location you desire, provided it has enough disk space to hold the files.

If you are experiencing difficulty running the installer package, you can also download a unanet103 .zip or unanet103 .tar.gz version also available on the Support Download site under the "Packaged Release Files" section.   You can unzip / unpack the files to any location you desire, provided it has enough disk space to hold them.  

Configure the License

When you purchased Unanet, you should have received an email containing a  file attachment.  This is your Unanet license and needs to be installed over the default (empty) license file provided by the install.

Replace the license file created during the install with your new Unanet file.  The file location should be ../unanet/config -- depending on where you chose to install your Unanet files.

Note that the license agreement does allow for you to use the file on multiple installations of Unanet (assuming the additional copies of Unanet are for testing purposes only).  Unanet does encourage you to install a test instance for the purpose of experimenting with new functionality, new product versions or troubleshooting issues.

Configure the Database Connection

In order for your Unanet Servlet application to communicate to your Unanet database, you will need to modify the default  file located in ../unanet/config (depending on your installation location).  Also, for more information about the file, click here.

Edit the file in the text editor of your choice.

For Oracle Users


For SQL Server Users


Note:  Unanet comes with JDBC drivers for both Oracle and SQL Server.  By default, the file will be set up to use the SQL Server driver (jTDS) with the database being located on the same machine as the Unanet servlet -- and a database name and password of "unanet".  If your setup does not vary from those parameters, you may not need to change the file at all.

Configure Temp Directory

You'll need to modify the default file located in the ../unanet/config (depending on your installation location), to set the Temp Directory (Fully Qualified Directory Name) (unanet.temp_directory) property.   If you do not uncomment or otherwise set this property to your desired location, system output will be directed to the execution directory of your servlet engine (likely an undesirable location).  You may be able to simply uncomment the default property setting unless you would prefer to direct the output elsewhere.


Next Step

Step 3 -- Install/Configure Unanet Database

When you have satisfied the prerequisite requirements, you are ready to move on to Step 3 -- Installing and configuring the Unanet Database.  Make sure to choose the link that corresponds to your database type.