To install Aware IM under Windows operating system you need to run the set-up program that guides you through the installation process. Before starting the set-up program check that your computer meets the necessary requirements described below.

Note: Aware IM needs Java version 12.0 or later to be installed on your machine. You do not need to install Java for the Windows operating system as Aware IM already comes with Java as part of its distribution package. The Java version Aware IM comes with is JDK 12.0 for 64-bit Windows. If you want to upgrade your Java system to the later version or to use 32-bit version of Windows you can set up Aware IM to work with a custom version of Java. See section Java installation for more details.

To run Aware IM under the Windows operating system you need the following:

• IBM PC compatible computer
• 512 Mb of RAM (1 Gb recommended)
• 700 Mb of free disk space
• Windows operating system (any Windows version is supported)
• Internet Explorer (version 8.0 or later), Mozilla Firefox (version 3.0 or later), Google Chrome or Safari web browser

To start installation of the Aware IM software, run the installation program SETUP.exe which is located on your installation CD or which has been downloaded from the Awaresoft web site. It is a self-extracting executable that will unpack all the required files on your hard disk.

Firstly the software displays the welcome screen and the license page that you must accept in order to proceed with the installation. The next screen shows the default directory where Aware IM will be installed. You can press the Next button to accept the default directory or specify a different directory. The next screen lets you choose the folder where Aware IM shortcuts will be installed. You can accept the default choice or select a different folder or choose not to install the shortcuts at all.

After you press the Install button the software will start unpacking the required files on your hard disk.

If you want to use the default database system (Apache Derby) with Aware IM you can start using Aware IM right away – see section Aware IM Deployment Options. If you want to use MySQL, MS SQL Server / SQL Server Express/Azure, Oracle, PostgreSQL or Maria DB databases you will need to set up the appropriate database software after the set-up program has finished – see section Java installation.

Whether you are running the Configuration Tool or configured applications you need to run the Aware IM Control Panel or start Aware IM Windows services first.

To start the Aware IM Control Panel you can either choose the “Control Panel” shortcut in the Programs menu or you can start it manually by changing to the CP/eclipse directory of your Aware IM installation and running the CP.exe file. It is highly recommended that you run this executable as administrator.

The Aware IM Control Panel will start all the required components such as Tomcat server and Aware IM server. On successful startup the green “OK” message will be displayed as System Status.

Note that when starting the Aware IM Control Panel for the first time you will be asked to provide the name of your business application. The name of your business application will be used by Aware IM to create the default business space and the initial business space version (see business space and business space version).

To start the Configuration Tool press the “Start Configurator” button on the Aware IM Control Panel (or you can start it from File Explorer by changing to the ConfigTool/eclipse directory of your Aware IM installation and running the ConfigTool.exe). When you start the Configuration Tool it will ask you to provide the business name you are logging into and password. Enter the business name you specified when you started the Aware IM Control Panel for the first time. Enter admin” as user name and then enter the default password “password”.

You can change certain system settings by using the Settings menu of the Aware IM Control Panel.

Aware IM Control Panel starts up the following components required for Aware IM:

• Tomcat server
• Aware IM server
• Configuration Tool

When starting up these components the Control Panel uses default startup options. You can change memory settings allocated to each of the components on startup, ports used, database engine and database configuration. You will need to restart Aware IM after changing most of these settings. You can also change the settings manually by changing Aware IM configuration files – this is especially useful when Aware IM runs as a Windows service or when the operating system does not have a graphical user interface.

To change memory allocation and Java startup options manually:

Normally you will not require changing these options. However, if you need to change the initial Java startup properties for each of those components, you can do so by placing the special property file called startupOptions.props into the BIN directory of your Aware IM installation. The sample startupOptions.props file with the settings equivalent to the default settings is located in the samples directory of your Aware IM installation.

For example, you can increase the memory allocated to different Aware IM components on startup. To do so add -Xmx96m after java in the corresponding line (where 96m is the amount of memory in Mb allocated to the component, you can increase this number further provided that your machine has enough memory).

Applications you configure with the Configuration Tool should be run within a web browser. Open your browser and point it to the following URL:

http://localhost:8080/AwareIM/logonOp.html

See also login describing other entry points to the configured applications.

You can also select the Operation shortcut from your Programs menu.

To uninstall Aware IM software select the Uninstall shortcut from the Programs menu or Aware IM programs folder or run Uninstall.exe located in the root directory of your Aware IM installation.

Running Aware IM as a Windows service

To install Aware IM as Windows service, do the following:

1. Shutdown Aware IM if it is running
2. Run the batch file InstallService.bat located in the AwareIM/bin directory where AwareIM is the root directory of your Aware IM installation.
3. Start the services manually or re-boot your machine to make sure that services are automatically started. To start services manually go to the Windows Services manager located in the Administrative Tools folder of the Windows Control Panel. Start Tomcat service first; and then the Aware IM service.

To uninstall Aware IM services run the UninstallService.bat file located in the AwareIM/bin directory. This file stops the services automatically if they are running.