blob: 49ed194bedf4af0ff0d3c219aed7bca4fda2a765 (plain)

ofs	hex dump	ascii
0000	de 12 04 95 00 00 00 00 e1 00 00 00 1c 00 00 00 24 07 00 00 33 01 00 00 2c 0e 00 00 00 00 00 00	................$...3...,.......
0020	f8 12 00 00 69 00 00 00 f9 12 00 00 25 00 00 00 63 13 00 00 6a 00 00 00 89 13 00 00 54 00 00 00	....i.......%...c...j.......T...
0040	f4 13 00 00 5d 00 00 00 49 14 00 00 26 00 00 00 a7 14 00 00 0c 00 00 00 ce 14 00 00 0a 00 00 00	....]...I...&...................
0060	db 14 00 00 09 00 00 00 e6 14 00 00 06 00 00 00 f0 14 00 00 09 00 00 00 f7 14 00 00 07 00 00 00	................................
0080	01 15 00 00 06 00 00 00 09 15 00 00 09 00 00 00 10 15 00 00 05 00 00 00 1a 15 00 00 c2 00 00 00	................................
00a0	20 15 00 00 f2 00 00 00 e3 15 00 00 6d 00 00 00 d6 16 00 00 3d 00 00 00 44 17 00 00 0d 00 00 00	............m.......=...D.......
00c0	82 17 00 00 11 00 00 00 90 17 00 00 64 00 00 00 a2 17 00 00 44 00 00 00 07 18 00 00 19 00 00 00	............d.......D...........
00e0	4c 18 00 00 07 00 00 00 66 18 00 00 8f 00 00 00 6e 18 00 00 41 00 00 00 fe 18 00 00 0e 00 00 00	L.......f.......n...A...........
0100	40 19 00 00 82 00 00 00 4f 19 00 00 64 00 00 00 d2 19 00 00 22 00 00 00 37 1a 00 00 21 00 00 00	@.......O...d......."...7...!...
0120	5a 1a 00 00 33 00 00 00 7c 1a 00 00 19 01 00 00 b0 1a 00 00 14 00 00 00 ca 1b 00 00 22 00 00 00	Z...3...|..................."...
0140	df 1b 00 00 15 00 00 00 02 1c 00 00 21 00 00 00 18 1c 00 00 11 00 00 00 3a 1c 00 00 23 00 00 00	............!...........:...#...
0160	4c 1c 00 00 16 00 00 00 70 1c 00 00 0e 00 00 00 87 1c 00 00 0d 00 00 00 96 1c 00 00 98 00 00 00	L.......p.......................
0180	a4 1c 00 00 1d 00 00 00 3d 1d 00 00 19 00 00 00 5b 1d 00 00 14 00 00 00 75 1d 00 00 19 00 00 00	........=.......[.......u.......
01a0	8a 1d 00 00 13 00 00 00 a4 1d 00 00 1b 00 00 00 b8 1d 00 00 2a 00 00 00 d4 1d 00 00 18 00 00 00	....................*...........
01c0	ff 1d 00 00 1f 00 00 00 18 1e 00 00 0f 00 00 00 38 1e 00 00 c7 00 00 00 48 1e 00 00 0f 00 00 00	................8.......H.......
01e0	10 1f 00 00 5c 00 00 00 20 1f 00 00 49 00 00 00 7d 1f 00 00 07 00 00 00 c7 1f 00 00 4f 00 00 00	....\.......I...}...........O...
0200	cf 1f 00 00 19 00 00 00 1f 20 00 00 13 00 00 00 39 20 00 00 08 00 00 00 4d 20 00 00 1f 00 00 00	................9.......M.......
0220	56 20 00 00 26 00 00 00 76 20 00 00 0d 00 00 00 9d 20 00 00 53 00 00 00 ab 20 00 00 3d 00 00 00	V...&...v...........S.......=...
0240	ff 20 00 00 3a 00 00 00 3d 21 00 00 9d 00 00 00 78 21 00 00 37 00 00 00 16 22 00 00 2d 00 00 00	....:...=!......x!..7...."..-...
0260	4e 22 00 00 b3 00 00 00 7c 22 00 00 46 00 00 00 30 23 00 00 0f 00 00 00 77 23 00 00 13 00 00 00	N"......|"..F...0#......w#......
0280	87 23 00 00 0f 00 00 00 9b 23 00 00 19 00 00 00 ab 23 00 00 55 00 00 00 c5 23 00 00 a7 00 00 00	.#.......#.......#..U....#......
02a0	1b 24 00 00 3c 00 00 00 c3 24 00 00 4d 01 00 00 00 25 00 00 b3 00 00 00 4e 26 00 00 8d 00 00 00	.$..<....$..M....%......N&......
02c0	02 27 00 00 8f 00 00 00 90 27 00 00 31 00 00 00 20 28 00 00 42 00 00 00 52 28 00 00 2e 00 00 00	.'.......'..1....(..B...R(......
02e0	95 28 00 00 62 00 00 00 c4 28 00 00 a9 00 00 00 27 29 00 00 15 00 00 00 d1 29 00 00 1e 00 00 00	.(..b....(......').......)......
0300	e7 29 00 00 c7 00 00 00 06 2a 00 00 1e 00 00 00 ce 2a 00 00 0c 00 00 00 ed 2a 00 00 d7 00 00 00	.).......*.......*.......*......
0320	fa 2a 00 00 58 01 00 00 d2 2b 00 00 9b 00 00 00 2b 2d 00 00 30 00 00 00 c7 2d 00 00 06 00 00 00	.*..X....+......+-..0....-......
0340	f8 2d 00 00 07 00 00 00 ff 2d 00 00 0d 00 00 00 07 2e 00 00 b6 00 00 00 15 2e 00 00 40 00 00 00	.-.......-..................@...
0360	cc 2e 00 00 07 00 00 00 0d 2f 00 00 06 00 00 00 15 2f 00 00 fa 00 00 00 1c 2f 00 00 50 00 00 00	........./......./......./..P...
0380	17 30 00 00 34 00 00 00 68 30 00 00 a5 00 00 00 9d 30 00 00 12 00 00 00 43 31 00 00 81 00 00 00	.0..4...h0.......0......C1......
03a0	56 31 00 00 15 00 00 00 d8 31 00 00 07 00 00 00 ee 31 00 00 16 00 00 00 f6 31 00 00 06 00 00 00	V1.......1.......1.......1......
03c0	0d 32 00 00 0e 00 00 00 14 32 00 00 4a 00 00 00 23 32 00 00 12 00 00 00 6e 32 00 00 1d 00 00 00	.2.......2..J...#2......n2......
03e0	81 32 00 00 11 00 00 00 9f 32 00 00 18 00 00 00 b1 32 00 00 28 00 00 00 ca 32 00 00 1e 00 00 00	.2.......2.......2..(....2......
0400	f3 32 00 00 06 00 00 00 12 33 00 00 93 01 00 00 19 33 00 00 0a 00 00 00 ad 34 00 00 70 00 00 00	.2.......3.......3.......4..p...
0420	b8 34 00 00 0c 00 00 00 29 35 00 00 0b 00 00 00 36 35 00 00 15 00 00 00 42 35 00 00 1a 00 00 00	.4......)5......65......B5......
0440	58 35 00 00 18 00 00 00 73 35 00 00 1d 00 00 00 8c 35 00 00 04 00 00 00 aa 35 00 00 1a 00 00 00	X5......s5.......5.......5......
0460	af 35 00 00 27 00 00 00 ca 35 00 00 8c 00 00 00 f2 35 00 00 15 00 00 00 7f 36 00 00 c9 00 00 00	.5..'....5.......5.......6......
0480	95 36 00 00 0b 00 00 00 5f 37 00 00 62 00 00 00 6b 37 00 00 81 00 00 00 ce 37 00 00 17 00 00 00	.6......_7..b...k7.......7......
04a0	50 38 00 00 12 00 00 00 68 38 00 00 19 00 00 00 7b 38 00 00 18 01 00 00 95 38 00 00 7d 00 00 00	P8......h8......{8.......8..}...
04c0	ae 39 00 00 80 00 00 00 2c 3a 00 00 45 00 00 00 ad 3a 00 00 35 00 00 00 f3 3a 00 00 2f 00 00 00	.9......,:..E....:..5....:../...
04e0	29 3b 00 00 d2 00 00 00 59 3b 00 00 84 00 00 00 2c 3c 00 00 48 00 00 00 b1 3c 00 00 21 00 00 00	);......Y;......,<..H....<..!...
0500	fa 3c 00 00 61 00 00 00 1c 3d 00 00 41 00 00 00 7e 3d 00 00 70 00 00 00 c0 3d 00 00 54 00 00 00	.<..a....=..A...~=..p....=..T...
0520	31 3e 00 00 bc 00 00 00 86 3e 00 00 85 00 00 00 43 3f 00 00 e7 00 00 00 c9 3f 00 00 2a 00 00 00	1>.......>......C?.......?..*...
0540	b1 40 00 00 3b 00 00 00 dc 40 00 00 93 00 00 00 18 41 00 00 1d 00 00 00 ac 41 00 00 37 00 00 00	.@..;....@.......A.......A..7...
0560	ca 41 00 00 8b 00 00 00 02 42 00 00 48 00 00 00 8e 42 00 00 90 00 00 00 d7 42 00 00 31 00 00 00	.A.......B..H....B.......B..1...
0580	68 43 00 00 7f 00 00 00 9a 43 00 00 47 00 00 00 1a 44 00 00 36 00 00 00 62 44 00 00 0f 00 00 00	hC.......C..G....D..6...bD......
05a0	99 44 00 00 95 00 00 00 a9 44 00 00 09 00 00 00 3f 45 00 00 ac 00 00 00 49 45 00 00 18 00 00 00	.D.......D......?E......IE......
05c0	f6 45 00 00 0c 00 00 00 0f 46 00 00 2a 00 00 00 1c 46 00 00 39 00 00 00 47 46 00 00 25 00 00 00	.E.......F..*....F..9...GF..%...
05e0	81 46 00 00 08 00 00 00 a7 46 00 00 0f 00 00 00 b0 46 00 00 18 00 00 00 c0 46 00 00 0f 00 00 00	.F.......F.......F.......F......
0600	d9 46 00 00 3a 00 00 00 e9 46 00 00 48 00 00 00 24 47 00 00 2b 00 00 00 6d 47 00 00 64 00 00 00	.F..:....F..H...$G..+...mG..d...
0620	99 47 00 00 5c 00 00 00 fe 47 00 00 64 00 00 00 5b 48 00 00 32 00 00 00 c0 48 00 00 5b 00 00 00	.G..\....G..d...[H..2....H..[...
0640	f3 48 00 00 ed 01 00 00 4f 49 00 00 31 00 00 00 3d 4b 00 00 0e 01 00 00 6f 4b 00 00 0c 00 00 00	.H......OI..1...=K......oK......
0660	7e 4c 00 00 48 00 00 00 8b 4c 00 00 4d 00 00 00 d4 4c 00 00 4e 00 00 00 22 4d 00 00 21 00 00 00	~L..H....L..M....L..N..."M..!...
0680	71 4d 00 00 59 00 00 00 93 4d 00 00 1b 00 00 00 ed 4d 00 00 75 00 00 00 09 4e 00 00 18 00 00 00	qM..Y....M.......M..u....N......
06a0	7f 4e 00 00 b5 00 00 00 98 4e 00 00 44 00 00 00 4e 4f 00 00 15 01 00 00 93 4f 00 00 0c 00 00 00	.N.......N..D...NO.......O......
06c0	a9 50 00 00 0b 00 00 00 b6 50 00 00 18 00 00 00 c2 50 00 00 d3 00 00 00 db 50 00 00 0c 00 00 00	.P.......P.......P.......P......
06e0	af 51 00 00 39 00 00 00 bc 51 00 00 05 00 00 00 f6 51 00 00 3c 00 00 00 fc 51 00 00 56 00 00 00	.Q..9....Q.......Q..<....Q..V...
0700	39 52 00 00 08 00 00 00 90 52 00 00 45 00 00 00 99 52 00 00 0f 00 00 00 df 52 00 00 07 00 00 00	9R.......R..E....R.......R......
0720	ef 52 00 00 da 00 00 00 f7 52 00 00 69 00 00 00 d2 53 00 00 25 00 00 00 3c 54 00 00 6a 00 00 00	.R.......R..i....S..%...<T..j...
0740	62 54 00 00 54 00 00 00 cd 54 00 00 5d 00 00 00 22 55 00 00 26 00 00 00 80 55 00 00 0c 00 00 00	bT..T....T..]..."U..&....U......
0760	a7 55 00 00 0a 00 00 00 b4 55 00 00 09 00 00 00 bf 55 00 00 06 00 00 00 c9 55 00 00 09 00 00 00	.U.......U.......U.......U......
0780	d0 55 00 00 07 00 00 00 da 55 00 00 06 00 00 00 e2 55 00 00 09 00 00 00 e9 55 00 00 05 00 00 00	.U.......U.......U.......U......
07a0	f3 55 00 00 c2 00 00 00 f9 55 00 00 f2 00 00 00 bc 56 00 00 6d 00 00 00 af 57 00 00 3d 00 00 00	.U.......U.......V..m....W..=...
07c0	1d 58 00 00 0d 00 00 00 5b 58 00 00 11 00 00 00 69 58 00 00 64 00 00 00 7b 58 00 00 44 00 00 00	.X......[X......iX..d...{X..D...
07e0	e0 58 00 00 19 00 00 00 25 59 00 00 07 00 00 00 3f 59 00 00 8f 00 00 00 47 59 00 00 41 00 00 00	.X......%Y......?Y......GY..A...
0800	d7 59 00 00 0e 00 00 00 19 5a 00 00 82 00 00 00 28 5a 00 00 64 00 00 00 ab 5a 00 00 22 00 00 00	.Y.......Z......(Z..d....Z.."...
0820	10 5b 00 00 21 00 00 00 33 5b 00 00 33 00 00 00 55 5b 00 00 19 01 00 00 89 5b 00 00 14 00 00 00	.[..!...3[..3...U[.......[......
0840	a3 5c 00 00 22 00 00 00 b8 5c 00 00 15 00 00 00 db 5c 00 00 21 00 00 00 f1 5c 00 00 11 00 00 00	.\.."....\.......\..!....\......
0860	13 5d 00 00 23 00 00 00 25 5d 00 00 16 00 00 00 49 5d 00 00 0e 00 00 00 60 5d 00 00 0d 00 00 00	.]..#...%]......I]......`]......
0880	6f 5d 00 00 98 00 00 00 7d 5d 00 00 1d 00 00 00 16 5e 00 00 19 00 00 00 34 5e 00 00 14 00 00 00	o]......}].......^......4^......
08a0	4e 5e 00 00 19 00 00 00 63 5e 00 00 13 00 00 00 7d 5e 00 00 1b 00 00 00 91 5e 00 00 2a 00 00 00	N^......c^......}^.......^..*...
08c0	ad 5e 00 00 18 00 00 00 d8 5e 00 00 1f 00 00 00 f1 5e 00 00 0f 00 00 00 11 5f 00 00 c7 00 00 00	.^.......^.......^......._......
08e0	21 5f 00 00 0f 00 00 00 e9 5f 00 00 5c 00 00 00 f9 5f 00 00 49 00 00 00 56 60 00 00 07 00 00 00	!_......._..\...._..I...V`......
0900	a0 60 00 00 4f 00 00 00 a8 60 00 00 19 00 00 00 f8 60 00 00 13 00 00 00 12 61 00 00 08 00 00 00	.`..O....`.......`.......a......
0920	26 61 00 00 1f 00 00 00 2f 61 00 00 26 00 00 00 4f 61 00 00 0d 00 00 00 76 61 00 00 53 00 00 00	&a....../a..&...Oa......va..S...
0940	84 61 00 00 3d 00 00 00 d8 61 00 00 3a 00 00 00 16 62 00 00 9d 00 00 00 51 62 00 00 37 00 00 00	.a..=....a..:....b......Qb..7...
0960	ef 62 00 00 2d 00 00 00 27 63 00 00 b3 00 00 00 55 63 00 00 46 00 00 00 09 64 00 00 0f 00 00 00	.b..-...'c......Uc..F....d......
0980	50 64 00 00 13 00 00 00 60 64 00 00 0f 00 00 00 74 64 00 00 19 00 00 00 84 64 00 00 55 00 00 00	Pd......`d......td.......d..U...
09a0	9e 64 00 00 a7 00 00 00 f4 64 00 00 3c 00 00 00 9c 65 00 00 4d 01 00 00 d9 65 00 00 b3 00 00 00	.d.......d..<....e..M....e......
09c0	27 67 00 00 8d 00 00 00 db 67 00 00 8f 00 00 00 69 68 00 00 31 00 00 00 f9 68 00 00 42 00 00 00	'g.......g......ih..1....h..B...
09e0	2b 69 00 00 2e 00 00 00 6e 69 00 00 62 00 00 00 9d 69 00 00 a9 00 00 00 00 6a 00 00 15 00 00 00	+i......ni..b....i.......j......
0a00	aa 6a 00 00 1e 00 00 00 c0 6a 00 00 c7 00 00 00 df 6a 00 00 1e 00 00 00 a7 6b 00 00 0c 00 00 00	.j.......j.......j.......k......
0a20	c6 6b 00 00 d7 00 00 00 d3 6b 00 00 58 01 00 00 ab 6c 00 00 9b 00 00 00 04 6e 00 00 30 00 00 00	.k.......k..X....l.......n..0...
0a40	a0 6e 00 00 06 00 00 00 d1 6e 00 00 07 00 00 00 d8 6e 00 00 0d 00 00 00 e0 6e 00 00 b6 00 00 00	.n.......n.......n.......n......
0a60	ee 6e 00 00 40 00 00 00 a5 6f 00 00 07 00 00 00 e6 6f 00 00 06 00 00 00 ee 6f 00 00 fa 00 00 00	.n..@....o.......o.......o......
0a80	f5 6f 00 00 50 00 00 00 f0 70 00 00 34 00 00 00 41 71 00 00 a5 00 00 00 76 71 00 00 12 00 00 00	.o..P....p..4...Aq......vq......
0aa0	1c 72 00 00 81 00 00 00 2f 72 00 00 15 00 00 00 b1 72 00 00 07 00 00 00 c7 72 00 00 16 00 00 00	.r....../r.......r.......r......
0ac0	cf 72 00 00 06 00 00 00 e6 72 00 00 0e 00 00 00 ed 72 00 00 4a 00 00 00 fc 72 00 00 12 00 00 00	.r.......r.......r..J....r......
0ae0	47 73 00 00 1d 00 00 00 5a 73 00 00 11 00 00 00 78 73 00 00 18 00 00 00 8a 73 00 00 28 00 00 00	Gs......Zs......xs.......s..(...
0b00	a3 73 00 00 1e 00 00 00 cc 73 00 00 06 00 00 00 eb 73 00 00 93 01 00 00 f2 73 00 00 0a 00 00 00	.s.......s.......s.......s......
0b20	86 75 00 00 70 00 00 00 91 75 00 00 0c 00 00 00 02 76 00 00 0b 00 00 00 0f 76 00 00 15 00 00 00	.u..p....u.......v.......v......
0b40	1b 76 00 00 1a 00 00 00 31 76 00 00 18 00 00 00 4c 76 00 00 1d 00 00 00 65 76 00 00 04 00 00 00	.v......1v......Lv......ev......
0b60	83 76 00 00 1a 00 00 00 88 76 00 00 27 00 00 00 a3 76 00 00 8c 00 00 00 cb 76 00 00 15 00 00 00	.v.......v..'....v.......v......
0b80	58 77 00 00 c9 00 00 00 6e 77 00 00 0b 00 00 00 38 78 00 00 62 00 00 00 44 78 00 00 81 00 00 00	Xw......nw......8x..b...Dx......
0ba0	a7 78 00 00 17 00 00 00 29 79 00 00 12 00 00 00 41 79 00 00 19 00 00 00 54 79 00 00 18 01 00 00	.x......)y......Ay......Ty......
0bc0	6e 79 00 00 7d 00 00 00 87 7a 00 00 80 00 00 00 05 7b 00 00 45 00 00 00 86 7b 00 00 35 00 00 00	ny..}....z.......{..E....{..5...
0be0	cc 7b 00 00 2f 00 00 00 02 7c 00 00 d2 00 00 00 32 7c 00 00 84 00 00 00 05 7d 00 00 48 00 00 00	.{../....|......2|.......}..H...
0c00	8a 7d 00 00 21 00 00 00 d3 7d 00 00 61 00 00 00 f5 7d 00 00 41 00 00 00 57 7e 00 00 70 00 00 00	.}..!....}..a....}..A...W~..p...
0c20	99 7e 00 00 54 00 00 00 0a 7f 00 00 bc 00 00 00 5f 7f 00 00 85 00 00 00 1c 80 00 00 e7 00 00 00	.~..T..........._...............
0c40	a2 80 00 00 2a 00 00 00 8a 81 00 00 3b 00 00 00 b5 81 00 00 93 00 00 00 f1 81 00 00 1d 00 00 00	....*.......;...................
0c60	85 82 00 00 37 00 00 00 a3 82 00 00 8b 00 00 00 db 82 00 00 48 00 00 00 67 83 00 00 90 00 00 00	....7...............H...g.......
0c80	b0 83 00 00 31 00 00 00 41 84 00 00 7f 00 00 00 73 84 00 00 47 00 00 00 f3 84 00 00 36 00 00 00	....1...A.......s...G.......6...
0ca0	3b 85 00 00 0f 00 00 00 72 85 00 00 95 00 00 00 82 85 00 00 09 00 00 00 18 86 00 00 ac 00 00 00	;.......r.......................
0cc0	22 86 00 00 18 00 00 00 cf 86 00 00 0c 00 00 00 e8 86 00 00 2a 00 00 00 f5 86 00 00 39 00 00 00	"...................*.......9...
0ce0	20 87 00 00 25 00 00 00 5a 87 00 00 08 00 00 00 80 87 00 00 0f 00 00 00 89 87 00 00 18 00 00 00	....%...Z.......................
0d00	99 87 00 00 0f 00 00 00 b2 87 00 00 3a 00 00 00 c2 87 00 00 48 00 00 00 fd 87 00 00 2b 00 00 00	............:.......H.......+...
0d20	46 88 00 00 64 00 00 00 72 88 00 00 5c 00 00 00 d7 88 00 00 64 00 00 00 34 89 00 00 32 00 00 00	F...d...r...\.......d...4...2...
0d40	99 89 00 00 5b 00 00 00 cc 89 00 00 ed 01 00 00 28 8a 00 00 31 00 00 00 16 8c 00 00 0e 01 00 00	....[...........(...1...........
0d60	48 8c 00 00 0c 00 00 00 57 8d 00 00 48 00 00 00 64 8d 00 00 4d 00 00 00 ad 8d 00 00 4e 00 00 00	H.......W...H...d...M.......N...
0d80	fb 8d 00 00 21 00 00 00 4a 8e 00 00 59 00 00 00 6c 8e 00 00 1b 00 00 00 c6 8e 00 00 75 00 00 00	....!...J...Y...l...........u...
0da0	e2 8e 00 00 18 00 00 00 58 8f 00 00 b5 00 00 00 71 8f 00 00 44 00 00 00 27 90 00 00 15 01 00 00	........X.......q...D...'.......
0dc0	6c 90 00 00 0c 00 00 00 82 91 00 00 0b 00 00 00 8f 91 00 00 18 00 00 00 9b 91 00 00 d3 00 00 00	l...............................
0de0	b4 91 00 00 0c 00 00 00 88 92 00 00 39 00 00 00 95 92 00 00 05 00 00 00 cf 92 00 00 3c 00 00 00	............9...............<...
0e00	d5 92 00 00 56 00 00 00 12 93 00 00 08 00 00 00 69 93 00 00 45 00 00 00 72 93 00 00 0f 00 00 00	....V...........i...E...r.......
0e20	b8 93 00 00 07 00 00 00 c8 93 00 00 01 00 00 00 00 00 00 00 a3 00 00 00 06 00 00 00 82 00 00 00	................................
0e40	d2 00 00 00 00 00 00 00 de 00 00 00 94 00 00 00 73 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00	................s...............
0e60	3a 00 00 00 4e 00 00 00 00 00 00 00 83 00 00 00 3c 00 00 00 9c 00 00 00 ca 00 00 00 25 00 00 00	:...N...........<...........%...
0e80	89 00 00 00 00 00 00 00 7a 00 00 00 aa 00 00 00 00 00 00 00 a9 00 00 00 b9 00 00 00 00 00 00 00	........z.......................
0ea0	a1 00 00 00 00 00 00 00 00 00 00 00 0e 00 00 00 9e 00 00 00 78 00 00 00 c4 00 00 00 45 00 00 00	....................x.......E...
0ec0	87 00 00 00 5f 00 00 00 00 00 00 00 db 00 00 00 8f 00 00 00 a5 00 00 00 b6 00 00 00 00 00 00 00	...._...........................
0ee0	00 00 00 00 15 00 00 00 66 00 00 00 a8 00 00 00 90 00 00 00 18 00 00 00 58 00 00 00 d8 00 00 00	........f...............X.......
0f00	c3 00 00 00 cf 00 00 00 76 00 00 00 38 00 00 00 00 00 00 00 e1 00 00 00 d3 00 00 00 7b 00 00 00	........v...8...............{...
0f20	00 00 00 00 00 00 00 00 b4 00 00 00 35 00 00 00 1d 00 00 00 6e 00 00 00 98 00 00 00 00 00 00 00	............5.......n...........
0f40	6c 00 00 00 4a 00 00 00 62 00 00 00 71 00 00 00 bc 00 00 00 c1 00 00 00 00 00 00 00 7c 00 00 00	l...J...b...q...............|...
0f60	00 00 00 00 4f 00 00 00 9d 00 00 00 00 00 00 00 74 00 00 00 80 00 00 00 00 00 00 00 af 00 00 00	....O...........t...............
0f80	60 00 00 00 88 00 00 00 6f 00 00 00 00 00 00 00 b2 00 00 00 24 00 00 00 16 00 00 00 2f 00 00 00	`.......o...........$......./...
0fa0	a4 00 00 00 00 00 00 00 36 00 00 00 00 00 00 00 5b 00 00 00 31 00 00 00 e0 00 00 00 75 00 00 00	........6.......[...1.......u...
0fc0	c9 00 00 00 11 00 00 00 03 00 00 00 ab 00 00 00 50 00 00 00 41 00 00 00 d4 00 00 00 47 00 00 00	................P...A.......G...
0fe0	1e 00 00 00 ba 00 00 00 04 00 00 00 05 00 00 00 1c 00 00 00 1a 00 00 00 00 00 00 00 34 00 00 00	............................4...
1000	7d 00 00 00 72 00 00 00 28 00 00 00 86 00 00 00 00 00 00 00 dd 00 00 00 57 00 00 00 8a 00 00 00	}...r...(...............W.......
1020	00 00 00 00 7e 00 00 00 92 00 00 00 54 00 00 00 c0 00 00 00 5e 00 00 00 10 00 00 00 91 00 00 00	....~.......T.......^...........
1040	6b 00 00 00 4d 00 00 00 00 00 00 00 00 00 00 00 a0 00 00 00 00 00 00 00 02 00 00 00 00 00 00 00	k...M...........................
1060	9f 00 00 00 00 00 00 00 cb 00 00 00 00 00 00 00 27 00 00 00 46 00 00 00 0d 00 00 00 c5 00 00 00	................'...F...........
1080	00 00 00 00 2e 00 00 00 5a 00 00 00 00 00 00 00 39 00 00 00 85 00 00 00 81 00 00 00 51 00 00 00	........Z.......9...........Q...
10a0	09 00 00 00 d6 00 00 00 0f 00 00 00 40 00 00 00 00 00 00 00 00 00 00 00 3f 00 00 00 26 00 00 00	............@...........?...&...
10c0	c7 00 00 00 53 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 bd 00 00 00 65 00 00 00 23 00 00 00	....S...................e...#...
10e0	00 00 00 00 6d 00 00 00 00 00 00 00 4c 00 00 00 00 00 00 00 0c 00 00 00 8c 00 00 00 00 00 00 00	....m.......L...................
1100	1b 00 00 00 4b 00 00 00 67 00 00 00 00 00 00 00 59 00 00 00 ce 00 00 00 08 00 00 00 00 00 00 00	....K...g.......Y...............
1120	14 00 00 00 00 00 00 00 52 00 00 00 cc 00 00 00 56 00 00 00 00 00 00 00 0b 00 00 00 00 00 00 00	........R.......V...............
1140	d1 00 00 00 8e 00 00 00 00 00 00 00 2c 00 00 00 44 00 00 00 5d 00 00 00 d9 00 00 00 c6 00 00 00	............,...D...]...........
1160	6a 00 00 00 3b 00 00 00 00 00 00 00 00 00 00 00 1f 00 00 00 d5 00 00 00 30 00 00 00 ac 00 00 00	j...;...................0.......
1180	29 00 00 00 79 00 00 00 5c 00 00 00 00 00 00 00 33 00 00 00 95 00 00 00 c8 00 00 00 b0 00 00 00	)...y...\.......3...............
11a0	19 00 00 00 ad 00 00 00 63 00 00 00 b8 00 00 00 96 00 00 00 77 00 00 00 b5 00 00 00 a6 00 00 00	........c...........w...........
11c0	00 00 00 00 da 00 00 00 00 00 00 00 b7 00 00 00 48 00 00 00 bf 00 00 00 84 00 00 00 55 00 00 00	................H...........U...
11e0	b3 00 00 00 00 00 00 00 17 00 00 00 bb 00 00 00 00 00 00 00 2d 00 00 00 93 00 00 00 9a 00 00 00	....................-...........
1200	00 00 00 00 a7 00 00 00 d0 00 00 00 3d 00 00 00 00 00 00 00 c2 00 00 00 00 00 00 00 cd 00 00 00	............=...................
1220	0a 00 00 00 8d 00 00 00 b1 00 00 00 00 00 00 00 22 00 00 00 00 00 00 00 d7 00 00 00 00 00 00 00	................"...............
1240	7f 00 00 00 37 00 00 00 00 00 00 00 3e 00 00 00 68 00 00 00 00 00 00 00 2a 00 00 00 07 00 00 00	....7.......>...h.......*.......
1260	a2 00 00 00 00 00 00 00 00 00 00 00 12 00 00 00 be 00 00 00 21 00 00 00 df 00 00 00 00 00 00 00	....................!...........
1280	dc 00 00 00 49 00 00 00 00 00 00 00 64 00 00 00 ae 00 00 00 00 00 00 00 32 00 00 00 00 00 00 00	....I.......d...........2.......
12a0	00 00 00 00 70 00 00 00 61 00 00 00 20 00 00 00 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00	....p...a.......................
12c0	97 00 00 00 99 00 00 00 00 00 00 00 8b 00 00 00 00 00 00 00 00 00 00 00 9b 00 00 00 00 00 00 00	................................
12e0	2b 00 00 00 69 00 00 00 00 00 00 00 43 00 00 00 00 00 00 00 42 00 00 00 00 2a 2a 4e 4f 54 45 2a	+...i.......C.......B....**NOTE*
1300	2a 3a 20 62 65 20 63 61 72 65 66 75 6c 6c 20 77 68 69 6c 65 20 63 6f 70 79 69 6e 67 20 61 6e 64	*:.be.carefull.while.copying.and
1320	20 70 61 73 74 69 6e 67 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 73 2e 20 44 6f 62 6c	.pasting.previous.commands..Dobl
1340	65 20 71 75 6f 74 65 73 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 63 6f 72 72 65 63 74 65	e.quotes.may.need.to.be.correcte
1360	64 2e 00 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 3a 20 65 6d 70 74 79 20 66 69 6c 65 20 28 72 65	d..**meta-data**:.empty.file.(re
1380	71 75 69 72 65 64 29 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2a 2a 20 66 69 6c 65	quired)..**network-config**.file
13a0	20 6f 6e 6c 79 20 68 61 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 61 74 20 64 69 73	.only.has.configuration.that.dis
13c0	61 62 6c 65 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 64 68 63 70 20 63 6c 69 65 6e 74 20	ables.the.automatic.dhcp.client.
13e0	6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f	on.first.interface..**network-co
1400	6e 66 69 67 2a 2a 3a 20 66 69 6c 65 20 74 68 61 74 20 77 69 6c 6c 20 69 6e 64 69 63 61 74 65 20	nfig**:.file.that.will.indicate.
1420	74 6f 20 61 76 6f 69 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e	to.avoid.dhcp.client.on.first.in
1440	74 65 72 66 61 63 65 2e 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 20 66 69 6c 65 20 6d 75 73 74	terface..**user-data**.file.must
1460	20 73 74 61 72 74 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 61 6e	.start.with.``#cloud-config``.an
1480	64 20 63 6f 6e 74 61 69 6e 73 20 76 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 20 46 6f 72 20 65 78	d.contains.vyos-commands..For.ex
14a0	61 6d 70 6c 65 3a 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 3a 20 69 6e 63 6c 75 64 65 73 20 76	ample:.**user-data**:.includes.v
14c0	79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 00 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 00 2f 63 6f 6e 66	yos-commands../config-file./conf
14e0	69 67 75 72 65 00 2f 67 65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 70 6f 77 65 72 6f 66 66	igure./generate./image./poweroff
1500	00 2f 72 65 62 6f 6f 74 00 2f 72 65 73 65 74 00 2f 72 65 74 72 69 65 76 65 00 2f 73 68 6f 77 00	./reboot./reset./retrieve./show.
1520	41 20 56 79 4f 53 20 71 63 6f 77 20 69 6d 61 67 65 20 77 69 74 68 20 63 6c 6f 75 64 2d 69 6e 69	A.VyOS.qcow.image.with.cloud-ini
1540	74 20 6f 70 74 69 6f 6e 73 20 69 73 20 6e 65 65 64 65 64 2e 20 54 68 69 73 20 63 61 6e 20 62 65	t.options.is.needed..This.can.be
1560	20 6f 62 74 61 69 6e 65 64 20 75 73 69 6e 67 20 60 76 79 6f 73 2d 76 6d 2d 69 6d 61 67 65 73 60	.obtained.using.`vyos-vm-images`
1580	5f 20 72 65 70 6f 2e 20 41 66 74 65 72 20 63 6c 6f 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6f 2c	_.repo..After.clonning.the.repo,
15a0	20 65 64 69 74 20 74 68 65 20 66 69 6c 65 20 2a 2a 71 65 6d 75 2e 79 6d 6c 2a 2a 20 61 6e 64 20	.edit.the.file.**qemu.yml**.and.
15c0	63 6f 6d 6d 65 6e 74 20 74 68 65 20 2a 2a 64 6f 77 6e 6c 6f 61 64 2d 69 73 6f 2a 2a 20 72 6f 6c	comment.the.**download-iso**.rol
15e0	65 2e 00 41 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 77 72	e..A.cloud-config.document.is.wr
1600	69 74 74 65 6e 20 69 6e 20 59 41 4d 4c 2e 20 54 68 65 20 66 69 6c 65 20 6d 75 73 74 20 62 65 67	itten.in.YAML..The.file.must.beg
1620	69 6e 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 6c 69 6e 65 2e 20	in.with.``#cloud-config``.line..
1640	54 68 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 74 6f 70 2d 6c 65 76 65 6c 20 6b 65 79	The.only.supported.top-level.key
1660	73 20 61 72 65 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 61	s.are.``vyos_config_commands``.a
1680	6e 64 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 2e 20 54 68 65 20 75 73 65 20 6f 66 20 74	nd.``write_files``..The.use.of.t
16a0	68 65 73 65 20 6b 65 79 73 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 66 6f	hese.keys.is.described.in.the.fo
16c0	6c 6c 6f 77 69 6e 67 20 74 77 6f 20 73 65 63 74 69 6f 6e 73 2e 00 41 20 73 69 6d 70 6c 65 20 65	llowing.two.sections..A.simple.e
16e0	78 61 6d 70 6c 65 20 69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2c 20 77 68 65 72 65 20 74 68 65	xample.is.shown.below,.where.the
1700	20 6f 70 73 20 63 6f 6d 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 68 65 20 70 6f 73	.ops.command.executed.in.the.pos
1720	74 2d 68 6f 6f 6b 20 73 63 72 69 70 74 20 69 73 20 22 73 68 6f 77 20 69 6e 74 65 72 66 61 63 65	t-hook.script.is."show.interface
1740	73 22 2e 00 41 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 73 79 6d 62 6f 6c 20 69 73 20 6e 6f 74	s"..A.single-quote.symbol.is.not
1760	20 61 6c 6c 6f 77 65 64 20 69 6e 73 69 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 76 61 6c 75 65	.allowed.inside.command.or.value
1780	2e 00 41 50 49 20 45 6e 64 70 6f 69 6e 74 73 00 41 63 63 65 70 74 20 6d 69 6e 69 6f 6e 20 6b 65	..API.Endpoints.Accept.minion.ke
17a0	79 00 41 6c 6c 20 65 6e 64 70 6f 69 6e 74 73 20 6f 6e 6c 79 20 6c 69 73 74 65 6e 20 6f 6e 20 48	y.All.endpoints.only.listen.on.H
17c0	54 54 50 20 50 4f 53 54 20 72 65 71 75 65 73 74 73 20 61 6e 64 20 74 68 65 20 41 50 49 20 4b 45	TTP.POST.requests.and.the.API.KE
17e0	59 20 6d 75 73 74 20 73 65 74 20 61 73 20 60 60 6b 65 79 60 60 20 69 6e 20 74 68 65 20 66 6f 72	Y.must.set.as.``key``.in.the.for
1800	6d 64 61 74 61 2e 00 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 63 61 6e 20 62 65 20 6f 76 65 72 72	mdata..All.of.these.can.be.overr
1820	69 64 64 65 6e 20 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e	idden.using.the.configuration.in
1840	20 75 73 65 72 2d 64 61 74 61 2e 00 41 6c 73 6f 2c 20 74 68 69 73 20 6c 61 62 20 63 6f 6e 73 69	.user-data..Also,.this.lab.consi
1860	64 65 72 73 3a 00 41 6e 73 69 62 6c 65 00 41 6e 79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20	ders:.Ansible.Any.modifications.
1880	77 65 72 65 20 64 6f 6e 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 75 6e 66 69 78 65 64	were.done.to.work.around.unfixed
18a0	20 62 75 67 73 20 61 6e 64 20 69 6d 70 6c 65 6d 65 6e 74 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73	.bugs.and.implement.enhancements
18c0	20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 69 6e 20 74 68 65 20 56 79	.that.are.not.complete.in.the.Vy
18e0	4f 53 20 73 79 73 74 65 6d 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 68 65 72 65 2e 00 41 74	OS.system.can.be.placed.here..At
1900	20 74 68 69 73 20 73 74 65 70 20 77 65 20 63 61 6e 20 67 65 74 20 73 6f 6d 65 20 6f 70 2d 6d 6f	.this.step.we.can.get.some.op-mo
1920	64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 56 79 4f 53 20 6e 6f 64 65 73 3a 00	de.information.from.VyOS.nodes:.
1940	41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 00 42 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 2c 20	Authentication.Before.starting,.
1960	70 6c 65 61 73 65 20 72 65 66 65 72 20 74 6f 20 63 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77	please.refer.to.cloud-init.`netw
1980	6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6b 6e	ork-config-docs`_.in.order.to.kn
19a0	6f 77 20 68 6f 77 20 74 6f 20 69 6d 70 6f 72 74 20 75 73 65 72 20 61 6e 64 20 6e 65 74 77 6f 72	ow.how.to.import.user.and.networ
19c0	6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 2e 00 42 65 6c 6f 77 20 73 65 65 20 6f 6e 65 20	k.configurations..Below.see.one.
19e0	65 78 61 6d 70 6c 65 20 66 6f 72 20 63 75 72 6c 20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 70 79 74	example.for.curl.and.one.for.pyt
1a00	68 6f 6e 2e 20 54 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69	hon..The.rest.of.the.documentati
1a20	6f 6e 20 69 73 20 72 65 64 75 63 65 64 20 74 6f 20 63 75 72 6c 2e 00 43 68 65 63 6b 20 73 61 6c	on.is.reduced.to.curl..Check.sal
1a40	74 2d 6b 65 79 73 20 6f 6e 20 74 68 65 20 73 61 6c 74 20 6d 61 73 74 65 72 00 43 68 65 63 6b 20	t-keys.on.the.salt.master.Check.
1a60	74 68 61 74 20 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 20 69 73 20 61 6c 69 76 65 3a 00 43 68 65 63	that.proxy.minion.is.alive:.Chec
1a80	6b 20 74 68 61 74 20 73 61 6c 74 20 6d 61 73 74 65 72 20 63 61 6e 20 63 6f 6d 6d 75 6e 69 63 61	k.that.salt.master.can.communica
1aa0	74 65 20 77 69 74 68 20 6d 69 6e 69 6f 6e 73 00 43 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61	te.with.minions.Cloud.and.virtua
1ac0	6c 69 7a 65 64 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 56 79 4f 53 20 61 72 65 20 69 6e 69 74	lized.instances.of.VyOS.are.init
1ae0	69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 74 68 65 20 69 6e 64 75 73 74 72 79 2d 73 74 61 6e 64	ialized.using.the.industry-stand
1b00	61 72 64 20 63 6c 6f 75 64 2d 69 6e 69 74 2e 20 56 69 61 20 63 6c 6f 75 64 2d 69 6e 69 74 2c 20	ard.cloud-init..Via.cloud-init,.
1b20	74 68 65 20 73 79 73 74 65 6d 20 70 65 72 66 6f 72 6d 73 20 74 61 73 6b 73 20 73 75 63 68 20 61	the.system.performs.tasks.such.a
1b40	73 20 69 6e 6a 65 63 74 69 6e 67 20 53 53 48 20 6b 65 79 73 20 61 6e 64 20 63 6f 6e 66 69 67 75	s.injecting.SSH.keys.and.configu
1b60	72 69 6e 67 20 74 68 65 20 6e 65 74 77 6f 72 6b 2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 74	ring.the.network..In.addition,.t
1b80	68 65 20 75 73 65 72 20 63 61 6e 20 73 75 70 70 6c 79 20 61 20 63 75 73 74 6f 6d 20 63 6f 6e 66	he.user.can.supply.a.custom.conf
1ba0	69 67 75 72 61 74 69 6f 6e 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e 63	iguration.at.the.time.of.instanc
1bc0	65 20 6c 61 75 6e 63 68 2e 00 43 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 6d 6f 64 75 6c 65 73 00 43	e.launch..Cloud-config.modules.C
1be0	6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f	loud-init.`network-config-docs`_
1c00	2e 00 43 6c 6f 75 64 2d 69 6e 69 74 20 6f 6e 20 50 72 6f 78 6d 6f 78 00 43 6f 6d 6d 61 6e 64 20	..Cloud-init.on.Proxmox.Command.
1c20	45 78 65 63 75 74 69 6f 6e 20 61 74 20 49 6e 69 74 69 61 6c 20 42 6f 6f 74 00 43 6f 6d 6d 61 6e	Execution.at.Initial.Boot.Comman
1c40	64 20 53 63 72 69 70 74 69 6e 67 00 43 6f 6d 6d 61 6e 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69	d.Scripting.Command.for.generati
1c60	6e 67 20 60 60 73 65 65 64 2e 69 73 6f 60 60 00 43 6f 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 65	ng.``seed.iso``.Commands.require
1c80	6d 65 6e 74 73 3a 00 43 6f 6e 66 69 67 20 53 6f 75 72 63 65 73 00 43 6f 6e 66 69 67 75 72 61 74	ments:.Config.Sources.Configurat
1ca0	69 6f 6e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65	ion.Configuration.commands.are.e
1cc0	78 65 63 75 74 65 64 20 6a 75 73 74 20 6c 69 6b 65 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20	xecuted.just.like.from.a.normal.
1ce0	63 6f 6e 66 69 67 20 73 65 73 73 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20	config.session..For.example,.if.
1d00	79 6f 75 20 77 61 6e 74 20 74 6f 20 64 69 73 61 62 6c 65 20 61 20 42 47 50 20 70 65 65 72 20 6f	you.want.to.disable.a.BGP.peer.o
1d20	6e 20 56 52 52 50 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20 62 61 63 6b 75 70 3a 00 43 6f 6e	n.VRRP.transition.to.backup:.Con
1d40	66 69 67 75 72 65 2c 20 74 68 65 6e 20 44 65 6c 65 74 65 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69	figure,.then.Delete.Object.Confi
1d60	67 75 72 65 2c 20 74 68 65 6e 20 4c 6f 61 64 20 46 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20	gure,.then.Load.File.Configure,.
1d80	74 68 65 6e 20 53 61 76 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 61 76 65 20 46	then.Save.Configure,.then.Save.F
1da0	69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 65 74 00 43 6f 6e 66 69 67 75 72	ile.Configure,.then.Set.Configur
1dc0	65 2c 20 74 68 65 6e 20 53 68 6f 77 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 74	e,.then.Show.Object.Configure,.t
1de0	68 65 6e 20 53 68 6f 77 20 61 20 53 69 6e 67 6c 65 20 4f 62 6a 65 63 74 20 56 61 6c 75 65 00 43	hen.Show.a.Single.Object.Value.C
1e00	6f 6e 74 65 6e 74 20 6f 66 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 00 43 6f 6e 74 65 6e 74 20	ontent.of.commands.conf.Content.
1e20	6f 66 20 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 20 66 69 6c 65 3a 00 43 72 65 61 74 65 20 73	of.network-config.file:.Create.s
1e40	65 65 64 2e 69 73 6f 00 43 72 65 61 74 65 20 74 65 78 74 20 66 69 6c 65 73 20 6e 61 6d 65 64 20	eed.iso.Create.text.files.named.
1e60	75 73 65 72 2d 64 61 74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 2e 20 4f 6e 20 6c 69 6e 75	user-data.and.meta-data..On.linu
1e80	78 2d 62 61 73 65 64 20 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 6b 69 73 6f 66 73 20 75 74 69	x-based.systems,.the.mkisofs.uti
1ea0	6c 69 74 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 73	lity.can.be.used.to.create.the.s
1ec0	65 65 64 20 49 53 4f 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78 20 77 69	eed.ISO..The.following.syntax.wi
1ee0	6c 6c 20 61 64 64 20 74 68 65 73 65 20 66 69 6c 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 39 36	ll.add.these.files.to.the.ISO.96
1f00	36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 00 43 72 65 61 74 69 6e 67 20 74 68 65 20 56 4d 00	60.file.system..Creating.the.VM.
1f20	43 75 73 74 6f 6d 20 73 63 72 69 70 74 73 20 61 72 65 20 6e 6f 74 20 65 78 65 63 75 74 65 64 20	Custom.scripts.are.not.executed.
1f40	77 69 74 68 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 28 55 73 65 20 73 75 64 6f 20 69	with.root.privileges.(Use.sudo.i
1f60	6e 73 69 64 65 20 69 66 20 74 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 29 2e 00 44 48 43	nside.if.this.is.necessary)..DHC
1f80	50 20 6f 6e 20 66 69 72 73 74 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 20 69 66	P.on.first.Ethernet.interface.if
1fa0	20 6e 6f 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f	.no.network.configuration.is.pro
1fc0	76 69 64 65 64 2e 00 45 78 61 6d 70 6c 65 00 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67	vided..Example.Example.of.config
1fe0	75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 22	uration.commands.from.the.file."
2000	2f 73 72 76 2f 73 61 6c 74 2f 73 74 61 74 65 73 2f 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 22 00 45	/srv/salt/states/commands.txt".E
2020	78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 00 45 78 61 6d 70 6c 65	xample.of.configuration:.Example
2040	20 6f 66 20 6f 70 2d 6d 6f 64 65 3a 00 45 78 61 6d 70 6c 65 73 00 45 78 65 63 75 74 69 6e 67 20	.of.op-mode:.Examples.Executing.
2060	43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 45 78 65 63 75 74 69 6e 67 20	Configuration.Scripts.Executing.
2080	70 72 65 2d 68 6f 6f 6b 73 2f 70 6f 73 74 2d 68 6f 6f 6b 73 20 53 63 72 69 70 74 73 00 46 69 6c	pre-hooks/post-hooks.Scripts.Fil
20a0	65 20 63 6f 6e 74 65 6e 74 73 00 46 69 6c 65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 70	e.contents.File.generated.with.p
20c0	72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 3a 20 60 60 2f 74 6d 70 2f 76 79 6f 73 2d 31 2e 33	revious.command:.``/tmp/vyos-1.3
20e0	2e 30 2d 63 6c 6f 75 64 2d 69 6e 69 74 2d 31 30 47 2d 71 65 6d 75 2e 71 63 6f 77 32 60 60 00 46	.0-cloud-init-10G-qemu.qcow2``.F
2100	69 6e 61 6c 79 2c 20 66 69 6c 65 20 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 20 68 61 73 20 6e 6f	inaly,.file.**meta-data**.has.no
2120	20 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 69 74 27 73 20 72 65 71 75 69 72 65 64 2e 00 46 6f 72	.content,.but.it's.required..For
2140	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 65 6e 61 62 6c 69 6e 67 20 74 68 65 20	.configuration.and.enabling.the.
2160	41 50 49 20 73 65 65 20 3a 72 65 66 3a 60 68 74 74 70 2d 61 70 69 60 00 46 6f 72 20 63 6f 6e 66	API.see.:ref:`http-api`.For.conf
2180	69 67 75 72 61 74 69 6f 6e 2f 75 70 67 72 61 64 65 20 6d 61 6e 61 67 65 6d 65 6e 74 20 69 73 73	iguration/upgrade.management.iss
21a0	75 65 73 2c 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 73 63 72 69 70 74	ues,.modification.of.this.script
21c0	20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 2e 20 41 6c 77 61	.should.be.the.last.option..Alwa
21e0	79 73 20 74 72 79 20 74 6f 20 66 69 6e 64 20 73 6f 6c 75 74 69 6f 6e 73 20 62 61 73 65 64 20 6f	ys.try.to.find.solutions.based.o
2200	6e 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20 66 69 72 73 74 2e 00 46 6f 72 20 65 78 61 6d 70 6c	n.CLI.commands.first..For.exampl
2220	65 2c 20 67 65 74 20 74 68 65 20 61 64 64 72 65 73 73 65 73 20 6f 66 20 61 20 60 60 64 75 6d 30	e,.get.the.addresses.of.a.``dum0
2240	60 60 20 69 6e 74 65 72 66 61 63 65 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 20	``.interface..For.example,.show.
2260	77 68 69 63 68 20 69 6d 61 67 65 73 20 61 72 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 46 6f 72 20	which.images.are.installed..For.
2280	6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20	more.information.on.the.NoCloud.
22a0	64 61 74 61 20 73 6f 75 72 63 65 2c 20 76 69 73 69 74 20 69 74 73 20 60 70 61 67 65 20 3c 68 74	data.source,.visit.its.`page.<ht
22c0	74 70 73 3a 2f 2f 63 6c 6f 75 64 69 6e 69 74 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f 2f 65	tps://cloudinit.readthedocs.io/e
22e0	6e 2f 6c 61 74 65 73 74 2f 72 65 66 65 72 65 6e 63 65 2f 64 61 74 61 73 6f 75 72 63 65 73 2f 6e	n/latest/reference/datasources/n
2300	6f 63 6c 6f 75 64 2e 68 74 6d 6c 3e 60 5f 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 69 6e 69 74	ocloud.html>`_.in.the.cloud-init
2320	20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 46 72 6f 6d 20 63 6c 69 20 6f 72 20 47 55 49 2c	.documentation..From.cli.or.GUI,
2340	20 70 6f 77 65 72 20 6f 6e 20 56 4d 2c 20 61 6e 64 20 61 66 74 65 72 20 69 74 20 62 6f 6f 74 73	.power.on.VM,.and.after.it.boots
2360	2c 20 76 65 72 69 66 79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 47 65 6e 65 72 61 74 65 20	,.verify.configuration.Generate.
2380	4f 62 6a 65 63 74 00 47 65 6e 65 72 61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 47 65 74 74 69	Object.Generate.qcow.image.Getti
23a0	6e 67 20 53 74 61 72 74 65 64 00 48 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d	ng.Started.Here.is.a.simple.exam
23c0	70 6c 65 3a 00 48 65 72 65 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 63 6c 6f 75 64 2d 63 6f	ple:.Here.is.an.example.cloud-co
23e0	6e 66 69 67 20 74 68 61 74 20 61 70 70 65 6e 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	nfig.that.appends.configuration.
2400	61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 49 53 4f 20 66	at.the.time.of.first.boot..ISO.f
2420	69 6c 65 73 20 73 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69	iles.storage:.``local``.volume.i
2440	73 20 75 73 65 64 20 66 6f 72 20 60 60 2e 69 73 6f 60 60 20 66 69 6c 65 20 73 74 6f 72 61 67 65	s.used.for.``.iso``.file.storage
2460	2e 20 49 6e 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c	..In.this.scenario.``local``.vol
2480	75 6d 65 20 74 79 70 65 20 69 73 20 73 65 74 20 74 6f 20 2a 2a 64 69 72 65 63 74 6f 72 79 2a 2a	ume.type.is.set.to.**directory**
24a0	2c 20 61 62 64 20 61 74 74 61 63 68 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 60	,.abd.attached.to.``/var/lib/vz`
24c0	60 2e 00 49 66 20 63 6f 6d 6d 61 6e 64 20 65 6e 64 73 20 69 6e 20 61 20 76 61 6c 75 65 2c 20 69	`..If.command.ends.in.a.value,.i
24e0	74 20 6d 75 73 74 20 62 65 20 69 6e 73 69 64 65 20 73 69 6e 67 6c 65 20 71 75 6f 74 65 73 2e 00	t.must.be.inside.single.quotes..
2500	49 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69	If.no.networking.configuration.i
2520	73 20 70 72 6f 76 69 64 65 64 2c 20 74 68 65 6e 20 64 68 63 70 20 63 6c 69 65 6e 74 20 69 73 20	s.provided,.then.dhcp.client.is.
2540	67 6f 69 6e 67 20 74 6f 20 62 65 20 65 6e 61 62 6c 65 64 20 6f 6e 20 66 69 72 73 74 20 69 6e 74	going.to.be.enabled.on.first.int
2560	65 72 66 61 63 65 2e 20 42 61 72 65 20 69 6e 20 6d 69 6e 64 20 74 68 61 74 20 74 68 69 73 20 63	erface..Bare.in.mind.that.this.c
2580	6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6e 79 65 63 74 65 64 20 61 74	onfiguration.will.be.inyected.at
25a0	20 61 6e 20 4f 53 20 6c 65 76 65 6c 2c 20 73 6f 20 64 6f 6e 27 74 20 65 78 70 65 63 74 20 74 6f	.an.OS.level,.so.don't.expect.to
25c0	20 66 69 6e 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	.find.dhcp.client.configuration.
25e0	6f 6e 20 76 79 6f 73 20 63 6c 69 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 20 62 65 68	on.vyos.cli..Because.of.this.beh
2600	61 76 69 6f 72 2c 20 69 6e 20 6e 65 78 74 20 65 78 61 6d 70 6c 65 20 6c 61 62 20 77 65 20 77 69	avior,.in.next.example.lab.we.wi
2620	6c 6c 20 64 69 73 61 62 6c 65 20 64 68 63 70 2d 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61	ll.disable.dhcp-client.configura
2640	74 69 6f 6e 20 6f 6e 20 65 74 68 30 2e 00 49 66 20 79 6f 75 20 65 6e 63 6f 75 6e 74 65 72 20 70	tion.on.eth0..If.you.encounter.p
2660	72 6f 62 6c 65 6d 73 2c 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 63 6c 6f 75 64 2d 63	roblems,.verify.that.the.cloud-c
2680	6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 76 61 6c 69 64 20 59 41	onfig.document.contains.valid.YA
26a0	4d 4c 2e 20 4f 6e 6c 69 6e 65 20 72 65 73 6f 75 72 63 65 73 20 73 75 63 68 20 61 73 20 68 74 74	ML..Online.resources.such.as.htt
26c0	70 73 3a 2f 2f 77 77 77 2e 79 61 6d 6c 6c 69 6e 74 2e 63 6f 6d 2f 20 70 72 6f 76 69 64 65 20 61	ps://www.yamllint.com/.provide.a
26e0	20 73 69 6d 70 6c 65 20 74 6f 6f 6c 20 66 6f 72 20 76 61 6c 69 64 61 74 69 6e 67 20 59 41 4d 4c	.simple.tool.for.validating.YAML
2700	2e 00 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 67 61 74 68 65 72 20 69 6e 66 6f 72 6d 61 74	..If.you.need.to.gather.informat
2720	69 6f 6e 20 66 72 6f 6d 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 6f 6e 66 69	ion.from.linux.commands.to.confi
2740	67 75 72 65 20 56 79 4f 53 2c 20 79 6f 75 20 63 61 6e 20 65 78 65 63 75 74 65 20 63 6f 6d 6d 61	gure.VyOS,.you.can.execute.comma
2760	6e 64 73 20 61 6e 64 20 74 68 65 6e 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 69 6e 20 74	nds.and.then.configure.VyOS.in.t
2780	68 65 20 73 61 6d 65 20 73 63 72 69 70 74 2e 00 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73	he.same.script..If.you.want.to.s
27a0	63 72 69 70 74 20 74 68 65 20 63 6f 6e 66 69 67 73 20 69 6e 20 61 20 6c 61 6e 67 75 61 67 65 20	cript.the.configs.in.a.language.
27c0	6f 74 68 65 72 20 74 68 61 6e 20 62 61 73 68 20 79 6f 75 20 63 61 6e 20 68 61 76 65 20 79 6f 75	other.than.bash.you.can.have.you
27e0	72 20 73 63 72 69 70 74 20 6f 75 74 70 75 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65	r.script.output.commands.and.the
2800	6e 20 73 6f 75 72 63 65 20 74 68 65 6d 20 69 6e 20 61 20 62 61 73 68 20 73 63 72 69 70 74 2e 00	n.source.them.in.a.bash.script..
2820	49 6d 70 6f 72 74 69 6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 57 61 72 6e 69 6e 67 73	Importing.and.Disabling.Warnings
2840	20 66 6f 72 20 76 65 72 69 66 79 3d 46 61 6c 73 65 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 72	.for.verify=False.In.Proxmox.ser
2860	76 65 72 20 74 68 72 65 65 20 66 69 6c 65 73 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 62 65 20	ver.three.files.are.going.to.be.
2880	75 73 65 64 20 66 6f 72 20 74 68 69 73 20 73 65 74 75 70 3a 00 49 6e 20 56 79 4f 53 2c 20 62 79	used.for.this.setup:.In.VyOS,.by
28a0	20 64 65 66 61 75 6c 74 2c 20 65 6e 61 62 6c 65 73 20 6f 6e 6c 79 20 74 77 6f 20 6d 6f 64 75 6c	.default,.enables.only.two.modul
28c0	65 73 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 61 6c 6c 20 66 69 6c 65 73 20 61 72 65 20 6c	es:.In.this.lab,.all.files.are.l
28e0	6f 63 61 74 65 64 20 69 6e 20 60 60 2f 74 6d 70 2f 60 60 2e 20 53 6f 2c 20 62 65 66 6f 72 65 20	ocated.in.``/tmp/``..So,.before.
2900	67 6f 69 6e 67 20 6f 6e 2c 20 6c 65 74 73 20 6d 6f 76 65 20 74 6f 20 74 68 61 74 20 64 69 72 65	going.on,.lets.move.to.that.dire
2920	63 74 6f 72 79 3a 00 49 6e 20 74 68 69 73 20 6c 61 62 2c 20 77 65 20 61 72 65 20 75 73 69 6e 67	ctory:.In.this.lab,.we.are.using
2940	20 31 2e 33 2e 30 20 56 79 4f 53 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 73 65 74 74 69 6e 67 20	.1.3.0.VyOS.version.and.setting.
2960	61 20 64 69 73 6b 20 6f 66 20 31 30 47 2e 20 44 6f 77 6e 6c 6f 61 64 20 56 79 4f 53 20 2e 69 73	a.disk.of.10G..Download.VyOS..is
2980	6f 20 66 69 6c 65 20 61 6e 64 20 73 61 76 65 20 69 74 20 61 73 20 60 60 2f 74 6d 70 2f 76 79 6f	o.file.and.save.it.as.``/tmp/vyo
29a0	73 2e 69 73 6f 60 60 2e 20 43 6f 6d 6d 61 6e 64 20 75 73 65 64 20 66 6f 72 20 67 65 6e 65 72 61	s.iso``..Command.used.for.genera
29c0	74 69 6e 67 20 71 63 6f 77 20 69 6d 61 67 65 3a 00 49 6e 69 74 69 61 6c 20 43 6f 6e 66 69 67 75	ting.qcow.image:.Initial.Configu
29e0	72 61 74 69 6f 6e 00 49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 61 20 56 79 44 65 76 69 63 65 20 4f	ration.Initializing.a.VyDevice.O
2a00	62 6a 65 63 74 00 49 6e 6a 65 63 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 61	bject.Injecting.configuration.da
2a20	74 61 20 69 73 20 6e 6f 74 20 6c 69 6d 69 74 65 64 20 74 6f 20 63 6c 6f 75 64 20 70 6c 61 74 66	ta.is.not.limited.to.cloud.platf
2a40	6f 72 6d 73 2e 20 55 73 65 72 73 20 63 61 6e 20 65 6d 70 6c 6f 79 20 74 68 65 20 4e 6f 43 6c 6f	orms..Users.can.employ.the.NoClo
2a60	75 64 20 64 61 74 61 20 73 6f 75 72 63 65 20 74 6f 20 69 6e 6a 65 63 74 20 75 73 65 72 2d 64 61	ud.data.source.to.inject.user-da
2a80	74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 20 6f 6e 20 76 69 72 74 75 61 6c 69 7a 61 74 69	ta.and.meta-data.on.virtualizati
2aa0	6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 73 75 63 68 20 61 73 20 56 4d 77 61 72 65 2c 20 48 79 70	on.platforms.such.as.VMware,.Hyp
2ac0	65 72 2d 56 20 61 6e 64 20 4b 56 4d 2e 00 49 6e 73 74 61 6c 6c 20 60 60 6e 61 70 61 6c 6d 2d 76	er-V.and.KVM..Install.``napalm-v
2ae0	79 6f 73 60 60 20 6d 6f 64 75 6c 65 00 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 00 49 74 20 69 73 20	yos``.module.Installation.It.is.
2b00	70 6f 73 73 69 62 6c 65 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 76 69 61 20 6e	possible.to.configure.VyOS.via.n
2b20	65 74 6d 69 6b 6f 5f 20 70 72 6f 78 79 20 6d 6f 64 75 6c 65 2e 20 49 74 20 72 65 71 75 69 72 65	etmiko_.proxy.module..It.require
2b40	73 20 61 20 6d 69 6e 69 6f 6e 20 77 69 74 68 20 69 6e 73 74 61 6c 6c 65 64 20 70 61 63 6b 65 74	s.a.minion.with.installed.packet
2b60	20 20 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 20 77 68 6f	..``python3-netmiko``.module.who
2b80	20 68 61 73 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 56 79 4f 53 20 6e 6f 64 65 73 2e	.has.a.connection.to.VyOS.nodes.
2ba0	20 53 61 6c 74 2d 6d 69 6e 69 6f 6e 20 68 61 76 65 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65	.Salt-minion.have.to.communicate
2bc0	20 77 69 74 68 20 73 61 6c 74 20 6d 61 73 74 65 72 00 4d 61 6a 6f 72 20 63 6c 6f 75 64 20 70 72	.with.salt.master.Major.cloud.pr
2be0	6f 76 69 64 65 72 73 20 6f 66 66 65 72 20 61 20 6d 65 61 6e 73 20 6f 66 20 70 72 6f 76 69 64 69	oviders.offer.a.means.of.providi
2c00	6e 67 20 75 73 65 72 2d 64 61 74 61 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74	ng.user-data.at.the.time.of.inst
2c20	61 6e 63 65 20 6c 61 75 6e 63 68 2e 20 49 74 20 63 61 6e 20 62 65 20 70 72 6f 76 69 64 65 64 20	ance.launch..It.can.be.provided.
2c40	61 73 20 70 6c 61 69 6e 20 74 65 78 74 20 6f 72 20 61 73 20 62 61 73 65 36 34 2d 65 6e 63 6f 64	as.plain.text.or.as.base64-encod
2c60	65 64 20 74 65 78 74 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6c 6f 75 64 20 70 72 6f 76	ed.text,.depending.on.cloud.prov
2c80	69 64 65 72 2e 20 41 6c 73 6f 2c 20 69 74 20 63 61 6e 20 62 65 20 63 6f 6d 70 72 65 73 73 65 64	ider..Also,.it.can.be.compressed
2ca0	20 75 73 69 6e 67 20 67 7a 69 70 2c 20 77 68 69 63 68 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 77	.using.gzip,.which.makes.sense.w
2cc0	69 74 68 20 61 20 6c 6f 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64	ith.a.long.configuration.command
2ce0	73 20 6c 69 73 74 2c 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 20 68 61 72 64 20 6c 69 6d 69	s.list,.because.of.the.hard.limi
2d00	74 20 74 6f 20 7e 31 36 33 38 34 20 62 79 74 65 73 20 66 6f 72 20 74 68 65 20 77 68 6f 6c 65 20	t.to.~16384.bytes.for.the.whole.
2d20	75 73 65 72 2d 64 61 74 61 2e 00 4d 65 74 61 64 61 74 61 20 2d 20 4d 65 74 61 64 61 74 61 20 69	user-data..Metadata.-.Metadata.i
2d40	73 20 73 6f 75 72 63 65 64 20 62 79 20 74 68 65 20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d 20	s.sourced.by.the.cloud.platform.
2d60	6f 72 20 68 79 70 65 72 76 69 73 6f 72 2e 20 49 6e 20 73 6f 6d 65 20 63 6c 6f 75 64 73 2c 20 74	or.hypervisor..In.some.clouds,.t
2d80	68 65 72 65 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 48 54 54 50 20 65	here.is.implemented.as.an.HTTP.e
2da0	6e 64 70 6f 69 6e 74 20 61 74 20 60 60 68 74 74 70 3a 2f 2f 31 36 39 2e 32 35 34 2e 31 36 39 2e	ndpoint.at.``http://169.254.169.
2dc0	32 35 34 60 60 2e 00 4d 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 6b 65 79 73 20 74 68 61 74 20	254``..Most.important.keys.that.
2de0	6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 3a 00 4e 61 70 61 6c 6d 00 4e	needs.to.be.considered:.Napalm.N
2e00	65 74 6d 69 6b 6f 00 4e 65 74 6d 69 6b 6f 2d 70 72 6f 78 79 00 4e 65 74 77 6f 72 6b 20 63 6f 6e	etmiko.Netmiko-proxy.Network.con
2e20	66 69 67 75 72 61 74 69 6f 6e 20 2d 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 20	figuration.-.This.config.source.
2e40	69 6e 66 6f 72 6d 73 20 74 68 65 20 73 79 73 74 65 6d 20 61 62 6f 75 74 20 74 68 65 20 6e 65 74	informs.the.system.about.the.net
2e60	77 6f 72 6b 20 73 65 74 74 69 6e 67 73 20 6c 69 6b 65 20 49 50 20 61 64 64 72 65 73 73 65 73 2c	work.settings.like.IP.addresses,
2e80	20 72 6f 75 74 65 73 2c 20 44 4e 53 2e 20 41 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 69 6e 20	.routes,.DNS..Available.only.in.
2ea0	73 65 76 65 72 61 6c 20 63 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e	several.cloud.and.virtualization
2ec0	20 70 6c 61 74 66 6f 72 6d 73 2e 00 4e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61	.platforms..Networking.configura
2ee0	74 69 6f 6e 73 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 70 61 73 73 65 64 20 69 6e 20 75 73 65	tions.shouldn't.be.passed.in.use
2f00	72 2d 64 61 74 61 20 66 69 6c 65 2e 00 4e 6f 43 6c 6f 75 64 00 4e 6f 72 6e 69 72 00 4e 6f 74 65	r-data.file..NoCloud.Nornir.Note
2f20	20 74 68 61 74 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67	.that.the./opt/vyatta/etc/config
2f40	20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f	.is.used.instead.of.the./config/
2f60	73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e 20	scripts.directory.referenced.in.
2f80	74 68 65 20 3a 72 65 66 3a 60 63 6f 6d 6d 61 6e 64 2d 73 63 72 69 70 74 69 6e 67 60 20 73 65 63	the.:ref:`command-scripting`.sec
2fa0	74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 62 65 63 61 75 73	tion.of.the.documentation.becaus
2fc0	65 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 20 64 69 72 65 63 74 6f 72 79 20 69	e.the./config/script.directory.i
2fe0	73 6e 27 74 20 6d 6f 75 6e 74 65 64 20 77 68 65 6e 20 74 68 65 20 60 60 77 72 69 74 65 5f 66 69	sn't.mounted.when.the.``write_fi
3000	6c 65 73 60 60 20 6d 6f 64 75 6c 65 20 65 78 65 63 75 74 65 73 2e 00 4e 6f 74 65 73 20 66 6f 72	les``.module.executes..Notes.for
3020	20 74 68 69 73 20 70 61 72 74 69 63 75 6c 61 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 61 74 20 6d	.this.particular.example,.that.m
3040	61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 6f 74 68 65 72 20	ay.need.to.be.modified.in.other.
3060	73 65 74 75 70 73 3a 00 4e 6f 77 2c 20 74 68 61 74 20 66 69 6c 65 20 6e 65 65 64 73 20 74 6f 20	setups:.Now,.that.file.needs.to.
3080	62 65 20 63 6f 70 69 65 64 20 74 6f 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 20	be.copied.to.proxmox.server:.On.
30a0	56 79 4f 53 20 74 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69	VyOS.this.will.cause.the.followi
30c0	6e 67 20 70 72 6f 62 6c 65 6d 3a 20 41 66 74 65 72 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20	ng.problem:.After.modifying.the.
30e0	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 73 63 72 69 70 74 20 6c 69 6b 65 20 74 68	configuration.via.script.like.th
3100	69 73 20 6f 6e 63 65 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d	is.once,.it.is.not.possible.to.m
3120	61 6e 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74 68 65 20 63 6f 6e 66 69 67 20 61 6e 79 6d 6f 72	anually.modify.the.config.anymor
3140	65 3a 00 4f 6e 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 63 65 20 74 68 65 20 74	e:.On.proxmox.server:.Once.the.t
3160	68 72 65 65 20 66 69 6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 2c 20 69 74 27 73 20 74 69	hree.files.were.created,.it's.ti
3180	6d 65 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 60 60 73 65 65 64 2e 69 73 6f 60 60 20	me.to.generate.the.``seed.iso``.
31a0	69 6d 61 67 65 2c 20 77 68 69 63 68 20 6e 65 65 64 73 20 74 6f 20 62 65 20 6d 6f 75 6e 74 65 64	image,.which.needs.to.be.mounted
31c0	20 74 6f 20 74 68 65 20 6e 65 77 20 56 4d 20 61 73 20 61 20 63 64 2e 00 4f 6e 65 20 63 6f 6d 6d	.to.the.new.VM.as.a.cd..One.comm
31e0	61 6e 64 20 70 65 72 20 6c 69 6e 65 2e 00 4f 70 2d 6d 6f 64 65 00 4f 74 68 65 72 20 73 63 72 69	and.per.line..Op-mode.Other.scri
3200	70 74 20 6c 61 6e 67 75 61 67 65 73 00 4f 75 74 70 75 74 00 4f 75 74 70 75 74 20 6f 70 2d 6d 6f	pt.languages.Output.Output.op-mo
3220	64 65 00 50 6c 65 61 73 65 20 74 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 43 6f 6e	de.Please.take.a.look.at.the.Con
3240	74 72 69 62 75 74 69 6e 67 20 47 75 69 64 65 20 66 6f 72 20 6f 75 72 20 3a 72 65 66 3a 60 64 6f	tributing.Guide.for.our.:ref:`do
3260	63 75 6d 65 6e 74 61 74 69 6f 6e 60 2e 00 50 6f 73 74 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74	cumentation`..Postconfig.on.boot
3280	00 50 6f 77 65 72 20 6f 6e 20 56 4d 20 61 6e 64 20 76 65 72 69 66 69 63 61 74 69 6f 6e 73 00 50	.Power.on.VM.and.verifications.P
32a0	72 65 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 00 50 72 65 70 61 72 65 20 63 6c 6f 75 64 2d 69	reconfig.on.boot.Prepare.cloud-i
32c0	6e 69 74 20 66 69 6c 65 73 00 50 72 6f 78 6d 6f 78 20 49 50 20 61 64 64 72 65 73 73 3a 20 2a 2a	nit.files.Proxmox.IP.address:.**
32e0	31 39 32 2e 31 36 38 2e 30 2e 32 35 33 2f 32 34 2a 2a 00 50 72 6f 78 6d 6f 78 20 60 43 6c 6f 75	192.168.0.253/24**.Proxmox.`Clou
3300	64 2d 69 6e 69 74 2d 53 75 70 70 6f 72 74 60 5f 2e 00 50 79 56 79 4f 53 00 50 79 56 79 4f 53 20	d-init-Support`_..PyVyOS.PyVyOS.
3320	69 73 20 61 20 50 79 74 68 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f 72 20 69 6e 74 65 72 61 63 74	is.a.Python.library.for.interact
3340	69 6e 67 20 77 69 74 68 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 76 69 61 20 74 68 65 69 72 20	ing.with.VyOS.devices.via.their.
3360	41 50 49 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 67 75 69 64 65 73 20 79	API..This.documentation.guides.y
3380	6f 75 20 6f 6e 20 75 73 69 6e 67 20 50 79 56 79 4f 53 20 74 6f 20 6d 61 6e 61 67 65 20 79 6f 75	ou.on.using.PyVyOS.to.manage.you
33a0	72 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 70 72 6f 67 72 61 6d 6d 61 74 69 63 61 6c 6c 79 2e	r.VyOS.devices.programmatically.
33c0	20 54 68 65 20 63 6f 6d 70 6c 65 74 65 20 50 79 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69	.The.complete.PyVyOS.documentati
33e0	6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 5b 52 65 61 64 20 74 68 65 20 44 6f 63	on.is.available.on.[Read.the.Doc
3400	73 5d 28 68 74 74 70 73 3a 2f 2f 70 79 76 79 6f 73 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f	s](https://pyvyos.readthedocs.io
3420	2f 65 6e 2f 6c 61 74 65 73 74 2f 29 2c 20 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61	/en/latest/),.and.the.library.ca
3440	6e 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 5b 47 69 74 48 75 62 5d 28 68 74 74 70 73 3a 2f 2f 67	n.be.found.on.[GitHub](https://g
3460	69 74 68 75 62 2e 63 6f 6d 2f 72 6f 62 65 72 74 6f 62 65 72 74 6f 2f 70 79 76 79 6f 73 29 20 61	ithub.com/robertoberto/pyvyos).a
3480	6e 64 20 5b 50 79 50 49 5d 28 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 6f 72 67 2f 70 72 6f 6a 65	nd.[PyPI](https://pypi.org/proje
34a0	63 74 2f 70 79 76 79 6f 73 2f 29 2e 00 52 65 66 65 72 65 6e 63 65 73 00 52 65 6d 6f 76 65 20 64	ct/pyvyos/)..References.Remove.d
34c0	65 66 61 75 6c 74 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65	efault.dhcp.client.on.first.inte
34e0	72 66 61 63 65 2c 20 61 6e 64 20 6c 6f 61 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74	rface,.and.load.other.configurat
3500	69 6f 6e 20 64 75 72 69 6e 67 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 75 73 69 6e 67 20 63 6c 6f	ion.during.first.boot,.using.clo
3520	75 64 2d 69 6e 69 74 2e 00 52 65 73 65 74 20 4f 62 6a 65 63 74 00 52 75 6e 20 61 6e 73 69 62 6c	ud-init..Reset.Object.Run.ansibl
3540	65 00 52 75 6e 20 63 6f 6d 6d 61 6e 64 73 20 72 65 6d 6f 74 65 6c 79 00 52 75 6e 20 63 6f 6e 66	e.Run.commands.remotely.Run.conf
3560	69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 00 52 75 6e 20 6f 70 65 72 61 74 69 6f 6e	iguration.commands.Run.operation
3580	61 6c 20 63 6f 6d 6d 61 6e 64 73 00 53 53 48 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 6f 6e	al.commands.SSH.is.configured.on
35a0	20 70 6f 72 74 20 32 32 2e 00 53 61 6c 74 00 53 61 6c 74 20 6d 61 73 74 65 72 20 63 6f 6e 66 69	.port.22..Salt.Salt.master.confi
35c0	67 75 72 61 74 69 6f 6e 3a 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67 75	guration:.Save.a.running.configu
35e0	72 61 74 69 6f 6e 20 74 6f 20 61 20 66 69 6c 65 2e 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67	ration.to.a.file..Save.a.running
3600	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 74 61 72 74 75 70 20 63 6f	.configuration.to.the.startup.co
3620	6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 57 68 65 6e 20 79 6f 75 20 64 6f 6e 27 74 20 73 70 65 63	nfiguration..When.you.don't.spec
3640	69 66 79 20 74 68 65 20 66 69 6c 65 20 77 68 65 6e 20 73 61 76 69 6e 67 2c 20 69 74 20 73 61 76	ify.the.file.when.saving,.it.sav
3660	65 73 20 74 6f 20 60 60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e 00 53	es.to.``/config/config.boot``..S
3680	63 72 69 70 74 20 76 79 6f 73 2d 6e 61 70 61 6c 6d 2e 70 79 00 53 63 72 69 70 74 73 20 61 72 65	cript.vyos-napalm.py.Scripts.are
36a0	20 72 75 6e 20 69 6e 20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64 65 72 2e 20 54 68 65 69	.run.in.alphabetical.order..Thei
36c0	72 20 6e 61 6d 65 73 20 6d 75 73 74 20 63 6f 6e 73 69 73 74 20 65 6e 74 69 72 65 6c 79 20 6f 66	r.names.must.consist.entirely.of
36e0	20 41 53 43 49 49 20 75 70 70 65 72 2d 20 61 6e 64 20 6c 6f 77 65 72 2d 63 61 73 65 20 6c 65 74	.ASCII.upper-.and.lower-case.let
3700	74 65 72 73 2c 41 53 43 49 49 20 64 69 67 69 74 73 2c 20 41 53 43 49 49 20 75 6e 64 65 72 73 63	ters,ASCII.digits,.ASCII.undersc
3720	6f 72 65 73 2c 20 61 6e 64 20 41 53 43 49 49 20 6d 69 6e 75 73 2d 68 79 70 68 65 6e 73 2e 4e 6f	ores,.and.ASCII.minus-hyphens.No
3740	20 6f 74 68 65 72 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 00 53	.other.characters.are.allowed..S
3760	68 6f 77 20 4f 62 6a 65 63 74 00 53 6f 6d 65 74 69 6d 65 73 20 79 6f 75 20 73 69 6d 70 6c 79 20	how.Object.Sometimes.you.simply.
3780	77 61 6e 27 74 20 74 6f 20 65 78 65 63 75 74 65 20 61 20 62 75 6e 63 68 20 6f 66 20 6f 70 2d 6d	wan't.to.execute.a.bunch.of.op-m
37a0	6f 64 65 20 63 6f 6d 6d 61 6e 64 73 20 76 69 61 20 53 53 48 20 6f 6e 20 61 20 72 65 6d 6f 74 65	ode.commands.via.SSH.on.a.remote
37c0	20 56 79 4f 53 20 73 79 73 74 65 6d 2e 00 53 74 6f 72 61 67 65 64 20 75 73 65 64 3a 20 76 6f 6c	.VyOS.system..Storaged.used:.vol
37e0	75 6d 65 20 6c 6f 63 61 6c 2c 20 77 68 69 63 68 20 69 73 20 6d 6f 75 6e 74 65 64 20 6f 6e 20 64	ume.local,.which.is.mounted.on.d
3800	69 72 65 63 74 6f 72 79 20 2a 2a 2f 76 61 72 2f 6c 69 62 2f 76 7a 2a 2a 2c 20 61 6e 64 20 63 6f	irectory.**/var/lib/vz**,.and.co
3820	6e 74 61 69 6e 73 20 61 6c 6c 20 74 79 70 65 20 6f 66 20 63 6f 6e 74 65 6e 74 2c 20 69 6e 63 6c	ntains.all.type.of.content,.incl
3840	75 64 69 6e 67 20 73 6e 69 70 70 65 74 73 2e 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 2f 73 72	uding.snippets..Structure.of./sr
3860	76 2f 73 61 6c 74 3a 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 66 69 6c 65 73 00 53 79 73 74 65	v/salt:.Structure.of.files.Syste
3880	6d 20 44 65 66 61 75 6c 74 73 2f 46 61 6c 6c 62 61 63 6b 73 00 54 68 65 20 41 50 49 20 70 75 73	m.Defaults/Fallbacks.The.API.pus
38a0	68 65 73 20 65 76 65 72 79 20 72 65 71 75 65 73 74 20 74 6f 20 61 20 73 65 73 73 69 6f 6e 20 61	hes.every.request.to.a.session.a
38c0	6e 64 20 63 6f 6d 6d 69 74 20 69 74 2e 20 42 75 74 20 73 6f 6d 65 20 6f 66 20 56 79 4f 53 20 63	nd.commit.it..But.some.of.VyOS.c
38e0	6f 6d 70 6f 6e 65 6e 74 73 20 6c 69 6b 65 20 44 48 43 50 20 61 6e 64 20 50 50 50 6f 45 20 53 65	omponents.like.DHCP.and.PPPoE.Se
3900	72 76 65 72 73 2c 20 49 50 53 65 63 2c 20 56 58 4c 41 4e 2c 20 61 6e 64 20 6f 74 68 65 72 20 74	rvers,.IPSec,.VXLAN,.and.other.t
3920	75 6e 6e 65 6c 73 20 72 65 71 75 69 72 65 20 66 75 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	unnels.require.full.configuratio
3940	6e 20 66 6f 72 20 63 6f 6d 6d 69 74 2e 20 54 68 65 20 65 6e 64 70 6f 69 6e 74 20 77 69 6c 6c 20	n.for.commit..The.endpoint.will.
3960	70 72 6f 63 65 73 73 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 79	process.multiple.commands.when.y
3980	6f 75 20 70 61 73 73 20 74 68 65 6d 20 61 73 20 61 20 6c 69 73 74 20 74 6f 20 74 68 65 20 60 60	ou.pass.them.as.a.list.to.the.``
39a0	64 61 74 61 60 60 20 66 69 65 6c 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69	data``.field..The.``/config/scri
39c0	70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70	pts/vyos-postconfig-bootup.scrip
39e0	74 60 60 20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 61 66 74	t``.script.is.called.on.boot.aft
3a00	65 72 20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 66 75 6c	er.the.VyOS.configuration.is.ful
3a20	6c 79 20 61 70 70 6c 69 65 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74	ly.applied..The.``/config/script
3a40	73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 60 60	s/vyos-preconfig-bootup.script``
3a60	20 73 63 72 69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 62 65 66 6f 72 65	.script.is.called.on.boot.before
3a80	20 74 68 65 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72 69 6e 67 20 62	.the.VyOS.configuration.during.b
3aa0	6f 6f 74 20 70 72 6f 63 65 73 73 2e 00 54 68 65 20 60 60 2f 73 68 6f 77 60 60 20 65 6e 64 70 6f	oot.process..The.``/show``.endpo
3ac0	69 6e 74 20 69 73 20 74 6f 20 73 68 6f 77 20 65 76 65 72 79 74 68 69 6e 67 20 69 6e 20 74 68 65	int.is.to.show.everything.in.the
3ae0	20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 6d 6f 64 65 2e 00 54 68 65 20 60 60 67 65 6e 65 72 61 74	.operational.mode..The.``generat
3b00	65 60 60 20 65 6e 64 70 6f 69 6e 74 20 72 75 6e 20 61 20 60 60 67 65 6e 65 72 61 74 65 60 60 20	e``.endpoint.run.a.``generate``.
3b20	63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 60 60 72 65 73 65 74 60 60 20 65 6e 64 70 6f 69 6e 74 20	command..The.``reset``.endpoint.
3b40	72 75 6e 20 61 20 60 60 72 65 73 65 74 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 63 6f 6d	run.a.``reset``.command..The.com
3b60	6d 61 6e 64 73 20 6c 69 73 74 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 60 60 73 68 6f	mands.list.produced.by.the.``sho
3b80	77 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 60 60 20 63 6f 6d 6d 61	w.configuration.commands``.comma
3ba0	6e 64 20 6f 6e 20 61 20 56 79 4f 53 20 72 6f 75 74 65 72 20 73 68 6f 75 6c 64 20 63 6f 6d 70 6c	nd.on.a.VyOS.router.should.compl
3bc0	79 20 77 69 74 68 20 61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f 20	y.with.all.the.requirements,.so.
3be0	69 74 20 69 73 20 65 61 73 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70 65 72 20 63 6f 6d 6d 61	it.is.easy.to.get.a.proper.comma
3c00	6e 64 73 20 6c 69 73 74 20 62 79 20 63 6f 70 79 69 6e 67 20 69 74 20 66 72 6f 6d 20 61 6e 6f 74	nds.list.by.copying.it.from.anot
3c20	68 65 72 20 72 6f 75 74 65 72 2e 00 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 70	her.router..The.configuration.sp
3c40	65 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75	ecified.in.the.cloud-config.docu
3c60	6d 65 6e 74 20 6f 76 65 72 77 72 69 74 65 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72	ment.overwrites.default.configur
3c80	61 74 69 6f 6e 20 76 61 6c 75 65 73 20 61 6e 64 20 76 61 6c 75 65 73 20 63 6f 6e 66 69 67 75 72	ation.values.and.values.configur
3ca0	65 64 20 76 69 61 20 4d 65 74 61 64 61 74 61 2e 00 54 68 65 20 64 65 66 61 75 6c 74 20 64 69 72	ed.via.Metadata..The.default.dir
3cc0	65 63 74 6f 72 69 65 73 20 77 68 65 72 65 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 53 63 72 69 70	ectories.where.your.custom.Scrip
3ce0	74 73 20 73 68 6f 75 6c 64 20 62 65 20 6c 6f 63 61 74 65 64 20 61 72 65 3a 00 54 68 65 20 64 65	ts.should.be.located.are:.The.de
3d00	66 61 75 6c 74 20 66 69 6c 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 68 65 20	fault.file.looks.like.this:.The.
3d20	65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73	easiest.way.to.configure.the.sys
3d40	74 65 6d 20 76 69 61 20 75 73 65 72 2d 64 61 74 61 20 69 73 20 74 68 65 20 43 6c 6f 75 64 2d 63	tem.via.user-data.is.the.Cloud-c
3d60	6f 6e 66 69 67 20 73 79 6e 74 61 78 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 00 54 68	onfig.syntax.described.below..Th
3d80	65 20 65 6e 64 70 6f 69 6e 74 20 60 60 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 60 60 20 69 73 20 74	e.endpoint.``/config-file``.is.t
3da0	6f 20 73 61 76 65 20 6f 72 20 6c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00	o.save.or.load.a.configuration..
3dc0	54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 20 73 65 74 73 20 74 68 65 20 68	The.following.example.sets.the.h
3de0	6f 73 74 6e 61 6d 65 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 69 6e 73 74 61 6e 63 65 20 69 64	ostname.based.on.the.instance.id
3e00	65 6e 74 69 66 69 65 72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 45 43 32 20 6d	entifier.obtained.from.the.EC2.m
3e20	65 74 61 64 61 74 61 20 73 65 72 76 69 63 65 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65	etadata.service..The.following.e
3e40	78 61 6d 70 6c 65 20 73 68 6f 77 73 20 68 6f 77 20 74 6f 20 65 78 65 63 75 74 65 20 63 6f 6d 6d	xample.shows.how.to.execute.comm
3e60	61 6e 64 73 20 61 66 74 65 72 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 66 69 67 75 72 61	ands.after.the.initial.configura
3e80	74 69 6f 6e 2e 00 54 68 65 20 6b 65 79 20 75 73 65 64 20 74 6f 20 64 65 73 69 67 6e 61 74 65 20	tion..The.key.used.to.designate.
3ea0	61 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 60 60 76 79 6f 73 5f 63	a.VyOS.configuration.is.``vyos_c
3ec0	6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 2e 20 57 68 61 74 20 66 6f 6c 6c 6f 77 73 20 69	onfig_commands``..What.follows.i
3ee0	73 20 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 22	s.VyOS.configuration.using.the."
3f00	73 65 74 2d 73 74 79 6c 65 22 20 73 79 6e 74 61 78 2e 20 42 6f 74 68 20 22 73 65 74 22 20 61 6e	set-style".syntax..Both."set".an
3f20	64 20 22 64 65 6c 65 74 65 22 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 73 75 70 70 6f 72 74 65	d."delete".commands.are.supporte
3f40	64 2e 00 54 68 65 20 73 65 65 64 2e 69 73 6f 20 66 69 6c 65 20 63 61 6e 20 62 65 20 61 74 74 61	d..The.seed.iso.file.can.be.atta
3f60	63 68 65 64 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 41 73 20	ched.to.the.virtual.machine..As.
3f80	61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 77 69 74 68 20 4b 56 4d 20	an.example,.the.method.with.KVM.
3fa0	74 6f 20 61 74 74 61 63 68 20 74 68 65 20 49 53 4f 20 61 73 20 61 20 43 44 20 64 72 69 76 65 20	to.attach.the.ISO.as.a.CD.drive.
3fc0	66 6f 6c 6c 6f 77 73 2e 00 54 68 65 72 65 20 69 73 20 61 20 70 69 74 66 61 6c 6c 20 77 68 65 6e	follows..There.is.a.pitfall.when
3fe0	20 77 6f 72 6b 69 6e 67 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69	.working.with.configuration.scri
4000	70 74 73 2e 20 49 74 20 69 73 20 74 65 6d 70 74 69 6e 67 20 74 6f 20 63 61 6c 6c 20 63 6f 6e 66	pts..It.is.tempting.to.call.conf
4020	69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 20 77 69 74 68 20 22 73 75 64 6f 22 20 28 69	iguration.scripts.with."sudo".(i
4040	2e 65 2e 2c 20 74 65 6d 70 6f 72 61 72 79 20 72 6f 6f 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 29	.e.,.temporary.root.permissions)
4060	2c 20 62 65 63 61 75 73 65 20 74 68 61 74 27 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 77 61 79 20	,.because.that's.the.common.way.
4080	6f 6e 20 6d 6f 73 74 20 4c 69 6e 75 78 20 70 6c 61 74 66 6f 72 6d 73 20 74 6f 20 63 61 6c 6c 20	on.most.Linux.platforms.to.call.
40a0	73 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 73 2e 00 54 68 65 73 65 20 61 72 65 20 74 68 65 20 56	system.commands..These.are.the.V
40c0	79 4f 53 20 64 65 66 61 75 6c 74 73 20 61 6e 64 20 66 61 6c 6c 62 61 63 6b 73 2e 00 54 68 69 73	yOS.defaults.and.fallbacks..This
40e0	20 73 65 63 74 69 6f 6e 20 6e 65 65 64 73 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 2c 20 65 78 61	.section.needs.improvements,.exa
4100	6d 70 6c 65 73 20 61 6e 64 20 65 78 70 6c 61 6e 61 74 69 6f 6e 73 2e 00 54 68 69 73 20 77 69 6c	mples.and.explanations..This.wil
4120	6c 20 72 65 73 75 6c 74 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 20	l.result.in.the.following.error.
4140	6d 65 73 73 61 67 65 3a 20 60 60 53 65 74 20 66 61 69 6c 65 64 60 60 20 49 66 20 74 68 69 73 20	message:.``Set.failed``.If.this.
4160	68 61 70 70 65 6e 73 2c 20 61 20 72 65 62 6f 6f 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f	happens,.a.reboot.is.required.to
4180	20 62 65 20 61 62 6c 65 20 74 6f 20 65 64 69 74 20 74 68 65 20 63 6f 6e 66 69 67 20 6d 61 6e 75	.be.able.to.edit.the.config.manu
41a0	61 6c 6c 79 20 61 67 61 69 6e 2e 00 54 6f 20 4c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74	ally.again..To.Load.a.configurat
41c0	69 6f 6e 20 66 69 6c 65 2e 00 54 6f 20 61 64 64 20 6f 72 20 64 65 6c 65 74 65 20 61 6e 20 69 6d	ion.file..To.add.or.delete.an.im
41e0	61 67 65 2c 20 75 73 65 20 74 68 65 20 60 60 2f 69 6d 61 67 65 60 60 20 65 6e 64 70 6f 69 6e 74	age,.use.the.``/image``.endpoint
4200	2e 00 54 6f 20 61 76 6f 69 64 20 74 68 65 73 65 20 70 72 6f 62 6c 65 6d 73 2c 20 74 68 65 20 70	..To.avoid.these.problems,.the.p
4220	72 6f 70 65 72 20 77 61 79 20 69 73 20 74 6f 20 63 61 6c 6c 20 61 20 73 63 72 69 70 74 20 77 69	roper.way.is.to.call.a.script.wi
4240	74 68 20 74 68 65 20 60 60 76 79 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 65 2e 67 2e	th.the.``vyattacfg``.group,.e.g.
4260	2c 20 62 79 20 75 73 69 6e 67 20 74 68 65 20 60 60 73 67 60 60 20 28 73 77 69 74 63 68 20 67 72	,.by.using.the.``sg``.(switch.gr
4280	6f 75 70 29 20 63 6f 6d 6d 61 6e 64 3a 00 54 6f 20 67 65 74 20 74 68 65 20 77 68 6f 6c 65 20 63	oup).command:.To.get.the.whole.c
42a0	6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 70 61 73 73 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 74	onfiguration,.pass.an.empty.list
42c0	20 74 6f 20 74 68 65 20 60 60 70 61 74 68 60 60 20 66 69 65 6c 64 00 54 6f 20 69 6e 63 6c 75 64	.to.the.``path``.field.To.includ
42e0	65 20 56 79 4f 53 20 73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20 61 6c	e.VyOS.specific.functions.and.al
4300	69 61 73 65 73 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 60 60 73 6f 75 72 63 65 20 2f 6f 70 74 2f	iases.you.need.to.``source./opt/
4320	76 79 61 74 74 61 2f 65 74 63 2f 66 75 6e 63 74 69 6f 6e 73 2f 73 63 72 69 70 74 2d 74 65 6d 70	vyatta/etc/functions/script-temp
4340	6c 61 74 65 60 60 20 66 69 6c 65 73 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 79 6f 75 72 20	late``.files.at.the.top.of.your.
4360	73 63 72 69 70 74 2e 00 54 6f 20 69 6e 69 74 69 61 74 65 20 61 20 72 65 62 6f 6f 74 20 75 73 65	script..To.initiate.a.reboot.use
4380	20 74 68 65 20 60 60 72 65 62 6f 6f 74 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 6f 20 6d 61 6b	.the.``reboot``.endpoint..To.mak
43a0	65 20 73 75 72 65 20 74 68 61 74 20 61 20 73 63 72 69 70 74 20 69 73 20 6e 6f 74 20 61 63 63 69	e.sure.that.a.script.is.not.acci
43c0	64 65 6e 74 61 6c 6c 79 20 63 61 6c 6c 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 60 60 76 79	dentally.called.without.the.``vy
43e0	61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 74 68 65 20 73 63 72 69 70 74 20 63 61 6e 20	attacfg``.group,.the.script.can.
4400	62 65 20 73 61 66 65 67 75 61 72 64 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 6f 20 6f 6e 6c	be.safeguarded.like.this:.To.onl
4420	79 20 67 65 74 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	y.get.a.part.of.the.configuratio
4440	6e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 73 79 73 74 65 6d 20 73 79 73 6c 6f 67 60 60	n,.for.example.``system.syslog``
4460	2e 00 54 6f 20 70 6f 77 65 72 20 6f 66 66 20 74 68 65 20 73 79 73 74 65 6d 20 75 73 65 20 74 68	..To.power.off.the.system.use.th
4480	65 20 60 60 70 6f 77 65 72 6f 66 66 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 72 6f 75 62 6c 65	e.``poweroff``.endpoint..Trouble
44a0	73 68 6f 6f 74 69 6e 67 00 55 6e 6c 69 6b 65 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 75	shooting.Unlike.a.normal.configu
44c0	72 61 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 61 6c 6c 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20	ration.session,.all.operational.
44e0	63 6f 6d 6d 61 6e 64 73 20 6d 75 73 74 20 62 65 20 70 72 65 70 65 6e 64 65 64 20 77 69 74 68 20	commands.must.be.prepended.with.
4500	60 60 72 75 6e 60 60 2c 20 65 76 65 6e 20 69 66 20 79 6f 75 20 68 61 76 65 6e 27 74 20 63 72 65	``run``,.even.if.you.haven't.cre
4520	61 74 65 64 20 61 20 73 65 73 73 69 6f 6e 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 65 2e 00 55	ated.a.session.with.configure..U
4540	73 65 72 2d 64 61 74 61 00 55 73 65 72 2d 64 61 74 61 20 2d 20 55 73 65 72 2d 64 61 74 61 20 69	ser-data.User-data.-.User-data.i
4560	73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 75 73 65 72 2e 20 54 68 69 73 20 63 6f	s.specified.by.the.user..This.co
4580	6e 66 69 67 20 73 6f 75 72 63 65 20 6f 66 66 65 72 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74	nfig.source.offers.the.ability.t
45a0	6f 20 69 6e 73 65 72 74 20 61 6e 79 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63	o.insert.any.CLI.configuration.c
45c0	6f 6d 6d 61 6e 64 73 20 69 6e 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 62	ommands.into.the.configuration.b
45e0	65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 55 73 69 6e 67 20 41 50 49 20	efore.the.first.boot..Using.API.
4600	52 65 73 70 6f 6e 73 65 20 43 6c 61 73 73 00 55 73 69 6e 67 20 50 79 56 79 4f 53 00 56 4d 20 49	Response.Class.Using.PyVyOS.VM.I
4620	44 3a 20 69 6e 20 74 68 69 73 20 65 78 61 6d 70 6c 65 2c 20 56 4d 20 49 44 20 75 73 65 64 20 69	D:.in.this.example,.VM.ID.used.i
4640	73 20 35 35 35 2e 00 56 4d 20 52 65 73 6f 75 72 63 65 73 3a 20 74 68 65 73 65 20 70 61 72 61 6d	s.555..VM.Resources:.these.param
4660	65 74 65 72 73 20 63 61 6e 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 73 20 6e 65 65 64 65 64 2e	eters.can.be.modified.as.needed.
4680	00 56 4d 20 53 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 73	.VM.Storage:.``local``.volume.is
46a0	20 75 73 65 64 2e 00 56 79 4f 53 20 41 50 49 00 56 79 4f 53 20 41 75 74 6f 6d 61 74 69 6f 6e 00	.used..VyOS.API.VyOS.Automation.
46c0	56 79 4f 53 20 60 63 6c 6f 75 64 2d 69 6e 69 74 2d 64 6f 63 73 60 5f 2e 00 56 79 4f 53 20 63 6c	VyOS.`cloud-init-docs`_..VyOS.cl
46e0	6f 75 64 2d 69 6e 69 74 00 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d	oud-init.VyOS.configuration.comm
4700	61 6e 64 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20 66 69	ands.are.defined.in.user-data.fi
4720	6c 65 2e 00 56 79 4f 53 20 68 61 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 72 75 6e 20	le..VyOS.has.the.ability.to.run.
4740	63 75 73 74 6f 6d 20 20 73 63 72 69 70 74 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72	custom..scripts.before.and.after
4760	20 65 61 63 68 20 63 6f 6d 6d 69 74 00 56 79 4f 53 20 73 75 70 70 6f 72 74 20 74 68 72 65 65 20	.each.commit.VyOS.support.three.
4780	74 79 70 65 73 20 6f 66 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 73 2e 00 56 79 4f 53 20 73 75	types.of.config.sources..VyOS.su
47a0	70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 61 6e 73 69 62 6c 65	pports.configuration.via.ansible
47c0	2e 20 4e 65 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 61 6e 73 69 62 6c 65 60 60 20 61 6e	..Need.to.install.``ansible``.an
47e0	64 20 60 60 70 79 74 68 6f 6e 33 2d 70 61 72 61 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 00 56 79	d.``python3-paramiko``.module.Vy
4800	4f 53 20 73 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 6e 65	OS.supports.configuration.via.ne
4820	74 6d 69 6b 6f 5f 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60	tmiko_..It.requires.to.install.`
4840	60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 2e 00 56 79 4f 53 20	`python3-netmiko``.module..VyOS.
4860	73 75 70 70 6f 72 74 73 20 65 78 65 63 75 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	supports.executing.configuration
4880	20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 6e 2d 69 6e	.and.operational.commands.non-in
48a0	74 65 72 61 63 74 69 76 65 6c 79 20 66 72 6f 6d 20 73 68 65 6c 6c 20 73 63 72 69 70 74 73 2e 00	teractively.from.shell.scripts..
48c0	56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d 6f 64 65 20 61 6e 64 20 63 6f 6e 66 69 67	VyOS.supports.op-mode.and.config
48e0	75 72 61 74 69 6f 6e 20 76 69 61 20 73 61 6c 74 5f 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73	uration.via.salt_..VyOS.supports
4900	20 73 6f 6d 65 20 6e 61 70 61 6c 6d 5f 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 66	.some.napalm_.functions.for.conf
4920	69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 2d 6d 6f 64 65 2e 20 49 74 20 72 65 71 75 69 72	iguration.and.op-mode..It.requir
4940	65 73 20 6d 6f 72 65 20 74 65 73 74 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 74 68 65	es.more.tests..VyOS.supports.the
4960	20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e	.execution.of.operational.comman
4980	64 73 20 61 6e 64 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 69 6e 69 74 69 61 6c	ds.and.linux.commands.at.initial
49a0	20 62 6f 6f 74 2e 20 54 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e	.boot..This.is.accomplished.usin
49c0	67 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 74 6f 20 63 65 72 74 61 69 6e 20 66 69 6c	g.``write_files``.to.certain.fil
49e0	65 73 20 69 6e 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67	es.in.the./opt/vyatta/etc/config
4a00	2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 2e 20 43 6f 6d 6d 61 6e 64 73 20 73 70 65	/scripts.directory..Commands.spe
4a20	63 69 66 69 65 64 20 69 6e 20 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f	cified.in.opt/vyatta/etc/config/
4a40	73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63	scripts/vyos-preconfig-bootup.sc
4a60	72 69 70 74 20 61 72 65 20 65 78 65 63 75 74 65 64 20 70 72 69 6f 72 20 74 6f 20 63 6f 6e 66 69	ript.are.executed.prior.to.confi
4a80	67 75 72 61 74 69 6f 6e 2e 20 54 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f	guration..The./opt/vyatta/etc/co
4aa0	6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f	nfig/scripts/vyos-postconfig-boo
4ac0	74 75 70 2e 73 63 72 69 70 74 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6d 6d 61 6e 64	tup.script.file.contains.command
4ae0	73 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 61 66 74 65 72 20 63 6f 6e 66 69 67 75 72 61	s.to.be.executed.after.configura
4b00	74 69 6f 6e 2e 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 20 61 72	tion..In.both.cases,.commands.ar
4b20	65 20 65 78 65 63 75 74 65 64 20 61 73 20 74 68 65 20 72 6f 6f 74 20 75 73 65 72 2e 00 57 65 20	e.executed.as.the.root.user..We.
4b40	6e 65 65 64 20 32 20 66 69 6c 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 20 61 6e 64 20	need.2.files,.commands.conf.and.
4b60	73 63 72 69 70 74 20 69 74 73 65 6c 66 2e 00 57 68 69 6c 65 20 6f 74 68 65 72 20 6d 65 74 68 6f	script.itself..While.other.metho
4b80	64 73 20 65 78 69 73 74 2c 20 74 68 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68 74 66 6f 72 77 61	ds.exist,.the.most.straightforwa
4ba0	72 64 20 6d 65 74 68 6f 64 20 66 6f 72 20 75 73 69 6e 67 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20	rd.method.for.using.the.NoCloud.
4bc0	64 61 74 61 20 73 6f 75 72 63 65 20 69 73 20 63 72 65 61 74 69 6e 67 20 61 20 73 65 65 64 20 49	data.source.is.creating.a.seed.I
4be0	53 4f 20 61 6e 64 20 61 74 74 61 63 68 69 6e 67 20 69 74 20 74 6f 20 74 68 65 20 76 69 72 74 75	SO.and.attaching.it.to.the.virtu
4c00	61 6c 20 6d 61 63 68 69 6e 65 20 61 73 20 61 20 43 44 20 64 72 69 76 65 2e 20 54 68 65 20 76 6f	al.machine.as.a.CD.drive..The.vo
4c20	6c 75 6d 65 20 6d 75 73 74 20 62 65 20 66 6f 72 6d 61 74 74 65 64 20 61 73 20 61 20 76 66 61 74	lume.must.be.formatted.as.a.vfat
4c40	20 6f 72 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 20 77 69 74 68 20 74 68	.or.ISO.9660.file.system.with.th
4c60	65 20 6c 61 62 65 6c 20 22 63 69 64 61 74 61 22 20 6f 72 20 22 43 49 44 41 54 41 22 2e 00 57 69	e.label."cidata".or."CIDATA"..Wi
4c80	6c 6c 20 72 65 74 75 72 6e 3a 00 57 69 74 68 20 74 68 65 20 60 60 72 65 74 72 69 65 76 65 60 60	ll.return:.With.the.``retrieve``
4ca0	20 65 6e 64 70 6f 69 6e 74 20 79 6f 75 20 67 65 74 20 70 61 72 74 73 20 6f 72 20 74 68 65 20 77	.endpoint.you.get.parts.or.the.w
4cc0	68 6f 6c 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 57 69 74 68 6f 75 74 20 70 72 6f 78	hole.configuration..Without.prox
4ce0	79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67	y.it.requires.VyOS.minion.config
4d00	75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 74 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61	uration.and.support.op-mode.data
4d20	3a 00 57 69 74 68 6f 75 74 20 70 72 6f 78 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53	:.Without.proxy.it.requires.VyOS
4d40	20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72	.minion.configuration.and.suppor
4d60	74 73 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 59 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c 6c	ts.op-mode.data:.You.can.install
4d80	20 50 79 56 79 4f 53 20 75 73 69 6e 67 20 70 69 70 3a 00 59 6f 75 20 63 61 6e 20 70 61 73 73 20	.PyVyOS.using.pip:.You.can.pass.
4da0	61 20 60 60 73 65 74 60 60 2c 20 60 60 64 65 6c 65 74 65 60 60 20 6f 72 20 60 60 63 6f 6d 6d 65	a.``set``,.``delete``.or.``comme
4dc0	6e 74 60 60 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 74 68 65 20 60 60 2f 63 6f 6e 66 69 67 75 72 65	nt``.command.to.the.``/configure
4de0	60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 60 60 64 65 6c 65 74 65 60 60 20 61 20 73 69 6e 67 6c 65	``.endpoint..``delete``.a.single
4e00	20 63 6f 6d 6d 61 6e 64 00 60 60 73 65 65 64 2e 69 73 6f 60 60 20 77 61 73 20 70 72 65 76 69 6f	.command.``seed.iso``.was.previo
4e20	75 73 6c 79 20 63 72 65 61 74 65 64 20 69 6e 20 64 69 72 65 63 74 6f 72 79 20 60 60 2f 74 6d 70	usly.created.in.directory.``/tmp
4e40	2f 60 60 2e 20 49 74 27 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 69 74 20 74	/``..It's.necessary.to.move.it.t
4e60	6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 2f 74 65 6d 70 6c 61 74 65 2f 69 73 6f 60 60 00 60	o.``/var/lib/vz/template/iso``.`
4e80	60 73 65 74 60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 00 60 60 76 79 6f 73 5f 75	`set``.a.single.command.``vyos_u
4ea0	73 65 72 64 61 74 61 60 60 20 2d 20 74 68 65 20 6d 6f 64 75 6c 65 20 61 63 63 65 70 74 73 20 61	serdata``.-.the.module.accepts.a
4ec0	20 6c 69 73 74 20 6f 66 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61	.list.of.CLI.configuration.comma
4ee0	6e 64 73 20 69 6e 20 61 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60	nds.in.a.``vyos_config_commands`
4f00	60 20 73 65 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 67 69 76 65 73 20 61 6e 20 65 61 73 79 20 77	`.section,.which.gives.an.easy.w
4f20	61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 64 75 72 69 6e	ay.to.configure.the.system.durin
4f40	67 20 64 65 70 6c 6f 79 6d 65 6e 74 2e 00 60 60 76 79 6f 73 60 60 2f 60 60 76 79 6f 73 60 60 20	g.deployment..``vyos``/``vyos``.
4f60	63 72 65 64 65 6e 74 69 61 6c 73 20 69 66 20 6e 6f 20 6f 74 68 65 72 73 20 73 70 65 63 69 66 69	credentials.if.no.others.specifi
4f80	65 64 20 62 79 20 64 61 74 61 20 73 6f 75 72 63 65 2e 00 60 60 77 72 69 74 65 5f 66 69 6c 65 73	ed.by.data.source..``write_files
4fa0	60 60 20 2d 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f 77 73 20 74 6f 20 69 6e 73 65 72	``.-.this.module.allows.to.inser
4fc0	74 20 61 6e 79 20 66 69 6c 65 73 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20	t.any.files.into.the.filesystem.
4fe0	62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 66 6f 72 20 65 78 61 6d 70	before.the.first.boot,.for.examp
5000	6c 65 2c 20 70 72 65 2d 67 65 6e 65 72 61 74 65 64 20 65 6e 63 72 79 70 74 69 6f 6e 20 6b 65 79	le,.pre-generated.encryption.key
5020	73 2c 20 63 65 72 74 69 66 69 63 61 74 65 73 2c 20 6f 72 20 65 76 65 6e 20 61 20 77 68 6f 6c 65	s,.certificates,.or.even.a.whole
5040	20 60 60 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 20 66 69 6c 65 2e 20 54 68 65 20 66 6f 72 6d 61	.``config.boot``.file..The.forma
5060	74 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 69 6e 69 74 20	t.is.described.in.the.cloudinit.
5080	64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 77 72 69 74 65 5f	documentation.`Cloud-init-write_
50a0	66 69 6c 65 73 60 5f 2e 00 61 64 64 20 61 6e 20 69 6d 61 67 65 00 61 6e 73 69 62 6c 65 2e 63 66	files`_..add.an.image.ansible.cf
50c0	67 00 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 74 00 63 6c 6f 75 64	g.cloud-config.file.format.cloud
50e0	2d 69 6e 69 74 20 6c 6f 67 73 20 74 6f 20 2f 76 61 72 2f 6c 6f 67 2f 63 6c 6f 75 64 2d 69 6e 69	-init.logs.to./var/log/cloud-ini
5100	74 2e 6c 6f 67 2e 20 54 68 69 73 20 66 69 6c 65 20 63 61 6e 20 62 65 20 68 65 6c 70 66 75 6c 20	t.log..This.file.can.be.helpful.
5120	69 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 79 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61	in.determining.why.the.configura
5140	74 69 6f 6e 20 76 61 72 69 65 73 20 66 72 6f 6d 20 77 68 61 74 20 79 6f 75 20 65 78 70 65 63 74	tion.varies.from.what.you.expect
5160	2e 20 59 6f 75 20 63 61 6e 20 66 65 74 63 68 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 61	..You.can.fetch.the.most.importa
5180	6e 74 20 64 61 74 61 20 66 69 6c 74 65 72 69 6e 67 20 6f 75 74 70 75 74 20 66 6f 72 20 60 60 76	nt.data.filtering.output.for.``v
51a0	79 6f 73 60 60 20 6b 65 79 77 6f 72 64 3a 00 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 00 64 65 6c 65	yos``.keyword:.commands.txt.dele
51c0	74 65 20 61 6e 20 69 6d 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 31 2e 33 2d 72	te.an.image,.for.example.``1.3-r
51e0	6f 6c 6c 69 6e 67 2d 32 30 32 30 30 36 30 37 30 31 31 37 60 60 00 68 6f 73 74 73 00 69 64 5f 72	olling-202006070117``.hosts.id_r
5200	73 61 5f 64 6f 63 6b 65 72 2e 70 75 62 2e 20 4e 65 65 64 73 20 74 6f 20 64 65 63 6c 61 72 65 20	sa_docker.pub..Needs.to.declare.
5220	6f 6e 6c 79 20 70 75 62 6c 69 63 20 6b 65 79 20 65 78 61 63 74 6c 79 2e 00 69 66 20 79 6f 75 20	only.public.key.exactly..if.you.
5240	6a 75 73 74 20 77 61 6e 74 20 74 68 65 20 56 61 6c 75 65 20 6f 66 20 61 20 6d 75 6c 74 69 2d 76	just.want.the.Value.of.a.multi-v
5260	61 6c 75 65 64 20 6e 6f 64 65 2c 20 75 73 65 20 74 68 65 20 60 60 72 65 74 75 72 6e 56 61 6c 75	alued.node,.use.the.``returnValu
5280	65 73 60 60 20 6f 70 65 72 61 74 69 6f 6e 2e 00 6d 61 69 6e 2e 79 6d 6c 00 72 31 31 2d 70 72 6f	es``.operation..main.yml.r11-pro
52a0	78 79 2e 73 6c 73 20 49 6e 63 6c 75 64 65 73 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72 20 63	xy.sls.Includes.parameters.for.c
52c0	6f 6e 6e 65 63 74 69 6e 67 20 74 6f 20 73 61 6c 74 2d 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 00 73	onnecting.to.salt-proxy.minion.s
52e0	74 61 72 74 75 70 20 73 63 72 69 70 74 73 00 74 6f 70 2e 73 6c 73 00 4d 49 4d 45 2d 56 65 72 73	tartup.scripts.top.sls.MIME-Vers
5300	69 6f 6e 3a 20 31 2e 30 0a 43 6f 6e 74 65 6e 74 2d 54 79 70 65 3a 20 74 65 78 74 2f 70 6c 61 69	ion:.1.0.Content-Type:.text/plai
5320	6e 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38 0a 43 6f 6e 74 65 6e 74 2d 54 72 61 6e 73 66 65	n;.charset=UTF-8.Content-Transfe
5340	72 2d 45 6e 63 6f 64 69 6e 67 3a 20 38 62 69 74 0a 58 2d 47 65 6e 65 72 61 74 6f 72 3a 20 4c 6f	r-Encoding:.8bit.X-Generator:.Lo
5360	63 61 6c 61 7a 79 20 28 68 74 74 70 73 3a 2f 2f 6c 6f 63 61 6c 61 7a 79 2e 63 6f 6d 29 0a 50 72	calazy.(https://localazy.com).Pr
5380	6f 6a 65 63 74 2d 49 64 2d 56 65 72 73 69 6f 6e 3a 20 0a 4c 61 6e 67 75 61 67 65 3a 20 65 6e 0a	oject-Id-Version:..Language:.en.
53a0	50 6c 75 72 61 6c 2d 46 6f 72 6d 73 3a 20 6e 70 6c 75 72 61 6c 73 3d 32 3b 20 70 6c 75 72 61 6c	Plural-Forms:.nplurals=2;.plural
53c0	3d 28 6e 3d 3d 31 29 20 3f 20 30 20 3a 20 31 3b 0a 00 2a 2a 4e 4f 54 45 2a 2a 3a 20 62 65 20 63	=(n==1).?.0.:.1;..**NOTE**:.be.c
53e0	61 72 65 66 75 6c 6c 20 77 68 69 6c 65 20 63 6f 70 79 69 6e 67 20 61 6e 64 20 70 61 73 74 69 6e	arefull.while.copying.and.pastin
5400	67 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 73 2e 20 44 6f 62 6c 65 20 71 75 6f 74 65	g.previous.commands..Doble.quote
5420	73 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 63 6f 72 72 65 63 74 65 64 2e 00 2a 2a 6d 65	s.may.need.to.be.corrected..**me
5440	74 61 2d 64 61 74 61 2a 2a 3a 20 65 6d 70 74 79 20 66 69 6c 65 20 28 72 65 71 75 69 72 65 64 29	ta-data**:.empty.file.(required)
5460	2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2a 2a 20 66 69 6c 65 20 6f 6e 6c 79 20 68	..**network-config**.file.only.h
5480	61 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 68 61 74 20 64 69 73 61 62 6c 65 73 20 74	as.configuration.that.disables.t
54a0	68 65 20 61 75 74 6f 6d 61 74 69 63 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73	he.automatic.dhcp.client.on.firs
54c0	74 20 69 6e 74 65 72 66 61 63 65 2e 00 2a 2a 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2a 2a 3a	t.interface..**network-config**:
54e0	20 66 69 6c 65 20 74 68 61 74 20 77 69 6c 6c 20 69 6e 64 69 63 61 74 65 20 74 6f 20 61 76 6f 69	.file.that.will.indicate.to.avoi
5500	64 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65	d.dhcp.client.on.first.interface
5520	2e 00 2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 20 66 69 6c 65 20 6d 75 73 74 20 73 74 61 72 74 20	..**user-data**.file.must.start.
5540	77 69 74 68 20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 61 6e 64 20 63 6f 6e 74 61	with.``#cloud-config``.and.conta
5560	69 6e 73 20 76 79 6f 73 2d 63 6f 6d 6d 61 6e 64 73 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 00	ins.vyos-commands..For.example:.
5580	2a 2a 75 73 65 72 2d 64 61 74 61 2a 2a 3a 20 69 6e 63 6c 75 64 65 73 20 76 79 6f 73 2d 63 6f 6d	**user-data**:.includes.vyos-com
55a0	6d 61 6e 64 73 2e 00 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 00 2f 63 6f 6e 66 69 67 75 72 65 00 2f	mands../config-file./configure./
55c0	67 65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 70 6f 77 65 72 6f 66 66 00 2f 72 65 62 6f 6f	generate./image./poweroff./reboo
55e0	74 00 2f 72 65 73 65 74 00 2f 72 65 74 72 69 65 76 65 00 2f 73 68 6f 77 00 41 20 56 79 4f 53 20	t./reset./retrieve./show.A.VyOS.
5600	71 63 6f 77 20 69 6d 61 67 65 20 77 69 74 68 20 63 6c 6f 75 64 2d 69 6e 69 74 20 6f 70 74 69 6f	qcow.image.with.cloud-init.optio
5620	6e 73 20 69 73 20 6e 65 65 64 65 64 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 6f 62 74 61 69 6e	ns.is.needed..This.can.be.obtain
5640	65 64 20 75 73 69 6e 67 20 60 76 79 6f 73 2d 76 6d 2d 69 6d 61 67 65 73 60 5f 20 72 65 70 6f 2e	ed.using.`vyos-vm-images`_.repo.
5660	20 41 66 74 65 72 20 63 6c 6f 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6f 2c 20 65 64 69 74 20 74	.After.clonning.the.repo,.edit.t
5680	68 65 20 66 69 6c 65 20 2a 2a 71 65 6d 75 2e 79 6d 6c 2a 2a 20 61 6e 64 20 63 6f 6d 6d 65 6e 74	he.file.**qemu.yml**.and.comment
56a0	20 74 68 65 20 2a 2a 64 6f 77 6e 6c 6f 61 64 2d 69 73 6f 2a 2a 20 72 6f 6c 65 2e 00 41 20 63 6c	.the.**download-iso**.role..A.cl
56c0	6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 77 72 69 74 74 65 6e 20 69	oud-config.document.is.written.i
56e0	6e 20 59 41 4d 4c 2e 20 54 68 65 20 66 69 6c 65 20 6d 75 73 74 20 62 65 67 69 6e 20 77 69 74 68	n.YAML..The.file.must.begin.with
5700	20 60 60 23 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 60 60 20 6c 69 6e 65 2e 20 54 68 65 20 6f 6e 6c	.``#cloud-config``.line..The.onl
5720	79 20 73 75 70 70 6f 72 74 65 64 20 74 6f 70 2d 6c 65 76 65 6c 20 6b 65 79 73 20 61 72 65 20 60	y.supported.top-level.keys.are.`
5740	60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 61 6e 64 20 60 60 77 72	`vyos_config_commands``.and.``wr
5760	69 74 65 5f 66 69 6c 65 73 60 60 2e 20 54 68 65 20 75 73 65 20 6f 66 20 74 68 65 73 65 20 6b 65	ite_files``..The.use.of.these.ke
5780	79 73 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67	ys.is.described.in.the.following
57a0	20 74 77 6f 20 73 65 63 74 69 6f 6e 73 2e 00 41 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 20	.two.sections..A.simple.example.
57c0	69 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2c 20 77 68 65 72 65 20 74 68 65 20 6f 70 73 20 63 6f	is.shown.below,.where.the.ops.co
57e0	6d 6d 61 6e 64 20 65 78 65 63 75 74 65 64 20 69 6e 20 74 68 65 20 70 6f 73 74 2d 68 6f 6f 6b 20	mmand.executed.in.the.post-hook.
5800	73 63 72 69 70 74 20 69 73 20 22 73 68 6f 77 20 69 6e 74 65 72 66 61 63 65 73 22 2e 00 41 20 73	script.is."show.interfaces"..A.s
5820	69 6e 67 6c 65 2d 71 75 6f 74 65 20 73 79 6d 62 6f 6c 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65	ingle-quote.symbol.is.not.allowe
5840	64 20 69 6e 73 69 64 65 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 76 61 6c 75 65 2e 00 41 50 49 20 45	d.inside.command.or.value..API.E
5860	6e 64 70 6f 69 6e 74 73 00 41 63 63 65 70 74 20 6d 69 6e 69 6f 6e 20 6b 65 79 00 41 6c 6c 20 65	ndpoints.Accept.minion.key.All.e
5880	6e 64 70 6f 69 6e 74 73 20 6f 6e 6c 79 20 6c 69 73 74 65 6e 20 6f 6e 20 48 54 54 50 20 50 4f 53	ndpoints.only.listen.on.HTTP.POS
58a0	54 20 72 65 71 75 65 73 74 73 20 61 6e 64 20 74 68 65 20 41 50 49 20 4b 45 59 20 6d 75 73 74 20	T.requests.and.the.API.KEY.must.
58c0	73 65 74 20 61 73 20 60 60 6b 65 79 60 60 20 69 6e 20 74 68 65 20 66 6f 72 6d 64 61 74 61 2e 00	set.as.``key``.in.the.formdata..
58e0	41 6c 6c 20 6f 66 20 74 68 65 73 65 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 75	All.of.these.can.be.overridden.u
5900	73 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e 20 75 73 65 72 2d 64	sing.the.configuration.in.user-d
5920	61 74 61 2e 00 41 6c 73 6f 2c 20 74 68 69 73 20 6c 61 62 20 63 6f 6e 73 69 64 65 72 73 3a 00 41	ata..Also,.this.lab.considers:.A
5940	6e 73 69 62 6c 65 00 41 6e 79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 77 65 72 65 20 64 6f	nsible.Any.modifications.were.do
5960	6e 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 75 6e 66 69 78 65 64 20 62 75 67 73 20 61	ne.to.work.around.unfixed.bugs.a
5980	6e 64 20 69 6d 70 6c 65 6d 65 6e 74 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 68 61 74 20 61	nd.implement.enhancements.that.a
59a0	72 65 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 69 6e 20 74 68 65 20 56 79 4f 53 20 73 79 73 74	re.not.complete.in.the.VyOS.syst
59c0	65 6d 20 63 61 6e 20 62 65 20 70 6c 61 63 65 64 20 68 65 72 65 2e 00 41 74 20 74 68 69 73 20 73	em.can.be.placed.here..At.this.s
59e0	74 65 70 20 77 65 20 63 61 6e 20 67 65 74 20 73 6f 6d 65 20 6f 70 2d 6d 6f 64 65 20 69 6e 66 6f	tep.we.can.get.some.op-mode.info
5a00	72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 56 79 4f 53 20 6e 6f 64 65 73 3a 00 41 75 74 68 65 6e 74	rmation.from.VyOS.nodes:.Authent
5a20	69 63 61 74 69 6f 6e 00 42 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 2c 20 70 6c 65 61 73 65 20	ication.Before.starting,.please.
5a40	72 65 66 65 72 20 74 6f 20 63 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 6f 72 6b 2d 63 6f 6e	refer.to.cloud-init.`network-con
5a60	66 69 67 2d 64 6f 63 73 60 5f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6b 6e 6f 77 20 68 6f 77 20	fig-docs`_.in.order.to.know.how.
5a80	74 6f 20 69 6d 70 6f 72 74 20 75 73 65 72 20 61 6e 64 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69	to.import.user.and.network.confi
5aa0	67 75 72 61 74 69 6f 6e 73 2e 00 42 65 6c 6f 77 20 73 65 65 20 6f 6e 65 20 65 78 61 6d 70 6c 65	gurations..Below.see.one.example
5ac0	20 66 6f 72 20 63 75 72 6c 20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 70 79 74 68 6f 6e 2e 20 54 68	.for.curl.and.one.for.python..Th
5ae0	65 20 72 65 73 74 20 6f 66 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 72	e.rest.of.the.documentation.is.r
5b00	65 64 75 63 65 64 20 74 6f 20 63 75 72 6c 2e 00 43 68 65 63 6b 20 73 61 6c 74 2d 6b 65 79 73 20	educed.to.curl..Check.salt-keys.
5b20	6f 6e 20 74 68 65 20 73 61 6c 74 20 6d 61 73 74 65 72 00 43 68 65 63 6b 20 74 68 61 74 20 70 72	on.the.salt.master.Check.that.pr
5b40	6f 78 79 20 6d 69 6e 69 6f 6e 20 69 73 20 61 6c 69 76 65 3a 00 43 68 65 63 6b 20 74 68 61 74 20	oxy.minion.is.alive:.Check.that.
5b60	73 61 6c 74 20 6d 61 73 74 65 72 20 63 61 6e 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 77 69 74 68	salt.master.can.communicate.with
5b80	20 6d 69 6e 69 6f 6e 73 00 43 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 65 64 20 69	.minions.Cloud.and.virtualized.i
5ba0	6e 73 74 61 6e 63 65 73 20 6f 66 20 56 79 4f 53 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 64	nstances.of.VyOS.are.initialized
5bc0	20 75 73 69 6e 67 20 74 68 65 20 69 6e 64 75 73 74 72 79 2d 73 74 61 6e 64 61 72 64 20 63 6c 6f	.using.the.industry-standard.clo
5be0	75 64 2d 69 6e 69 74 2e 20 56 69 61 20 63 6c 6f 75 64 2d 69 6e 69 74 2c 20 74 68 65 20 73 79 73	ud-init..Via.cloud-init,.the.sys
5c00	74 65 6d 20 70 65 72 66 6f 72 6d 73 20 74 61 73 6b 73 20 73 75 63 68 20 61 73 20 69 6e 6a 65 63	tem.performs.tasks.such.as.injec
5c20	74 69 6e 67 20 53 53 48 20 6b 65 79 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 74 68	ting.SSH.keys.and.configuring.th
5c40	65 20 6e 65 74 77 6f 72 6b 2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 74 68 65 20 75 73 65 72	e.network..In.addition,.the.user
5c60	20 63 61 6e 20 73 75 70 70 6c 79 20 61 20 63 75 73 74 6f 6d 20 63 6f 6e 66 69 67 75 72 61 74 69	.can.supply.a.custom.configurati
5c80	6f 6e 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e 63 65 20 6c 61 75 6e 63	on.at.the.time.of.instance.launc
5ca0	68 2e 00 43 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 6d 6f 64 75 6c 65 73 00 43 6c 6f 75 64 2d 69 6e	h..Cloud-config.modules.Cloud-in
5cc0	69 74 20 60 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f 2e 00 43 6c 6f 75 64	it.`network-config-docs`_..Cloud
5ce0	2d 69 6e 69 74 20 6f 6e 20 50 72 6f 78 6d 6f 78 00 43 6f 6d 6d 61 6e 64 20 45 78 65 63 75 74 69	-init.on.Proxmox.Command.Executi
5d00	6f 6e 20 61 74 20 49 6e 69 74 69 61 6c 20 42 6f 6f 74 00 43 6f 6d 6d 61 6e 64 20 53 63 72 69 70	on.at.Initial.Boot.Command.Scrip
5d20	74 69 6e 67 00 43 6f 6d 6d 61 6e 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 60 60 73 65	ting.Command.for.generating.``se
5d40	65 64 2e 69 73 6f 60 60 00 43 6f 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 65 6d 65 6e 74 73 3a 00	ed.iso``.Commands.requirements:.
5d60	43 6f 6e 66 69 67 20 53 6f 75 72 63 65 73 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 43 6f 6e	Config.Sources.Configuration.Con
5d80	66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 78 65 63 75 74 65 64	figuration.commands.are.executed
5da0	20 6a 75 73 74 20 6c 69 6b 65 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 20	.just.like.from.a.normal.config.
5dc0	73 65 73 73 69 6f 6e 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 77 61 6e	session..For.example,.if.you.wan
5de0	74 20 74 6f 20 64 69 73 61 62 6c 65 20 61 20 42 47 50 20 70 65 65 72 20 6f 6e 20 56 52 52 50 20	t.to.disable.a.BGP.peer.on.VRRP.
5e00	74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20 62 61 63 6b 75 70 3a 00 43 6f 6e 66 69 67 75 72 65 2c	transition.to.backup:.Configure,
5e20	20 74 68 65 6e 20 44 65 6c 65 74 65 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 74	.then.Delete.Object.Configure,.t
5e40	68 65 6e 20 4c 6f 61 64 20 46 69 6c 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 61	hen.Load.File.Configure,.then.Sa
5e60	76 65 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 61 76 65 20 46 69 6c 65 00 43 6f 6e	ve.Configure,.then.Save.File.Con
5e80	66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 65 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e	figure,.then.Set.Configure,.then
5ea0	20 53 68 6f 77 20 4f 62 6a 65 63 74 00 43 6f 6e 66 69 67 75 72 65 2c 20 74 68 65 6e 20 53 68 6f	.Show.Object.Configure,.then.Sho
5ec0	77 20 61 20 53 69 6e 67 6c 65 20 4f 62 6a 65 63 74 20 56 61 6c 75 65 00 43 6f 6e 74 65 6e 74 20	w.a.Single.Object.Value.Content.
5ee0	6f 66 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 00 43 6f 6e 74 65 6e 74 20 6f 66 20 6e 65 74 77	of.commands.conf.Content.of.netw
5f00	6f 72 6b 2d 63 6f 6e 66 69 67 20 66 69 6c 65 3a 00 43 72 65 61 74 65 20 73 65 65 64 2e 69 73 6f	ork-config.file:.Create.seed.iso
5f20	00 43 72 65 61 74 65 20 74 65 78 74 20 66 69 6c 65 73 20 6e 61 6d 65 64 20 75 73 65 72 2d 64 61	.Create.text.files.named.user-da
5f40	74 61 20 61 6e 64 20 6d 65 74 61 2d 64 61 74 61 2e 20 4f 6e 20 6c 69 6e 75 78 2d 62 61 73 65 64	ta.and.meta-data..On.linux-based
5f60	20 73 79 73 74 65 6d 73 2c 20 74 68 65 20 6d 6b 69 73 6f 66 73 20 75 74 69 6c 69 74 79 20 63 61	.systems,.the.mkisofs.utility.ca
5f80	6e 20 62 65 20 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 73 65 65 64 20 49 53 4f	n.be.used.to.create.the.seed.ISO
5fa0	2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78 20 77 69 6c 6c 20 61 64 64 20	..The.following.syntax.will.add.
5fc0	74 68 65 73 65 20 66 69 6c 65 73 20 74 6f 20 74 68 65 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65	these.files.to.the.ISO.9660.file
5fe0	20 73 79 73 74 65 6d 2e 00 43 72 65 61 74 69 6e 67 20 74 68 65 20 56 4d 00 43 75 73 74 6f 6d 20	.system..Creating.the.VM.Custom.
6000	73 63 72 69 70 74 73 20 61 72 65 20 6e 6f 74 20 65 78 65 63 75 74 65 64 20 77 69 74 68 20 72 6f	scripts.are.not.executed.with.ro
6020	6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 28 55 73 65 20 73 75 64 6f 20 69 6e 73 69 64 65 20 69	ot.privileges.(Use.sudo.inside.i
6040	66 20 74 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 29 2e 00 44 48 43 50 20 6f 6e 20 66 69	f.this.is.necessary)..DHCP.on.fi
6060	72 73 74 20 45 74 68 65 72 6e 65 74 20 69 6e 74 65 72 66 61 63 65 20 69 66 20 6e 6f 20 6e 65 74	rst.Ethernet.interface.if.no.net
6080	77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 76 69 64 65 64 2e 00	work.configuration.is.provided..
60a0	45 78 61 6d 70 6c 65 00 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	Example.Example.of.configuration
60c0	20 63 6f 6d 6d 61 6e 64 73 20 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 22 2f 73 72 76 2f 73 61	.commands.from.the.file."/srv/sa
60e0	6c 74 2f 73 74 61 74 65 73 2f 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 22 00 45 78 61 6d 70 6c 65 20	lt/states/commands.txt".Example.
6100	6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 00 45 78 61 6d 70 6c 65 20 6f 66 20 6f 70 2d	of.configuration:.Example.of.op-
6120	6d 6f 64 65 3a 00 45 78 61 6d 70 6c 65 73 00 45 78 65 63 75 74 69 6e 67 20 43 6f 6e 66 69 67 75	mode:.Examples.Executing.Configu
6140	72 61 74 69 6f 6e 20 53 63 72 69 70 74 73 00 45 78 65 63 75 74 69 6e 67 20 70 72 65 2d 68 6f 6f	ration.Scripts.Executing.pre-hoo
6160	6b 73 2f 70 6f 73 74 2d 68 6f 6f 6b 73 20 53 63 72 69 70 74 73 00 46 69 6c 65 20 63 6f 6e 74 65	ks/post-hooks.Scripts.File.conte
6180	6e 74 73 00 46 69 6c 65 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 68 20 70 72 65 76 69 6f 75 73	nts.File.generated.with.previous
61a0	20 63 6f 6d 6d 61 6e 64 3a 20 60 60 2f 74 6d 70 2f 76 79 6f 73 2d 31 2e 33 2e 30 2d 63 6c 6f 75	.command:.``/tmp/vyos-1.3.0-clou
61c0	64 2d 69 6e 69 74 2d 31 30 47 2d 71 65 6d 75 2e 71 63 6f 77 32 60 60 00 46 69 6e 61 6c 79 2c 20	d-init-10G-qemu.qcow2``.Finaly,.
61e0	66 69 6c 65 20 2a 2a 6d 65 74 61 2d 64 61 74 61 2a 2a 20 68 61 73 20 6e 6f 20 63 6f 6e 74 65 6e	file.**meta-data**.has.no.conten
6200	74 2c 20 62 75 74 20 69 74 27 73 20 72 65 71 75 69 72 65 64 2e 00 46 6f 72 20 63 6f 6e 66 69 67	t,.but.it's.required..For.config
6220	75 72 61 74 69 6f 6e 20 61 6e 64 20 65 6e 61 62 6c 69 6e 67 20 74 68 65 20 41 50 49 20 73 65 65	uration.and.enabling.the.API.see
6240	20 3a 72 65 66 3a 60 68 74 74 70 2d 61 70 69 60 00 46 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69	.:ref:`http-api`.For.configurati
6260	6f 6e 2f 75 70 67 72 61 64 65 20 6d 61 6e 61 67 65 6d 65 6e 74 20 69 73 73 75 65 73 2c 20 6d 6f	on/upgrade.management.issues,.mo
6280	64 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 73 63 72 69 70 74 20 73 68 6f 75 6c 64	dification.of.this.script.should
62a0	20 62 65 20 74 68 65 20 6c 61 73 74 20 6f 70 74 69 6f 6e 2e 20 41 6c 77 61 79 73 20 74 72 79 20	.be.the.last.option..Always.try.
62c0	74 6f 20 66 69 6e 64 20 73 6f 6c 75 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 43 4c 49 20 63	to.find.solutions.based.on.CLI.c
62e0	6f 6d 6d 61 6e 64 73 20 66 69 72 73 74 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 67 65 74 20	ommands.first..For.example,.get.
6300	74 68 65 20 61 64 64 72 65 73 73 65 73 20 6f 66 20 61 20 60 60 64 75 6d 30 60 60 20 69 6e 74 65	the.addresses.of.a.``dum0``.inte
6320	72 66 61 63 65 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 20 77 68 69 63 68 20 69	rface..For.example,.show.which.i
6340	6d 61 67 65 73 20 61 72 65 20 69 6e 73 74 61 6c 6c 65 64 2e 00 46 6f 72 20 6d 6f 72 65 20 69 6e	mages.are.installed..For.more.in
6360	66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 64 61 74 61 20 73 6f	formation.on.the.NoCloud.data.so
6380	75 72 63 65 2c 20 76 69 73 69 74 20 69 74 73 20 60 70 61 67 65 20 3c 68 74 74 70 73 3a 2f 2f 63	urce,.visit.its.`page.<https://c
63a0	6c 6f 75 64 69 6e 69 74 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f 2f 65 6e 2f 6c 61 74 65 73	loudinit.readthedocs.io/en/lates
63c0	74 2f 72 65 66 65 72 65 6e 63 65 2f 64 61 74 61 73 6f 75 72 63 65 73 2f 6e 6f 63 6c 6f 75 64 2e	t/reference/datasources/nocloud.
63e0	68 74 6d 6c 3e 60 5f 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 69 6e 69 74 20 64 6f 63 75 6d 65	html>`_.in.the.cloud-init.docume
6400	6e 74 61 74 69 6f 6e 2e 00 46 72 6f 6d 20 63 6c 69 20 6f 72 20 47 55 49 2c 20 70 6f 77 65 72 20	ntation..From.cli.or.GUI,.power.
6420	6f 6e 20 56 4d 2c 20 61 6e 64 20 61 66 74 65 72 20 69 74 20 62 6f 6f 74 73 2c 20 76 65 72 69 66	on.VM,.and.after.it.boots,.verif
6440	79 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 47 65 6e 65 72 61 74 65 20 4f 62 6a 65 63 74 00	y.configuration.Generate.Object.
6460	47 65 6e 65 72 61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 47 65 74 74 69 6e 67 20 53 74 61 72	Generate.qcow.image.Getting.Star
6480	74 65 64 00 48 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 3a 00 48 65	ted.Here.is.a.simple.example:.He
64a0	72 65 20 69 73 20 61 6e 20 65 78 61 6d 70 6c 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 74 68	re.is.an.example.cloud-config.th
64c0	61 74 20 61 70 70 65 6e 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 74 20 74 68 65 20	at.appends.configuration.at.the.
64e0	74 69 6d 65 20 6f 66 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 49 53 4f 20 66 69 6c 65 73 20 73 74	time.of.first.boot..ISO.files.st
6500	6f 72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 73 20 75 73 65 64 20	orage:.``local``.volume.is.used.
6520	66 6f 72 20 60 60 2e 69 73 6f 60 60 20 66 69 6c 65 20 73 74 6f 72 61 67 65 2e 20 49 6e 20 74 68	for.``.iso``.file.storage..In.th
6540	69 73 20 73 63 65 6e 61 72 69 6f 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 74 79 70	is.scenario.``local``.volume.typ
6560	65 20 69 73 20 73 65 74 20 74 6f 20 2a 2a 64 69 72 65 63 74 6f 72 79 2a 2a 2c 20 61 62 64 20 61	e.is.set.to.**directory**,.abd.a
6580	74 74 61 63 68 65 64 20 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 60 60 2e 00 49 66 20 63	ttached.to.``/var/lib/vz``..If.c
65a0	6f 6d 6d 61 6e 64 20 65 6e 64 73 20 69 6e 20 61 20 76 61 6c 75 65 2c 20 69 74 20 6d 75 73 74 20	ommand.ends.in.a.value,.it.must.
65c0	62 65 20 69 6e 73 69 64 65 20 73 69 6e 67 6c 65 20 71 75 6f 74 65 73 2e 00 49 66 20 6e 6f 20 6e	be.inside.single.quotes..If.no.n
65e0	65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 76 69	etworking.configuration.is.provi
6600	64 65 64 2c 20 74 68 65 6e 20 64 68 63 70 20 63 6c 69 65 6e 74 20 69 73 20 67 6f 69 6e 67 20 74	ded,.then.dhcp.client.is.going.t
6620	6f 20 62 65 20 65 6e 61 62 6c 65 64 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2e	o.be.enabled.on.first.interface.
6640	20 42 61 72 65 20 69 6e 20 6d 69 6e 64 20 74 68 61 74 20 74 68 69 73 20 63 6f 6e 66 69 67 75 72	.Bare.in.mind.that.this.configur
6660	61 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 69 6e 79 65 63 74 65 64 20 61 74 20 61 6e 20 4f 53 20	ation.will.be.inyected.at.an.OS.
6680	6c 65 76 65 6c 2c 20 73 6f 20 64 6f 6e 27 74 20 65 78 70 65 63 74 20 74 6f 20 66 69 6e 64 20 64	level,.so.don't.expect.to.find.d
66a0	68 63 70 20 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 6e 20 76 79 6f 73	hcp.client.configuration.on.vyos
66c0	20 63 6c 69 2e 20 42 65 63 61 75 73 65 20 6f 66 20 74 68 69 73 20 62 65 68 61 76 69 6f 72 2c 20	.cli..Because.of.this.behavior,.
66e0	69 6e 20 6e 65 78 74 20 65 78 61 6d 70 6c 65 20 6c 61 62 20 77 65 20 77 69 6c 6c 20 64 69 73 61	in.next.example.lab.we.will.disa
6700	62 6c 65 20 64 68 63 70 2d 63 6c 69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 6e	ble.dhcp-client.configuration.on
6720	20 65 74 68 30 2e 00 49 66 20 79 6f 75 20 65 6e 63 6f 75 6e 74 65 72 20 70 72 6f 62 6c 65 6d 73	.eth0..If.you.encounter.problems
6740	2c 20 76 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64	,.verify.that.the.cloud-config.d
6760	6f 63 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 20 76 61 6c 69 64 20 59 41 4d 4c 2e 20 4f 6e 6c	ocument.contains.valid.YAML..Onl
6780	69 6e 65 20 72 65 73 6f 75 72 63 65 73 20 73 75 63 68 20 61 73 20 68 74 74 70 73 3a 2f 2f 77 77	ine.resources.such.as.https://ww
67a0	77 2e 79 61 6d 6c 6c 69 6e 74 2e 63 6f 6d 2f 20 70 72 6f 76 69 64 65 20 61 20 73 69 6d 70 6c 65	w.yamllint.com/.provide.a.simple
67c0	20 74 6f 6f 6c 20 66 6f 72 20 76 61 6c 69 64 61 74 69 6e 67 20 59 41 4d 4c 2e 00 49 66 20 79 6f	.tool.for.validating.YAML..If.yo
67e0	75 20 6e 65 65 64 20 74 6f 20 67 61 74 68 65 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f	u.need.to.gather.information.fro
6800	6d 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79	m.linux.commands.to.configure.Vy
6820	4f 53 2c 20 79 6f 75 20 63 61 6e 20 65 78 65 63 75 74 65 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64	OS,.you.can.execute.commands.and
6840	20 74 68 65 6e 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 69 6e 20 74 68 65 20 73 61 6d 65	.then.configure.VyOS.in.the.same
6860	20 73 63 72 69 70 74 2e 00 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 63 72 69 70 74 20 74	.script..If.you.want.to.script.t
6880	68 65 20 63 6f 6e 66 69 67 73 20 69 6e 20 61 20 6c 61 6e 67 75 61 67 65 20 6f 74 68 65 72 20 74	he.configs.in.a.language.other.t
68a0	68 61 6e 20 62 61 73 68 20 79 6f 75 20 63 61 6e 20 68 61 76 65 20 79 6f 75 72 20 73 63 72 69 70	han.bash.you.can.have.your.scrip
68c0	74 20 6f 75 74 70 75 74 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 6e 20 73 6f 75 72 63	t.output.commands.and.then.sourc
68e0	65 20 74 68 65 6d 20 69 6e 20 61 20 62 61 73 68 20 73 63 72 69 70 74 2e 00 49 6d 70 6f 72 74 69	e.them.in.a.bash.script..Importi
6900	6e 67 20 61 6e 64 20 44 69 73 61 62 6c 69 6e 67 20 57 61 72 6e 69 6e 67 73 20 66 6f 72 20 76 65	ng.and.Disabling.Warnings.for.ve
6920	72 69 66 79 3d 46 61 6c 73 65 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 20 74 68 72	rify=False.In.Proxmox.server.thr
6940	65 65 20 66 69 6c 65 73 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 75 73 65 64 20 66 6f	ee.files.are.going.to.be.used.fo
6960	72 20 74 68 69 73 20 73 65 74 75 70 3a 00 49 6e 20 56 79 4f 53 2c 20 62 79 20 64 65 66 61 75 6c	r.this.setup:.In.VyOS,.by.defaul
6980	74 2c 20 65 6e 61 62 6c 65 73 20 6f 6e 6c 79 20 74 77 6f 20 6d 6f 64 75 6c 65 73 3a 00 49 6e 20	t,.enables.only.two.modules:.In.
69a0	74 68 69 73 20 6c 61 62 2c 20 61 6c 6c 20 66 69 6c 65 73 20 61 72 65 20 6c 6f 63 61 74 65 64 20	this.lab,.all.files.are.located.
69c0	69 6e 20 60 60 2f 74 6d 70 2f 60 60 2e 20 53 6f 2c 20 62 65 66 6f 72 65 20 67 6f 69 6e 67 20 6f	in.``/tmp/``..So,.before.going.o
69e0	6e 2c 20 6c 65 74 73 20 6d 6f 76 65 20 74 6f 20 74 68 61 74 20 64 69 72 65 63 74 6f 72 79 3a 00	n,.lets.move.to.that.directory:.
6a00	49 6e 20 74 68 69 73 20 6c 61 62 2c 20 77 65 20 61 72 65 20 75 73 69 6e 67 20 31 2e 33 2e 30 20	In.this.lab,.we.are.using.1.3.0.
6a20	56 79 4f 53 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 73 65 74 74 69 6e 67 20 61 20 64 69 73 6b 20	VyOS.version.and.setting.a.disk.
6a40	6f 66 20 31 30 47 2e 20 44 6f 77 6e 6c 6f 61 64 20 56 79 4f 53 20 2e 69 73 6f 20 66 69 6c 65 20	of.10G..Download.VyOS..iso.file.
6a60	61 6e 64 20 73 61 76 65 20 69 74 20 61 73 20 60 60 2f 74 6d 70 2f 76 79 6f 73 2e 69 73 6f 60 60	and.save.it.as.``/tmp/vyos.iso``
6a80	2e 20 43 6f 6d 6d 61 6e 64 20 75 73 65 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 71 63	..Command.used.for.generating.qc
6aa0	6f 77 20 69 6d 61 67 65 3a 00 49 6e 69 74 69 61 6c 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00	ow.image:.Initial.Configuration.
6ac0	49 6e 69 74 69 61 6c 69 7a 69 6e 67 20 61 20 56 79 44 65 76 69 63 65 20 4f 62 6a 65 63 74 00 49	Initializing.a.VyDevice.Object.I
6ae0	6e 6a 65 63 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 61 74 61 20 69 73 20 6e	njecting.configuration.data.is.n
6b00	6f 74 20 6c 69 6d 69 74 65 64 20 74 6f 20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d 73 2e 20 55	ot.limited.to.cloud.platforms..U
6b20	73 65 72 73 20 63 61 6e 20 65 6d 70 6c 6f 79 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 64 61 74 61	sers.can.employ.the.NoCloud.data
6b40	20 73 6f 75 72 63 65 20 74 6f 20 69 6e 6a 65 63 74 20 75 73 65 72 2d 64 61 74 61 20 61 6e 64 20	.source.to.inject.user-data.and.
6b60	6d 65 74 61 2d 64 61 74 61 20 6f 6e 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e 20 70 6c 61 74	meta-data.on.virtualization.plat
6b80	66 6f 72 6d 73 20 73 75 63 68 20 61 73 20 56 4d 77 61 72 65 2c 20 48 79 70 65 72 2d 56 20 61 6e	forms.such.as.VMware,.Hyper-V.an
6ba0	64 20 4b 56 4d 2e 00 49 6e 73 74 61 6c 6c 20 60 60 6e 61 70 61 6c 6d 2d 76 79 6f 73 60 60 20 6d	d.KVM..Install.``napalm-vyos``.m
6bc0	6f 64 75 6c 65 00 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 00 49 74 20 69 73 20 70 6f 73 73 69 62 6c	odule.Installation.It.is.possibl
6be0	65 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 20 76 69 61 20 6e 65 74 6d 69 6b 6f 5f	e.to.configure.VyOS.via.netmiko_
6c00	20 70 72 6f 78 79 20 6d 6f 64 75 6c 65 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 61 20 6d 69 6e	.proxy.module..It.requires.a.min
6c20	69 6f 6e 20 77 69 74 68 20 69 6e 73 74 61 6c 6c 65 64 20 70 61 63 6b 65 74 20 20 60 60 70 79 74	ion.with.installed.packet..``pyt
6c40	68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 20 77 68 6f 20 68 61 73 20 61 20	hon3-netmiko``.module.who.has.a.
6c60	63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 56 79 4f 53 20 6e 6f 64 65 73 2e 20 53 61 6c 74 2d 6d	connection.to.VyOS.nodes..Salt-m
6c80	69 6e 69 6f 6e 20 68 61 76 65 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 77 69 74 68 20 73	inion.have.to.communicate.with.s
6ca0	61 6c 74 20 6d 61 73 74 65 72 00 4d 61 6a 6f 72 20 63 6c 6f 75 64 20 70 72 6f 76 69 64 65 72 73	alt.master.Major.cloud.providers
6cc0	20 6f 66 66 65 72 20 61 20 6d 65 61 6e 73 20 6f 66 20 70 72 6f 76 69 64 69 6e 67 20 75 73 65 72	.offer.a.means.of.providing.user
6ce0	2d 64 61 74 61 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e 63 65 20 6c 61	-data.at.the.time.of.instance.la
6d00	75 6e 63 68 2e 20 49 74 20 63 61 6e 20 62 65 20 70 72 6f 76 69 64 65 64 20 61 73 20 70 6c 61 69	unch..It.can.be.provided.as.plai
6d20	6e 20 74 65 78 74 20 6f 72 20 61 73 20 62 61 73 65 36 34 2d 65 6e 63 6f 64 65 64 20 74 65 78 74	n.text.or.as.base64-encoded.text
6d40	2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6c 6f 75 64 20 70 72 6f 76 69 64 65 72 2e 20 41	,.depending.on.cloud.provider..A
6d60	6c 73 6f 2c 20 69 74 20 63 61 6e 20 62 65 20 63 6f 6d 70 72 65 73 73 65 64 20 75 73 69 6e 67 20	lso,.it.can.be.compressed.using.
6d80	67 7a 69 70 2c 20 77 68 69 63 68 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 77 69 74 68 20 61 20 6c	gzip,.which.makes.sense.with.a.l
6da0	6f 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 73 74 2c	ong.configuration.commands.list,
6dc0	20 62 65 63 61 75 73 65 20 6f 66 20 74 68 65 20 68 61 72 64 20 6c 69 6d 69 74 20 74 6f 20 7e 31	.because.of.the.hard.limit.to.~1
6de0	36 33 38 34 20 62 79 74 65 73 20 66 6f 72 20 74 68 65 20 77 68 6f 6c 65 20 75 73 65 72 2d 64 61	6384.bytes.for.the.whole.user-da
6e00	74 61 2e 00 4d 65 74 61 64 61 74 61 20 2d 20 4d 65 74 61 64 61 74 61 20 69 73 20 73 6f 75 72 63	ta..Metadata.-.Metadata.is.sourc
6e20	65 64 20 62 79 20 74 68 65 20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d 20 6f 72 20 68 79 70 65	ed.by.the.cloud.platform.or.hype
6e40	72 76 69 73 6f 72 2e 20 49 6e 20 73 6f 6d 65 20 63 6c 6f 75 64 73 2c 20 74 68 65 72 65 20 69 73	rvisor..In.some.clouds,.there.is
6e60	20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 48 54 54 50 20 65 6e 64 70 6f 69 6e 74	.implemented.as.an.HTTP.endpoint
6e80	20 61 74 20 60 60 68 74 74 70 3a 2f 2f 31 36 39 2e 32 35 34 2e 31 36 39 2e 32 35 34 60 60 2e 00	.at.``http://169.254.169.254``..
6ea0	4d 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 6b 65 79 73 20 74 68 61 74 20 6e 65 65 64 73 20 74	Most.important.keys.that.needs.t
6ec0	6f 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 3a 00 4e 61 70 61 6c 6d 00 4e 65 74 6d 69 6b 6f 00	o.be.considered:.Napalm.Netmiko.
6ee0	4e 65 74 6d 69 6b 6f 2d 70 72 6f 78 79 00 4e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74	Netmiko-proxy.Network.configurat
6f00	69 6f 6e 20 2d 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 20 69 6e 66 6f 72 6d 73	ion.-.This.config.source.informs
6f20	20 74 68 65 20 73 79 73 74 65 6d 20 61 62 6f 75 74 20 74 68 65 20 6e 65 74 77 6f 72 6b 20 73 65	.the.system.about.the.network.se
6f40	74 74 69 6e 67 73 20 6c 69 6b 65 20 49 50 20 61 64 64 72 65 73 73 65 73 2c 20 72 6f 75 74 65 73	ttings.like.IP.addresses,.routes
6f60	2c 20 44 4e 53 2e 20 41 76 61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 69 6e 20 73 65 76 65 72 61 6c	,.DNS..Available.only.in.several
6f80	20 63 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e 20 70 6c 61 74 66 6f	.cloud.and.virtualization.platfo
6fa0	72 6d 73 2e 00 4e 65 74 77 6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 73	rms..Networking.configurations.s
6fc0	68 6f 75 6c 64 6e 27 74 20 62 65 20 70 61 73 73 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20	houldn't.be.passed.in.user-data.
6fe0	66 69 6c 65 2e 00 4e 6f 43 6c 6f 75 64 00 4e 6f 72 6e 69 72 00 4e 6f 74 65 20 74 68 61 74 20 74	file..NoCloud.Nornir.Note.that.t
7000	68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 20 69 73 20 75 73 65	he./opt/vyatta/etc/config.is.use
7020	64 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73	d.instead.of.the./config/scripts
7040	20 64 69 72 65 63 74 6f 72 79 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e 20 74 68 65 20 3a 72 65	.directory.referenced.in.the.:re
7060	66 3a 60 63 6f 6d 6d 61 6e 64 2d 73 63 72 69 70 74 69 6e 67 60 20 73 65 63 74 69 6f 6e 20 6f 66	f:`command-scripting`.section.of
7080	20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 62 65 63 61 75 73 65 20 74 68 65 20 2f	.the.documentation.because.the./
70a0	63 6f 6e 66 69 67 2f 73 63 72 69 70 74 20 64 69 72 65 63 74 6f 72 79 20 69 73 6e 27 74 20 6d 6f	config/script.directory.isn't.mo
70c0	75 6e 74 65 64 20 77 68 65 6e 20 74 68 65 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 6d	unted.when.the.``write_files``.m
70e0	6f 64 75 6c 65 20 65 78 65 63 75 74 65 73 2e 00 4e 6f 74 65 73 20 66 6f 72 20 74 68 69 73 20 70	odule.executes..Notes.for.this.p
7100	61 72 74 69 63 75 6c 61 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 61 74 20 6d 61 79 20 6e 65 65 64	articular.example,.that.may.need
7120	20 74 6f 20 62 65 20 6d 6f 64 69 66 69 65 64 20 69 6e 20 6f 74 68 65 72 20 73 65 74 75 70 73 3a	.to.be.modified.in.other.setups:
7140	00 4e 6f 77 2c 20 74 68 61 74 20 66 69 6c 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 70 69	.Now,.that.file.needs.to.be.copi
7160	65 64 20 74 6f 20 70 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 20 56 79 4f 53 20 74 68	ed.to.proxmox.server:.On.VyOS.th
7180	69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 62	is.will.cause.the.following.prob
71a0	6c 65 6d 3a 20 41 66 74 65 72 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75	lem:.After.modifying.the.configu
71c0	72 61 74 69 6f 6e 20 76 69 61 20 73 63 72 69 70 74 20 6c 69 6b 65 20 74 68 69 73 20 6f 6e 63 65	ration.via.script.like.this.once
71e0	2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d 61 6e 75 61 6c 6c 79	,.it.is.not.possible.to.manually
7200	20 6d 6f 64 69 66 79 20 74 68 65 20 63 6f 6e 66 69 67 20 61 6e 79 6d 6f 72 65 3a 00 4f 6e 20 70	.modify.the.config.anymore:.On.p
7220	72 6f 78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 63 65 20 74 68 65 20 74 68 72 65 65 20 66 69	roxmox.server:.Once.the.three.fi
7240	6c 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 2c 20 69 74 27 73 20 74 69 6d 65 20 74 6f 20 67	les.were.created,.it's.time.to.g
7260	65 6e 65 72 61 74 65 20 74 68 65 20 60 60 73 65 65 64 2e 69 73 6f 60 60 20 69 6d 61 67 65 2c 20	enerate.the.``seed.iso``.image,.
7280	77 68 69 63 68 20 6e 65 65 64 73 20 74 6f 20 62 65 20 6d 6f 75 6e 74 65 64 20 74 6f 20 74 68 65	which.needs.to.be.mounted.to.the
72a0	20 6e 65 77 20 56 4d 20 61 73 20 61 20 63 64 2e 00 4f 6e 65 20 63 6f 6d 6d 61 6e 64 20 70 65 72	.new.VM.as.a.cd..One.command.per
72c0	20 6c 69 6e 65 2e 00 4f 70 2d 6d 6f 64 65 00 4f 74 68 65 72 20 73 63 72 69 70 74 20 6c 61 6e 67	.line..Op-mode.Other.script.lang
72e0	75 61 67 65 73 00 4f 75 74 70 75 74 00 4f 75 74 70 75 74 20 6f 70 2d 6d 6f 64 65 00 50 6c 65 61	uages.Output.Output.op-mode.Plea
7300	73 65 20 74 61 6b 65 20 61 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 43 6f 6e 74 72 69 62 75 74 69	se.take.a.look.at.the.Contributi
7320	6e 67 20 47 75 69 64 65 20 66 6f 72 20 6f 75 72 20 3a 72 65 66 3a 60 64 6f 63 75 6d 65 6e 74 61	ng.Guide.for.our.:ref:`documenta
7340	74 69 6f 6e 60 2e 00 50 6f 73 74 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 00 50 6f 77 65 72 20	tion`..Postconfig.on.boot.Power.
7360	6f 6e 20 56 4d 20 61 6e 64 20 76 65 72 69 66 69 63 61 74 69 6f 6e 73 00 50 72 65 63 6f 6e 66 69	on.VM.and.verifications.Preconfi
7380	67 20 6f 6e 20 62 6f 6f 74 00 50 72 65 70 61 72 65 20 63 6c 6f 75 64 2d 69 6e 69 74 20 66 69 6c	g.on.boot.Prepare.cloud-init.fil
73a0	65 73 00 50 72 6f 78 6d 6f 78 20 49 50 20 61 64 64 72 65 73 73 3a 20 2a 2a 31 39 32 2e 31 36 38	es.Proxmox.IP.address:.**192.168
73c0	2e 30 2e 32 35 33 2f 32 34 2a 2a 00 50 72 6f 78 6d 6f 78 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d	.0.253/24**.Proxmox.`Cloud-init-
73e0	53 75 70 70 6f 72 74 60 5f 2e 00 50 79 56 79 4f 53 00 50 79 56 79 4f 53 20 69 73 20 61 20 50 79	Support`_..PyVyOS.PyVyOS.is.a.Py
7400	74 68 6f 6e 20 6c 69 62 72 61 72 79 20 66 6f 72 20 69 6e 74 65 72 61 63 74 69 6e 67 20 77 69 74	thon.library.for.interacting.wit
7420	68 20 56 79 4f 53 20 64 65 76 69 63 65 73 20 76 69 61 20 74 68 65 69 72 20 41 50 49 2e 20 54 68	h.VyOS.devices.via.their.API..Th
7440	69 73 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 67 75 69 64 65 73 20 79 6f 75 20 6f 6e 20 75	is.documentation.guides.you.on.u
7460	73 69 6e 67 20 50 79 56 79 4f 53 20 74 6f 20 6d 61 6e 61 67 65 20 79 6f 75 72 20 56 79 4f 53 20	sing.PyVyOS.to.manage.your.VyOS.
7480	64 65 76 69 63 65 73 20 70 72 6f 67 72 61 6d 6d 61 74 69 63 61 6c 6c 79 2e 20 54 68 65 20 63 6f	devices.programmatically..The.co
74a0	6d 70 6c 65 74 65 20 50 79 56 79 4f 53 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 61	mplete.PyVyOS.documentation.is.a
74c0	76 61 69 6c 61 62 6c 65 20 6f 6e 20 5b 52 65 61 64 20 74 68 65 20 44 6f 63 73 5d 28 68 74 74 70	vailable.on.[Read.the.Docs](http
74e0	73 3a 2f 2f 70 79 76 79 6f 73 2e 72 65 61 64 74 68 65 64 6f 63 73 2e 69 6f 2f 65 6e 2f 6c 61 74	s://pyvyos.readthedocs.io/en/lat
7500	65 73 74 2f 29 2c 20 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61 6e 20 62 65 20 66 6f	est/),.and.the.library.can.be.fo
7520	75 6e 64 20 6f 6e 20 5b 47 69 74 48 75 62 5d 28 68 74 74 70 73 3a 2f 2f 67 69 74 68 75 62 2e 63	und.on.[GitHub](https://github.c
7540	6f 6d 2f 72 6f 62 65 72 74 6f 62 65 72 74 6f 2f 70 79 76 79 6f 73 29 20 61 6e 64 20 5b 50 79 50	om/robertoberto/pyvyos).and.[PyP
7560	49 5d 28 68 74 74 70 73 3a 2f 2f 70 79 70 69 2e 6f 72 67 2f 70 72 6f 6a 65 63 74 2f 70 79 76 79	I](https://pypi.org/project/pyvy
7580	6f 73 2f 29 2e 00 52 65 66 65 72 65 6e 63 65 73 00 52 65 6d 6f 76 65 20 64 65 66 61 75 6c 74 20	os/)..References.Remove.default.
75a0	64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2c 20	dhcp.client.on.first.interface,.
75c0	61 6e 64 20 6c 6f 61 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72	and.load.other.configuration.dur
75e0	69 6e 67 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 75 73 69 6e 67 20 63 6c 6f 75 64 2d 69 6e 69 74	ing.first.boot,.using.cloud-init
7600	2e 00 52 65 73 65 74 20 4f 62 6a 65 63 74 00 52 75 6e 20 61 6e 73 69 62 6c 65 00 52 75 6e 20 63	..Reset.Object.Run.ansible.Run.c
7620	6f 6d 6d 61 6e 64 73 20 72 65 6d 6f 74 65 6c 79 00 52 75 6e 20 63 6f 6e 66 69 67 75 72 61 74 69	ommands.remotely.Run.configurati
7640	6f 6e 20 63 6f 6d 6d 61 6e 64 73 00 52 75 6e 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d	on.commands.Run.operational.comm
7660	61 6e 64 73 00 53 53 48 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 6f 6e 20 70 6f 72 74 20 32	ands.SSH.is.configured.on.port.2
7680	32 2e 00 53 61 6c 74 00 53 61 6c 74 20 6d 61 73 74 65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	2..Salt.Salt.master.configuratio
76a0	6e 3a 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	n:.Save.a.running.configuration.
76c0	74 6f 20 61 20 66 69 6c 65 2e 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67	to.a.file..Save.a.running.config
76e0	75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 74 61 72 74 75 70 20 63 6f 6e 66 69 67 75 72 61	uration.to.the.startup.configura
7700	74 69 6f 6e 2e 20 57 68 65 6e 20 79 6f 75 20 64 6f 6e 27 74 20 73 70 65 63 69 66 79 20 74 68 65	tion..When.you.don't.specify.the
7720	20 66 69 6c 65 20 77 68 65 6e 20 73 61 76 69 6e 67 2c 20 69 74 20 73 61 76 65 73 20 74 6f 20 60	.file.when.saving,.it.saves.to.`
7740	60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 2e 00 53 63 72 69 70 74 20 76	`/config/config.boot``..Script.v
7760	79 6f 73 2d 6e 61 70 61 6c 6d 2e 70 79 00 53 63 72 69 70 74 73 20 61 72 65 20 72 75 6e 20 69 6e	yos-napalm.py.Scripts.are.run.in
7780	20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64 65 72 2e 20 54 68 65 69 72 20 6e 61 6d 65 73	.alphabetical.order..Their.names
77a0	20 6d 75 73 74 20 63 6f 6e 73 69 73 74 20 65 6e 74 69 72 65 6c 79 20 6f 66 20 41 53 43 49 49 20	.must.consist.entirely.of.ASCII.
77c0	75 70 70 65 72 2d 20 61 6e 64 20 6c 6f 77 65 72 2d 63 61 73 65 20 6c 65 74 74 65 72 73 2c 41 53	upper-.and.lower-case.letters,AS
77e0	43 49 49 20 64 69 67 69 74 73 2c 20 41 53 43 49 49 20 75 6e 64 65 72 73 63 6f 72 65 73 2c 20 61	CII.digits,.ASCII.underscores,.a
7800	6e 64 20 41 53 43 49 49 20 6d 69 6e 75 73 2d 68 79 70 68 65 6e 73 2e 4e 6f 20 6f 74 68 65 72 20	nd.ASCII.minus-hyphens.No.other.
7820	63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 00 53 68 6f 77 20 4f 62 6a	characters.are.allowed..Show.Obj
7840	65 63 74 00 53 6f 6d 65 74 69 6d 65 73 20 79 6f 75 20 73 69 6d 70 6c 79 20 77 61 6e 27 74 20 74	ect.Sometimes.you.simply.wan't.t
7860	6f 20 65 78 65 63 75 74 65 20 61 20 62 75 6e 63 68 20 6f 66 20 6f 70 2d 6d 6f 64 65 20 63 6f 6d	o.execute.a.bunch.of.op-mode.com
7880	6d 61 6e 64 73 20 76 69 61 20 53 53 48 20 6f 6e 20 61 20 72 65 6d 6f 74 65 20 56 79 4f 53 20 73	mands.via.SSH.on.a.remote.VyOS.s
78a0	79 73 74 65 6d 2e 00 53 74 6f 72 61 67 65 64 20 75 73 65 64 3a 20 76 6f 6c 75 6d 65 20 6c 6f 63	ystem..Storaged.used:.volume.loc
78c0	61 6c 2c 20 77 68 69 63 68 20 69 73 20 6d 6f 75 6e 74 65 64 20 6f 6e 20 64 69 72 65 63 74 6f 72	al,.which.is.mounted.on.director
78e0	79 20 2a 2a 2f 76 61 72 2f 6c 69 62 2f 76 7a 2a 2a 2c 20 61 6e 64 20 63 6f 6e 74 61 69 6e 73 20	y.**/var/lib/vz**,.and.contains.
7900	61 6c 6c 20 74 79 70 65 20 6f 66 20 63 6f 6e 74 65 6e 74 2c 20 69 6e 63 6c 75 64 69 6e 67 20 73	all.type.of.content,.including.s
7920	6e 69 70 70 65 74 73 2e 00 53 74 72 75 63 74 75 72 65 20 6f 66 20 2f 73 72 76 2f 73 61 6c 74 3a	nippets..Structure.of./srv/salt:
7940	00 53 74 72 75 63 74 75 72 65 20 6f 66 20 66 69 6c 65 73 00 53 79 73 74 65 6d 20 44 65 66 61 75	.Structure.of.files.System.Defau
7960	6c 74 73 2f 46 61 6c 6c 62 61 63 6b 73 00 54 68 65 20 41 50 49 20 70 75 73 68 65 73 20 65 76 65	lts/Fallbacks.The.API.pushes.eve
7980	72 79 20 72 65 71 75 65 73 74 20 74 6f 20 61 20 73 65 73 73 69 6f 6e 20 61 6e 64 20 63 6f 6d 6d	ry.request.to.a.session.and.comm
79a0	69 74 20 69 74 2e 20 42 75 74 20 73 6f 6d 65 20 6f 66 20 56 79 4f 53 20 63 6f 6d 70 6f 6e 65 6e	it.it..But.some.of.VyOS.componen
79c0	74 73 20 6c 69 6b 65 20 44 48 43 50 20 61 6e 64 20 50 50 50 6f 45 20 53 65 72 76 65 72 73 2c 20	ts.like.DHCP.and.PPPoE.Servers,.
79e0	49 50 53 65 63 2c 20 56 58 4c 41 4e 2c 20 61 6e 64 20 6f 74 68 65 72 20 74 75 6e 6e 65 6c 73 20	IPSec,.VXLAN,.and.other.tunnels.
7a00	72 65 71 75 69 72 65 20 66 75 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 6f 72 20 63	require.full.configuration.for.c
7a20	6f 6d 6d 69 74 2e 20 54 68 65 20 65 6e 64 70 6f 69 6e 74 20 77 69 6c 6c 20 70 72 6f 63 65 73 73	ommit..The.endpoint.will.process
7a40	20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d 6d 61 6e 64 73 20 77 68 65 6e 20 79 6f 75 20 70 61 73 73	.multiple.commands.when.you.pass
7a60	20 74 68 65 6d 20 61 73 20 61 20 6c 69 73 74 20 74 6f 20 74 68 65 20 60 60 64 61 74 61 60 60 20	.them.as.a.list.to.the.``data``.
7a80	66 69 65 6c 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f	field..The.``/config/scripts/vyo
7aa0	73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 60 60 20 73 63 72	s-postconfig-bootup.script``.scr
7ac0	69 70 74 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 61 66 74 65 72 20 74 68 65 20	ipt.is.called.on.boot.after.the.
7ae0	56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 66 75 6c 6c 79 20 61 70 70 6c	VyOS.configuration.is.fully.appl
7b00	69 65 64 2e 00 54 68 65 20 60 60 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d	ied..The.``/config/scripts/vyos-
7b20	70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 60 60 20 73 63 72 69 70 74	preconfig-bootup.script``.script
7b40	20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 62 6f 6f 74 20 62 65 66 6f 72 65 20 74 68 65 20 56 79	.is.called.on.boot.before.the.Vy
7b60	4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72 69 6e 67 20 62 6f 6f 74 20 70 72 6f	OS.configuration.during.boot.pro
7b80	63 65 73 73 2e 00 54 68 65 20 60 60 2f 73 68 6f 77 60 60 20 65 6e 64 70 6f 69 6e 74 20 69 73 20	cess..The.``/show``.endpoint.is.
7ba0	74 6f 20 73 68 6f 77 20 65 76 65 72 79 74 68 69 6e 67 20 69 6e 20 74 68 65 20 6f 70 65 72 61 74	to.show.everything.in.the.operat
7bc0	69 6f 6e 61 6c 20 6d 6f 64 65 2e 00 54 68 65 20 60 60 67 65 6e 65 72 61 74 65 60 60 20 65 6e 64	ional.mode..The.``generate``.end
7be0	70 6f 69 6e 74 20 72 75 6e 20 61 20 60 60 67 65 6e 65 72 61 74 65 60 60 20 63 6f 6d 6d 61 6e 64	point.run.a.``generate``.command
7c00	2e 00 54 68 65 20 60 60 72 65 73 65 74 60 60 20 65 6e 64 70 6f 69 6e 74 20 72 75 6e 20 61 20 60	..The.``reset``.endpoint.run.a.`
7c20	60 72 65 73 65 74 60 60 20 63 6f 6d 6d 61 6e 64 2e 00 54 68 65 20 63 6f 6d 6d 61 6e 64 73 20 6c	`reset``.command..The.commands.l
7c40	69 73 74 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 60 60 73 68 6f 77 20 63 6f 6e 66 69	ist.produced.by.the.``show.confi
7c60	67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 60 60 20 63 6f 6d 6d 61 6e 64 20 6f 6e 20 61	guration.commands``.command.on.a
7c80	20 56 79 4f 53 20 72 6f 75 74 65 72 20 73 68 6f 75 6c 64 20 63 6f 6d 70 6c 79 20 77 69 74 68 20	.VyOS.router.should.comply.with.
7ca0	61 6c 6c 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f 20 69 74 20 69 73 20 65	all.the.requirements,.so.it.is.e
7cc0	61 73 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70 65 72 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 73	asy.to.get.a.proper.commands.lis
7ce0	74 20 62 79 20 63 6f 70 79 69 6e 67 20 69 74 20 66 72 6f 6d 20 61 6e 6f 74 68 65 72 20 72 6f 75	t.by.copying.it.from.another.rou
7d00	74 65 72 2e 00 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 70 65 63 69 66 69 65 64	ter..The.configuration.specified
7d20	20 69 6e 20 74 68 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 64 6f 63 75 6d 65 6e 74 20 6f 76	.in.the.cloud-config.document.ov
7d40	65 72 77 72 69 74 65 73 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76	erwrites.default.configuration.v
7d60	61 6c 75 65 73 20 61 6e 64 20 76 61 6c 75 65 73 20 63 6f 6e 66 69 67 75 72 65 64 20 76 69 61 20	alues.and.values.configured.via.
7d80	4d 65 74 61 64 61 74 61 2e 00 54 68 65 20 64 65 66 61 75 6c 74 20 64 69 72 65 63 74 6f 72 69 65	Metadata..The.default.directorie
7da0	73 20 77 68 65 72 65 20 79 6f 75 72 20 63 75 73 74 6f 6d 20 53 63 72 69 70 74 73 20 73 68 6f 75	s.where.your.custom.Scripts.shou
7dc0	6c 64 20 62 65 20 6c 6f 63 61 74 65 64 20 61 72 65 3a 00 54 68 65 20 64 65 66 61 75 6c 74 20 66	ld.be.located.are:.The.default.f
7de0	69 6c 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 68 65 20 65 61 73 69 65 73 74	ile.looks.like.this:.The.easiest
7e00	20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 76 69 61	.way.to.configure.the.system.via
7e20	20 75 73 65 72 2d 64 61 74 61 20 69 73 20 74 68 65 20 43 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 73	.user-data.is.the.Cloud-config.s
7e40	79 6e 74 61 78 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f 77 2e 00 54 68 65 20 65 6e 64 70 6f	yntax.described.below..The.endpo
7e60	69 6e 74 20 60 60 2f 63 6f 6e 66 69 67 2d 66 69 6c 65 60 60 20 69 73 20 74 6f 20 73 61 76 65 20	int.``/config-file``.is.to.save.
7e80	6f 72 20 6c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 54 68 65 20 66 6f 6c	or.load.a.configuration..The.fol
7ea0	6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 20 73 65 74 73 20 74 68 65 20 68 6f 73 74 6e 61 6d 65	lowing.example.sets.the.hostname
7ec0	20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 69 6e 73 74 61 6e 63 65 20 69 64 65 6e 74 69 66 69 65	.based.on.the.instance.identifie
7ee0	72 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 45 43 32 20 6d 65 74 61 64 61 74 61	r.obtained.from.the.EC2.metadata
7f00	20 73 65 72 76 69 63 65 2e 00 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 6c 65 20	.service..The.following.example.
7f20	73 68 6f 77 73 20 68 6f 77 20 74 6f 20 65 78 65 63 75 74 65 20 63 6f 6d 6d 61 6e 64 73 20 61 66	shows.how.to.execute.commands.af
7f40	74 65 72 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 54	ter.the.initial.configuration..T
7f60	68 65 20 6b 65 79 20 75 73 65 64 20 74 6f 20 64 65 73 69 67 6e 61 74 65 20 61 20 56 79 4f 53 20	he.key.used.to.designate.a.VyOS.
7f80	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63	configuration.is.``vyos_config_c
7fa0	6f 6d 6d 61 6e 64 73 60 60 2e 20 57 68 61 74 20 66 6f 6c 6c 6f 77 73 20 69 73 20 56 79 4f 53 20	ommands``..What.follows.is.VyOS.
7fc0	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 75 73 69 6e 67 20 74 68 65 20 22 73 65 74 2d 73 74 79	configuration.using.the."set-sty
7fe0	6c 65 22 20 73 79 6e 74 61 78 2e 20 42 6f 74 68 20 22 73 65 74 22 20 61 6e 64 20 22 64 65 6c 65	le".syntax..Both."set".and."dele
8000	74 65 22 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e 00 54 68 65 20	te".commands.are.supported..The.
8020	73 65 65 64 2e 69 73 6f 20 66 69 6c 65 20 63 61 6e 20 62 65 20 61 74 74 61 63 68 65 64 20 74 6f	seed.iso.file.can.be.attached.to
8040	20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 41 73 20 61 6e 20 65 78 61 6d	.the.virtual.machine..As.an.exam
8060	70 6c 65 2c 20 74 68 65 20 6d 65 74 68 6f 64 20 77 69 74 68 20 4b 56 4d 20 74 6f 20 61 74 74 61	ple,.the.method.with.KVM.to.atta
8080	63 68 20 74 68 65 20 49 53 4f 20 61 73 20 61 20 43 44 20 64 72 69 76 65 20 66 6f 6c 6c 6f 77 73	ch.the.ISO.as.a.CD.drive.follows
80a0	2e 00 54 68 65 72 65 20 69 73 20 61 20 70 69 74 66 61 6c 6c 20 77 68 65 6e 20 77 6f 72 6b 69 6e	..There.is.a.pitfall.when.workin
80c0	67 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 63 72 69 70 74 73 2e 20 49 74	g.with.configuration.scripts..It
80e0	20 69 73 20 74 65 6d 70 74 69 6e 67 20 74 6f 20 63 61 6c 6c 20 63 6f 6e 66 69 67 75 72 61 74 69	.is.tempting.to.call.configurati
8100	6f 6e 20 73 63 72 69 70 74 73 20 77 69 74 68 20 22 73 75 64 6f 22 20 28 69 2e 65 2e 2c 20 74 65	on.scripts.with."sudo".(i.e.,.te
8120	6d 70 6f 72 61 72 79 20 72 6f 6f 74 20 70 65 72 6d 69 73 73 69 6f 6e 73 29 2c 20 62 65 63 61 75	mporary.root.permissions),.becau
8140	73 65 20 74 68 61 74 27 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 77 61 79 20 6f 6e 20 6d 6f 73 74	se.that's.the.common.way.on.most
8160	20 4c 69 6e 75 78 20 70 6c 61 74 66 6f 72 6d 73 20 74 6f 20 63 61 6c 6c 20 73 79 73 74 65 6d 20	.Linux.platforms.to.call.system.
8180	63 6f 6d 6d 61 6e 64 73 2e 00 54 68 65 73 65 20 61 72 65 20 74 68 65 20 56 79 4f 53 20 64 65 66	commands..These.are.the.VyOS.def
81a0	61 75 6c 74 73 20 61 6e 64 20 66 61 6c 6c 62 61 63 6b 73 2e 00 54 68 69 73 20 73 65 63 74 69 6f	aults.and.fallbacks..This.sectio
81c0	6e 20 6e 65 65 64 73 20 69 6d 70 72 6f 76 65 6d 65 6e 74 73 2c 20 65 78 61 6d 70 6c 65 73 20 61	n.needs.improvements,.examples.a
81e0	6e 64 20 65 78 70 6c 61 6e 61 74 69 6f 6e 73 2e 00 54 68 69 73 20 77 69 6c 6c 20 72 65 73 75 6c	nd.explanations..This.will.resul
8200	74 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65	t.in.the.following.error.message
8220	3a 20 60 60 53 65 74 20 66 61 69 6c 65 64 60 60 20 49 66 20 74 68 69 73 20 68 61 70 70 65 6e 73	:.``Set.failed``.If.this.happens
8240	2c 20 61 20 72 65 62 6f 6f 74 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 62 65 20 61 62 6c	,.a.reboot.is.required.to.be.abl
8260	65 20 74 6f 20 65 64 69 74 20 74 68 65 20 63 6f 6e 66 69 67 20 6d 61 6e 75 61 6c 6c 79 20 61 67	e.to.edit.the.config.manually.ag
8280	61 69 6e 2e 00 54 6f 20 4c 6f 61 64 20 61 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c	ain..To.Load.a.configuration.fil
82a0	65 2e 00 54 6f 20 61 64 64 20 6f 72 20 64 65 6c 65 74 65 20 61 6e 20 69 6d 61 67 65 2c 20 75 73	e..To.add.or.delete.an.image,.us
82c0	65 20 74 68 65 20 60 60 2f 69 6d 61 67 65 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 6f 20 61 76	e.the.``/image``.endpoint..To.av
82e0	6f 69 64 20 74 68 65 73 65 20 70 72 6f 62 6c 65 6d 73 2c 20 74 68 65 20 70 72 6f 70 65 72 20 77	oid.these.problems,.the.proper.w
8300	61 79 20 69 73 20 74 6f 20 63 61 6c 6c 20 61 20 73 63 72 69 70 74 20 77 69 74 68 20 74 68 65 20	ay.is.to.call.a.script.with.the.
8320	60 60 76 79 61 74 74 61 63 66 67 60 60 20 67 72 6f 75 70 2c 20 65 2e 67 2e 2c 20 62 79 20 75 73	``vyattacfg``.group,.e.g.,.by.us
8340	69 6e 67 20 74 68 65 20 60 60 73 67 60 60 20 28 73 77 69 74 63 68 20 67 72 6f 75 70 29 20 63 6f	ing.the.``sg``.(switch.group).co
8360	6d 6d 61 6e 64 3a 00 54 6f 20 67 65 74 20 74 68 65 20 77 68 6f 6c 65 20 63 6f 6e 66 69 67 75 72	mmand:.To.get.the.whole.configur
8380	61 74 69 6f 6e 2c 20 70 61 73 73 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 74 20 74 6f 20 74 68 65	ation,.pass.an.empty.list.to.the
83a0	20 60 60 70 61 74 68 60 60 20 66 69 65 6c 64 00 54 6f 20 69 6e 63 6c 75 64 65 20 56 79 4f 53 20	.``path``.field.To.include.VyOS.
83c0	73 70 65 63 69 66 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20 61 6c 69 61 73 65 73 20 79	specific.functions.and.aliases.y
83e0	6f 75 20 6e 65 65 64 20 74 6f 20 60 60 73 6f 75 72 63 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f	ou.need.to.``source./opt/vyatta/
8400	65 74 63 2f 66 75 6e 63 74 69 6f 6e 73 2f 73 63 72 69 70 74 2d 74 65 6d 70 6c 61 74 65 60 60 20	etc/functions/script-template``.
8420	66 69 6c 65 73 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 79 6f 75 72 20 73 63 72 69 70 74 2e	files.at.the.top.of.your.script.
8440	00 54 6f 20 69 6e 69 74 69 61 74 65 20 61 20 72 65 62 6f 6f 74 20 75 73 65 20 74 68 65 20 60 60	.To.initiate.a.reboot.use.the.``
8460	72 65 62 6f 6f 74 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 6f 20 6d 61 6b 65 20 73 75 72 65 20	reboot``.endpoint..To.make.sure.
8480	74 68 61 74 20 61 20 73 63 72 69 70 74 20 69 73 20 6e 6f 74 20 61 63 63 69 64 65 6e 74 61 6c 6c	that.a.script.is.not.accidentall
84a0	79 20 63 61 6c 6c 65 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 60 60 76 79 61 74 74 61 63 66 67	y.called.without.the.``vyattacfg
84c0	60 60 20 67 72 6f 75 70 2c 20 74 68 65 20 73 63 72 69 70 74 20 63 61 6e 20 62 65 20 73 61 66 65	``.group,.the.script.can.be.safe
84e0	67 75 61 72 64 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 00 54 6f 20 6f 6e 6c 79 20 67 65 74 20 61	guarded.like.this:.To.only.get.a
8500	20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 66 6f 72 20	.part.of.the.configuration,.for.
8520	65 78 61 6d 70 6c 65 20 60 60 73 79 73 74 65 6d 20 73 79 73 6c 6f 67 60 60 2e 00 54 6f 20 70 6f	example.``system.syslog``..To.po
8540	77 65 72 20 6f 66 66 20 74 68 65 20 73 79 73 74 65 6d 20 75 73 65 20 74 68 65 20 60 60 70 6f 77	wer.off.the.system.use.the.``pow
8560	65 72 6f 66 66 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 54 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e	eroff``.endpoint..Troubleshootin
8580	67 00 55 6e 6c 69 6b 65 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20	g.Unlike.a.normal.configuration.
85a0	73 65 73 73 69 6f 6e 2c 20 61 6c 6c 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64	session,.all.operational.command
85c0	73 20 6d 75 73 74 20 62 65 20 70 72 65 70 65 6e 64 65 64 20 77 69 74 68 20 60 60 72 75 6e 60 60	s.must.be.prepended.with.``run``
85e0	2c 20 65 76 65 6e 20 69 66 20 79 6f 75 20 68 61 76 65 6e 27 74 20 63 72 65 61 74 65 64 20 61 20	,.even.if.you.haven't.created.a.
8600	73 65 73 73 69 6f 6e 20 77 69 74 68 20 63 6f 6e 66 69 67 75 72 65 2e 00 55 73 65 72 2d 64 61 74	session.with.configure..User-dat
8620	61 00 55 73 65 72 2d 64 61 74 61 20 2d 20 55 73 65 72 2d 64 61 74 61 20 69 73 20 73 70 65 63 69	a.User-data.-.User-data.is.speci
8640	66 69 65 64 20 62 79 20 74 68 65 20 75 73 65 72 2e 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f	fied.by.the.user..This.config.so
8660	75 72 63 65 20 6f 66 66 65 72 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 69 6e 73 65 72	urce.offers.the.ability.to.inser
8680	74 20 61 6e 79 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73	t.any.CLI.configuration.commands
86a0	20 69 6e 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 62 65 66 6f 72 65 20 74	.into.the.configuration.before.t
86c0	68 65 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 55 73 69 6e 67 20 41 50 49 20 52 65 73 70 6f 6e 73	he.first.boot..Using.API.Respons
86e0	65 20 43 6c 61 73 73 00 55 73 69 6e 67 20 50 79 56 79 4f 53 00 56 4d 20 49 44 3a 20 69 6e 20 74	e.Class.Using.PyVyOS.VM.ID:.in.t
8700	68 69 73 20 65 78 61 6d 70 6c 65 2c 20 56 4d 20 49 44 20 75 73 65 64 20 69 73 20 35 35 35 2e 00	his.example,.VM.ID.used.is.555..
8720	56 4d 20 52 65 73 6f 75 72 63 65 73 3a 20 74 68 65 73 65 20 70 61 72 61 6d 65 74 65 72 73 20 63	VM.Resources:.these.parameters.c
8740	61 6e 20 62 65 20 6d 6f 64 69 66 69 65 64 20 61 73 20 6e 65 65 64 65 64 2e 00 56 4d 20 53 74 6f	an.be.modified.as.needed..VM.Sto
8760	72 61 67 65 3a 20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 73 20 75 73 65 64 2e 00	rage:.``local``.volume.is.used..
8780	56 79 4f 53 20 41 50 49 00 56 79 4f 53 20 41 75 74 6f 6d 61 74 69 6f 6e 00 56 79 4f 53 20 60 63	VyOS.API.VyOS.Automation.VyOS.`c
87a0	6c 6f 75 64 2d 69 6e 69 74 2d 64 6f 63 73 60 5f 2e 00 56 79 4f 53 20 63 6c 6f 75 64 2d 69 6e 69	loud-init-docs`_..VyOS.cloud-ini
87c0	74 00 56 79 4f 53 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72	t.VyOS.configuration.commands.ar
87e0	65 20 64 65 66 69 6e 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20 66 69 6c 65 2e 00 56 79 4f	e.defined.in.user-data.file..VyO
8800	53 20 68 61 73 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 72 75 6e 20 63 75 73 74 6f 6d 20	S.has.the.ability.to.run.custom.
8820	20 73 63 72 69 70 74 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 20 65 61 63 68 20 63	.scripts.before.and.after.each.c
8840	6f 6d 6d 69 74 00 56 79 4f 53 20 73 75 70 70 6f 72 74 20 74 68 72 65 65 20 74 79 70 65 73 20 6f	ommit.VyOS.support.three.types.o
8860	66 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20	f.config.sources..VyOS.supports.
8880	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 61 6e 73 69 62 6c 65 2e 20 4e 65 65 64 20	configuration.via.ansible..Need.
88a0	74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 61 6e 73 69 62 6c 65 60 60 20 61 6e 64 20 60 60 70 79 74	to.install.``ansible``.and.``pyt
88c0	68 6f 6e 33 2d 70 61 72 61 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 00 56 79 4f 53 20 73 75 70 70	hon3-paramiko``.module.VyOS.supp
88e0	6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 6e 65 74 6d 69 6b 6f 5f 2e	orts.configuration.via.netmiko_.
8900	20 49 74 20 72 65 71 75 69 72 65 73 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 70 79 74 68 6f 6e	.It.requires.to.install.``python
8920	33 2d 6e 65 74 6d 69 6b 6f 60 60 20 6d 6f 64 75 6c 65 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74	3-netmiko``.module..VyOS.support
8940	73 20 65 78 65 63 75 74 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70	s.executing.configuration.and.op
8960	65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69	erational.commands.non-interacti
8980	76 65 6c 79 20 66 72 6f 6d 20 73 68 65 6c 6c 20 73 63 72 69 70 74 73 2e 00 56 79 4f 53 20 73 75	vely.from.shell.scripts..VyOS.su
89a0	70 70 6f 72 74 73 20 6f 70 2d 6d 6f 64 65 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	pports.op-mode.and.configuration
89c0	20 76 69 61 20 73 61 6c 74 5f 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 73 6f 6d 65 20 6e	.via.salt_..VyOS.supports.some.n
89e0	61 70 61 6c 6d 5f 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69	apalm_.functions.for.configurati
8a00	6f 6e 20 61 6e 64 20 6f 70 2d 6d 6f 64 65 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 6d 6f 72 65	on.and.op-mode..It.requires.more
8a20	20 74 65 73 74 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 65 78 65 63 75 74	.tests..VyOS.supports.the.execut
8a40	69 6f 6e 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20	ion.of.operational.commands.and.
8a60	6c 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 69 6e 69 74 69 61 6c 20 62 6f 6f 74 2e 20	linux.commands.at.initial.boot..
8a80	54 68 69 73 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75 73 69 6e 67 20 60 60 77 72 69	This.is.accomplished.using.``wri
8aa0	74 65 5f 66 69 6c 65 73 60 60 20 74 6f 20 63 65 72 74 61 69 6e 20 66 69 6c 65 73 20 69 6e 20 74	te_files``.to.certain.files.in.t
8ac0	68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74	he./opt/vyatta/etc/config/script
8ae0	73 20 64 69 72 65 63 74 6f 72 79 2e 20 43 6f 6d 6d 61 6e 64 73 20 73 70 65 63 69 66 69 65 64 20	s.directory..Commands.specified.
8b00	69 6e 20 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73	in.opt/vyatta/etc/config/scripts
8b20	2f 76 79 6f 73 2d 70 72 65 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 20 61 72	/vyos-preconfig-bootup.script.ar
8b40	65 20 65 78 65 63 75 74 65 64 20 70 72 69 6f 72 20 74 6f 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	e.executed.prior.to.configuratio
8b60	6e 2e 20 54 68 65 20 2f 6f 70 74 2f 76 79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f 73 63	n..The./opt/vyatta/etc/config/sc
8b80	72 69 70 74 73 2f 76 79 6f 73 2d 70 6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72	ripts/vyos-postconfig-bootup.scr
8ba0	69 70 74 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 62 65	ipt.file.contains.commands.to.be
8bc0	20 65 78 65 63 75 74 65 64 20 61 66 74 65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 49	.executed.after.configuration..I
8be0	6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 78 65 63 75	n.both.cases,.commands.are.execu
8c00	74 65 64 20 61 73 20 74 68 65 20 72 6f 6f 74 20 75 73 65 72 2e 00 57 65 20 6e 65 65 64 20 32 20	ted.as.the.root.user..We.need.2.
8c20	66 69 6c 65 73 2c 20 63 6f 6d 6d 61 6e 64 73 2e 63 6f 6e 66 20 61 6e 64 20 73 63 72 69 70 74 20	files,.commands.conf.and.script.
8c40	69 74 73 65 6c 66 2e 00 57 68 69 6c 65 20 6f 74 68 65 72 20 6d 65 74 68 6f 64 73 20 65 78 69 73	itself..While.other.methods.exis
8c60	74 2c 20 74 68 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68 74 66 6f 72 77 61 72 64 20 6d 65 74 68	t,.the.most.straightforward.meth
8c80	6f 64 20 66 6f 72 20 75 73 69 6e 67 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 64 61 74 61 20 73 6f	od.for.using.the.NoCloud.data.so
8ca0	75 72 63 65 20 69 73 20 63 72 65 61 74 69 6e 67 20 61 20 73 65 65 64 20 49 53 4f 20 61 6e 64 20	urce.is.creating.a.seed.ISO.and.
8cc0	61 74 74 61 63 68 69 6e 67 20 69 74 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68	attaching.it.to.the.virtual.mach
8ce0	69 6e 65 20 61 73 20 61 20 43 44 20 64 72 69 76 65 2e 20 54 68 65 20 76 6f 6c 75 6d 65 20 6d 75	ine.as.a.CD.drive..The.volume.mu
8d00	73 74 20 62 65 20 66 6f 72 6d 61 74 74 65 64 20 61 73 20 61 20 76 66 61 74 20 6f 72 20 49 53 4f	st.be.formatted.as.a.vfat.or.ISO
8d20	20 39 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 20 77 69 74 68 20 74 68 65 20 6c 61 62 65 6c	.9660.file.system.with.the.label
8d40	20 22 63 69 64 61 74 61 22 20 6f 72 20 22 43 49 44 41 54 41 22 2e 00 57 69 6c 6c 20 72 65 74 75	."cidata".or."CIDATA"..Will.retu
8d60	72 6e 3a 00 57 69 74 68 20 74 68 65 20 60 60 72 65 74 72 69 65 76 65 60 60 20 65 6e 64 70 6f 69	rn:.With.the.``retrieve``.endpoi
8d80	6e 74 20 79 6f 75 20 67 65 74 20 70 61 72 74 73 20 6f 72 20 74 68 65 20 77 68 6f 6c 65 20 63 6f	nt.you.get.parts.or.the.whole.co
8da0	6e 66 69 67 75 72 61 74 69 6f 6e 2e 00 57 69 74 68 6f 75 74 20 70 72 6f 78 79 20 69 74 20 72 65	nfiguration..Without.proxy.it.re
8dc0	71 75 69 72 65 73 20 56 79 4f 53 20 6d 69 6e 69 6f 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e	quires.VyOS.minion.configuration
8de0	20 61 6e 64 20 73 75 70 70 6f 72 74 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 57 69 74 68 6f	.and.support.op-mode.data:.Witho
8e00	75 74 20 70 72 6f 78 79 20 69 74 20 72 65 71 75 69 72 65 73 20 56 79 4f 53 20 6d 69 6e 69 6f 6e	ut.proxy.it.requires.VyOS.minion
8e20	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d	.configuration.and.supports.op-m
8e40	6f 64 65 20 64 61 74 61 3a 00 59 6f 75 20 63 61 6e 20 69 6e 73 74 61 6c 6c 20 50 79 56 79 4f 53	ode.data:.You.can.install.PyVyOS
8e60	20 75 73 69 6e 67 20 70 69 70 3a 00 59 6f 75 20 63 61 6e 20 70 61 73 73 20 61 20 60 60 73 65 74	.using.pip:.You.can.pass.a.``set
8e80	60 60 2c 20 60 60 64 65 6c 65 74 65 60 60 20 6f 72 20 60 60 63 6f 6d 6d 65 6e 74 60 60 20 63 6f	``,.``delete``.or.``comment``.co
8ea0	6d 6d 61 6e 64 20 74 6f 20 74 68 65 20 60 60 2f 63 6f 6e 66 69 67 75 72 65 60 60 20 65 6e 64 70	mmand.to.the.``/configure``.endp
8ec0	6f 69 6e 74 2e 00 60 60 64 65 6c 65 74 65 60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e	oint..``delete``.a.single.comman
8ee0	64 00 60 60 73 65 65 64 2e 69 73 6f 60 60 20 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 63 72	d.``seed.iso``.was.previously.cr
8f00	65 61 74 65 64 20 69 6e 20 64 69 72 65 63 74 6f 72 79 20 60 60 2f 74 6d 70 2f 60 60 2e 20 49 74	eated.in.directory.``/tmp/``..It
8f20	27 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 65 20 69 74 20 74 6f 20 60 60 2f 76 61	's.necessary.to.move.it.to.``/va
8f40	72 2f 6c 69 62 2f 76 7a 2f 74 65 6d 70 6c 61 74 65 2f 69 73 6f 60 60 00 60 60 73 65 74 60 60 20	r/lib/vz/template/iso``.``set``.
8f60	61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 00 60 60 76 79 6f 73 5f 75 73 65 72 64 61 74 61	a.single.command.``vyos_userdata
8f80	60 60 20 2d 20 74 68 65 20 6d 6f 64 75 6c 65 20 61 63 63 65 70 74 73 20 61 20 6c 69 73 74 20 6f	``.-.the.module.accepts.a.list.o
8fa0	66 20 43 4c 49 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 20	f.CLI.configuration.commands.in.
8fc0	61 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 73 65 63 74 69	a.``vyos_config_commands``.secti
8fe0	6f 6e 2c 20 77 68 69 63 68 20 67 69 76 65 73 20 61 6e 20 65 61 73 79 20 77 61 79 20 74 6f 20 63	on,.which.gives.an.easy.way.to.c
9000	6f 6e 66 69 67 75 72 65 20 74 68 65 20 73 79 73 74 65 6d 20 64 75 72 69 6e 67 20 64 65 70 6c 6f	onfigure.the.system.during.deplo
9020	79 6d 65 6e 74 2e 00 60 60 76 79 6f 73 60 60 2f 60 60 76 79 6f 73 60 60 20 63 72 65 64 65 6e 74	yment..``vyos``/``vyos``.credent
9040	69 61 6c 73 20 69 66 20 6e 6f 20 6f 74 68 65 72 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 64	ials.if.no.others.specified.by.d
9060	61 74 61 20 73 6f 75 72 63 65 2e 00 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 2d 20 74 68	ata.source..``write_files``.-.th
9080	69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f 77 73 20 74 6f 20 69 6e 73 65 72 74 20 61 6e 79 20 66	is.module.allows.to.insert.any.f
90a0	69 6c 65 73 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 62 65 66 6f 72 65 20	iles.into.the.filesystem.before.
90c0	74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 70 72 65	the.first.boot,.for.example,.pre
90e0	2d 67 65 6e 65 72 61 74 65 64 20 65 6e 63 72 79 70 74 69 6f 6e 20 6b 65 79 73 2c 20 63 65 72 74	-generated.encryption.keys,.cert
9100	69 66 69 63 61 74 65 73 2c 20 6f 72 20 65 76 65 6e 20 61 20 77 68 6f 6c 65 20 60 60 63 6f 6e 66	ificates,.or.even.a.whole.``conf
9120	69 67 2e 62 6f 6f 74 60 60 20 66 69 6c 65 2e 20 54 68 65 20 66 6f 72 6d 61 74 20 69 73 20 64 65	ig.boot``.file..The.format.is.de
9140	73 63 72 69 62 65 64 20 69 6e 20 74 68 65 20 63 6c 6f 75 64 69 6e 69 74 20 64 6f 63 75 6d 65 6e	scribed.in.the.cloudinit.documen
9160	74 61 74 69 6f 6e 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 77 72 69 74 65 5f 66 69 6c 65 73 60 5f	tation.`Cloud-init-write_files`_
9180	2e 00 61 64 64 20 61 6e 20 69 6d 61 67 65 00 61 6e 73 69 62 6c 65 2e 63 66 67 00 63 6c 6f 75 64	..add.an.image.ansible.cfg.cloud
91a0	2d 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 74 00 63 6c 6f 75 64 2d 69 6e 69 74 20 6c	-config.file.format.cloud-init.l
91c0	6f 67 73 20 74 6f 20 2f 76 61 72 2f 6c 6f 67 2f 63 6c 6f 75 64 2d 69 6e 69 74 2e 6c 6f 67 2e 20	ogs.to./var/log/cloud-init.log..
91e0	54 68 69 73 20 66 69 6c 65 20 63 61 6e 20 62 65 20 68 65 6c 70 66 75 6c 20 69 6e 20 64 65 74 65	This.file.can.be.helpful.in.dete
9200	72 6d 69 6e 69 6e 67 20 77 68 79 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 61	rmining.why.the.configuration.va
9220	72 69 65 73 20 66 72 6f 6d 20 77 68 61 74 20 79 6f 75 20 65 78 70 65 63 74 2e 20 59 6f 75 20 63	ries.from.what.you.expect..You.c
9240	61 6e 20 66 65 74 63 68 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 64 61 74 61	an.fetch.the.most.important.data
9260	20 66 69 6c 74 65 72 69 6e 67 20 6f 75 74 70 75 74 20 66 6f 72 20 60 60 76 79 6f 73 60 60 20 6b	.filtering.output.for.``vyos``.k
9280	65 79 77 6f 72 64 3a 00 63 6f 6d 6d 61 6e 64 73 2e 74 78 74 00 64 65 6c 65 74 65 20 61 6e 20 69	eyword:.commands.txt.delete.an.i
92a0	6d 61 67 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 31 2e 33 2d 72 6f 6c 6c 69 6e 67 2d	mage,.for.example.``1.3-rolling-
92c0	32 30 32 30 30 36 30 37 30 31 31 37 60 60 00 68 6f 73 74 73 00 69 64 5f 72 73 61 5f 64 6f 63 6b	202006070117``.hosts.id_rsa_dock
92e0	65 72 2e 70 75 62 2e 20 4e 65 65 64 73 20 74 6f 20 64 65 63 6c 61 72 65 20 6f 6e 6c 79 20 70 75	er.pub..Needs.to.declare.only.pu
9300	62 6c 69 63 20 6b 65 79 20 65 78 61 63 74 6c 79 2e 00 69 66 20 79 6f 75 20 6a 75 73 74 20 77 61	blic.key.exactly..if.you.just.wa
9320	6e 74 20 74 68 65 20 56 61 6c 75 65 20 6f 66 20 61 20 6d 75 6c 74 69 2d 76 61 6c 75 65 64 20 6e	nt.the.Value.of.a.multi-valued.n
9340	6f 64 65 2c 20 75 73 65 20 74 68 65 20 60 60 72 65 74 75 72 6e 56 61 6c 75 65 73 60 60 20 6f 70	ode,.use.the.``returnValues``.op
9360	65 72 61 74 69 6f 6e 2e 00 6d 61 69 6e 2e 79 6d 6c 00 72 31 31 2d 70 72 6f 78 79 2e 73 6c 73 20	eration..main.yml.r11-proxy.sls.
9380	49 6e 63 6c 75 64 65 73 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72 20 63 6f 6e 6e 65 63 74 69	Includes.parameters.for.connecti
93a0	6e 67 20 74 6f 20 73 61 6c 74 2d 70 72 6f 78 79 20 6d 69 6e 69 6f 6e 00 73 74 61 72 74 75 70 20	ng.to.salt-proxy.minion.startup.
93c0	73 63 72 69 70 74 73 00 74 6f 70 2e 73 6c 73 00	scripts.top.sls.