Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Central build sometimes fails on 1 GB machines #1730

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/central-install-digital-ocean.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <central-install-digital-ocean-swap>`.
If you choose a 2 GB server we strongly recommend you :ref:`add swap <central-install-digital-ocean-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.
Expand Down
2 changes: 1 addition & 1 deletion docs/central-install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <central-install-digital-ocean>` 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 <https://aws.amazon.com/>`_. 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 <https://aws.amazon.com/>`_. 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.

Expand Down
6 changes: 2 additions & 4 deletions docs/central-troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <scaling-down-images>`.

If you still run into problems, try :ref:`increasing allocated memory <central-install-custom-memory>`.
We recommend having at least 2 GB of memory. If you still run into problems, try :ref:`increasing allocated memory <central-install-custom-memory>`.

.. _file-upload-fails-with-413:

Expand Down