From fa7d02ab42d2a66e8e13bba2dba0f4c98a735c38 Mon Sep 17 00:00:00 2001 From: Yaw Anokwa Date: Tue, 16 Jan 2024 10:39:00 -0800 Subject: [PATCH] Central build sometimes fails on 1 GB machines --- docs/central-install-digital-ocean.rst | 4 ++-- docs/central-install.rst | 2 +- docs/central-troubleshooting.rst | 6 ++---- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/central-install-digital-ocean.rst b/docs/central-install-digital-ocean.rst index a74413366..1bf463f85 100644 --- a/docs/central-install-digital-ocean.rst +++ b/docs/central-install-digital-ocean.rst @@ -38,11 +38,11 @@ At the very top, under **Choose an image**, switch to the **Marketplace** tab an As you continue down this page, there are a few options that may be important to you: - There is a section for standard droplets and another for more expensive optimized droplets. In general, you should not need optimized droplets. -- The **size** option affects a few things, but the most important is the amount of memory available to your server. Memory does not affect storage space, it sets the amount of "thinking room" the server gets while it's working on things. If you don't expect many forms to be submitted at once and you don't expect many large media attachments, you can start with 1 GB. Higher-load servers and servers which handle many image or video attachments may need 2 GB or more. It is pretty easy to upgrade to a larger size later. +- The **size** option affects a few things, but the most important is the amount of memory available to your server. Memory does not affect storage space, it sets the amount of "thinking room" the server gets while it's working on things. If you don't expect many forms to be submitted at once and you don't expect many large media attachments, you can start with 2 GB. Higher-load servers and servers which handle many image or video attachments may need 4 GB or more. It is pretty easy to upgrade to a larger size later. .. tip:: - If you choose a 1 GB server we strongly recommend you :ref:`add swap `. + If you choose a 2 GB server we strongly recommend you :ref:`add swap `. - The datacenter region selects where physically your server will be located. If you have security concerns, this is your chance to decide which country hosts your data. Otherwise, generally selecting the option with closest geographic proximity to your users is a good idea. - If you are technically savvy and understand what an SSH key is, there is a field here that you will want to fill in. If not, don't worry about it. diff --git a/docs/central-install.rst b/docs/central-install.rst index c00f66038..61e5c19aa 100644 --- a/docs/central-install.rst +++ b/docs/central-install.rst @@ -60,7 +60,7 @@ Installing on AWS Amazon Web Services (AWS) is one of the many other options for installing Central. It's a good idea to read through the :doc:`instructions we've provided ` for DigitalOcean, as many of the steps remain the same or similar. -To obtain a server you will need to first `create an AWS account `_. When launching your instance, select the Ubuntu Server 20.04 LTS AMI in step 1. The ``t2.micro`` instance type has the 1 GB of memory recommended for if you don't expect many forms to be submitted at once and you don't expect many large media attachments. Regardless of how much memory you select, we also recommend 1 GB of swap and a minimum of 15 GB of disk storage. +To obtain a server you will need to first `create an AWS account `_. When launching your instance, select the Ubuntu Server 20.04 LTS AMI in step 1. The ``t2.small`` instance type has the 2 GB of memory recommended. Regardless of how much memory you select, we also recommend 2 GB of swap and a minimum of 25 GB of disk storage. When adjusting the security settings open up the ports for SSH, HTTP, and HTTPS. Once you have launched your instance, go to the Elastic IPs menu option under Network & Security, then allocate a new address and associate it with your server in order to keep the IP address for your server consistent. diff --git a/docs/central-troubleshooting.rst b/docs/central-troubleshooting.rst index 8df3f9f2c..ddb679fde 100644 --- a/docs/central-troubleshooting.rst +++ b/docs/central-troubleshooting.rst @@ -78,11 +78,9 @@ If you get an error suggesting that the JavaScript heap is out of memory, try :r Export produces corrupt zip --------------------------- -If you have installed Central on a 1 GB server or your forms collect many large media files, you may encounter problems exporting submission .zip files. Usually, the .zip file will end up being empty, or much smaller than expected and possibly corrupt. +If you have installed Central on a 1 GB server, you may encounter problems exporting submission .zip files. Usually, the .zip file will end up being empty, or much smaller than expected and possibly corrupt. -If you are expecting to collect media files, we recommend having at least 2 GB of memory. When collecting images, we recommend :ref:`specifying a maximum size in form design `. - -If you still run into problems, try :ref:`increasing allocated memory `. +We recommend having at least 2 GB of memory. If you still run into problems, try :ref:`increasing allocated memory `. .. _file-upload-fails-with-413: