Contents

System Requirements

Hardware Requirements

  • Processor: 2.4 GHz
  • RAM: 4 GB
  • Disk: 250Mb

Software Requirements

  1. OS / Platforms

    actiTIME Auto installation package supports MS Windows platform only. The following versions are supported: Windows 7, 8, 8.1, 10, Vista, XP, 2012, 2008, and 2003.

  2. Databases

    actiTIME Auto installation package supports both MS Access and MySQL databases. The database to use is selected during the installation.

    Software requirements depend on the database you are going to use:

    • MS Access

      If you choose to use MS Access database, actiTIME Auto installation package will require Microsoft Data Access Objects(DAO) 3.0 or later installed. Usually, it is a part of Windows and is already installed. But if not, you can install Microsoft DAO as a part of Microsoft Jet 4.0 Database Engine as described at http://support.microsoft.com/kb/239114/

      Please choose the MS Access database only if the expected number of actiTIME users is less than ten (10). Otherwise, please consider using the MySQL database platform to avoid performance degradation and collisions when updating data.

    • MySQL

      There are no specific system requirements for the case when MySQL database is selected. actiTIME Auto installation package will download and install MySQL during the actiTIME installation.

      You may speed up the installation process by downloading a MySQL Noinstall ZIP Archive package v5.1.* or v.5.5.* in advance.

Installing actiTIME

You will need local administrator privileges to install actiTIME.

To install actiTIME Auto installation package, run the installer (an .exe file) on your computer and follow the instructions you will be provided with in the installer interface.

After the installation is complete, actiTIME will be available at the address:
http://<IP address or computer name> or
http://<IP address or computer name>:<port number>.

Log in to actiTIME with the username 'admin' and password 'manager'.

Review your firewall settings (if you have one) after the installation and open the port that you configured during the installation of actiTIME for remote access.

Configuring actiTIME Notifications

After you have successfully logged in to actiTIME, go to Settings --> General Settings and scroll down to the end of the page. You will find the Email Settings section. Specify here your mail server parameters in order to make actiTIME email notifications work.

Please enter correct values in the following mandatory fields:

  • Outgoing mail server (SMTP) - name or address of your mail server.
  • Port - mail server port (usually 25)
  • URL of your actiTIME installation - address you used to log in to actiTIME in the previous step (ex. http://<IP address or computer name>:<port number>). This address is required to enable links from email messages back to actiTIME
  • "From" address for email messages – address from which the notifications will be sent
  • Error Processing - email address of your system or network administrator who will be notified if actiTIME detects issues when sending email messages.

If you don't know what are the correct values please consult your System or Network Administrator.

Starting / Stopping actiTIME

Manual start procedure is necessary when actiTIME has not started automatically and you cannot access it.

You will need local administrator privileges to initiate actiTIME startup and shutdown.

To start actiTIME:
  • Double click on the "Start actiTIME" desktop shortcut, OR
  • Choose "Start actiTIME" menu option (from the "actiTIME" menu group), OR
  • Start actiTIME service from the services management console
To stop actiTIME:
  • Double click on the "Stop actiTIME" desktop shortcut, OR
  • Choose "Stop actiTIME" menu option (from the "actiTIME" menu group), OR
  • Stop actiTIME service from the services management console

If an error occurs during the startup / shutdown procedure, review the event log for additional information on the error.

Repairing actiTIME Installation

Repairing procedure is required when:

  • actiTIME does not start;
  • actiTIME database has been restored from the previous version;
  • actiTIME should be configured to be available at another address and / or port;
  • any installation files were accidentally deleted.

You will need local administrator privileges to repair actiTIME installation.

To repair actiTIME installation, launch the actiTIME Auto installation package installer, choose the "Repair / Reconfigure" option and follow the instructions provided in the installer interface.

Upgrading actiTIME from a Previous Version

You can upgrade your existing actiTIME installation using the actiTIME Auto installation package only if your existing actiTIME installation is on the Windows platform.

We have done our best to ensure that your data stays safe. However, to avoid any risk of data loss, we suggest that you back up your database before the upgrade.

You will need local administrator privileges to upgrade actiTIME.

To upgrade actiTIME installation, launch the actiTIME Auto installation package installer on your computer (an .exe file) and follow the instructions you will be provided with in the installer interface.

To upgrade actiTIME, perform the following steps:

  1. Stop actiTIME web application

  2. Make sure that you do not have MS Access running with actiTIME database file opened in it

  3. Launch actiTIME Auto installation package installer

  4. Follow the installation instructions in the installer interfaces to the Database configuration screen

  5. On the Database configuration screen choose the option "Copy data from the existing database" and specify the path to the existing actiTIME database file (usually this path is detected and prefilled automatically)

  6. Click the "Next" button and continue actiTIME setup

The installer will create a new database file and copy data into it from the existing actiTIME database. Your old database file will not be modified.

Please do not try to run your old actiTIME installation after the upgrade because the ODBC driver will be configured to use the new database file and the old version of actITIME will be incompatible with the new database structure.

After you have successfully upgraded actiTIME, configure mail server parameters to make actiTIME notifications work properly. Refer to the 'Configuring actiTIME Notifications' section for instructions.

Database Backup Instructions: MS Access Database

Backup procedure:
  1. Stop actiTIME.

  2. Go to the '<actiTIME installation directory>\database' folder and make a backup copy of the 'actitime.mdb' file.

  3. Start actiTIME.

Restore procedure:
  1. Stop actiTIME.

  2. Go to the '<actiTIME installation directory>\database' folder and replace the 'actitime.mdb' file with its backup copy.

  3. Start actiTIME.

Database Backup Instructions: MySQL Database

Backup procedure:
  1. Start actiTIME.

  2. Open CMD.

  3. Go to the '<actiTIME folder>/database/MySQL/bin' folder.

  4. Create a dump of the existing actiTIME data by running the following command:

    mysqldump -u <username> -p<password> -P <port_number> -R actitime > actitime_data.sql

    where

    <username> is the name of the user who has all the necessary rights to administer the database.

    <password> is the password of this user (please note that there should be NO space between '-p' and 'password').

    <port_number> is the port used by MySQL.

    You will find these parameters in the '<actiTIME installation directory>\actitime.config' file. They are specified in the strings "DBUser" and "DBPassword".

    The port number is specified in the line "DBurl":

    DBurl=jdbc:mysql://<host>:<port_number>/<dbname>

    After the execution of this command MySQL will create a file with dump of actiTIME data called 'actitime_data.sql'.

Restore procedure:
  1. Start actiTIME.

  2. Open CMD.

  3. Go to the '<actiTIME folder>/database/MySQL/bin' folder.

  4. Restore your actiTIME data by running the following commands:

    mysqladmin -f -u <username> -p<password> -P <port_number> drop actitime

    After this command the current data will be dropped.

    mysqladmin -f -u <username> -p<password> -P <port_number> create actitime

    mysql -u <username> -p<password> -P <port_number> actitime < actitime_data.sql

    where

    <username> is the name of the user who has all the necessary rights to administer the database.

    <password> is the password of this user (please note that there should be NO space between '-p' and 'password').

    <port_number> is the port used by MySQL.

    You will find these parameters in the '<actiTIME installation directory>\actitime.config' file. They are specified in the strings "DBUser" and "DBPassword".

    The port number is specified in the line "DBurl":

    DBurl=jdbc:mysql://<host>:<port_number>/<dbname>

    actitime_data.sql is the file containing the backup of your actiTIME data.

  5. Restart actiTIME.

Uninstalling actiTIME

You will need local administrator privileges to uninstall actiTIME.

To uninstall actiTIME, choose the "Uninstall actiTIME" menu option or launch actiTIME uninstallation from the standard "Add or Remove Programs" dialog in the Windows Control Panel.

Note: actiTIME database will not be removed after the uninstallation. If you are using an Access database, the actiTIME.mdb file is renamed and saved in the same directory; if you are using MySQL database, a database dump is saved.