Before installing AwareIM on a Mac computer check that your computer meets the necessary requirements described below.

• Apple Macintosh computer
• 512 Mb of RAM (1Gb recommended)
• 700 Mb of free disk space
• Mac OS X 10.10 operating system or later
• Safari, Firefox or some other Internet browser

To start installation of the AwareIM software, double click on the AwareIM distribution file AwareIM.zip, which has been downloaded from the Awaresoft web site, to un-compress the file. The archive contains an application file AwareIM.app. Copy this file into any directory, for example /Applications and double click the application to run it.

Whether you are running the Configuration Tool or configured applications you need to run the AwareIM Control Panel first.

To start the AwareIM Control Panel, double click on the AwareIM application.

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.

The following section lists the common problems encountered when running AwareIM.

1. By default AwareIM files are installed with full access to the current user but with read-only access to other users. As a result AwareIM will not run if launched by another user as it needs write access to its files. If you want other users to be able to run AwareIM you can change access privileges of AwareIM files. To do this:
   • Start the Terminal application located in the Application/Utilities directory
   • From the Terminal window enter the command to change to AwareIM.app directory:
     
     

     cd ../../Applications/AwareIM.app

   • Enter the command to change access privileges to all AwareIM files:
     
     

     sudo chmod –R 777 Contents (enter your password when asked)

   • Restart AwareIM

To start the Configuration Tool press the “Start Configurator” button on the AwareIM Control Panel. 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 the default user name admin and the default password password. Do not forget to change the default password as soon as you log in (use the “Change Password” command under the “Tools” menu).

AwareIM Control Panel starts up the following components required for AwareIM:

• Tomcat server
• AwareIM server
• Configuration Tool

When starting up these components the Control Panel uses default startup options.

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

For example, you can increase the memory allocated to different AwareIM 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 the Login section describing other entry points to the configured applications.