Knowledge Base/Getting Started

Installation Instructions (Linux)

Angelfish
posted this on December 11, 2012 10:15 AM

After filling out the Trial Version Request form, you will receive an email that contains support information, a link to download the software, and a serial code.

You'll need the serial code to unlock the trial version, so you'll want to keep the email handy.

Support is available - if you get stuck, our support team will help!

How to Open a Support Ticket


Before You Begin


Before installing Angelfish, we recommend the following:

1) Create a role account to own the Angelfish files / folders / processes.

Angelfish processes will not run as root, so you need to create a separate user account to own the files / folders / processes. We typically use "agf" but you can use whatever you'd like.

2) Choose a TCP port for the web interface.

Angelfish uses port 9000 by default, but you can change the port to anything above 1024 or below 65356.

3) Create an installation directory.

The default path is /usr/local/agfs/ -- be sure to assign ownership of the directory to the role account created in step 1.

4) Download the installation package.

The download URL is available in the Trial Version email, and we recommend storing the installation package in the role account's home directory. (e.g. /home/agf/)

5) Determine if /tmp/ is executable.

If /tmp/ is mounted as noexec, Angelfish will only install to /usr/local/agfs/

 

Installation Steps


  • Angelfish processes will not run as root -- use the role account for installation.
  • Angelfish can be installed to any path. However...
  • If /tmp/ is mounted as noexec, Angelfish will install to /usr/local/agfs/.

1) Untar the installation package

$ tar xvf <installation-package-name>.tar

 

2) Run the Angelfish installer

 

$ ./agfs-linux-x86_64.130118.7330b.run

 

Installer Notes:

  • You'll be prompted to specify your installation directory, data directory, and default file browsing location during the installation process.
  • Port 9000 is used by default for the web UI, but you can specify any port during the install process (above 1024 and below 65356)
  • The Angelfish installation directory contains the control script for the Angelfish processes (agfsctl). You can view help text for agfsctl with the --help flag (i.e. agfsctl --help).

 

3)  Access the web UI & enter the serial

Training Video

Open a browser and type the IP address or hostname of the Angelfish server, plus the TCP port used by Angelfish (default is 9000). For example:

http://192.168.75.10:9000

If the port was changed during installation, please replace "9000" with the correct port.

You'll be prompted to enter the serial code from the Trial Version email - simply copy & paste it into field and click the "activate" button. After a few seconds, the UI will refresh and show the Angelfish login screen.

 

4) Login

Default username / password is:

admin / Angelfish123

 

Congratulations! Angelfish is now successfully installed. You can read configuration and setup articles here:

Next Video: Create a Profile

Basic Administration Tasks

 
Topic is closed for comments