Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:1100_inst_guide:0200_linux [2022/08/21 12:10] – ↷ Links adapted because of a move operation administratordocs:1100_inst_guide:0200_linux [2025/10/30 09:31] (current) – aware_support3
Line 1: Line 1:
 {{tag>Manuals Installation_Guide}} {{tag>Manuals Installation_Guide}}
 [<10>] [<10>]
-====== Installation under Linux operating system ======+====== Linux Installation ======
  
  
-To install //**Aware IM**// under the Linux operating system follow the steps below:+To install //**AwareIM**// under the Linux operating system follow the steps below:
  
 +<callout type="warning" icon="true" heading="warning">//**AwareIM**// **needs Java version 17.0 or later to be installed on your machine.** Starting from 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 [[0500_java]] for more details on how to install Java.</callout>
  
-  - //**Aware IM **//**needs Java version 12.0 or later to be installed on your machine. Starting from Aware IM version 6.0 Aware IM no longer includes Java in its distribution. If you do not have Java installed on your system please download it and install before running Aware IM**//**. **//**See section [[0500_java]] for more details on how to install Java.** 
   - Download ''AwareIM.tar.gz'' file from the Awaresoft web site.    - Download ''AwareIM.tar.gz'' file from the Awaresoft web site. 
-  - Unpack the archive file into the local directory of your hard disk. We will assume that //**Aware IM**// is unpacked into the AwareIM directory. You can use the following command to unpack the archive\\ \\ <code> +  - 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\\ \\ <code>gnzip < /path/to/AwareIM.tar.gz | tar xvf – </code> 
-    gnzip < /path/to/AwareIM.tar.gz | tar xvf – +  - 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 [[0100_windows]].
-</code> +
-  - By default Aware IM is set up to work with the Apache Derby database, which is included in the //**Aware IM**// installation. If you are happy to use the default database you can start using Aware IM straight away – see next section. If you want to use //**Aware IM**// with other databases you need to make sure that the the database is installed and running on your machine before starting //**Aware IM**//. Then perform database integration steps as described in [[0100_windows]].+
  
-====== Running Aware IM ======+====== Running AwareIM ======
  
-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.+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.
  
-===== Starting Aware IM Control Panel =====+===== Starting AwareIM Control Panel =====
  
  
-To start the //**Aware IM**// Control Panel, run the ''CP'' executable located in the ''CP/eclipse'' directory of your Aware IM installation.+To start the //**AwareIM**// Control Panel, run the ''CP'' executable located in the ''CP/eclipse'' directory of your AwareIM 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.+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 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 [[docs:2000_concepts:0200_basics:0500_business_space]] for the explanation what business space and business space version are). +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 [[docs:2000_concepts:0200_basics:0500_business_space]] for the explanation what business space and business space version are). 
  
-===== Starting Aware IM under non-graphical Linux =====+===== Starting AwareIM under non-graphical Linux =====
  
  
-To start Aware IM under Linux that does not have graphical user interface do the following:+To start AwareIM under Linux that does not have graphical user interface do the following:
  
   - Open the Shell Console session and change to the AwareIM/bin directory:\\ \\ <code>cd AwareIM/bin </code>   - Open the Shell Console session and change to the AwareIM/bin directory:\\ \\ <code>cd AwareIM/bin </code>
-  - Issue the following command:\\ \\  <code>bash startAwareIMNoGUI.sh</code>+  - Issue the following command:\\ \\  <code>bash startAwareIMNoGUI.sh </code>
  
  
-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.+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 //**Aware IM**// to create the default business space and the initial business space version (see [[docs:2000_concepts:0200_basics:0500_business_space]] for the explanation what business space and business space version are). +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 [[docs:2000_concepts:0200_basics:0500_business_space]] for the explanation what business space and business space version are). 
  
 ===== Starting the Configuration Tool ===== ===== Starting the Configuration Tool =====
  
  
-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 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. 
  
  
Line 57: Line 55:
  
  
-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''. +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''. 
  
 ===== Starting configured applications ===== ===== Starting configured applications =====
Line 66: Line 64:
 [[http://localhost:8080/AwareIM/logonOp.html]] [[http://localhost:8080/AwareIM/logonOp.html]]
  
-See also “[[..:1300_user_guide|Aware IM User Guide]]” describing other entry points to the configured applications.+See also [[docs:2000_concepts:0900_prod_feats:0100_access_control:0200_login|Login]] describing other entry points to the configured applications.
  • Last modified: 2022/09/13 18:09