Skip to content

Commit 91ed3c3

Browse files
committed
Adding new Howto to provision through Oracle Cloud Console
1 parent 36c3dae commit 91ed3c3

21 files changed

+147
-91
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Launching an Oracle Solaris Instance on Oracle Cloud Infrastructure from the Instances Page
2+
3+
Oracle Cloud Infrastructure Compute lets you provision and manage compute hosts, known as **instances** . You can launch instances as needed to meet your compute and application requirements. After you launch an instance, you can access it securely from your computer, restart it, attach and detach volumes, and terminate it when you're done with it. Any changes made to the instance's local drives are lost when you terminate it. Any saved changes to volumes attached to the instance are retained.
4+
5+
Since October 2019, [Oracle Solaris 11.4](https://www.oracle.com/solaris/technologies/solaris11-overview.html) images have been available for download from the [Oracle Cloud Infrastructure(OCI)](https://www.oracle.com/cloud/) Marketplace. With Solaris now in the cloud, customers can benefit from Solaris instances running on x86 architecture. This article is a walkthrough on how to launch an Oracle Solaris instance from the Instances page in the Compute section in the OCI BUI known as the [*Oracle Cloud Console*](https://docs.oracle.com/en-us/iaas/Content/GSG/Concepts/console.htm), the [other article](Launch_through_Marketplace.md) shows how to launch an Oracle Solaris instance from the OCI marketplace.
6+
7+
Note: *Images in this document have been captured on 17th November 2022.*
8+
9+
## Oracle Solaris 11.4 on OCI: Installation
10+
11+
------
12+
13+
All the following actions will be done in the Oracle Cloud Console. It presumes you have a tenancy, a compartment, and a VNC and subnet already set up.
14+
15+
### Step 1: Accessing the Instances page
16+
17+
To get to the Compute *Instances* page in the Oracle Cloud Console do the following actions:
18+
19+
![](Images/OCI_Instance_01_navigate.png)
20+
21+
22+
After logging in to the Oracle Cloud Console, you can find the *Instances* page by clicking on the hamburger menu icon on the left. After you select *Compute*, you can then click on *Instances*. This should bring you to a page that looks like this:
23+
24+
![](Images/OCI_Instance_02_create.png)
25+
26+
To launch an instance click on the *Create instance* button.
27+
28+
### Step 2: (Optional) Choose a name for your instance
29+
30+
The first (optional) step is to choose a name for the new instance, **a)** in the following screenshot. There is a default name so you can also skip this step.
31+
32+
![](Images/OCI_Instance_03_choose_name.png)
33+
34+
### Step 3: Choose the Oracle Solaris image
35+
36+
Click on *Change image*, **b)** in the previous screenshot, and this will open the Browse all images pane. As the Oracle Solaris image is available from the OCI Marketplace you will need to choose *Oracle images* from the dropdown menu. See the next screenshot:
37+
38+
![](Images/OCI_Instance_04_choose_oracle_images.png)
39+
40+
Once the list of Oracle images has loaded make sure the compartment you want to launch the instance in is selected—**a)** in the following screenshot—and then search for the Oracle Solaris image by filling in "Solaris" in the *Search...* box on the right above the list of images—**b)** in the same screenshot.
41+
42+
This should bring up the Oracle Solaris 11.4 image. Click on the checkbox on the lefthand side of the image to select it—**c)**.![](Images/OCI_Instance_05_choose_Solaris_image.png)
43+
44+
The Oracle Solaris 11.4 image entry has a dropdown menu listing the latest Oracle Solaris images—**d)**. Note, these will work on both VM and BM shapes. The latest available Oracle Solaris version will be the default, but there are options to run older versions. The versions available are the very first version—which still had a different image for VM and BM shapes—and the latest versions going back a year. When a new SRU update is available for Oracle Solaris on OCI, it will be added to the list as an option for your use and the oldest of the recent images will be dropped.
45+
46+
Once you choose your preferred version of the Oracle Solaris image, you can then agree to the [terms and conditions](https://cloudmarketplace.oracle.com/marketplace/content?contentId=58993511&render=inline) and click Launch Instance—**e)**. For our walkthrough, we have chosen the default image.
47+
48+
Now click on *Select image* to go back to the main page—**f)**.
49+
50+
### Step 4: Choose a shape
51+
52+
Another important choice you can make is to choose the underlying shape on which you wish to run the image. The current default shape that OCI offers is the VM.Standard.E4.Flex with 1 core OCPU, 16 GB memory, 1 Gbps network bandwidth. But you can choose a preferred shape by clicking the *Change shape* button.
53+
54+
For our demonstration, we are using an INTEL Skylake VM.Standard2.1 with 1 core OCPU, 15 GB memory, 1 Gbps network bandwidth you can find in the *Specialty and previous generation* section.
55+
56+
![](Images/OCI_Instance_06_choose_shape.png)
57+
58+
#### Step 5: Choose your VCN and Subnet
59+
60+
In the *Networking* section check if the correct Primary network (VNC) and Subnet are selected. If they aren't use the dropdown menus to select the correct ones,
61+
62+
#### Step 6: Configure the SSH keys
63+
64+
After you choose your preferred shape and check the networking settings, you must save the Private and Public Keys(SSH Key Pairs) to your instance or you can choose to select your own pair—**a)** in the following screenshot. If using the auto-generated, SSH key pair, it is critically important to save the Private keys as it cannot be accessed later.
65+
66+
![](Images/OCI_Instance_07_provision.png)
67+
68+
#### Step 7: Launch the instance
69+
70+
Once you click Create—**b)** in the screenshot above, OCI will provision and your instance will be up and running in a few seconds. Additionally, you can also find your public IP address from the Instance Information to connect to your instance using SSH. For more information on how to connect to a running instance, [click here](https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/accessinginstance.htm).
71+
72+
![](Images/OCI_Instance_08_final.png)
73+
74+
Once you are connected to your instance as an opc user, you can then choose to install additional software from the Oracle Solaris Support Repository. Note that on first boot after provisioning it may take a bit longer because Oracle Solaris will initiate its SMF services before letting you log in.
75+
76+
Refer to the [Oracle Solaris Blog](https://blogs.oracle.com/solaris/), to learn more.
77+
78+
Copyright (c) 2022, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Launching an Oracle Solaris Instance on Oracle Cloud Infrastructure from the Marketplace
2+
3+
Oracle Cloud Infrastructure Compute lets you provision and manage compute hosts, known as **instances** . You can launch instances as needed to meet your compute and application requirements. After you launch an instance, you can access it securely from your computer, restart it, attach and detach volumes, and terminate it when you're done with it. Any changes made to the instance's local drives are lost when you terminate it. Any saved changes to volumes attached to the instance are retained.
4+
5+
Since October 2019, [Oracle Solaris 11.4](https://www.oracle.com/solaris/technologies/solaris11-overview.html) images have been available for download from the [Oracle Cloud Infrastructure(OCI)](https://www.oracle.com/cloud/) Marketplace. With Solaris now in the cloud, customers can benefit from Solaris instances running on x86 architecture. This article is a walkthrough on how to launch an Oracle Solaris instance from the OCI Marketplace, the [other article](Launch_through_Instances.md) shows how to launch an Oracle Solaris instance from the *Instances* pane in the OCI BUI known as the *OCI Console*.
6+
7+
Note: *Images in this document have been captured on 14th November 2022.*
8+
9+
## Oracle Solaris 11.4 on OCI: Installation
10+
11+
------
12+
13+
A set of Oracle Solaris images is available in the the OCI Marketplace.
14+
15+
![](Images/OCI_solaris_on_cloud.png)
16+
17+
### Step 1: Accessing the OCI Marketplace
18+
19+
To get to the *Marketplace* pane in the OCI Console do the following actions:
20+
21+
![](Images/OCI_marketplace.png)
22+
23+
24+
After logging in to the OCI Console, you can find the OCI Marketplace by clicking on the hamburger menu icon on the left. After you select Marketplace, you can then click on *All Applications*. In the All Applications directory, you can use filters to help find the Oracle Solaris listing, as in this screenshot:
25+
26+
![](Images/OCI_solaris.png)
27+
28+
Clicking this should bring you to the Oracle Solaris page on the Marketplace.
29+
30+
### Step 2: Launching an Oracle Solaris 11.4 instance
31+
32+
For Oracle Solaris 11.4, the OCI Marketplace has a dropdown menu listing the latest Oracle Solaris images. Note, these will work on both VM and BM shapes. The latest available Oracle Solaris version will be the default, but there are options to run older versions. The versions available are the very first version—which still had a different image for VM and BM shapes—and the latest versions going back a year. When a new SRU update is available for Oracle Solaris on OCI, it will be added to the list as an option for your use and the oldest of the recent images will be dropped.
33+
34+
Once you choose your preferred version of the Oracle Solaris image and your compartment, you can then agree to the [terms and conditions](https://cloudmarketplace.oracle.com/marketplace/content?contentId=58993511&render=inline) and click Launch Instance. For our walkthrough, we have chosen the default image.
35+
36+
![](Images/OCI_solaris_launchinstance.png)
37+
38+
### Step 3: Configuring the instance
39+
40+
Once you click Launch Instance, you are directed to the Create Instance page where in the *Placement* section you can choose your Availability Domain and preferred [Fault Domain](https://docs.oracle.com/en-us/iaas/Content/General/Concepts/regions.htm#fault). Another important choice you can make is to choose the underlying shape on which you wish to run the image. The current default shape that OCI offers is the VM.Standard.E4.Flex with 1 core OCPU, 16 GB memory, 1 Gbps network bandwidth. But you can choose a preferred shape by selecting the Change Shape option.
41+
42+
![](Images/OCI_available_shapes.png)
43+
44+
For our demonstration, we are using an INTEL Skylake VM.Standard2.1 with 1 core OCPU, 15 GB memory, 1 Gbps network bandwidth you can find in the *Specialty and previous generation* section. After you choose your preferred shape, you must save the Private and Public Keys(SSH Key Pairs) to your instance or you can choose to select your own pair. If using the auto-generated, SSH key pair, it is critically important to save the Private keys as it cannot be accessed later.
45+
46+
![](Images/OCI_keys.png)
47+
48+
### Step 4: Instance Details
49+
50+
Once you click Create, OCI will provision and your instance will be up and running in a few seconds. Additionally, you can also find your public IP address from the Instance Information to connect to your instance using SSH. For more information on how to connect to a running instance, [click here](https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/accessinginstance.htm).
51+
52+
![](Images/OCI_activeconsole.png)
53+
54+
Once you are connected to your instance as an opc user, you can then choose to install additional software from the Oracle Solaris Support Repository. Note that on first boot after provisioning it may take a bit longer because Oracle Solaris will initiate its SMF services before letting you log in.
55+
56+
Refer to the [Oracle Solaris Blog](https://blogs.oracle.com/solaris/), to learn more.
57+
58+
Copyright (c) 2022, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/.

OracleSolaris_OCI/01_Launch_Instance/README.md

+1-85
Original file line numberDiff line numberDiff line change
@@ -2,88 +2,4 @@
22

33
Oracle Cloud Infrastructure Compute lets you provision and manage compute hosts, known as **instances** . You can launch instances as needed to meet your compute and application requirements. After you launch an instance, you can access it securely from your computer, restart it, attach and detach volumes, and terminate it when you're done with it. Any changes made to the instance's local drives are lost when you terminate it. Any saved changes to volumes attached to the instance are retained.
44

5-
Since October 2019, [Oracle Solaris 11.4](https://www.oracle.com/solaris/technologies/solaris11-overview.html) images have been available for download from the [Oracle Cloud Infrastructure(OCI)](https://www.oracle.com/cloud/) Marketplace. With Solaris now in the cloud, customers can benefit from Solaris instances running on x86 architecture. Here is walkthrough of launching an Oracle Solaris instance on OCI and the configuration options available:
6-
7-
Note: *Images in the markdown have been captured on 4th March 2021.*
8-
9-
## Oracle Solaris 11.4 on OCI: Installation
10-
11-
------
12-
13-
## ![](Images/OCI_solaris_on_cloud.png)
14-
15-
16-
17-
## Step 1: Accessing the OCI Marketplace
18-
19-
20-
21-
![](Images/OCI_marketplace.png)
22-
23-
24-
25-
After logging in to the OCI console, you can find the OCI Marketplace by clicking on the hamburger menu icon on the left. After you select Marketplace, you can then click on Applications. In the All Applications directory, you can use filters to help find the Oracle Solaris listings, as in this screenshot:
26-
27-
28-
29-
![](Images/OCI_solaris.png)
30-
31-
32-
33-
## Step 2: Launching an Oracle Solaris 11.4 instance
34-
35-
36-
37-
For Oracle Solaris 11.4, the OCI Marketplace has a dropdown menu listing the latest Oracle Solaris Virtual Machine and Bare Metal images. The Oracle Solaris 11.4.29 Virtual Machine is the latest available version(default) of Oracle Solaris in OCI, but there are options to run an older image either as a VM or a Bare Metal instance. When a new SRU update is available for Oracle Solaris on OCI, it will be added to the list as an option for your use.
38-
39-
Once you choose your preferred version of the Oracle Solaris image in your compartment, you can then agree to the [terms and conditions](https://cloudmarketplace.oracle.com/marketplace/content?contentId=58993511&render=inline) and click Launch Instance. For our walkthrough, we have chosen the default 11.4.29 Virtual Machine image.
40-
41-
42-
43-
![](Images/OCI_solaris_launchinstance.png)
44-
45-
46-
47-
48-
49-
## Step 3: Configuring the instance
50-
51-
52-
53-
Once you click Launch Instance, you are directed to the Create Instance page where you choose your Availability Domain and preferred [Fault Domain](https://docs.oracle.com/en-us/iaas/Content/General/Concepts/regions.htm#fault). Another important choice you can make is to choose the underlying shape on which you wish to run the image. The default shape that OCI offers is the VM.Standard.E3.Flex with 1 core OCPU, 16 GB memory, 1 Gbps network bandwidth. But you can choose a preferred shape by selecting the Change Shape option.
54-
55-
56-
57-
![](Images/OCI_available_shapes.png)
58-
59-
60-
61-
For our demonstration, we are using an INTEL Skylake VM.Standard2.2 with 2 core OCPU, 30 GB memory, 2 Gbps network bandwidth. After you choose your preferred shape, you must save the Private and Public Keys(SSH Key Pairs) to your instance or you can choose to select your own pair. If using the auto-generated, SSH key pair, it is critically important to save the Private keys as it cannot be accessed later.
62-
63-
64-
65-
![](Images/OCI_keys.png)
66-
67-
68-
69-
## Step 4: Instance Details
70-
71-
72-
73-
Once you click Create, OCI will provision and your instance will be up and running in a few seconds. Additionally, you can also find your public IP address from the Instance Information to connect to your instance using SSH. For more information on how to connect to a running instance, [click here](https://docs.oracle.com/en-us/iaas/Content/Compute/Tasks/accessinginstance.htm).
74-
75-
76-
77-
![](Images/OCI_activeconsole.png)
78-
79-
80-
81-
Once you are connected to your instance as an opc user, you can then choose to install additional software from the Oracle Solaris Support Repository.
82-
83-
84-
85-
Refer to the [Oracle Solaris Blog](https://blogs.oracle.com/solaris/), to learn more.
86-
87-
88-
89-
Copyright (c) 2021, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/.
5+
There are two ways you can launch an instance using the OCI BUI, called the OCI Console. The first is through the entry in the [*Marketplace*](Launch_through_Marketplace.md), the other is through the [*Instances* page](Launch_through_Instances.md) in the Compute section of the OCI Console. The two articles linked above will show you how to do this.

REST/setting_up_the_connection.md

+10-6
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Setting Up the RAD/REST Service
22

3-
The README file assume you're using Oracle Solaris 11.4, if you're using Oracle Solaris 11.3 you'll need to create/configure your the `rad:remote` service first, for more details [read the RAD Developer's Guide](https://docs.oracle.com/cd/E53394_01/html/E54825/gpztv.html#scrolltoc).
3+
The README file assumes you're using Oracle Solaris 11.4, if you're using Oracle Solaris 11.3 you'll need to create/configure your the `rad:remote` service first, for more details [read the RAD Developer's Guide](https://docs.oracle.com/cd/E53394_01/html/E54825/gpztv.html#scrolltoc).
44

55
### Enabling `rad:remote`
66

@@ -28,15 +28,17 @@ Now it's running, you can connect to the system remotely.
2828

2929
### Copying The Certs
3030

31-
In case where you're system is using a certificate issued by the host CA — like in my case — you'll need to copy that across to your client system first:
31+
In case where you're system is using a self-signed certificate issued by the host CA — like in my case — you'll need to copy that across to your client system first:
3232

33-
```shell
33+
```bash
3434
-bash-4.4$ scp testuser@test_server.example.com:/etc/certs/localhost/host-ca/hostca.crt .
3535
Password:
3636
hostca.crt 100% 1147 666.9KB/s 00:00
3737
```
3838

39-
Now we can use the `hostca.crt` in all our REST conversations that connect to this server.
39+
Now we can use the `hostca.crt` in all our REST conversations to validate the server in the connections.
40+
41+
A tip, when you copy the self-signed certificate over from the server it is helpful to rename the file to reflect which server it belongs to, especially if you're going to be connecting to multiple servers with self-signed certificates.
4042

4143
## Testing the Connection
4244

@@ -78,9 +80,11 @@ This second authentication method can be found at `/api/authentication/2.0/Sessi
7880

7981
This second method was added to allow for more advanced authentication methods like two-factor authentication for javascript based apps like the Oracle Solaris WebUI. For our purposes the first one works fine. I've put the JSON data in a file called `login.json` and will refer to it in the coming examples. Both will work on Oracle Solaris 11.4.
8082

83+
Oracle Solaris 11.4 SRU33 introduced a third option, using an X.509 Client Certificate. This avoids the need for using a username/password combination—and the risks of exposing them, and instead uses a pre-signed certificate that the connecting application can use to authenticate. An added advantage of this method is that you can use it directly on the REST call you want to use for your control or data request, instead of having to do an authentication call first and then to the control or data call with a second call. For more informaiton on how to use it see [Using the X.509 Client](Using_the_X509_Client.md) doc.
84+
8185
### Using Curl
8286

83-
On the client, from the directory I put the certificate in I can run:
87+
As an example of using the first authentication method, on the client—from the directory that holds the `hostca.crt` and `login.json` files—I can run:
8488

8589
```shell
8690
-bash-4.4$ curl -c cookie.txt -X POST --cacert hostca.crt --header 'Content-Type:application/json' --data '@login.json' https://test_server.example.com:6788/api/authentication/1.0/Session/
@@ -194,4 +198,4 @@ The return text is: {
194198

195199
You see the same result.
196200

197-
Copyright (c) 2020, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at <https://oss.oracle.com/licenses/upl/>.
201+
Copyright (c) 2022, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at <https://oss.oracle.com/licenses/upl/>.
Loading
Loading

0 commit comments

Comments
 (0)