| Both sides previous revision Previous revision Next revision | Previous revision |
| docs:1100_inst_guide:0300_macos [2022/08/21 12:09] – ↷ Page moved from start:1100_inst_guide:0300_macos to docs:1100_inst_guide:0300_macos administrator | docs:1100_inst_guide:0300_macos [2025/10/30 09:32] (current) – aware_support3 |
|---|
| [<10>] | [<10>] |
| |
| ====== Installation under Mac OS X operating system ====== | ====== MacOS Installation ====== |
| |
| |
| |
| Before installing Aware IM on a Mac computer check that your computer meets the necessary requirements described below. | Before installing //**AwareIM**// on a Mac computer check that your computer meets the necessary requirements described below. |
| |
| * Apple Macintosh computer | * Apple Macintosh computer |
| |
| |
| <note> | <callout type="primary" icon="true" title="note"> |
| **//** Aware IM** //needs Java version 12.0 or later to be installed on your machine. You do not need to install Java for MAC OS X operating system as //**Aware IM**// already comes with Java as part of its distribution package. The Java version //**Aware IM**// comes with is JDK 15.0 (64-bit). If you want to upgrade your Java system to the later version you can set up //**Aware IM**// to work with your version of Java. See section [[0500_java]] for more details**.**\\ | ** //**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 //**Aware IM**// 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 //**Aware IM**// again after that. | **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. |
| </note> | </callout> |
| ====== Installing Aware IM ====== | ====== Installing AwareIM ====== |
| |
| To start installation of the //**Aware IM**// software, double click on the //**Aware IM**// 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. | 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 Aware IM ====== | ====== Running AwareIM ====== |
| |
| **Whether you are running the Configuration Tool or configured applications you need to run the **//**Aware IM**//** Control Panel first.** | **Whether you are running the Configuration Tool or configured applications you need to run the **//**AwareIM**//** Control Panel first.** |
| |
| ===== Starting Aware IM Control Panel ===== | ===== Starting AwareIM Control Panel ===== |
| |
| | To start the //**AwareIM**// Control Panel, double click on the AwareIM application. |
| |
| To start the //**Aware IM**// Control Panel, double click on the Aware IM 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]]. |
| |
| |
| 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. | |
| |
| | ===== Common problems when running AwareIM ===== |
| |
| |
| 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 “[[start:1300_user_guide|Aware IM User Guide]]” for the explanation what business space and business space version are). | The following section lists the common problems encountered when running AwareIM. |
| |
| |
| |
| ===== Common problems when running Aware IM ===== | - 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: |
| | |
| | |
| The following section lists the common problems encountered when running Aware IM. | |
| | |
| | |
| | |
| - By default //**Aware IM**// files are installed with full access to the current user but with read-only access to other users. As a result //**Aware IM**// 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 //**Aware IM**// you can change access privileges of //**Aware IM**// files. To do this: | |
| * Start the Terminal application located in the ''Application/Utilities'' directory | * 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> | * 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 //**Aware IM**// files:\\ \\ <code>sudo chmod –R 777 Contents (enter your password when asked)</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 Aware IM | *Restart AwareIM |
| |
| |
| |
| |
| To start the Configuration Tool press the “Start Configurator” button on the Aware IM 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 //**Aware IM**// 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). | 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 Aware IM components ===== | ===== Changing startup options of the AwareIM components ===== |
| |
| |
| Aware IM Control Panel starts up the following components required for Aware IM: | AwareIM Control Panel starts up the following components required for AwareIM: |
| |
| * Tomcat server | * Tomcat server |
| * Aware IM server | * AwareIM server |
| * Configuration Tool | * Configuration Tool |
| |
| When starting up these components the Control Panel uses default startup options. | 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 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. | 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 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). | 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 ===== | ===== Starting configured applications ===== |
| [[http://localhost:8080/AwareIM/logonOp.html]] | [[http://localhost:8080/AwareIM/logonOp.html]] |
| |
| See also the “Aware IM User Guide” describing other entry points to the configured applications. | See also the [[docs:2000_concepts:0900_prod_feats:0100_access_control:0200_login|]] section describing other entry points to the configured applications. |
| |
| |