summaryrefslogtreecommitdiff
path: root/doc/manual/en_US/dita/topics/cloud-using-cloud-profile-manager.dita
blob: 270678ebafd15fef42b6eddde9ec631b3f669eb5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="cloud-using-cloud-profile-manager">
  <title>Using the Cloud Profile Manager</title>
  
  <body>
    <p>
        This section describes how to use the Cloud Profile Manager to
        create a cloud profile.
      </p>
    <p>
        To open the Cloud Profile Manager click
        <b outputclass="bold">File</b>,
        <b outputclass="bold">Cloud Profile Manager</b> in
        VirtualBox Manager.
      </p>
    <fig id="fig-cloud-profile-manager">
      <title>The Cloud Profile Manager</title>
      <image href="images/cloud-profile-manager.png" width="12cm" placement="break"/>
    </fig>
    <p>
        You can use the Cloud Profile Manager in the following ways:
      </p>
    <ul>
      <li>
        <p>
            To create a new cloud profile automatically
          </p>
      </li>
      <li>
        <p>
            To create a cloud profile by importing settings from your
            Oracle Cloud Infrastructure configuration file.
          </p>
      </li>
    </ul>
    <p>
        Perform the following steps to create a new cloud profile
        automatically, using the Cloud Profile Manager:
      </p>
    <ol>
      <li>
        <p>
            Click the <b outputclass="bold">Add</b> icon and
            specify a <b outputclass="bold">Name</b> for the
            profile.
          </p>
      </li>
      <li>
        <p>
            Click <b outputclass="bold">Properties</b> and
            specify the following property values for the profile:
          </p>
        <ul>
          <li>
            <p>
                Compartment OCID
              </p>
          </li>
          <li>
            <p>
                Fingerprint of the public key
              </p>
          </li>
          <li>
            <p>
                Location of the private key on the client device
              </p>
          </li>
          <li>
            <p>
                Region OCID
              </p>
          </li>
          <li>
            <p>
                Tenancy OCID
              </p>
          </li>
          <li>
            <p>
                User OCID
              </p>
          </li>
        </ul>
        <p>
            Some of these are settings for your Oracle Cloud Infrastructure account, which you
            can view from the Oracle Cloud Infrastructure Console.
          </p>
      </li>
      <li>
        <p>
            (Optional) If you are using the cloud profile to connect to
            cloud virtual machines, select the
            <b outputclass="bold">Show VMs</b> check box.
          </p>
        <p>
            This creates a new subgroup of the
            <b outputclass="bold">OCI</b> group in VirtualBox Manager.
            See <xref href="cloud-vm-oci-group.dita#cloud-vm-oci-group"/>.
          </p>
      </li>
      <li>
        <p>
            Click <b outputclass="bold">Apply</b> to save your
            changes.
          </p>
        <p>
            The cloud profile settings are saved to the
            <filepath>oci_config</filepath> file in your Oracle VM VirtualBox
            global settings directory.
          </p>
      </li>
    </ol>
    <p>
        Perform the following steps to import an existing Oracle Cloud Infrastructure
        configuration file into the Cloud Profile Manager:
      </p>
    <ol>
      <li>
        <p>
            Ensure that a <filepath>config</filepath> file is present in
            your Oracle Cloud Infrastructure configuration directory. For example, this is
            <filepath>$HOME/.oci/config</filepath> on a Linux host.
          </p>
      </li>
      <li>
        <p>
            Click the <b outputclass="bold">Import</b> icon to
            open a dialog that prompts you to import cloud profiles from
            external files.
          </p>
        <note type="attention">
          <p>
              This action overwrites any cloud profiles that are in your
              Oracle VM VirtualBox global settings directory.
            </p>
        </note>
      </li>
      <li>
        <p>
            Click <b outputclass="bold">Import</b>.
          </p>
        <p>
            Your cloud profile settings are saved to the
            <filepath>oci_config</filepath> file in your Oracle VM VirtualBox
            global settings directory.
          </p>
      </li>
      <li>
        <p>
            Click <b outputclass="bold">Properties</b> to show
            the cloud profile settings.
          </p>
        <p>
            Double-click on the appropriate field to change the value.
          </p>
      </li>
      <li>
        <p>
            Click <b outputclass="bold">Apply</b> to save your
            changes.
          </p>
      </li>
    </ol>
  </body>
  
</topic>