Skip to content

Commit 2561e02

Browse files
authored
Merge pull request #66 from Interlisp/masinter-patch-1
Revise OIO Operations Guide for DNS and AWS updates
2 parents f7a7eda + e0d23dd commit 2561e02

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/OIO_Operations_Guide.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Online.Interlisp.Org: Operations Guide
22
## Overview
3-
Online.interlisp.org runs on an AWS EC2 instance (currently a t3.medium instance with 50GB attached EBS storage) controlled by the Interlisp.org AWS account. This instance runs Ubuntu (currently 20.04) with Docker CE installed. An AWS Elastic IP (3.19.8.9) is assigned to the instance, which in turn is pointed to by a DNS A record for online.interlisp.org managed via the Interlisp.org GoDaddy account.
3+
Online.interlisp.org runs on an AWS EC2 instance (currently a t3.medium instance with 50GB attached EBS storage) controlled by the Interlisp.org AWS account. This instance runs Ubuntu (currently 20.04) with Docker CE installed. An AWS Elastic IP (3.19.8.9) is assigned to the instance, which in turn is pointed to by a DNS A record for online.interlisp.org managed via the Interlisp.org NameCheap account. (We switched from GoDaddy in 2024; the NameCheap account is managed by [domains@interlisp.org](https://admin.google.com/u/1/ac/groups/00qsh70q2eprp4l/members).
44

55

66
Build, operation and maintenance of online.interlisp.org centers around two Docker images: the Portal image and the Medley (Online) image. These two images are available from the Github Container Registry at ghcr.io/interlisp/online-production and ghcr.io/interlisp/online-medley, respectively. (There is also a third image ghcr.io/interlisp/online-development that is a version of the Portal image with additional tools/features for test and development work.)
@@ -32,13 +32,14 @@ To enable this ssh connection, you will need an IAM login under the Interlisp.or
3232
2. AmazonS3FullAccess
3333
3. IAMUserChangePassword
3434
4. EC2InstanceConnect
35-
Any Administrator of the Interlisp.org AWS account can set this up for you (Larry, Frank, ?).
3635

36+
The simplest way to set that up is to add your AWS login to the Administrators group. Any Administrator of the Interlisp.org AWS account can set this up for you -- [currently Frank, Herb, Larry, Nick](https://us-east-1.console.aws.amazon.com/iam/home?region=us-east-1#/groups/details/administrators?section=users).
3737

3838
Once the IAM login is established, log into console.aws.amazon.com using the “interlisp” as the account (or, alternatively, 941561944431 as the account number) and your IAM username and password.
3939

4040

41-
From the AWS dashboard, navigate to the S3 service. In the S3 dashboard, you should see a list of S3 buckets for the account. (Currently, just 1 bucket.) Click on the “oio.support” bucket, revealing a list of three Objects (aka, files). These are the public/private keys that will enable ssh access to the online.interlisp.org EC2 host.
41+
From the AWS dashboard, navigate to the S3 service. (You might need to login at the [signin host](https://interlisp.signin.aws.amazon.com/console) to find the S3 dashboard.)
42+
In the S3 dashboard, you should see a list of S3 buckets for the account. (Currently, just 1 bucket.) Click on the “oio.support” bucket, revealing a list of three Objects (aka, files). These are the public/private keys that will enable ssh access to the online.interlisp.org EC2 host.
4243

4344

4445
Download the .pem file and the .pub file and place them into the ~/.ssh directory on whatever machine you will be using for the ssh terminal. Change the file permissions on the .pem file to prohibit all access except read/write by owner (chmod 0600 in Linux). On many systems, you will also need to ensure that the ~/..ssh directory is set to prohibit all access except read/write/execute by owner.
@@ -148,7 +149,7 @@ sudo systemctl start oio.service
148149
```
149150

150151

151-
## Bring new Medely release online
152+
## Bring new Medley release online
152153

153154
1. Make sure that the Docker image corresponding to the new Medley release has been created and uploaded to
154155
Docker Hub under interlisp/medley. When listing the Tags (sorted by Newest) under interlisp/medley, there should be

0 commit comments

Comments
 (0)