{{tag>Manuals Installation_Guide}}
[<10>]

====== Installation under Mac OS X operating system ======



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


<callout type="primary" icon="true" title="note"> 
** //**AwareIM**// needs Java version 17.0 or later to be installed on your machine. You do not need to install Java for MAC OS X operating system as //**AwareIM**// already comes with Java as part of its distribution package. The Java version //**AwareIM**// comes with is JDK 17.0 (64-bit). If you want to upgrade your Java system to the later version you can set up //**AwareIM**// to work with your version of Java. See section [[0500_java]] for more details**.**\\ 
\\ 
**Although //**AwareIM**// comes with its own Java it still needs some Java version to be installed in order to kick-start itself. On some systems that do not have any Java installed there will be an error message asking the user to install the legacy Java. In this case follow the instructions in the message to install legacy Java and start //**AwareIM**// again after that.
</callout>
====== Installing AwareIM ======

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.

====== Running AwareIM ======

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

===== Starting AwareIM Control Panel =====

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 [[glossary:business_space|business space]] and the initial [[glossary:business_space_version|business space version]]. 



===== Common problems when running AwareIM =====


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



  - 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:\\  \\ <code>cd ../../Applications/AwareIM.app</code>
    * Enter the command to change access privileges to all //**AwareIM**// files:\\ \\ <code>sudo chmod –R 777 Contents (enter your password when asked)</code>
    *Restart AwareIM


===== Starting the Configuration Tool =====


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).

===== Changing startup options of the AwareIM components =====


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).

===== Starting configured applications =====


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 [[docs:2000_concepts:0900_prod_feats:0100_access_control:0200_login|]] section describing other entry points to the configured applications.