LiquidFiles Documentation
LiquidFiles Documentation

Amazon EC2 Installation

In the Amazon Elastic Cloud, it's possible to launch a pre-configured LiquidFiles Virtual Appliance. Amazon has several data centres across the globe. LiquidFiles has pre-configured virtual appliances in all of Amazon's EC2 data centres.

Amazon Virtual Private Cloud (VPC) Configuration

For any Amazon EC2 instance to operate, you will need to configure Amazon Virtual Private Cloud (VPC) in the Amazon AWS space. If you're starting a complete fresh Amazon environment and LiquidFiles is your first instance, please follow these instructions to Configuration Amazon Virtual Private Cloud (VPC).

Installation

This is a step by step instruction for setting up LiquidFiles in the Amazon EC2 cloud.

First, login or create an account at the Amazon EC2 console.

First, select the region where you want to Launch the LiquidFiles instance. Select Instances in the left hand menu and click "Launch Instance."

In the Community AMI area, please search for "liquidfiles" and the LiquidFiles Virtual Appliance instance will be ready to be selected.

Regions

Here is the complete list of different EC2 regions and respective AMI's. Latest AMI Version: v4.2.6. The system is set to automatically update to the latest version as part of the nightly maintenance.

Region Location AMI
USA
us-east-1 N. Virginia ami-0b6e80c94d17dd33c
us-east-2 Ohio ami-0c610f833b66b4049
us-west-1 N. California ami-0bce68b3de2a3af86
us-west-2 Oregon ami-070f6b4b9ccf2250b
Africa
af-south-1 Cape Town ami-0a771d849a13a8a15
Asia Pacific
ap-east-1 Hong Kong ami-0c5a389e392cefbbe
ap-south-1 Mumbai ami-0c485fc8f65b5cfcb
ap-south-2 Hyderabad ami-026f7651aef37bb95
ap-southeast-1 Singapore ami-08b6c03d3f1a624ed
ap-southeast-2 Sydney ami-02acda74897402eff
ap-southeast-3 Jakarta ami-023edee965dd08530
ap-southeast-4 Melbourne ami-0a0ad196cdf495531
ap-northeast-1 Tokyo ami-0c08506513881a565
ap-northeast-2 Seoul ami-081cd5dcb3873e6db
ap-northeast-3 Osaka ami-0bdf744a2550b74ab
Canada
ca-central-1 Canada ami-073a7a1bce7fb5348
ca-central-1 Calgary ami-0053c119e74460308
Europe
eu-central-1 Frankfurt ami-086b8078c8d80f2df
eu-central-2 Zurich ami-0b90731748a36a1ec
eu-west-1 Ireland ami-0e8dc7f6f4ef62b0e
eu-west-2 London ami-08c7f0c70219f5589
eu-west-3 Paris ami-02a7103aa4a9cbc1b
eu-north-1 Stockholm ami-0cf6a040ef3f68ce9
eu-south-1 Milan ami-04cc8b86fec5a6ae5
eu-south-2 Spain ami-0742942654d316469
Middle East
me-south-1 Bahrain ami-07c093da8de09da21
me-central-1 UAE ami-0f1ced7b03fffcee5
Israel
sa-east-1 Tel Aviv ami-0ad2bfd7496e315ce
South America
sa-east-1 Sao Paulo ami-016e458afa8574383

With the Instance Type, a t3.micro (or t3a.micro) instance is fine for testing. With a t3.micro you won't have access to AV scanning. For production a t3.small is fine to start with and you may want to move to a t3.medium if you have more than about 20 users (depending on usage).

The default disk size is 20GB. You can increase this as much as you need for your requirements.

If you later want to increase the disk space, you can shut down the instance, go to the Volumes and select to modify your Volume. When you reboot the LiquidFile system it will automatically resize the filesystem to use all available disk space.

The following Security Group is a complete list of ports if you enable all features in LiquidFiles. A couple of notes:

  • The four ICMP rules at the top of the list are strictly not needed for operation but are generally considered safe and will improve stability, operation and troubleshooting.
  • 192.1.2.0/26 in the TCP/222 port section should be replaced with your own external admin network.
  • Please see the: System & Firewall configuration for more details on the required ports.

This is the old style AWS config, but it shows the information you need better.

At this point the LiquidFiles system is booting (after you've hit Launch Instance) and you can continue that part in the Getting Started section.

Next Steps — Static IP, DNS & Reverse DNS

For production systems, it's a good idea if we can to configure Static IP addresses as that make DNS configuration easier and more reliable.

Configure Fixed IP / Elastic IP

Please login to the AWS management console and go to EC2 → Elastic IP

After we've allocated our Elastic IP, we need to associate it with our LiquidFiles instance.

When the Elastic IP has been successfully associated with our LiquidFiles instance, we can copy the address and use that for our DNS server configuration.

Depending on your DNS Server/Service, the configuration is going to be a little bit different, and somewhere you will have the ability to add a name with an A record that has the value from the Amazon Elastic IP address we just allocated ourselves.

In our example, we use the name: liquidfiles.liquidftest.com that is mapped to 13.56.7.180.

Configure Reverse DNS

Once the DNS is configured, you can configure the Reverse DNS in the AWS console. There is a validation that the DNS configured matches the Reverse DNS you want to configure so you'll need to make sure your DNS is configured properly first.

Above we configured files.liquidftest.com mapped to 13.56.7.180, here we're configuring 13.56.7.180 mapping to files.liquidftest.com.

Please continue on the Getting Started page.