AgileApps Support Wiki Pre Release

Installing AgileApps

From AgileApps Support Wiki

Prerequisites

  • MySQL Server - mysql-5.1.x or higher versions. We recommended you download mysql-5.5.x.

Notepad.png

Note: If MySQL is not installed in the machine where AgileApps is installed, then make sure that MySQL binary is present in the local machine. Ensure that the command "mysql --version" returns the correct output. Without this, the mysql databases are not created in the remote machine.

  • MySQL Query Browser – version 1.1.x or higher (optional). We recommend you download the latest version.
  • Mail Server – ( QK SMTP Server / smtp4dev). We recommend you download the latest version.
  • Memcached – Memcached 1.4.10 or later for caching. If you select Ehcache during installation, then you can skip installing memcache.

Configuring MySQL Server Post Installation of MySQL

For information on configuring MySQL, based on the type of setup, refer to the following:

Installation Procedure

Notepad.png

Note: When you install AgileApps using a non-root MySQL user with the privileges, the service desk application is not available.

1. To install AgileApps, browse to the Software Download Center in Empower.
2. Download the Software AG Installer file. The latest installer file is made available here. Select the appropriate installer file based on your operating system (Windows/Unix/Mac OS X). For information on using the installer file, see the Using the Software AG Installer guide available in Software AG Product Documentation.
3. Follow the instructions in the Using the Software AG Installer guide to install your product. During the installation, when you are on the Products screen, select AgileApps application and the following components:
  • Core Files 10.13
  • Memcached 10.13 or EHCache
4. Select the language and click Next.
5. Continue to click Next till you click Accept on the Terms and Conditions page.
6. Configure AgileApps as follows:
a. Provide the location of the license files for IS and AgileApps.
b. Provide the location of MySQL driver jar.
c. In the Database Connection screen, provide the Host, Port, Database user, and Password.
Note: The Port, Database user, Password must be the same as provided during MySQL setup.
d. Click Next in the subsequent screens and click Finish.

Configuring the Property Files

All the property files installed as a result of the AgileApps application installation are available at <Install-dir>/profiles/IS_default/configuration/com.softwareagplatform.config.propsloader folder. Change the following values in the listed property files:

  • In the com.softwareag.catalina.connector.https.pid-agileappsHttps-8284.properties file, change port number from 8284 to 443.
  • In the com.softwareag.catalina.connector.http.pid-agileappsHttp-8283.properties file, change port number from 8283 to 80 and redirectPort from 8284 to 443.

Notepad.png

Note: If you are running more than one instance of AgileApps on the same machine, then ensure that the http/https port configuration for both AgileApps instances is different.

Accessing AgileApps

1. Start the IS server at <INSTALL-DIR>/profiles/IS_default/bin.
2. Access the Longjump user interface https://<host>/networking/Service using the following credentials. You will be prompted to reset the admin password after you log on.
  • user and password: Use the credentials you typed into the Software AG installer.
3. On the left panel click create new tenant. Enter the required details in the Create your Account page. After you click Create My Account, the application may take a few minutes to create the tenant. For more information on creating tenants, see Managing Tenants.
4. Log on to AgileApps using the URL https://<host>/networking/servicedesk/index.jsp with the credentials provided during the tenant creation. After you log on, you will be prompted to reset the password.

Platform Installation and Configuration

For more information related to installing and configuring AgileApps, see Platform Installation Guide.