To install AwareIM under the Linux operating system follow the steps below:

1. AwareIM needs Java version 17.0 or later to be installed on your machine. Starting from AwareIM version 6.0 AwareIM no longer includes Java in its distribution. If you do not have Java installed on your system please download it and install before running AwareIM. See section Java installation for more details on how to install Java.
2. Download AwareIM.tar.gz file from the Awaresoft web site.
3. Unpack the archive file into the local directory of your hard disk. We will assume that AwareIM is unpacked into the AwareIM directory. You can use the following command to unpack the archive
   
   

   gnzip < /path/to/AwareIM.tar.gz | tar xvf – 

4. By default AwareIM is set up to work with the Apache Derby database, which is included in the AwareIM installation. If you are happy to use the default database you can start using AwareIM straight away – see next section. If you want to use AwareIM with other databases you need to make sure that the the database is installed and running on your machine before starting AwareIM. Then perform database integration steps as described in Installation under Windows operating system.

How you run AwareIM depends on whether your Linux version supports graphical user interface (X-Windows) or not. If your Linux version supports graphical user interface you should start the AwareIM Control Panel.

To start the AwareIM Control Panel, run the CP executable located in the CP/eclipse directory of your AwareIM installation.

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

Note that when starting the AwareIM 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 AwareIM to create the default business space and the initial business space version (see Business Space for the explanation what business space and business space version are).

To start AwareIM under Linux that does not have graphical user interface do the following:

1. Open the Shell Console session and change to the AwareIM/bin directory:
   
   

   cd AwareIM/bin 

2. Issue the following command:
   
   

   bash startAwareIMNoGUI.sh 

The script file will start all the required components such as the Tomcat server and the AwareIM server. On successful startup the “AwareIM server started” message will be displayed in the console window.

Note that the default name of your application will be “DefaultApplication”. The name of your business application will be used by AwareIM to create the default business space and the initial business space version (see Business Space for the explanation what business space and business space version are).

If you are running the Linux version that supports graphical user interface you can start the Configuration Tool by clicking on the “Start Configurator” button on the AwareIM Control Panel.

If you are running non-graphical Linux you can only start the Configuration Tool remotely on a machine that supports graphical user interface (for example, a machine running Windows) – see section Running Configuration Tool on a Separate Machine in AwareIM deployment options

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 AwareIM Control Panel for the first time. Enter admin as the default user name and then enter the default password password.

Open your web 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.