dev.ampliconrepository.org instructions

Updating the development server

Here are the steps for updating the dev server on AWS, dev.ampliconrepository.org. Updating the prod server is the same process.

1. Get logged into the server
   1. Using AWSConsole (https://awsconsole.ucsd.edu) login to AWS.
   2. Go to EC2, select the dev server's checkbox and then the "Connect" button near the top.
   3. On the next page you may need to change the username on the next page from 'root' to 'ubuntu'. Click connect. Now you should have a terminal on the server in your browser.

Take the operator lock before changing the server, and release it when you're done.

2. If no changes to required packages, jump to step 3.

   1. Stop the docker container: "docker exec -t amplicon-dev bash /srv/caper/stop-server.sh" (waits for background tasks), then "docker stop amplicon-dev". These two replace the old root ./stop-server.sh, which ran them both. A bare docker stop skips the wait.
   2. Remove the old container with "docker rm amplicon-dev"
   3. "cd /home/ubuntu/ampRepo_for_docker_build/AmpliconRepository"
   4. git checkout <branch or tag name>
   5. docker build -t genepattern/amplicon-repo:dev .
   6. set up the new container to run the code with the updated requirements /home/ubuntu/AmpliconRepository-dev/scripts/deploy/start-server.sh. This will now have the new container but the old code Proceed to step 3.

3. Update the server code from github .

   1. cd ~/AmpliconRepository-Dev
   2. git checkout <branch or tag>
   3. ~/stop-and-start-server.sh <<-- this will stop and restart the server. On restart it will have the updated code you checked out.