To install Aware IM under the Linux operating system follow the steps below:
AwareIM.tar.gz
file from the Awaresoft web site. gnzip < /path/to/AwareIM.tar.gz | tar xvf –
How you run Aware IM 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 Aware IM Control Panel.
To start the Aware IM Control Panel, run the CP
executable located in the CP/eclipse
directory of your Aware IM installation.
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 for the explanation what business space and business space version are).
To start Aware IM under Linux that does not have graphical user interface do the following:
cd AwareIM/bin
bash startAwareIMNoGUI.sh
The script file will start all the required components such as the Tomcat server and the Aware IM server. On successful startup the “Aware IM 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 Aware IM 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 Aware IM 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 Aware IM 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 Aware IM 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.