Team@Work Standard Edition Ver 1.6 
Installation guide
--------------------------------------------

1. Prerequisites.
  a. Installation package.
  b. Third party required software.

2. Installation Procedure.
  a. Preparation.
  b. Installation screens.
    i.   "Introduction"
    ii.  "Choose Install Folder"
    iii. "Choose Java Virtual Machine"
    iv.  "Choose Shortcut Folder"
    v.   "Pre-Installation Summary"
    vi.  "Installing Team At Work"
    vii. "Install Complete"

  c. Installation troubleshooting.
  d. Finishing instructions.

3. Post Installation notes.
  a. Restoring Databases from backup.
  b. Importing a license.
  c. Starting the server.

----------------
1. Prerequisites
----------------

  To install correctly Team@Work server some requirements should be met
  prior to installation.

  1.a. Installation Package.
    Basically you have to choose between different installer versions
    for the different operating systems (Windows, Linux). The download pack contains following installation programs:
	- win_taw_server_1.6.exe: installer for Team@Work server on MS Windows platform
    	- win_taw_clients_1.6.exe: installer for Team@Work client applicaiotns on MS Windows platform
    	- lin_taw_server_1.6.bin: installer for Team@Work server on Linux platform
    	- lin_taw_clients_1.6.bin: installer for Team@Work client applicaiotns on Linux platform.

  1.b. Third party required software.
    The Team@Work is a Java(TM)-based and requires
    a Java Virtual Machine (JVM) to run. The current version of the
    server requires Sun's Java Runtime Environment (SunJRE) version
    1.4.0 or greater.

    If you have downloaded an installation package with the bundled JVM
    you can skip downloading/installing the JVM. Otherwise download an
    appropriate SunJRE from the Sun's website at:
    	http://java.sun.com/j2se/downloads.html
    For your convinience the download package contains appropriate JVM installer for MS Windows:
	j2re-1_4_1_01-windows-i586-i.exe. 

    Install the JVM PRIOR to running the installation package.

-------------------------
2. Installation Procedure
-------------------------

  These notes provide information about the installation procedure itself.
  The procedure described here is for Team@Work server installation. 
  The procedure for Team@Work client applications installation is absolutely the same.

  2.a. Preparation.
    Apart from the steps needed by 1.a. and 1.b as noted above there is a
    requirement, that any older versions, or previous installations of
    the Team@Work Server be Uninstalled from the system prior to
    continuing the installation procedure.

    NOTE: Some files, created by the application are not uninstalled.
          These include files, containing the Database, and should be
          removed manually, or backed up before continuing with the
          installation procedure.
          If you want to have your current database run with the new
          installation the following files and directories should be
          backed up before continuing:

          users
          users.xml
          DDS/
          Archive/

    NOTE: LINUX: This installation requires a graphical user interface
          to run. Running the installation executable in a terminal
          will not work, unless working under XWindows. Make sure you
          have started your Desktop Environment (Gnome, KDE etc.) prior
          to running the installation executable.

    After you have performed these steps start the downloaded executable
    installator (win_taw_server.exe for Windows, lin_taw_server.bin on
    Linux)

  2.b. Installation steps
    The installation process is wizard based and consists of a number of
    screens, where you should fill some data, required for a successful
    installation.

    2.b.i. "Introduction"
      This screen shows short information about the application being
      currently installed. It also reminds you, that it is recommended
      that you exit all other applications currently running.

      After you read the text press 'Next' to continue.

    2.b.ii. "Choose Install Folder"
      On this screen you should specify a directory, where you wish to
      install the Team@Work server. You may either write it by hand, or
      you can use the "Choose..." button to choose from the directories
      on your system.

      NOTE: It is common, that operating systems prohibit usage of special
            symbols in directory names. For an example Windows(tm)
            prohibits usage of symbols like: '/', '\', ':', '?' etc.
            Make sure the directory you are specifying matches the
            required OS criteria.

      After you select the installation directory press 'Next' to continue.

    2.b.iii. "Choose Java Virtual Machine"
      As noted earlier Team@Work Server is a Java(tm) server application,
      and as such requires a JVM to run.
      Here you can specify the JVM you wish the server to use.
      This screen also remind you, that the JVMs this server currently
      supports are the Sun JREs version 1.4 or newer.

      NOTE: If you have downloaded a package with a bundled JVM there will
            be an option to
             'Install a Java VM specifically for this application'
            We strongly suggest, that you use the bundled VM, except when
            you already have an installed JVM matching the criteria and 
            wish to save disk space.

      You are required to specify the JVM for the server.

      The list contains a number of installed JVMs already found on your
      system. It may or may not contain all the installed JVMs on your
      machine. If the JVM you want to use is not found in the list you
      can use the 'Search For Others' to force a search on the local
      machine for additional JVMs. You can also use the
      'Choose Another...' button to specify the JVM by hand.

      Please note, that if the JVM is not Sun JRE 1.4 or newer the server
      will not run at all.

      After you select the JVM to use press 'Next' button to continue.

    2.b.iv. "Choose Shortcut Folder"
      This screen is used to specify a location, where the links/shorcuts
      to the server executables and uninstaller should be created.
      On Windows systems you will typically use one of the 'Program Group'
      options, or use the default, which in this case will install the
      shortcuts in a subgroup in your Programs Menu.
      On Linux this is very dependant on your Desktop Environment, settings
      etc. You should consider installing the shortcuts in a directory on
      your path. Currently the installation does not support creating
      menu items in the Desktop Environment menus.

      After you have selected your shortcuts/links folder/directory press
      'Next' button to continue.

    2.b.v. "Pre-Installation Summary"
      This screen shows detailed information about the installation process.
      This is the place, where you should review your choices, and if not
      content with them, use the 'Previous' button to go back and correct or
      modify the installation settings.

      This screen also shows the available disk space at the destination
      directory and the required space. If the available space is less than
      the required you have to choose a different installation directory,
      or free up space on the selected destination.

      NOTE: Keep in mind, that when up and running the Team@Work server will
            require additional disk space to store your company's workflows,
            projects, user information etc. that can require considerable
            amount of free disk space, depending on the size of your
            company, the number of your workflows, their complexity, the 
            number of active projects etc. You should consider installing
            to a directory where such free space can be freed when needed.

      When you are content with the installation settings press 'Next' to
      start the installation process.

    2.b.vi. "Installing Team At Work"
      This screen does not require any user intervention, but will show
      information regarding the installation process.

      NOTE: You can cancel the installation process via the 'Cancel' button,
            but that is strongly undesirable. Better wait for the
            installation process to continue, and then uninstall the server
            using it's uninstaller program to avoid leaving stale files on
            your system.

      When the installation process finishes you will be automatically
      moved to the final screen.

    2.b.vii. "Install Complete"
      This screen is shown after the installation has completed.
      It will show the destination, where the server has been installed.

      Press the 'Done' button to quit the installation program.

  2.c. Installation troubleshooting.
    If any problems occur during the installation read carefully the messages
    that are displayed, explaining the error that occurred. Make sure there is
    enough space at the installation target, and that you have sufficient
    privileges to create and write to the destination directory.
    On some systems (like WindowsNT or Windows2000) you might need special
    privileges to install new software. If that is the case contact your
    system administrator and explain him/her the situation.

  2.d. Finishing instructions
    Currently the installation executable removes any temporary files and
    directories created during the installation process. You might want to
    place the installation executable in a safe directory, or to back it up
    for further installations.

---------------------------
3. Post Installation notes.
---------------------------

  3.a. Restoring Databases from backup.
    After the installation is completed you might want to restore the users
    information, workflows, tasks and projects by restoring the database from
    the backup created before the installation (see 2.a. Preparation.)
    This is done by copying the backuped files to the installation directory
    and overwriting all the files (users, users.xml, Archive/, DDS/) that
    are installed.


  3.b. Importing a license.
    Team@Work installation comes with a free trial license. It is a fully 
    functional license. After the trial period you should purchase a license 
    from the Efficient Software Systems web site (http://www.efficient-soft.com).
    If you have a License file sent to you by Efficient Software Systems LTD.
    you might want to import it prior to executing the server. This is done with
    the License Manager application, that can be started using the
    "LicenseManager" executable in the installation directory, or the
    "LicenseManager" shortcut in your Programs menu (on Windows).

  3.c. Starting the server.
    After the installation procedure completes successfully you may start the
    server via the "Team At Work Server" executable, created in the installation
    directory, or the shortcut created in your Programs Menu (on Windows).
