Merge pull request #1033 from oracle-devrel/fh-changes

Fh changes

Author: fhasan80

cloud-infrastructure/vmware-solutions/oracle-cloud-migrations/README.md

@@ -1,6 +1,6 @@
 # Oracle Cloud Migrations
 
-Oracle Cloud Migrations enables customers to migrate virtual machines to Oracle Cloud Infrastructure (OCI) Compute instances. It helps customers eliminate manual migration tasks and ultimately reduce errors in asset discovery and migration planning and execution.
+Oracle Cloud Migrations enables customers to migrate virtual machines to Oracle Cloud Infrastructure (OCI) Compute instances. It helps customers eliminate manual migration tasks and ultimately reduces errors in asset discovery and migration planning and execution.
 
 Reviewed: 11.12.2023
 
@@ -26,7 +26,7 @@ Reviewed: 11.12.2023
 ## Videos
 
 - [Cloud Coaching Clinic - Introduction to Oracle Cloud Migrations](https://www.youtube.com/watch?v=a1C3vZh5Wno)
-  - In this Cloud Coaching Clinic session, we talk about the Oracle Cloud Migrations Service and how it enables you to migration VMs from your on-premises VMware environments to OCI Compute VMs.
+  - In this Cloud Coaching Clinic session, we talk about the Oracle Cloud Migrations Service and how it enables you to migrate VMs from your on-premises VMware environments to OCI Compute VMs.
 
 # License
 

cloud-infrastructure/vmware-solutions/oracle-cloud-migrations/windows-migrations/LICENSE

@@ -0,0 +1,36 @@
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloud-infrastructure/vmware-solutions/oracle-cloud-migrations/windows-migrations/README.md

@@ -1,50 +1,22 @@
 # Windows Migrations
 
-## Operating system preparations
-
-In order to successfully migrate source environments based on the Microsoft Windows operating system you need to prepare the source environment.
-Microsoft Windows instances run on OCI Compute shapes using Paravirtualized drivers (VirtIO) for the Storage and Network interfaces. The drivers for these devices are by default not present and need to be installed before the migration to OCI in the source environment. If this is not done, the migrate instance will boot in OCI and fail with an “inaccessible boot device error” (Bluescreen error)
-and/or no networking interfaces presence.
-
-### Installing the Oracle Paravirtualized drivers
-You can download the Oracle VirtIO drivers for Windows for oracle's e-delivery site:
-https://docs.oracle.com/en/operating-systems/oracle-linux/kvm-virtio/
-
-**IMPORTANT**: Use the new VirtIO 2.0.1 or 2.1.0 Drivers, as the previous version (2.0) will result
-in an inaccessible boot device error.
-
-### Replication issues with source instances running Microsoft Windows
-On every replication cycle, the OCM service will try to create a snapshot on the source
-virtual machine. The VMware environment will try to make the snapshot using filesystem
-and application aware quiescing. 
-
-There are sometimes issues where the VMware platform is not able to quiesce the filesystem properly, 
-resulting in an replication error. The error could be something like: failed to open Virtual Disk. Open virtual Disk failed. 
-The error code is 1. (Error code 1 means an unkown VMware error)
-
-You can disable the application level quiescing, but be aware that the final replication cycle needs to
-be then run with a powered off source VM, else there could be a possibility of corrupted data.
-
-### How to disable application level quiescing during snapshots of virtual machines
-https://kb.vmware.com/s/article/2146204
-
-Disable VSS application quiescing using the VMware Tools configuration:
-- Open the file C:\ProgramData\VMware\VMware Tools\Tools.conf file using a text editor.
-- If the file does not exist at the location mentioned above, create it.
-- Add these entries to the file:
-```
-[vmbackup]
-vss.disableAppQuiescing = true
-```
-- Save and close the file.
-- Restart the VMware Tools Service.
-- Click Start > Run, type services.msc, and click OK.
-- Right-click the VMware Tools Service and click Restart.
+This is a guide on how to migrate source environments based on the Microsoft Windows operating system.
+
+Reviewed: 09.05.2024
+
+# When to use this asset?
+
+When you want to migrate source environments based on the Microsoft Windows operating system.
+
+# How to use this asset?
+
+Please read the README file in the files folder.
+
 
 # License
 
 Copyright (c) 2024 Oracle and/or its affiliates.
 
 Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/vmware-solutions/oracle-cloud-migrations/windows-migrations/files/README.md

@@ -0,0 +1,46 @@
+# Windows Migrations
+
+## Operating system preparations
+
+In order to successfully migrate source environments based on the Microsoft Windows operating system you need to prepare the source environment.
+
+Microsoft Windows instances run on OCI Compute shapes using paravirtualized drivers (VirtIO) for the Storage and Network interfaces. The drivers for these devices are by default not present and need to be installed before the migration to OCI in the source environment. If this is not done, the migrate instance will boot in OCI and fail with an “inaccessible boot device error” (Bluescreen error) and/or no networking interface presence.
+
+### Installing the Oracle Paravirtualized drivers
+
+[You can download the Oracle VirtIO drivers for Windows for Oracle's e-delivery site](https://docs.oracle.com/en/operating-systems/oracle-linux/kvm-virtio/)
+
+**IMPORTANT**: Use the new VirtIO 2.0.1 or 2.1.0 Drivers, as the previous version (2.0) will result in an inaccessible boot device error.
+
+### Replication issues with source instances running Microsoft Windows
+
+On every replication cycle, the OCM service will try to create a snapshot on the source virtual machine. The VMware environment will try to make the snapshot using filesystem and application aware quiescing. 
+
+There are sometimes issues where the VMware platform is not able to quiesce the filesystem properly, resulting in a replication error. The error could be something like: Failed to open Virtual Disk. Open Virtual Disk failed. The error code is 1. (Error code 1 means an unknown VMware error)
+
+You can disable the application level quiescing, but be aware that the final replication cycle needs to be then run with a powered-off source VM, else there could be a possibility of corrupted data.
+
+### How to disable application-level quiescing during snapshots of virtual machines
+
+[https://kb.vmware.com/s/article/2146204](https://kb.vmware.com/s/article/2146204)
+
+Disable VSS application quiescing using the VMware Tools configuration:
+- Open the file C:\ProgramData\VMware\VMware Tools\Tools.conf file using a text editor.
+- If the file does not exist at the location mentioned above, create it.
+- Add these entries to the file:
+```
+[vmbackup]
+vss.disableAppQuiescing = true
+```
+- Save and close the file.
+- Restart the VMware Tools Service.
+- Click Start > Run, type services.msc, and click OK.
+- Right-click the VMware Tools Service and click Restart.
+
+# License
+
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/vmware-solutions/oracle-cloud-vmware-solution/OCVS-Terraform-automation/LICENSE renamed to cloud-infrastructure/vmware-solutions/oracle-cloud-vmware-solution/OCVS-Terraform-automation/MultiHost-DenseIO-SingleCluster-SDDC/LICENSE

@@ -1,23 +1,22 @@
-## Terraform - Provisioning Multi host SDDC with single cluster
-Create by: [email protected]
-Date: February 2024
+# OCVS Terraform Automation: Multi Host DenseIO Single Cluster SDDC
 
-This is an example Terraform script to provision a multi host SDDC with a
-single cluster based on DenseIO shape, using VSAN for storage.
+Automate the provisioning and management of an OCVS environment.
 
-The terraform creates:
-- a VCN for deploying SDDC into
-- Needed subnet for ESXi servers
-- Needed VLANS for the VMware stack
+Reviewed: 09.05.2024
 
-The vSphere VLAN will be configured to allow egress traffic to internet via 
-NAT Gateway. This is needed for provisioning to succeed. As internet access
-is needed to license registration with VMware.
+# When to use this asset?
 
-more info:
-https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/ocvp_sddc
+This is an example Terraform script to provision a multi-host SDDC with a single cluster based on DenseIO shape, using VSAN for storage.
+
+# How to use this asset?
+
+See the README in the files folder.
 
 # License
+
 Copyright (c) 2024 Oracle and/or its affiliates.
+
 Licensed under the Universal Permissive License (UPL), Version 1.0.
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.
+

cloud-infrastructure/vmware-solutions/oracle-cloud-vmware-solution/OCVS-Terraform-automation/MultiHost-DenseIO-SingleCluster-SDDC/README.md

@@ -0,0 +1,21 @@
+## Terraform - Provisioning Multi host SDDC with single cluster
+
+Create by: Richard Garsthagen
+
+Date: February 2024
+
+This is an example Terraform script to provision a multi-host SDDC with a single cluster based on DenseIO shape, using VSAN for storage.
+
+The terraform creates:
+- a VCN for deploying SDDC into
+- Needed subnet for ESXi servers
+- Needed VLANS for the VMware stack
+
+The vSphere VLAN will be configured to allow egress traffic to the internet via NAT Gateway. This is needed for provisioning to succeed. Internet access is needed to license registration with VMware.
+
+[More Info](https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/ocvp_sddc)
+
+# License
+Copyright (c) 2024 Oracle and/or its affiliates.
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.