Skip to content

Commit

Permalink
Default to Ubuntu 24.04 and enable DNS on VCN
Browse files Browse the repository at this point in the history
  • Loading branch information
MallocArray committed Dec 2, 2024
1 parent 2227d77 commit b0cab6f
Show file tree
Hide file tree
Showing 8 changed files with 23 additions and 6,524 deletions.
30 changes: 18 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,29 +2,35 @@

Oracle Cloud Free Tier offer includes Always Free resources, such as 2 VMs with 1 CPU and 1 GB RAM each or Ampere ARM based VMs equivalent to 4 CPU and 24 GB RAM per month, which is sufficient to run a Unifi Controller for a small installation with no charge and no expiration date

<https://www.oracle.com/cloud/free/>
[https://www.oracle.com/cloud/free/](https://www.oracle.com/cloud/free/)

Oracle uses "stacks" that automates the provisioning of an environment using Terraform. Using only a single zip file, a Unifi Controller can be provisioned quickly with very little interaction.

## Breaking Changes

* The project name now only allows alphanumeric characters and no longer supports - or _. This is due to enabling DNS on the VCN to allow for static IP assignment

## Configuration

1) Download the .zip file.
2) Register an account on Oracle Cloud.
<https://myservices.us.oraclecloud.com/mycloud/signup>
* Recommended: Go to Menu>Compute>Instances>Create Instance. Click on "Edit" on the Placement panel and take note of the Availability domain number that is tagged with "Always Free Eligible". The process can then be cancelled. This number will be used later. (At this time, Ampere A1 can be created in any Availability Domain) ![Availability Domains](./images/availability-domain.jpg)
[https://myservices.us.oraclecloud.com/mycloud/signup](https://myservices.us.oraclecloud.com/mycloud/signup)
* Recommended: Go to Menu>Compute>Instances>Create Instance. Click on "Edit" on the Placement panel and take note of the Availability domain number that is tagged with "Always Free Eligible". The process can then be cancelled. This number will be used later. (At this time, Ampere A1 can be created in any Availability Domain) ![Availability Domains](./images/availability-domain.jpg)
3) Navigate to Menu>Storage>Object Storage & Archive>Buckets>Create Bucket. Give the bucket a name, such as "unifibackup". This will be used to store backup files outside of the VM Instance. Optional: Take note of the "Namespace: " value after creating the bucket as it will be used if mounting the bucket for autobackups.
4) Navigate to the Menu>Developer Services>Resource Manager>Stacks
5) Click "Create Stack" ![alt text](./images/stacks.jpg)
6) Leave the default option of "My Configuration". Change the "Terraform configuration source" to ".Zip file", then drag or Browse the zip file to the Stack Configuration section. Provide a name for the stack if desired or keep the auto-generated name. Leave the default Terraform version as 1.1.x then click Next ![alt text](./images/create-stack.jpg)
5) Click "Create Stack"
![alt text](./images/stacks.jpg)
6) Leave the default option of "My Configuration". Change the "Terraform configuration source" to ".Zip file", then drag or Browse the zip file to the Stack Configuration section. Provide a name for the stack if desired or keep the auto-generated name. Leave the default Terraform version as 1.2.x then click Next ![alt text](./images/create-stack.jpg)
7) Review the variables and modify if needed. Click Next, then Create
* Enter/Verify the Availability Domain number in the list of variables.
* Enter the name of the storage bucket created earlier
* Defaults to an Ampere ARM based instance, or change to VM.Standard.E2.1.Micro for an Intel based instance with lower CPU/Memory allowance for Free Tier
* Enter/Verify the Availability Domain number in the list of variables.
* Enter the name of the storage bucket created earlier
* Defaults to an Ampere ARM based instance, or change to VM.Standard.E2.1.Micro for an Intel based instance with lower CPU/Memory allowance for Free Tier
8) On the final Create page, check the box to "Run Apply"
* Alternatively, in the list of Stacks, click on the name of the newly created Stack. Click on **Apply** followed by Apply.
* Alternatively, in the list of Stacks, click on the name of the newly created Stack. Click on **Apply** followed by Apply.
9) In a few minutes, the Stacks job will complete and show the public IP address and URL to access the controller. It may take 15 minutes or more to complete the installation of the Unifi software.
* If the process encounters an error stating "shape VM.Standard.E2.1.Micro not found", verify the Availability Domain that is Always Free Eligible for your region, or try a different number 1-3.
* If the process encounters an error stating "Out of host capacity", your Region does not currently have available resources for Always Free instances. In the Oracle Forums regarding this error, they recommend trying again later as capacity is always being added.
* If the process encounters an error stating "shape VM.Standard.E2.1.Micro not found", verify the Availability Domain that is Always Free Eligible for your region, or try a different number 1-3.
* If the process encounters an error stating "Out of host capacity", your Region does not currently have available resources for Always Free instances. In the Oracle Forums regarding this error, they recommend trying again later as capacity is always being added. You can also upgrade to "Pay As You Go" (PAYG) which makes the Ampere instances much more available, and as long as you stay under the Free Tier limits, continues to be free.
[Managing Account Upgrades and Payment Method](https://docs.oracle.com/en-us/iaas/Content/Billing/Tasks/changingpaymentmethod.htm)
10) Open the URL to the controller web interface and configure or restore a backup file. If using a DNS name, update the entry to reflect the new IP address.
11) Setup the controller or restore from a backup file

Expand All @@ -42,7 +48,7 @@ The zip file contains one or more .TF files with Terraform instructions. These
* Network Security Groups with required ports for Unifi Controller
* Computer Instance sized for Always Free running Ubuntu 18.04 with public IP address
* iptables firewall rules added and saved for future reboots
* Packages updated on first boot and Unifi Controller installed using [GlennR's Installation Script](https://community.ui.com/questions/UniFi-Installation-Scripts-or-UniFi-Easy-Update-Script-or-Ubuntu-16-04-18-04-18-10-19-04-and-19-10-/ccbc7530-dd61-40a7-82ec-22b17f027776)
* Packages updated on first boot and Unifi Controller installed using [GlennR&#39;s Installation Script](https://community.ui.com/questions/UniFi-Installation-Scripts-or-UniFi-Easy-Update-Script-or-Ubuntu-16-04-18-04-18-10-19-04-and-19-10-/ccbc7530-dd61-40a7-82ec-22b17f027776)

## SSH Access to Instance

Expand Down
Binary file modified Unifi-OracleCloud.zip
Binary file not shown.
Loading

0 comments on commit b0cab6f

Please sign in to comment.