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

Topo and other changes #38

Merged
merged 4 commits into from
Jul 26, 2024
Merged
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
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,7 @@

- [Guides]()
- [COSI Accounts]()
- [Website Creation](./guides/website_creation.md)

# Resources

Expand Down
2 changes: 2 additions & 0 deletions src/equipment/computers/itl-build.md
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
# ITL Build

Since the ITL has been used as a lab and a classroom, it will need to have any software professors teaching in there require. Rebuilds are common to happen (usually once or twice a year).
30 changes: 30 additions & 0 deletions src/guides/website_creation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Creating a website

_updated: Jul 25th, 2024_

COSI websites are stored in Docker containers on [Tiamat](../infrastructure/servers/tiamat.md).

1. Get permission to host a site from the current Lab Directors.

2. Create a DNS entry for your website on [Zones](https://github.com/COSI-Lab/zones).
- Follow the directions in the readme for Zones
- At step 3, add a line to both `db.cosi` and `db.cslabs` using the following format:
```dns
<requested_subdomain> IN CNAME tiamat
```

3. Clone your repo on Tiamat in the `/docker` directory (at the root of the file system). Your repo must contain a `docker-compose.yaml` as well as anything else that you need for your container to function.

4. Update `/docker/caddy/Caddyfile` with the following information related to your site:
```caddyfile
<requested_subdomain>.cslabs.clarkson.edu{
reverse_proxy <container_name>:80
}

<requested_subdomain>.cosi.clarkson.edu{
reverse_proxy <container_name>:80
}
```
**NOTE:** This is the bare minimum required to make your site available. You can read more about configuring your entry [here](https://caddyserver.com/docs/caddyfile).

5. Restart all the containers by running `./run.sh` in `/docker`.
11 changes: 7 additions & 4 deletions src/infrastructure/network/topology.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,12 @@
# Topology

_updated: Apr 9th, 2024_

Note: Topology graphs have been temporarily removed due to dependency issues with `mdbook-graphviz`.
_updated: Jul 25th, 2024_

# Current Topology

![Current Topology](Current%20Topology.jpg)
![Current Topology](../../media/images/FinalTopo_SC.png)

## Notes
Servers like Mirror and Kasper that should ideally be up around the clock were placed in COLO because it is backed by a generator. There were a couple of incidents where the power went out on the hill campus that made COSI re-evaluate placement. If you want to know more about why the network changed you can take a look [here](https://carlone-capstone.cosi.clarkson.edu/).

There is room to add more [VLANs](vlans.md) to the network. Any new VLAN that needs internet connection can use the same port as the private VLAN that connects the two primary fiber switches.
Binary file added src/media/images/FinalTopo_SC.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading