Preparing to Use Oracle Exadata Cloud Infrastructure Migration Utility

Download the p37344128_240000_Linux-x86-64.zip file for the platform Linux-x86-64 from the My Oracle Support portal.

Note:

As a best practice, always download the latest version of the patch.
Copy the patch file to the client machine.
Log in to the client machine as the opc user.

Note:

For example, in this procedure, the username opc is used as the example user in subsequent steps.

Unzip the utility patch:
```
/home/opc> unzip p37344128_240000_Linux-x86-64.zip
```
After the utility is unzipped, the following files are created:
```
/home/opc> ls -lrth
-rwxr-xr-x opc opc 154M Mar 12 18:13 exacloudmigration
-rwwr-xr-x opc opc 13K Mar 12 18:28 README.txt
-rwwr-xr-x opc opc 37M Mar 12 21:21 ecmasshutility
```

On the client machine, if the resource access requires a proxy, set the following parameters. Otherwise, skip this step.

For proxy without user authentication, set:

/home/opc> export ECMA_PROXY_HOST=<Proxy host IP address>

/home/opc> export ECMA_PROXY_PORT=<Proxy port>

For example:

/home/opc> export ECMA_PROXY_HOST=a.b.c.d

/home/opc> export ECMA_PROXY_PORT=80

For proxy with user authentication, additionally set:

/home/opc> ECMA_PROXY_USER=<Proxy user name>

/home/opc> ECMA_PROXY_PASSWORD=<Proxy user password>

For example:

/home/opc> ECMA_PROXY_USER=proxyuser

/home/opc> ECMA_PROXY_PASSWORD=******

On the client machine, to use the Instance Principal authentication method, set the following environment variable. Otherwise, skip this step:
```
/home/opc> export OCI_ECMA_AUTH=instance_principal
```
Ensure that the prerequisites described in Section b. Instance Principal Authentication, under Prerequisites for Using Oracle Exadata Cloud Infrastructure Migration Utility are met.
On the client machine, to use the Resource Principal authentication method, set the following environment variable. Otherwise, skip this step:
```
/home/opc> export OCI_ECMA_AUTH=resource_principal
```
Ensure that the prerequisites described in Section b, Prerequisites for Resource Principal Authentication, under Prerequisites for Using Oracle Exadata Cloud Infrastructure Migration Utility are met.
On the client machine, to use a custom location for the OCI configuration file, set the following environment variable. Otherwise, skip this step:
```
/home/opc> export OCI_CONFIG_FILE=<custom_path>/config
```
For example, if the custom path is /home/opc/ecma, set:
```
/home/opc> export OCI_CONFIG_FILE=/home/opc/ecma/config
```
On the client machine, to use a custom (non-default) OCI profile name, set the following environment variable. Otherwise, skip this step:
```
/home/opc> export OCI_CONFIG_PROFILE=<custom_profile_name>
```
For example, if the custom (non-default) profile name is CUSTPROFILE, set:
```
/home/opc> export OCI_CONFIG_PROFILE=CUSTPROFILE
```
Note:

When this parameter is set, the utility ignores any profile specified in the inputs file.
Collect the following information to use as input when running the utility in the next steps:
1. Log in to the Oracle Cloud Console.
2. Obtain the source Exadata Infrastructure OCID to be used for migration or for creating the Exadata Infrastructure and Exadata VM clusters.
  In the Console, go to:
  - ExaDB-D:
    Dashboard → Navigation Menu → Oracle AI Database → Exadata Database Service on Dedicated Infrastructure → Exadata Infrastructure → Infrastructure name → Exadata Infrastructure Information → Copy OCID
  - ExaDB-C@C:
    Dashboard → Navigation Menu → Oracle AI Database → Exadata Database Service on Cloud@Customer → Exadata Infrastructure → Infrastructure name → Exadata Infrastructure Information → Copy OCID
3. Obtain the source VM Cluster OCID for migrating databases.
  In the Console, go to:
  - ExaDB-D:
    Dashboard → Navigation Menu → Oracle AI Database → Exadata Database Service on Dedicated Infrastructure → Exadata VM Clusters → Cluster name → VM Cluster Information → Copy OCID
  - ExaDB-C@C:
    Dashboard → Navigation Menu → Oracle AI Database → Exadata Database Service on Cloud@Customer → Exadata VM Clusters → Cluster name → VM Cluster Information → Copy OCID

Parent topic: Introduction, Prerequisites, and Preparation for Using Oracle Exadata Cloud Infrastructure Migration Utility