Before installing Appian, you must download and install the following third-party software:
In addition, you must download the following Appian software from Appian Community:
Product license files are required to start Appian after it has been installed. Long term product licenses can only be requested after Appian is installed. To request and install temporary or long-term licenses, please follow the steps outlined in the Requesting and Installing a License page.
Note: If you are migrating from an older version and have a product license from a previous version of Appian, it is valid to use with this version.
JDK 8 must be installed prior to running the Appian installer. This section describes how to install JDK 8 and update the JAVA_HOME and PATH environment variables.
Take note of the installation path. You will use this path when configuring the JAVA_HOME environment variable in the next step.
If necessary, for more information about installing see the JDK 8 documentation.
After running the Java installer, you must configure the JAVA_HOME environment variable to use the installation path and update the PATH variable to use the bin
directory for the JDK. If another JDK was previously installed, you must verify that it is set to the correct installation path.
To set the JAVA_HOME and PATH environment variables in Linux
/etc
directory.export JAVA_HOME=\<value\> export PATH=$JAVA_HOME/bin:$PATH:
To set the JAVA_HOME and PATH environment variables in Windows
Setting | Value |
---|---|
Variable name | JAVA_HOME |
Variable value | Installation path for JDK 8, for example, C:\Program Files\Java\jdk1.8.0_x |
;%JAVA_HOME%\bin
Important: If the JAVA_HOME environment variable is set to the installation path of another JDK version or a runtime environment that is not the JDK installation path, Appian will not start correctly.
Configure the UNIX user account and group that owns the application before running the setup program. A non-root user must have the following rights assigned when running the setup, and the APPIAN_HOME and JAVA_HOME directories must exist prior to running the installer.
Directory or File | Read | Write | Execute |
---|---|---|---|
APPIAN_HOME | Yes | Yes | Yes |
JAVA_HOME | Yes | No | Yes |
Installation Package | Yes | No | Yes |
The maximum allowable number of file descriptors available to the user running Appian may need to be increased. In order to determine if the limit needs to be increased, log in using the Appian application user account, and then run the following command:
1
ulimit -n
If the value returned by ulimit -n
is less than 100000, then increase the limit by running the following command:
1
ulimit -n 100000
Repeat this procedure for all servers running any component of the Appian architecture in all environments. For example, if you are using development, staging, and production environments, then you would repeat this procedure on each one.
Note: If the value of 100000 exceeds the total number of open files allowable for the system, consult your operating system documentation for instructions on configuring the limit on the total number of open files (this typically located in /proc/sys/fs/file-max
).
The system locale must be defined in order to install Appian. You will not be able to install Appian if the system locale is not defined.
In most cases, the system locale setting will already be set correctly. However, there is a rare issue that may be encountered on new or virtualized operating system installations. The instructions below describe how to verify the system locale on both supported platforms.
To verify the locale setting in Linux
Open Bash, and use the locale command to display the locale settings. If the locale is set, you will see something similar to the list below:
1
2
3
4
5
6
7
LANG=en_US
LC_CTYPE="en_US"
LC_NUMERIC="en_US"
LC_TIME="en_US"
LC_COLLATE="en_US"
LC_MONETARY="en_US"
LC_MESSAGES="en_US"
If the locale settings are not displayed, you must update or create the i18n file by doing the following steps:
/etc/sysconfig/i18n
in a text editor.Add the appropriate LANG=
and LC_ALL=
parameters. For example, if you are using English in the United States, you would define both parameters using en_US:
1
LANG=en_US LC_ALL=en_US
To verify the system locale setting in Windows
If the locale is not set correctly, make the necessary changes and reboot the machine.
Appian components communicate with each other over specified network ports. If you are preparing a distributed installation, you must first ensure that the required ports are open between the servers that host the different Appian components.