|
| 1 | +# Frequently Asked Questions |
| 2 | + |
| 3 | +**1. Is there a way to verify my input CD3 Excel sheet for any typos/miskates?** |
| 4 | +<br> |
| 5 | + Yes, please choose 'Validate CD3' option in setUpOCI menu in GreenField workflow. It validates specific tabs of the excel sheet. Please see |
| 6 | + [CD3 Validator Features](/cd3_automation_toolkit/documentation/user_guide/learn_more/SupportForCD3Validator.md#support-for-cd3-validator) for more details. |
| 7 | + |
| 8 | +**2. Can I use an existing outdir to export the data from OCI?** |
| 9 | +<br> |
| 10 | + |
| 11 | + Make sure to use a clean outdir without any .tfvars or .tfstate file. Also use a blank CD3 Excel sheet as export process will overwrite the data in the respective tab. |
| 12 | + |
| 13 | +**3. If I am already using the toolkit and my OCI tenancy has been subscribed to a new region, how do i use the new region with toolkit?** |
| 14 | +<br> |
| 15 | +Follow below steps to start using the newly subscribed region with the toolkit: |
| 16 | +<br> - Take backup of the existing out directory. |
| 17 | +<br> - Create a new directory for the region say 'london' along with other region directories. |
| 18 | +<br> - Copy all the terraform modules and .tf files, except the .auto.tfvars and .tfstate files from existing region directory to the new one |
| 19 | +<br> - Modify the name of variables file (eg variables_london.tf) |
| 20 | +<br> - Modify the region parameter in this variables_london.tf |
| 21 | +<br> - Modify Image OCIDs in this variables file according to new region. |
| 22 | + |
| 23 | + |
| 24 | +**4. How do I upgrade an existing version of the toolkit to the new one without disrupting my existing tenancy files/directories?** |
| 25 | +<br> |
| 26 | +Please look at [Steps to Upgrade Your Toolkit.](/cd3_automation_toolkit/documentation/user_guide/Upgrade_Toolkit.md#steps-to-upgrade-your-toolkit-for-existing-customers) |
| 27 | + |
| 28 | +**5. How do I export instances in batches using different filters?** |
| 29 | +<br> |
| 30 | +Follow below steps: |
| 31 | +<br> - Modify the setUpOCI.properties file to set non_gf_tenancy to "true". |
| 32 | +<br> - Choose "Export Compute". |
| 33 | +<br> - Specify the filter - prefix of the instances or specific AD to export. |
| 34 | +<br> - Once the execution completes, take a backup of the files generated for instances in out directory( _<customer\_name>\__instances.tfvars_ and _tf\_import\_cmds \_instances\_nonGF.sh_) and a backup of the 'Instances' tab of the Input CD3 Excel Sheet. |
| 35 | +<br> - Repeat steps from 1 to 4 to export next set of Instances using another filter. |
| 36 | +<br> - Once you export all the required instances using multiple filters, move the files from backup to the out directory and then execute all the shell scripts generated for Instances. Consolidate the data of exported instances from the Excel sheet backups. |
| 37 | + |
| 38 | + |
| 39 | + |
| 40 | +**6. How do I delete a compartment from OCI using the toolkit?** |
| 41 | +<br> |
| 42 | + |
| 43 | +Terraform destroy on compartments or removing the compartments details from _<customer\_name>\_compartments.auto.tfvars_ will not delete them from OCI Console by default. Inorder to destroy them from OCI either - |
| 44 | +<br> - Add an additional column - _enable\_delete_ to Compartments Tab of CD3 Excel sheet with the value _TRUE_ for the compartments that needs to be deleted on terraform destroy. Execute the toolkit menu option to Create Compartments.</li> |
| 45 | + <br>(OR) |
| 46 | +<br> - Add _enable\_delete = true_ parameter to each of the compartment that needs to be deleted in _<customer\_name>\_compartments.auto.tfvars_ |
| 47 | + |
| 48 | + |
| 49 | +**7. I am getting Timeout Error during export of DRG Route Rules while exporting Network Components.** |
| 50 | +<br> |
| 51 | + |
| 52 | +Toolkit exports all Dynamic as well as Static DRG route Rules and timesout if there is a large number of dynamic rules. As a workaround, edit line no 220 in file _/cd3user/oci\_tools/cd3\_automation\_toolkit\Network\BaseNetwork\exportRoutetable.py_. <br> |
| 53 | +Change _vcn = VirtualNetworkClient(config, timeout=(30,120))_ to _vcn = VirtualNetworkClient(config, timeout=(90,300))_ |
| 54 | + |
| 55 | +**8. I am getting 'Permission Denied' error while executing any commands inside the container.** |
| 56 | +<br> |
| 57 | + |
| 58 | +When you are running the docker container from a Linux OS, if the outdir is on the root, you may get a permission denied error while executing steps like createAPIKey.py. In such scenarios, please follow the steps given below - |
| 59 | +<br><br>**Error Screenshot:** |
| 60 | + |
| 61 | + |
| 62 | +<br><br>**Solution:** |
| 63 | + |
| 64 | +<br>Please change: |
| 65 | +<br> - selinux mode from Enforcing to Permissive |
| 66 | +<br> - change the owner of folders in /cd3user/tenancies to that of cd3user. |
| 67 | +Please refer the screenshots below - |
| 68 | + |
| 69 | +<br> - Alternately, please attach a data disk and map the container (/cd3user/tenancies) on a folder that is created on the data disk (your local folder). |
| 70 | + |
| 71 | + |
| 72 | +**9. Ordering changes observed during terraform plan for OCI compute plugin's.** |
| 73 | + |
| 74 | + |
| 75 | +It only changes the order of plugin's and won't change anything in OCI console. |
| 76 | +<br> |
0 commit comments