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 (http://support.unanet.com).  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 Downloading distribution files link. This link explains how to access the distribution site. On the distribution site, 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:  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 (http://download.unanet.com) 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.  

Unzip the unanet103.zip for Windows or unpack the unanet103.tar.gz. Unanet recommends unpacking the files 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.


Configure the License

When you purchased Unanet, you should have received an email containing a  license.properties  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 license.properties 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 license.properties 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  database.properties  file located in ../unanet/config (depending on your installation location).  Also, for more information about the database.properties file, click here.

Edit the database.properties 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 database.properties 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 database.properties file at all.


Configure Temp Directory

You'll need to modify the default  unanet.properties 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.

#unanet.temp_directory=c:/unanet/temp


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.