1. Installation Guide

1.1. Download

Use the download URL obtained from your Plunify sales representative to download InTime.

Otherwise, a Plunify user account is needed in order to download InTime. Please sign in or sign up for a new account at http://www.plunify.com/en/login.php

1.2. InTime Basic Installation

The InTime Basic edition runs on a single computer with the latest strategy generation database. This edition does not require an InTime Server to be running, so an InTime license file must be present on the same machine. For InTime Group and InTime Enterprise editions, please see the InTime Group/Enterprise Installation guide.

Note

To install the InTime Cloud edition, follow the installation instructions for the InTime Basic edition. After installation a local license is not required in order to submit your designs to the Plunify Cloud.

After performing the steps below, please configure your environment as described in the InTime Configuration Guide.

1.2.1. Operating System (OS)

  • 64-bit architectures only
  • Windows / Ubuntu 12.04 and above / RedHat Enterprise 5 and above / compatible
  • Other versions are supported upon request.

Linux Installation

Please download the Linux installer: intime_v<InTime version>_64bit_linux.sh

Next, proceed to install the software.

Open a command-line terminal.

Create the folder to install InTime in.

(Example) $ mkdir -p ~/plunify/intime

Navigate to the installation folder.

(Example) $ cd ~/plunify/intime

Run the installer script.

(Example) ~/plunify/intime $ sh ~/Downloads/intime_v1.1.0_64bit_linux.sh
Verifying archive integrity... All good.
Uncompressing Plunify InTime version 1.1.0......................................
................................................................................
................................................................................
................................................................................

The script extracts installation files and presents a licensing agreement.

Hit <space> to scroll down or “q” to skip to the end.

PLUNIFY SOFTWARE LICENSE AGREEMENT REVISION 2014-01-09

Copyright (c) 2009-2014, PLUNIFY All rights reserved.


This Software License Agreement (the "Agreement") is a legally binding
agreement between the User of the software (the "User") and PLUNIFY Pte Ltd
("PLUNIFY"), seated at 67 Ayer Rajah Crescent #03-20/22 Singapore 139950. By
using or installing the software (as updated by PLUNIFY from time to time,
the "Software"), the User is accepting to be bound by all of the terms and
conditions of this Agreement.
--More--

Enter ‘Y’ to accept and proceed, or ‘N’ to exit the installer.

--------------------------------------------------------------------------------

Accept the terms of the Plunify End-User Licensing Agreement ('y' for Yes or 'n' for No)? y

Thank you, proceeding with installation...

There are three options for running builds (hit Enter to install the defaults):

  • “Local” - on a standalone PC where InTime is installed.
  • “Private Cloud” - within the user’s network.
  • “Plunify Cloud” - using Plunify-managed cloud computing resources.

Local is always installed, but the rest are optional. See Understanding Run Targets for more information on the different options.

Hit <Enter> to install all the options.

Install default modules (Recommended)? ('y' for Yes or 'n' for No) [y]

Otherwise, type “n” and press <Enter> to choose between the “Private Cloud” and the “Plunify Cloud”.

Use a Private Cloud to compile your designs ('y' for Yes or 'n' for No) [y]

Use a Plunify-managed Cloud to compile your designs ('y' for Yes or 'n' for No) [y]

Finally, the installer creates InTime-related shortcuts on the user’s desktop.

Windows Installation

Please download the Windows installer: intime_v<InTime version>_64bit_win.exe

Run the installer by double-clicking the downloaded file.

The installer wizard contains the following pages which guide you through the installation process.

  1. Welcome page
  2. Accept license agreement
  3. Choose users
  4. Choose install directory
  5. Choose components
  6. Choose start menu folder
  7. Installation in progress...
  8. Installation completed

Note

When installation completes, an uninstaller will be created. The uninstaller can be accessed either through the created start menu item or through the “Add/Remove Programs” dialog in Windows.

1.3. InTime Group/Enterprise Installation

This installation guide shows how to install the required components of the InTime Group and InTime Enterprise editions.

  • InTime Group: Links up multiple computers for faster and better results.
  • InTime Enterprise: Deploy on private clouds or datacenters, centralized control, customization.

These editions require installation of an InTime Server as well as one or more InTime Workers. For installation instructions for the InTime Basic and InTime Cloud editions, please see the InTime Basic Installation guide.

After performing the steps below, please configure your environment as described in the InTime Configuration Guide.

1.3.1. InTime Server

A dedicated server is required to act as the InTime Server. Specifically, it is used for communication between the Workers.

1.3.2. Operating System (OS)

  • 64-bit architectures only
  • Windows / Ubuntu 12.04 and above / RedHat Enterprise 5 and above / compatible
  • Other versions are supported upon request.

1.3.3. Application

  1. InTime Server (Java 1.8.0_77 JDK will also be installed together)
  2. InTime compiled for the operating system on which the Workers will run.

1.3.4. Hardware

  1. A minimum of 40GB free space is required for InTime Server.

1.3.5. Network

  1. The InTime Server requires a static IP address in order to communicate with the Workers.
  2. A/The MAC address of the InTime Server machine is required for license generation.

1.3.6. Firewall

  1. Firewall requirements for incoming traffic.

    1. Ports 39940, 39941 for workers to communicate with InTime Server.
    2. Port 39942 for the administrative console.

Linux Installation

1.3.7. Step 1: Download InTime Server Installer

Download intimeserver_v<version>_64bit_linux.sh from the URL provided by Plunify.

1.3.8. Step 2: Setup Server Installer Permissions

This is normally installed by an administrator or a privileged user. Login as a privileged user and set user execute permissions for intimeserver_v<version>_64bit_linux.sh.

In this example, the user is cadadmin, and the installation directory is /home/cadadmin/intimeserver/. You can specify any directory for the installation.

$ pwd
/home/cadadmin/intimeserver/
$ chmod u+x intimeserver_v<version>_64bit_linux.sh

1.3.9. Step 3: Run Server Installer

Run the intimeserver_v<version>_64bit_linux.sh installer file. Use the default value when installing. For those user who are planning to migrate existing database and configurations from an earlier version, enter the directory of the ealier version for the installer to copy the files.

$ ./intimeserver_v<version>_64bit_linux.sh

Verifying archive integrity... All good.
Uncompressing Plunify InTime Server version 2.1.0 (Build 73fcd2c).........................
Install for which database? ('1' for SQLite or '2' for MySQL) [1] 1
Install support for SQLite
Do you want to clean up(remove) the installer ('y' for Yes or 'n' for No) [n] n
Use jvm options default(1), minimal(2), optimal(3) (Blank is default) 1

If you plan to migrate configuration and database from an earlier version of InTime Server
installed on another directory, key in the directory to migrate. If you are installing
over the existing directory or this is the first time you install InTime Server,
press enter to skip [enter]:
Skipping.
Intime Server installed OK.

$

1.3.10. Step 4: Verify Server Installation

Verify the installation by inspecting the contents of the intimeserver directory. The expected output is shown below.

$ pwd
/home/cadadmin/intimeserver
$ ls -lsh
total 992K
4.0K -rw-r--r-- 1 cadadmin eda 2.5K Apr 20 14:21 CHANGELOG
 16K -rw-r--r-- 1 cadadmin eda  13K Apr 20 14:21 InTime_icon.png
4.0K -rw-r--r-- 1 cadadmin eda  118 Apr 20 14:21 JDBC.properties
4.0K -rw-r--r-- 1 cadadmin eda   98 Apr 20 14:24 SQL.properties
4.0K -rwxr-xr-x 1 cadadmin eda  527 Apr 20 14:21 admin_console.sh
4.0K -rwxr-xr-x 1 cadadmin eda  583 Apr 20 14:21 admin_console.sh.rl
4.0K -rwxr-xr-x 1 cadadmin eda  329 Apr 20 14:21 backup_intimeruns.sh
4.0K drwxr-xr-x 2 cadadmin eda 4.0K Apr 20 14:21 conf
836K -rw-r--r-- 1 cadadmin eda 831K Apr 20 14:21 intimeserver.jar
4.0K -rw-r--r-- 1 cadadmin eda  287 Apr 20 14:21 intimeserver.properties.bak
   0 lrwxrwxrwx 1 cadadmin eda   11 Apr 20 14:24 jdk -> jdk1.8.0_77
4.0K drwxr-xr-x 8 cadadmin eda 4.0K Mar 21  2016 jdk1.8.0_77
4.0K -rw-r--r-- 1 cadadmin eda   63 Apr 20 14:24 jvm.options
4.0K -rw-r--r-- 1 cadadmin eda   63 Apr 20 14:21 jvm.options.default
4.0K -rw-r--r-- 1 cadadmin eda   62 Apr 20 14:21 jvm.options.minimal
4.0K -rw-r--r-- 1 cadadmin eda  240 Apr 20 14:21 jvm.options.optimal
4.0K drwxr-xr-x 2 cadadmin eda 4.0K Apr 20 14:21 keys
4.0K drwxr-xr-x 2 cadadmin eda 4.0K Apr 20 14:21 lib
8.0K -rwxr-xr-x 1 cadadmin eda 7.7K Apr 20 14:21 license_server.sh
4.0K drwxr-xr-x 2 cadadmin eda 4.0K Apr 20 14:21 logs
4.0K -rw-r--r-- 1 cadadmin eda   30 Apr 20 14:21 plunify.args.bak
 24K -rw-r--r-- 1 cadadmin eda  21K Apr 20 14:21 plunify.db.bak
4.0K -rw-r--r-- 1 cadadmin eda  555 Apr 20 14:21 plunify.errors.bak
4.0K drwxr-xr-x 2 cadadmin eda 4.0K Apr 20 14:21 report_template
4.0K -rwxr-xr-x 1 cadadmin eda  335 Apr 20 14:21 restore_intimeruns.sh
 12K -rwxr-xr-x 1 cadadmin eda 8.1K Apr 20 14:21 server_test.sh
8.0K -rwxr-xr-x 1 cadadmin eda 7.6K Apr 20 14:21 start_server.sh
4.0K drwxr-xr-x 3 cadadmin eda 4.0K Apr 20 14:21 util
4.0K drwxr-xr-x 6 cadadmin eda 4.0K Apr 20 14:21 web
$

1.3.11. Step 5: Install License And Start Server

Put the license file, e.g. server.lic, into /home/cadadmin/intimeserver/ and launch the InTime Server. To launch the InTime Server, run the script ./start_server.sh.

$ pwd
/home/cadadmin/intimeserver
$ ./start_server.sh

----- SHELL SCRIPT VARIABLES -----
PID [OLD]         = 29016
SERVERIP 1        = 192.168.2.100


$---------- BEGINNING OF LOG FILE ----------
UTC DATE/TIME: 2015-12-15 02:32:01.269


$---------- BEGINNING OF LOG FILE ----------
UTC DATE/TIME: 2015-12-15 02:32:01.269
Write permission (plunify.db) [  OK  ]
JDBC (plunify.db)             [  OK  ]
JDBC (intimeruns.h2.db)       [  OK  ]
Starting InTime Server        [  OK  ]
Starting License Server       [  OK  ]
License server.lic            [  OK  ]
License has started?          [  OK  ]
License not expired?          [  OK  ]
License Mac 08:00:27:70:A5:E2 [  OK  ]
License features              [  OK  ]

$

Note

To start/restart the Server at a later time, just run ./start_server.sh again. To shut down the server run ./start_server.sh -stop

1.3.12. Step 6: Check Server Status

Check the InTime Server’s status.

$ ps -ef|grep java
intime    5700     1  2 07:16 pts/3    00:00:03 /home/caadmin/intimeserver/./jdk/bin/java -Xms512m -Xmx1024m -server -Dlogback.configurationFile=/home/caadmin/intimeserver/./conf/logback.xml -DINTIMESERVER_HOME=/home/caadmin/intimeserver/. -classpath /home/caadmin/intimeserver/./intimeserver.jar:/home/caadmin/intimeserver/./lib/* com.plunify.main.InTimeServer -directory /home/caadmin/intimeserver/./plunify_server -licensefile /home/caadmin/intimeserver/./server.lic -log_level info

1.3.13. Step 7: Automatically Start Server (Optional)

To automatically start the InTime Server when a machine boots up, add the following line to /etc/rc.local.

$ vi /etc/rc.local
/bin/su -s /bin/bash -c '/home/cadadmin/intimeserver/start_server.sh' cadadmin

1.3.14. Step 8: Download Worker Installer

Download intime_v<version>_64bit_linux.sh from the URL provided by Plunify.

1.3.15. Step 9: Setup Worker Installer Permissions

This can be installed either by an administrator or by a user depending on the target installation directory. Login as the appropriate user and set user execute permissions for intime_v<version>_64bit_linux.sh.

In this example, the user is user10, and the installation directory is /home/user10/intime. You can specify any directory for the installation.

$ pwd
/home/user10/intime/
$ chmod u+x intime_v<version>_64bit_linux.sh

1.3.16. Step 10: Run Worker Installer

Run the intime_v<version>_64bit_linux.sh installer.

$ pwd
/home/user10/intime/
$ ./intime_v<version>_64bit_linux.sh
Verifying archive integrity... All good.
Uncompressing Plunify InTime version <version>..................................
................................................................................
................................................................................
................................................................................

The script extracts installation files and presents a licensing agreement. Hit <space> to scroll down.

PLUNIFY SOFTWARE LICENSE AGREEMENT REVISION 2014-01-09

Copyright (c) 2009-2014, PLUNIFY All rights reserved.


This Software License Agreement (the "Agreement") is a legally binding
agreement between the User of the software (the "User") and PLUNIFY Pte Ltd
("PLUNIFY"), seated at 67 Ayer Rajah Crescent #03-20/22 Singapore 139950. By
using or installing the software (as updated by PLUNIFY from time to time,
the "Software"), the User is accepting to be bound by all of the terms and
conditions of this Agreement.
--More--

Enter Y to accept and continue.

--------------------------------------------------------------------------------
Accept the terms of the Plunify End-User Licensing Agreement ('y' for Yes or 'n' for No)? y

Thank you, proceeding with installation...

Install default modules (Recommended)? ('y' for Yes or 'n' for No) [y] y
Installing defaults...


Installing 64-bit JRE...

InTime installation complete.

Windows Installation

1.3.17. Step 1: Download Server Installer

Download intimeserver_v<version>_64bit_win.sh from the URL provided by Plunify.

1.3.18. Step 2: Run Server Installer

Run the installer by double-clicking it on the machine designated as the server. InTime Server will be installed in the default directory C:\intimeserver. The installer will attempt to overwrite earlier version of libraries and files, do make sure a backup to this directory before installing.

The Installation Wizard contains the following pages which guide you through the installation process.

  1. User Account Control page
  2. Welcome page
  3. Installation completed

1.3.19. Step 3: Install License And Start Server

Request a license from Plunify by providing the MAC address of the InTime Server machine. After receiving the license file, for example, server.lic, place it in C:\intimeserver and launch the InTime Server.

Open a command prompt and navigate to C:\intimeserver. To launch InTime Server, run the start_server.bat script

Note

To start/restart the Server at a later time, just run start_server.bat again in another shell. To shut down the server run start_server.bat -stop

Please ensure that you see the license acceptance message as shown in the last five lines below in Figure 26.

_images/win_intimeserver_run_page_1.png

Figure 26: License Acceptance Notification

A Windows Security Alert may pop up indicating that a Java binary is running. Click “Allow access” as shown in Figure 27.

_images/win_intimeserver_run_page_2.png

Figure 27: Windows Security Alert

1.3.20. Step 4: Download Worker Installer

Download intime_v<version>_64bit_win.exe from the URL provided by Plunify.

1.3.21. Step 5: Run Worker Installer

Run the installer by double-clicking on the downloaded file on the user’s machine. The installer wizard contains the following pages which guide you through the installation process.

  1. Welcome page
  2. Accept license agreement
  3. Choose users
  4. Choose install directory
  5. Choose components
  6. Choose start menu folder
  7. Installation in progress...
  8. Installation completed

Note

When installation completes, an uninstaller will be created. The uninstaller can be accessed either through the created start menu item or through the “Add/Remove Programs” dialog in Windows.