So far in this series we have looked at creating asset within the
EMOC BUI but the Exalogic 2.0.1 installation also provide the Iaas
cli as an alternative to most of the common functionality
available within EMOC. The IaaS cli interface provides access to
the functions that are available to a user logged into the BUI
with the CloudUser Role.
As such not all functionality is available from the
command line
interface however having said that the IaaS cli provides all the
functionality required to create the Assets within a specific
Account (Tenure). Because these action are common and repeatable I
decided to wrap the functionality within a simple script that
takes a simple input file and creates the Asset.
Following the Script through will show us the required steps
needed to create the various Assets within an Account and hence I
will work through the various functions within the script below
describing the steps.
You will note from the various steps within the script that it is
designed to pause between actions allowing the proceeding action
to complete. The reason for this is because we could swamp EMOC
with a series of actions and may end up with a situation where we
are trying to action a Volume attached before the creation of the
vServer and Volume have completed.
processAssets()
This function simply reads through the passed input file
identifying what assets need to be created. An example of the
input file can be found below. It can be seen that the input file
can be used to create Assets in multiple Accounts during a single
run. The order of the entries define the functions that need to be
actioned as follows:
Input
Command
Iaas Actions
Parameters
Production:Connect
akm-describe-accounts
akm-create-access-key
iaas-create-key-pair
iaas-describe-vnets
iaas-describe-vserver-types
iaas-describe-server-templates
Username
Password
Production:Create|vServer
iaas-run-vserver
vServer Name
vServer Type Name
Template Name
Comma separated list of network names which the
vServer will connect to.
Comma separated list of IPs for the specified
networks.
Production:Create|Volume
iaas-create-volume
Volume Name
Volume Size
Production:Attach|Volume
iaas-attach-volumes-to-vserver
vServer Name
Comma separated list of volume names
Production:Disconnect
iaas-delete-key-pair
akm-delete-access-key
None
connectToAccount()
It can be seen from the connectToAccount function that before we
can execute any Asset creation we must first connect to the
appropriate account. To do this we will need the ID associated
with the Account. This can be found by executing the
akm-describe-accounts cli
command which will return a list of all
Accounts and there IDs. Once we have the Account ID we generate
and Access key using the akm-create-access-key
command and then a
keypair with the iaas-create-key-pair
command.
At this point we now have all the information we need to access
the specific named account.
createVServer()
This function simply retrieved the information from the input
line and then will create the vServer using the iaas-run-vserver
cli
command. Reading the function you will notice that it takes
the various input names for vServer Type, Template and Networks
and converts them into the appropriate IDs. The IaaS cli will not
work directly with component names and hence all IDs need to be
found.
createVolume()
Function that simply takes the Volume name and Size then executes
the iaas-create-volume
command to create the volume.
attachVolume()
Takes the name of the Volume, which we may have just created, and
a Volume then identifies the appropriate IDs before assigning the
Volume to the vServer with the iaas-attach-volumes-to-vserver.
disconnectFromAccount()
Once we have finished connecting to the Account we simply remove
the key pair with iaas-delete-key-pair and the access key with
akm-delete-access-key although it may be useful to keep this if
ssh is required and you do not subsequently modify the sshd
information to allow unsecured access. By default the key is
required for ssh access when a vServer is created from the
command-line.
CreateAssets.sh
1 export OCCLI=/opt/sun/occli/bin
2 export IAAS_HOME=/opt/oracle/iaas/cli
3 export JAVA_HOME=/usr/java/latest
4 export IAAS_BASE_URL=https://127.0.0.1
5 export IAAS_ACCESS_KEY_FILE=iaas_access.key
6 export KEY_FILE=iaas_access.pub
7 #CloudUser used to create vServers & Volumes
8 export IAAS_USER=exaprod
9 export IAAS_PASSWORD_FILE=root.pwd
10 export KEY_NAME=cli.recreate
11 export INPUT_FILE=CreateAssets.in
12
13 export ACCOUNTS_FILE=accounts.out
14 export VOLUMES_FILE=volumes.out
15 export DISTGRPS_FILE=distgrp.out
16 export VNETS_FILE=vnets.out
17 export VSERVER_TYPES_FILE=vstype.out
18 export VSERVER_FILE=vserver.out
19 export VSERVER_TEMPLATES=template.out
20 export KEY_PAIRS=keypairs.out
21
22 PROCESSING_ACCOUNT=""
23
24 function cleanTempFiles() {
25 rm -f $ACCOUNTS_FILE $VOLUMES_FILE $DISTGRPS_FILE $VNETS_FILE $VSERVER_TYPES_FILE $VSERVER_FILE $VSERVER_TEMPLATES $KEY_PAIRS $IAAS_PASSWORD_FILE $KEY_FILE $IAAS_ACCESS_KEY_FILE
26 }
27
28 function connectToAccount() {
29 if [[ "$ACCOUNT" != "$PROCESSING_ACCOUNT" ]]
30 then
31 if [[ "" != "$PROCESSING_ACCOUNT" ]]
32 then
33 $IAAS_HOME/bin/iaas-delete-key-pair --key-name $KEY_NAME --access-key-file $IAAS_ACCESS_KEY_FILE
34 $IAAS_HOME/bin/akm-delete-access-key $AK
35 fi
36 PROCESSING_ACCOUNT=$ACCOUNT
37 IAAS_USER=$ACCOUNT_USER
38 echo "$ACCOUNT_PASSWORD" > $IAAS_PASSWORD_FILE
39 $IAAS_HOME/bin/akm-describe-accounts --sep "|" > $ACCOUNTS_FILE
40 while read
line
41 do
42 ACCOUNT_ID=${line%%|*}
43 line=${line#*|}
44 ACCOUNT_NAME=${line%%|*}
45 # echo "Id = $ACCOUNT_ID"
46 # echo "Name = $ACCOUNT_NAME"
47 if [[ "$ACCOUNT_NAME" == "$ACCOUNT" ]]
48 then
49 echo "Found Production Account $line"
50 AK=`$IAAS_HOME/bin/akm-create-access-key --account $ACCOUNT_ID --access-key-file $IAAS_ACCESS_KEY_FILE`
51 KEYPAIR=`$IAAS_HOME/bin/iaas-create-key-pair --key-name $KEY_NAME --key-file $KEY_FILE`
52 echo "Connected to $ACCOUNT_NAME"
53 break
54 fi
55 done < $ACCOUNTS_FILE
56 fi
57 }
58
59 function disconnectFromAccount() {
60 $IAAS_HOME/bin/iaas-delete-key-pair --key-name $KEY_NAME --access-key-file $IAAS_ACCESS_KEY_FILE
61 $IAAS_HOME/bin/akm-delete-access-key $AK
62 PROCESSING_ACCOUNT=""
63 }
64
65 function getNetworks() {
66 $IAAS_HOME/bin/iaas-describe-vnets --sep "|" > $VNETS_FILE
67 }
68
69 function getVSTypes() {
70 $IAAS_HOME/bin/iaas-describe-vserver-types --sep "|" > $VSERVER_TYPES_FILE
71 }
72
73 function getTemplates() {
74 $IAAS_HOME/bin/iaas-describe-server-templates --sep "|" > $VSERVER_TEMPLATES
75 }
76
77 function getVolumes() {
78 $IAAS_HOME/bin/iaas-describe-volumes --sep "|" > $VOLUMES_FILE
79 }
80
81 function getVServers() {
82 $IAAS_HOME/bin/iaas-describe-vservers --sep "|" > $VSERVER_FILE
83 }
84
85 function getNetworkId() {
86 while read
line
87 do
88 NETWORK_ID=${line%%|*}
89 line=${line#*|}
90 NAME=${line%%|*}
91 if [[ "$NAME" == "$NETWORK_NAME" ]]
92 then
93 break
94 fi
95 done < $VNETS_FILE
96 }
97
98 function getVSTypeId() {
99 while read
line
100 do
101 VSTYPE_ID=${line%%|*}
102 line=${line#*|}
103 NAME=${line%%|*}
104 if [[ "$VSTYPE_NAME" == "$NAME" ]]
105 then
106 break
107 fi
108 done < $VSERVER_TYPES_FILE
109 }
110
111 function getTemplateId() {
112 while read
line
113 do
114 TEMPLATE_ID=${line%%|*}
115 line=${line#*|}
116 NAME=${line%%|*}
117 if [[ "$TEMPLATE_NAME" == "$NAME" ]]
118 then
119 break
120 fi
121 done < $VSERVER_TEMPLATES
122 }
123
124 function getVolumeId() {
125 while read
line
126 do
127 export VOLUME_ID=${line%%|*}
128 line=${line#*|}
129 NAME=${line%%|*}
130 if [[ "$NAME" == "$VOLUME_NAME" ]]
131 then
132 break;
133 fi
134 done < $VOLUMES_FILE
135 }
136
137 function getVServerId() {
138 while read
line
139 do
140 VSERVER_ID=${line%%|*}
141 line=${line#*|}
142 NAME=${line%%|*}
143 if [[ "$VSERVER_NAME" == "$NAME" ]]
144 then
145 break;
146 fi
147 done < $VSERVER_FILE
148 }
149
150 function getVServerState() {
151 getVServers
152 while read
line
153 do
154 VSERVER_ID=${line%%|*}
155 line=${line#*|}
156 NAME=${line%%|*}
157 line=${line#*|}
158 line=${line#*|}
159 VSERVER_STATE=${line%%|*}
160 if [[ "$VSERVER_NAME" == "$NAME" ]]
161 then
162 break;
163 fi
164 done < $VSERVER_FILE
165 }
166
167 function pauseUntilVServerRunning() {
168 # Wait until the Server is running before creating the next
169 getVServerState
170 while [[ "$VSERVER_STATE" != "RUNNING" ]]
171 do
172 getVServerState
173 echo "$NAME $VSERVER_STATE"
174 if [[ "$VSERVER_STATE" != "RUNNING" ]]
175 then
176 echo "Sleeping......."
177 sleep 60
178 fi
179 if [[ "$VSERVER_STATE" == "FAILED" ]]
180 then
181 echo "Will Delete $NAME in 5 Minutes....."
182 sleep 300
183 deleteVServer
184 echo "Deleted $NAME waiting 5 Minutes....."
185 sleep 300
186 break
187 fi
188 done
189 # Lets pause for a minute or two
190 echo "Just Chilling......"
191 sleep 60
192 echo "Ahhhhh we're getting there......."
193 sleep 60
194 echo "I'm almost at one with the universe......."
195 sleep 60
196 echo "Bong Reality Check !"
197 }
198
199 function deleteVServer() {
200 $IAAS_HOME/bin/iaas-terminate-vservers --force --vserver-ids $VSERVER_ID
201 }
202
203 function createVServer() {
204 VSERVER_NAME=${ASSET_DETAILS%%|*}
205 ASSET_DETAILS=${ASSET_DETAILS#*|}
206 VSTYPE_NAME=${ASSET_DETAILS%%|*}
207 ASSET_DETAILS=${ASSET_DETAILS#*|}
208 TEMPLATE_NAME=${ASSET_DETAILS%%|*}
209 ASSET_DETAILS=${ASSET_DETAILS#*|}
210 NETWORK_NAMES=${ASSET_DETAILS%%|*}
211 ASSET_DETAILS=${ASSET_DETAILS#*|}
212 IP_ADDRESSES=${ASSET_DETAILS%%|*}
213 # Get Ids associated with names
214 getVSTypeId
215 getTemplateId
216 # Convert Network Names to Ids
217 NETWORK_IDS=""
218 while true
219 do
220 NETWORK_NAME=${NETWORK_NAMES%%,*}
221 NETWORK_NAMES=${NETWORK_NAMES#*,}
222 getNetworkId
223 if [[ "$NETWORK_IDS" != "" ]]
224 then
225 NETWORK_IDS="$NETWORK_IDS,$NETWORK_ID"
226 else
227 NETWORK_IDS=$NETWORK_ID
228 fi
229 if [[ "$NETWORK_NAME" == "$NETWORK_NAMES" ]]
230 then
231 break
232 fi
233 done
234 # Create vServer
235 echo "About to execute : $IAAS_HOME/bin/iaas-run-vserver --name $VSERVER_NAME --key-name $KEY_NAME --vserver-type $VSTYPE_ID --server-template-id $TEMPLATE_ID --vnets $NETWORK_IDS --ip-addresses $IP_ADDRESSES"
236 $IAAS_HOME/bin/iaas-run-vserver --name $VSERVER_NAME --key-name $KEY_NAME --vserver-type $VSTYPE_ID --server-template-id $TEMPLATE_ID --vnets $NETWORK_IDS --ip-addresses $IP_ADDRESSES
237 pauseUntilVServerRunning
238 }
239
240 function createVolume() {
241 VOLUME_NAME=${ASSET_DETAILS%%|*}
242 ASSET_DETAILS=${ASSET_DETAILS#*|}
243 VOLUME_SIZE=${ASSET_DETAILS%%|*}
244 # Create Volume
245 echo "About to execute : $IAAS_HOME/bin/iaas-create-volume --name $VOLUME_NAME --size $VOLUME_SIZE"
246 $IAAS_HOME/bin/iaas-create-volume --name $VOLUME_NAME --size $VOLUME_SIZE
247 # Lets pause
248 echo "Just Waiting 30 Seconds......"
249 sleep 30
250 }
251
252 function attachVolume() {
253 VSERVER_NAME=${ASSET_DETAILS%%|*}
254 ASSET_DETAILS=${ASSET_DETAILS#*|}
255 VOLUME_NAMES=${ASSET_DETAILS%%|*}
256 # Get vServer Id
257 getVServerId
258 # Convert Volume Names to Ids
259 VOLUME_IDS=""
260 while true
261 do
262 VOLUME_NAME=${VOLUME_NAMES%%,*}
263 VOLUME_NAMES=${VOLUME_NAMES#*,}
264 getVolumeId
265 if [[ "$VOLUME_IDS" != "" ]]
266 then
267 VOLUME_IDS="$VOLUME_IDS,$VOLUME_ID"
268 else
269 VOLUME_IDS=$VOLUME_ID
270 fi
271 if [[ "$VOLUME_NAME" == "$VOLUME_NAMES" ]]
272 then
273 break
274 fi
275 done
276 # Attach Volumes
277 echo "About to execute : $IAAS_HOME/bin/iaas-attach-volumes-to-vserver --vserver-id $VSERVER_ID --volume-ids $VOLUME_IDS"
278 $IAAS_HOME/bin/iaas-attach-volumes-to-vserver --vserver-id $VSERVER_ID --volume-ids $VOLUME_IDS
279 # Lets pause
280 echo "Just Waiting 30 Seconds......"
281 sleep 30
282 }
283
284 function processAssets() {
285 while read
line
286 do
287 ACCOUNT=${line%%:*}
288 line=${line#*:}
289 ACTION=${line%%|*}
290 line=${line#*|}
291 if [[ "$ACTION" == "Connect" ]]
292 then
293 ACCOUNT_USER=${line%%|*}
294 line=${line#*|}
295 ACCOUNT_PASSWORD=${line%%|*}
296 connectToAccount
297
298 ## Account Info
299 getNetworks
300 getVSTypes
301 getTemplates
302
303 continue
304 fi
305 if [[ "$ACTION" == "Create" ]]
306 then
307 ASSET=${line%%|*}
308 line=${line#*|}
309 ASSET_DETAILS=$line
310 if [[ "$ASSET" == "vServer" ]]
311 then
312 createVServer
313
314 continue
315 fi
316 if [[ "$ASSET" == "Volume" ]]
317 then
318 createVolume
319
320 continue
321 fi
322 fi
323 if [[ "$ACTION" == "Attach" ]]
324 then
325 ASSET=${line%%|*}
326 line=${line#*|}
327 ASSET_DETAILS=$line
328 if [[ "$ASSET" == "Volume" ]]
329 then
330 getVolumes
331 getVServers
332 attachVolume
333
334 continue
335 fi
336 fi
337 if [[ "$ACTION" == "Connect" ]]
338 then
339 disconnectFromAccount
340
341 continue
342 fi
343 done < $INPUT_FILE
344 }
345
346 # Should Parameterise this
347
348 while [ $# -gt 0 ]
349 do
350 case "$1" in
351 -a) INPUT_FILE="$2"; shift;;
352 *) echo ""; echo >&2 \
353 "usage: $0 [-a <Asset Definition File>] (Default is CreateAssets.in)"
354 echo""; exit 1;;
355 *) break;;
356 esac
357 shift
358 done
359
360
361
362
363 processAssets
364
365 echo "**************************************"
366 echo "***** Finished Creating Assets *****"
367 echo "**************************************"
368
CreateAssetsProd.in
Production:Connect|exaprod|welcome1
Production:Create|vServer|VS006|VSTProduction|BaseOEL56ServerTemplate|EoIB-otd-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.223.13,192.168.0.13,10.117.81.67,172.17.0.14
Production:Create|vServer|VS007|VSTProduction|BaseOEL56ServerTemplate|EoIB-otd-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.223.14,192.168.0.14,10.117.81.68,172.17.0.15
Production:Create|vServer|VS008|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.61,192.168.0.61,10.117.81.61,172.17.0.16
Production:Create|vServer|VS009|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.62,192.168.0.62,10.117.81.62,172.17.0.17
Production:Create|vServer|VS000|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.63,192.168.0.63,10.117.81.63,172.17.0.18
Production:Create|vServer|VS001|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.64,192.168.0.64,10.117.81.64,172.17.0.19
Production:Create|vServer|VS002|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.65,192.168.0.65,10.117.81.65,172.17.0.20
Production:Create|vServer|VS003|VSTProduction|BaseOEL56ServerTemplate|EoIB-wls-prod,vn-prod-web,IPoIB-default,IPoIB-vserver-shared-storage|10.51.225.66,192.168.0.66,10.117.81.66,172.17.0.21
Production:Create|Volume|VS006|50
Production:Create|Volume|VS007|50
Production:Create|Volume|VS008|50
Production:Create|Volume|VS009|50
Production:Create|Volume|VS000|50
Production:Create|Volume|VS001|50
Production:Create|Volume|VS002|50
Production:Create|Volume|VS003|50
Production:Attach|Volume|VS006|VS006
Production:Attach|Volume|VS007|VS007
Production:Attach|Volume|VS008|VS008
Production:Attach|Volume|VS009|VS009
Production:Attach|Volume|VS000|VS000
Production:Attach|Volume|VS001|VS001
Production:Attach|Volume|VS002|VS002
Production:Attach|Volume|VS003|VS003
Production:Disconnect
Development:Connect|exadev|welcome1
Development:Create|vServer|VS014|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.24,10.117.81.71,172.17.0.24
Development:Create|vServer|VS015|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.25,10.117.81.72,172.17.0.25
Development:Create|vServer|VS016|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.26,10.117.81.73,172.17.0.26
Development:Create|vServer|VS017|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.27,10.117.81.74,172.17.0.27
Development:Create|vServer|VS018|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.28,10.117.81.75,172.17.0.28
Development:Create|vServer|VS019|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.29,10.117.81.76,172.17.0.29
Development:Create|vServer|VS020|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.30,10.117.81.77,172.17.0.30
Development:Create|vServer|VS021|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.31,10.117.81.78,172.17.0.31
Development:Create|vServer|VS022|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.32,10.117.81.79,172.17.0.32
Development:Create|vServer|VS023|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.33,10.117.81.80,172.17.0.33
Development:Create|vServer|VS024|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.34,10.117.81.81,172.17.0.34
Development:Create|vServer|VS025|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.35,10.117.81.82,172.17.0.35
Development:Create|vServer|VS026|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.36,10.117.81.83,172.17.0.36
Development:Create|vServer|VS027|VSTDevelopment|BaseOEL56ServerTemplate|EoIB-development,IPoIB-default,IPoIB-vserver-shared-storage|10.51.224.37,10.117.81.84,172.17.0.37
Development:Create|Volume|VS014|50
Development:Create|Volume|VS015|50
Development:Create|Volume|VS016|50
Development:Create|Volume|VS017|50
Development:Create|Volume|VS018|50
Development:Create|Volume|VS019|50
Development:Create|Volume|VS020|50
Development:Create|Volume|VS021|50
Development:Create|Volume|VS022|50
Development:Create|Volume|VS023|50
Development:Create|Volume|VS024|50
Development:Create|Volume|VS025|50
Development:Create|Volume|VS026|50
Development:Create|Volume|VS027|50
Development:Attach|Volume|VS014|VS014
Development:Attach|Volume|VS015|VS015
Development:Attach|Volume|VS016|VS016
Development:Attach|Volume|VS017|VS017
Development:Attach|Volume|VS018|VS018
Development:Attach|Volume|VS019|VS019
Development:Attach|Volume|VS020|VS020
Development:Attach|Volume|VS021|VS021
Development:Attach|Volume|VS022|VS022
Development:Attach|Volume|VS023|VS023
Development:Attach|Volume|VS024|VS024
Development:Attach|Volume|VS025|VS025
Development:Attach|Volume|VS026|VS026
Development:Attach|Volume|VS027|VS027
Development:Disconnect
This entry was originally posted on the The Old Toxophilist Site.
