Initial Installation in Linux
The latest Agiloft software release can be found at http://www.agiloft.com/ewdownload. Agiloft installers are native executable files for each OS. The Linux installer file name will be in this form:
- Agiloft-<Release date>-linux-64bit-setup.sh
The installation requires a user named Agiloft who owns the installation files. Normally the installer creates an appropriate local user automatically. If user IDs are managed centrally in your environment e.g., NIS, or you wish to control the creation of the user, you may create the Agiloft user beforehand and choose the appropriate option during installation. The Linux installer may be run in three modes, controlled by command line options.
- GUI mode: Use defaults, or no command line options. The installer runs as a Java GUI application, presenting dialog boxes and progress indicators. Next, it runs Setup in web mode. You should have X-windows installed on the machine where Agiloft is installed, and you will need good bandwidth if your X-server works on a remote machine.
- Console mode: Use –c option. The installer starts as console application, showing prompts and progress in a Unix terminal window. Then select how to run Setup: in web mode or in console mode, accepting all defaults.
- Unattended mode: Use –q option. The installer starts as console application, but uses default values and does not prompt the user for input. Setup then runs in console mode.
The Linux installer is run as .sh <installer file name>. If you choose the –c option, the installer runs in console mode. It prints a welcome message and recommends closing all other applications – this is optional. Press Enter to continue.
Note: If you want to specify the MySQL directory, use the parameter
-mysqldir <location>. For example,
installer_file.sh -mysqldir /home/admin/custommysqldir.
You must accept the terms of the Agiloft license agreement to install and use the software. You may review the terms of the License Agreement at any time by visiting our website. Enter 1 to accept the agreement.
To accept the default directory location, at /usr/local/ Agiloft for Linux, press Enter. To install Agiloft in a non-default directory, use the additional command line option: -dir, followed by the new installation directory name. You may also use the –dir command line option to change the default when running the installer in unattended mode.
Next, you are prompted to configure any antivirus software running on your system. When you are finished, press Enter.
Calculate disk space
A minimum of 8 GB is required for new installations of Agiloft. The installer automatically detects free disk space and will exit if the disk has insufficient space.
The installer gives you the option to import existing knowledgebases.
- Select No [1, Enter] to create a simple Demo KnowledgeBase during installation.
- To restore or import a KB from a previous backup, select Yes  and enter a path to an existing saved project. Click Next to continue.
Next, the installer extracts files into the installation directory. In console mode you will see a long line sequence displayed. In GUI mode, a progress bar is shown while the extraction runs.
You must decide how to run the Setup utility: either in Fully automatic mode [1, Enter] or with Customized setup .
- Press [1, Enter] to run Setup in console mode, applying all default selections.
- Press  to run Setup in web mode.
When running Setup in fully automatic mode, a list of messages similar to the example below will appear. The URLs it generates will differ for each individual installation. If the user has opted to restore projects, the message with the form “Restore projects from /a/path/to/directory/with/saved/knowlegebases folder” will appear. If the user has opted not to restore projects, then the message “Creating Demo project” will appear instead.
NGINX is installed by default in Linux. NGINX should not be configured on the server after installation, as upgrading the Agiloft version will overwrite any customizations. Instead, any custom domains or certificates for NGINX must always be done in the Setup Assistant. In the Web Server section of the Setup Assistant, you can add the SSL certificates for NGINX, which are required for an HTTPS installation. The steps to create the "crt" and "key" files are described here.
The files may be placed anywhere on the server. For example:
Starting from release version 2017_02, Agiloft does not support versions of glibc below 2.14.