blob: 4546ab53e73b429c72b32e80e30ecad7f56a00ee (plain)

ofs	hex dump	ascii
0000	de 12 04 95 00 00 00 00 ca 00 00 00 1c 00 00 00 6c 06 00 00 0d 01 00 00 bc 0c 00 00 00 00 00 00	................l...............
0020	f0 10 00 00 69 00 00 00 f1 10 00 00 25 00 00 00 5b 11 00 00 6a 00 00 00 81 11 00 00 54 00 00 00	....i.......%...[...j.......T...
0040	ec 11 00 00 5d 00 00 00 41 12 00 00 26 00 00 00 9f 12 00 00 0c 00 00 00 c6 12 00 00 0a 00 00 00	....]...A...&...................
0060	d3 12 00 00 09 00 00 00 de 12 00 00 06 00 00 00 e8 12 00 00 06 00 00 00 ef 12 00 00 09 00 00 00	................................
0080	f6 12 00 00 05 00 00 00 00 13 00 00 c2 00 00 00 06 13 00 00 f2 00 00 00 c9 13 00 00 6d 00 00 00	............................m...
00a0	bc 14 00 00 3d 00 00 00 2a 15 00 00 0d 00 00 00 68 15 00 00 11 00 00 00 76 15 00 00 64 00 00 00	....=...*.......h.......v...d...
00c0	88 15 00 00 44 00 00 00 ed 15 00 00 19 00 00 00 32 16 00 00 07 00 00 00 4c 16 00 00 8f 00 00 00	....D...........2.......L.......
00e0	54 16 00 00 41 00 00 00 e4 16 00 00 0e 00 00 00 26 17 00 00 82 00 00 00 35 17 00 00 64 00 00 00	T...A...........&.......5...d...
0100	b8 17 00 00 22 00 00 00 1d 18 00 00 21 00 00 00 40 18 00 00 33 00 00 00 62 18 00 00 19 01 00 00	....".......!...@...3...b.......
0120	96 18 00 00 14 00 00 00 b0 19 00 00 22 00 00 00 c5 19 00 00 15 00 00 00 e8 19 00 00 21 00 00 00	............"...............!...
0140	fe 19 00 00 11 00 00 00 20 1a 00 00 23 00 00 00 32 1a 00 00 16 00 00 00 56 1a 00 00 0e 00 00 00	............#...2.......V.......
0160	6d 1a 00 00 0d 00 00 00 7c 1a 00 00 98 00 00 00 8a 1a 00 00 18 00 00 00 23 1b 00 00 1f 00 00 00	m.......|...............#.......
0180	3c 1b 00 00 0f 00 00 00 5c 1b 00 00 c7 00 00 00 6c 1b 00 00 0f 00 00 00 34 1c 00 00 5c 00 00 00	<.......\.......l.......4...\...
01a0	44 1c 00 00 49 00 00 00 a1 1c 00 00 07 00 00 00 eb 1c 00 00 4f 00 00 00 f3 1c 00 00 19 00 00 00	D...I...............O...........
01c0	43 1d 00 00 13 00 00 00 5d 1d 00 00 08 00 00 00 71 1d 00 00 1f 00 00 00 7a 1d 00 00 26 00 00 00	C.......].......q.......z...&...
01e0	9a 1d 00 00 0d 00 00 00 c1 1d 00 00 53 00 00 00 cf 1d 00 00 3d 00 00 00 23 1e 00 00 3a 00 00 00	............S.......=...#...:...
0200	61 1e 00 00 9d 00 00 00 9c 1e 00 00 37 00 00 00 3a 1f 00 00 2d 00 00 00 72 1f 00 00 b3 00 00 00	a...........7...:...-...r.......
0220	a0 1f 00 00 46 00 00 00 54 20 00 00 13 00 00 00 9b 20 00 00 19 00 00 00 af 20 00 00 55 00 00 00	....F...T...................U...
0240	c9 20 00 00 a7 00 00 00 1f 21 00 00 3c 00 00 00 c7 21 00 00 4d 01 00 00 04 22 00 00 b3 00 00 00	.........!..<....!..M...."......
0260	52 23 00 00 8d 00 00 00 06 24 00 00 8f 00 00 00 94 24 00 00 42 00 00 00 24 25 00 00 2e 00 00 00	R#.......$.......$..B...$%......
0280	67 25 00 00 62 00 00 00 96 25 00 00 a9 00 00 00 f9 25 00 00 15 00 00 00 a3 26 00 00 c7 00 00 00	g%..b....%.......%.......&......
02a0	b9 26 00 00 1e 00 00 00 81 27 00 00 d7 00 00 00 a0 27 00 00 58 01 00 00 78 28 00 00 9b 00 00 00	.&.......'.......'..X...x(......
02c0	d1 29 00 00 30 00 00 00 6d 2a 00 00 06 00 00 00 9e 2a 00 00 07 00 00 00 a5 2a 00 00 0d 00 00 00	.)..0...m*.......*.......*......
02e0	ad 2a 00 00 b6 00 00 00 bb 2a 00 00 40 00 00 00 72 2b 00 00 07 00 00 00 b3 2b 00 00 06 00 00 00	.*.......*..@...r+.......+......
0300	bb 2b 00 00 fa 00 00 00 c2 2b 00 00 50 00 00 00 bd 2c 00 00 34 00 00 00 0e 2d 00 00 a5 00 00 00	.+.......+..P....,..4....-......
0320	43 2d 00 00 12 00 00 00 e9 2d 00 00 81 00 00 00 fc 2d 00 00 15 00 00 00 7e 2e 00 00 07 00 00 00	C-.......-.......-......~.......
0340	94 2e 00 00 16 00 00 00 9c 2e 00 00 06 00 00 00 b3 2e 00 00 0e 00 00 00 ba 2e 00 00 4a 00 00 00	............................J...
0360	c9 2e 00 00 12 00 00 00 14 2f 00 00 1d 00 00 00 27 2f 00 00 11 00 00 00 45 2f 00 00 18 00 00 00	........./......'/......E/......
0380	57 2f 00 00 28 00 00 00 70 2f 00 00 1e 00 00 00 99 2f 00 00 0a 00 00 00 b8 2f 00 00 70 00 00 00	W/..(...p/......./......./..p...
03a0	c3 2f 00 00 0b 00 00 00 34 30 00 00 15 00 00 00 40 30 00 00 1a 00 00 00 56 30 00 00 18 00 00 00	./......40......@0......V0......
03c0	71 30 00 00 1d 00 00 00 8a 30 00 00 04 00 00 00 a8 30 00 00 1a 00 00 00 ad 30 00 00 27 00 00 00	q0.......0.......0.......0..'...
03e0	c8 30 00 00 8c 00 00 00 f0 30 00 00 15 00 00 00 7d 31 00 00 c9 00 00 00 93 31 00 00 62 00 00 00	.0.......0......}1.......1..b...
0400	5d 32 00 00 81 00 00 00 c0 32 00 00 17 00 00 00 42 33 00 00 12 00 00 00 5a 33 00 00 19 00 00 00	]2.......2......B3......Z3......
0420	6d 33 00 00 18 01 00 00 87 33 00 00 7d 00 00 00 a0 34 00 00 80 00 00 00 1e 35 00 00 45 00 00 00	m3.......3..}....4.......5..E...
0440	9f 35 00 00 35 00 00 00 e5 35 00 00 2f 00 00 00 1b 36 00 00 d2 00 00 00 4b 36 00 00 84 00 00 00	.5..5....5../....6......K6......
0460	1e 37 00 00 48 00 00 00 a3 37 00 00 21 00 00 00 ec 37 00 00 61 00 00 00 0e 38 00 00 41 00 00 00	.7..H....7..!....7..a....8..A...
0480	70 38 00 00 70 00 00 00 b2 38 00 00 54 00 00 00 23 39 00 00 bc 00 00 00 78 39 00 00 85 00 00 00	p8..p....8..T...#9......x9......
04a0	35 3a 00 00 e7 00 00 00 bb 3a 00 00 2a 00 00 00 a3 3b 00 00 3b 00 00 00 ce 3b 00 00 93 00 00 00	5:.......:..*....;..;....;......
04c0	0a 3c 00 00 1d 00 00 00 9e 3c 00 00 37 00 00 00 bc 3c 00 00 8b 00 00 00 f4 3c 00 00 48 00 00 00	.<.......<..7....<.......<..H...
04e0	80 3d 00 00 90 00 00 00 c9 3d 00 00 7f 00 00 00 5a 3e 00 00 47 00 00 00 da 3e 00 00 0f 00 00 00	.=.......=......Z>..G....>......
0500	22 3f 00 00 95 00 00 00 32 3f 00 00 09 00 00 00 c8 3f 00 00 ac 00 00 00 d2 3f 00 00 2a 00 00 00	"?......2?.......?.......?..*...
0520	7f 40 00 00 39 00 00 00 aa 40 00 00 25 00 00 00 e4 40 00 00 08 00 00 00 0a 41 00 00 0f 00 00 00	.@..9....@..%....@.......A......
0540	13 41 00 00 18 00 00 00 23 41 00 00 0f 00 00 00 3c 41 00 00 3a 00 00 00 4c 41 00 00 48 00 00 00	.A......#A......<A..:...LA..H...
0560	87 41 00 00 2b 00 00 00 d0 41 00 00 64 00 00 00 fc 41 00 00 5c 00 00 00 61 42 00 00 64 00 00 00	.A..+....A..d....A..\...aB..d...
0580	be 42 00 00 32 00 00 00 23 43 00 00 5b 00 00 00 56 43 00 00 ed 01 00 00 b2 43 00 00 31 00 00 00	.B..2...#C..[...VC.......C..1...
05a0	a0 45 00 00 0e 01 00 00 d2 45 00 00 0c 00 00 00 e1 46 00 00 48 00 00 00 ee 46 00 00 4d 00 00 00	.E.......E.......F..H....F..M...
05c0	37 47 00 00 4e 00 00 00 85 47 00 00 59 00 00 00 d4 47 00 00 1b 00 00 00 2e 48 00 00 75 00 00 00	7G..N....G..Y....G.......H..u...
05e0	4a 48 00 00 18 00 00 00 c0 48 00 00 b5 00 00 00 d9 48 00 00 44 00 00 00 8f 49 00 00 15 01 00 00	JH.......H.......H..D....I......
0600	d4 49 00 00 0c 00 00 00 ea 4a 00 00 0b 00 00 00 f7 4a 00 00 18 00 00 00 03 4b 00 00 d3 00 00 00	.I.......J.......J.......K......
0620	1c 4b 00 00 0c 00 00 00 f0 4b 00 00 39 00 00 00 fd 4b 00 00 05 00 00 00 37 4c 00 00 3c 00 00 00	.K.......K..9....K......7L..<...
0640	3d 4c 00 00 56 00 00 00 7a 4c 00 00 08 00 00 00 d1 4c 00 00 45 00 00 00 da 4c 00 00 0f 00 00 00	=L..V...zL.......L..E....L......
0660	20 4d 00 00 07 00 00 00 30 4d 00 00 e2 00 00 00 38 4d 00 00 69 00 00 00 1b 4e 00 00 25 00 00 00	.M......0M......8M..i....N..%...
0680	85 4e 00 00 6a 00 00 00 ab 4e 00 00 54 00 00 00 16 4f 00 00 5d 00 00 00 6b 4f 00 00 26 00 00 00	.N..j....N..T....O..]...kO..&...
06a0	c9 4f 00 00 0c 00 00 00 f0 4f 00 00 0a 00 00 00 fd 4f 00 00 09 00 00 00 08 50 00 00 06 00 00 00	.O.......O.......O.......P......
06c0	12 50 00 00 06 00 00 00 19 50 00 00 09 00 00 00 20 50 00 00 05 00 00 00 2a 50 00 00 c2 00 00 00	.P.......P.......P......*P......
06e0	30 50 00 00 f2 00 00 00 f3 50 00 00 6d 00 00 00 e6 51 00 00 3d 00 00 00 54 52 00 00 0d 00 00 00	0P.......P..m....Q..=...TR......
0700	92 52 00 00 11 00 00 00 a0 52 00 00 64 00 00 00 b2 52 00 00 44 00 00 00 17 53 00 00 19 00 00 00	.R.......R..d....R..D....S......
0720	5c 53 00 00 07 00 00 00 76 53 00 00 8f 00 00 00 7e 53 00 00 41 00 00 00 0e 54 00 00 0e 00 00 00	\S......vS......~S..A....T......
0740	50 54 00 00 82 00 00 00 5f 54 00 00 64 00 00 00 e2 54 00 00 22 00 00 00 47 55 00 00 21 00 00 00	PT......_T..d....T.."...GU..!...
0760	6a 55 00 00 33 00 00 00 8c 55 00 00 19 01 00 00 c0 55 00 00 14 00 00 00 da 56 00 00 22 00 00 00	jU..3....U.......U.......V.."...
0780	ef 56 00 00 15 00 00 00 12 57 00 00 21 00 00 00 28 57 00 00 11 00 00 00 4a 57 00 00 23 00 00 00	.V.......W..!...(W......JW..#...
07a0	5c 57 00 00 16 00 00 00 80 57 00 00 0e 00 00 00 97 57 00 00 0d 00 00 00 a6 57 00 00 98 00 00 00	\W.......W.......W.......W......
07c0	b4 57 00 00 18 00 00 00 4d 58 00 00 1f 00 00 00 66 58 00 00 0f 00 00 00 86 58 00 00 c7 00 00 00	.W......MX......fX.......X......
07e0	96 58 00 00 0f 00 00 00 5e 59 00 00 5c 00 00 00 6e 59 00 00 49 00 00 00 cb 59 00 00 07 00 00 00	.X......^Y..\...nY..I....Y......
0800	15 5a 00 00 4f 00 00 00 1d 5a 00 00 19 00 00 00 6d 5a 00 00 13 00 00 00 87 5a 00 00 08 00 00 00	.Z..O....Z......mZ.......Z......
0820	9b 5a 00 00 1f 00 00 00 a4 5a 00 00 26 00 00 00 c4 5a 00 00 0d 00 00 00 eb 5a 00 00 53 00 00 00	.Z.......Z..&....Z.......Z..S...
0840	f9 5a 00 00 3d 00 00 00 4d 5b 00 00 3a 00 00 00 8b 5b 00 00 9d 00 00 00 c6 5b 00 00 37 00 00 00	.Z..=...M[..:....[.......[..7...
0860	64 5c 00 00 2d 00 00 00 9c 5c 00 00 b3 00 00 00 ca 5c 00 00 46 00 00 00 7e 5d 00 00 13 00 00 00	d\..-....\.......\..F...~]......
0880	c5 5d 00 00 19 00 00 00 d9 5d 00 00 55 00 00 00 f3 5d 00 00 a7 00 00 00 49 5e 00 00 3c 00 00 00	.].......]..U....]......I^..<...
08a0	f1 5e 00 00 4d 01 00 00 2e 5f 00 00 b3 00 00 00 7c 60 00 00 8d 00 00 00 30 61 00 00 8f 00 00 00	.^..M...._......|`......0a......
08c0	be 61 00 00 42 00 00 00 4e 62 00 00 2e 00 00 00 91 62 00 00 62 00 00 00 c0 62 00 00 a9 00 00 00	.a..B...Nb.......b..b....b......
08e0	23 63 00 00 15 00 00 00 cd 63 00 00 c7 00 00 00 e3 63 00 00 1e 00 00 00 ab 64 00 00 d7 00 00 00	#c.......c.......c.......d......
0900	ca 64 00 00 58 01 00 00 a2 65 00 00 9b 00 00 00 fb 66 00 00 30 00 00 00 97 67 00 00 06 00 00 00	.d..X....e.......f..0....g......
0920	c8 67 00 00 07 00 00 00 cf 67 00 00 0d 00 00 00 d7 67 00 00 b6 00 00 00 e5 67 00 00 40 00 00 00	.g.......g.......g.......g..@...
0940	9c 68 00 00 07 00 00 00 dd 68 00 00 06 00 00 00 e5 68 00 00 fa 00 00 00 ec 68 00 00 50 00 00 00	.h.......h.......h.......h..P...
0960	e7 69 00 00 34 00 00 00 38 6a 00 00 a5 00 00 00 6d 6a 00 00 12 00 00 00 13 6b 00 00 81 00 00 00	.i..4...8j......mj.......k......
0980	26 6b 00 00 15 00 00 00 a8 6b 00 00 07 00 00 00 be 6b 00 00 16 00 00 00 c6 6b 00 00 06 00 00 00	&k.......k.......k.......k......
09a0	dd 6b 00 00 0e 00 00 00 e4 6b 00 00 4a 00 00 00 f3 6b 00 00 12 00 00 00 3e 6c 00 00 1d 00 00 00	.k.......k..J....k......>l......
09c0	51 6c 00 00 11 00 00 00 6f 6c 00 00 18 00 00 00 81 6c 00 00 28 00 00 00 9a 6c 00 00 1e 00 00 00	Ql......ol.......l..(....l......
09e0	c3 6c 00 00 0a 00 00 00 e2 6c 00 00 70 00 00 00 ed 6c 00 00 0b 00 00 00 5e 6d 00 00 15 00 00 00	.l.......l..p....l......^m......
0a00	6a 6d 00 00 1a 00 00 00 80 6d 00 00 18 00 00 00 9b 6d 00 00 1d 00 00 00 b4 6d 00 00 04 00 00 00	jm.......m.......m.......m......
0a20	d2 6d 00 00 1a 00 00 00 d7 6d 00 00 27 00 00 00 f2 6d 00 00 8c 00 00 00 1a 6e 00 00 15 00 00 00	.m.......m..'....m.......n......
0a40	a7 6e 00 00 c9 00 00 00 bd 6e 00 00 62 00 00 00 87 6f 00 00 81 00 00 00 ea 6f 00 00 17 00 00 00	.n.......n..b....o.......o......
0a60	6c 70 00 00 12 00 00 00 84 70 00 00 19 00 00 00 97 70 00 00 18 01 00 00 b1 70 00 00 7d 00 00 00	lp.......p.......p.......p..}...
0a80	ca 71 00 00 80 00 00 00 48 72 00 00 45 00 00 00 c9 72 00 00 35 00 00 00 0f 73 00 00 2f 00 00 00	.q......Hr..E....r..5....s../...
0aa0	45 73 00 00 d2 00 00 00 75 73 00 00 84 00 00 00 48 74 00 00 48 00 00 00 cd 74 00 00 21 00 00 00	Es......us......Ht..H....t..!...
0ac0	16 75 00 00 61 00 00 00 38 75 00 00 41 00 00 00 9a 75 00 00 70 00 00 00 dc 75 00 00 54 00 00 00	.u..a...8u..A....u..p....u..T...
0ae0	4d 76 00 00 bc 00 00 00 a2 76 00 00 85 00 00 00 5f 77 00 00 e7 00 00 00 e5 77 00 00 2a 00 00 00	Mv.......v......_w.......w..*...
0b00	cd 78 00 00 3b 00 00 00 f8 78 00 00 93 00 00 00 34 79 00 00 1d 00 00 00 c8 79 00 00 37 00 00 00	.x..;....x......4y.......y..7...
0b20	e6 79 00 00 8b 00 00 00 1e 7a 00 00 48 00 00 00 aa 7a 00 00 90 00 00 00 f3 7a 00 00 7f 00 00 00	.y.......z..H....z.......z......
0b40	84 7b 00 00 47 00 00 00 04 7c 00 00 0f 00 00 00 4c 7c 00 00 95 00 00 00 5c 7c 00 00 09 00 00 00	.{..G....|......L|......\|......
0b60	f2 7c 00 00 ac 00 00 00 fc 7c 00 00 2a 00 00 00 a9 7d 00 00 39 00 00 00 d4 7d 00 00 25 00 00 00	.|.......|..*....}..9....}..%...
0b80	0e 7e 00 00 08 00 00 00 34 7e 00 00 0f 00 00 00 3d 7e 00 00 18 00 00 00 4d 7e 00 00 0f 00 00 00	.~......4~......=~......M~......
0ba0	66 7e 00 00 3a 00 00 00 76 7e 00 00 48 00 00 00 b1 7e 00 00 2b 00 00 00 fa 7e 00 00 64 00 00 00	f~..:...v~..H....~..+....~..d...
0bc0	26 7f 00 00 5c 00 00 00 8b 7f 00 00 64 00 00 00 e8 7f 00 00 32 00 00 00 4d 80 00 00 5b 00 00 00	&...\.......d.......2...M...[...
0be0	80 80 00 00 ed 01 00 00 dc 80 00 00 31 00 00 00 ca 82 00 00 0e 01 00 00 fc 82 00 00 0c 00 00 00	............1...................
0c00	0b 84 00 00 48 00 00 00 18 84 00 00 4d 00 00 00 61 84 00 00 4e 00 00 00 af 84 00 00 59 00 00 00	....H.......M...a...N.......Y...
0c20	fe 84 00 00 1b 00 00 00 58 85 00 00 75 00 00 00 74 85 00 00 18 00 00 00 ea 85 00 00 b5 00 00 00	........X...u...t...............
0c40	03 86 00 00 44 00 00 00 b9 86 00 00 15 01 00 00 fe 86 00 00 0c 00 00 00 14 88 00 00 0b 00 00 00	....D...........................
0c60	21 88 00 00 18 00 00 00 2d 88 00 00 d3 00 00 00 46 88 00 00 0c 00 00 00 1a 89 00 00 39 00 00 00	!.......-.......F...........9...
0c80	27 89 00 00 05 00 00 00 61 89 00 00 3c 00 00 00 67 89 00 00 56 00 00 00 a4 89 00 00 08 00 00 00	'.......a...<...g...V...........
0ca0	fb 89 00 00 45 00 00 00 04 8a 00 00 0f 00 00 00 4a 8a 00 00 07 00 00 00 5a 8a 00 00 01 00 00 00	....E...........J.......Z.......
0cc0	4c 00 00 00 9c 00 00 00 00 00 00 00 7d 00 00 00 aa 00 00 00 38 00 00 00 1f 00 00 00 00 00 00 00	L...........}.......8...........
0ce0	49 00 00 00 00 00 00 00 0a 00 00 00 00 00 00 00 21 00 00 00 b2 00 00 00 44 00 00 00 64 00 00 00	I...............!.......D...d...
0d00	a0 00 00 00 12 00 00 00 b3 00 00 00 ab 00 00 00 29 00 00 00 c6 00 00 00 0d 00 00 00 95 00 00 00	................)...............
0d20	8c 00 00 00 14 00 00 00 9e 00 00 00 00 00 00 00 87 00 00 00 62 00 00 00 39 00 00 00 32 00 00 00	....................b...9...2...
0d40	00 00 00 00 ca 00 00 00 00 00 00 00 00 00 00 00 ad 00 00 00 00 00 00 00 97 00 00 00 00 00 00 00	................................
0d60	6f 00 00 00 00 00 00 00 3d 00 00 00 72 00 00 00 00 00 00 00 6d 00 00 00 b1 00 00 00 81 00 00 00	o.......=...r.......m...........
0d80	31 00 00 00 26 00 00 00 1d 00 00 00 c5 00 00 00 c2 00 00 00 92 00 00 00 00 00 00 00 bd 00 00 00	1...&...........................
0da0	00 00 00 00 15 00 00 00 4d 00 00 00 46 00 00 00 24 00 00 00 c1 00 00 00 00 00 00 00 40 00 00 00	........M...F...$...........@...
0dc0	65 00 00 00 51 00 00 00 3f 00 00 00 00 00 00 00 99 00 00 00 88 00 00 00 a1 00 00 00 00 00 00 00	e...Q...?.......................
0de0	00 00 00 00 30 00 00 00 c4 00 00 00 00 00 00 00 75 00 00 00 5a 00 00 00 9f 00 00 00 22 00 00 00	....0...........u...Z......."...
0e00	2d 00 00 00 86 00 00 00 28 00 00 00 00 00 00 00 c8 00 00 00 00 00 00 00 90 00 00 00 6b 00 00 00	-.......(...................k...
0e20	00 00 00 00 00 00 00 00 a4 00 00 00 73 00 00 00 25 00 00 00 ba 00 00 00 af 00 00 00 00 00 00 00	............s...%...............
0e40	19 00 00 00 6a 00 00 00 00 00 00 00 89 00 00 00 00 00 00 00 b8 00 00 00 53 00 00 00 b7 00 00 00	....j...................S.......
0e60	7c 00 00 00 00 00 00 00 be 00 00 00 78 00 00 00 2f 00 00 00 36 00 00 00 2e 00 00 00 2b 00 00 00	|...........x.../...6.......+...
0e80	00 00 00 00 7a 00 00 00 3e 00 00 00 a5 00 00 00 c9 00 00 00 17 00 00 00 8f 00 00 00 00 00 00 00	....z...>.......................
0ea0	1e 00 00 00 00 00 00 00 35 00 00 00 4b 00 00 00 6c 00 00 00 11 00 00 00 b6 00 00 00 70 00 00 00	........5...K...l...........p...
0ec0	00 00 00 00 80 00 00 00 41 00 00 00 18 00 00 00 10 00 00 00 00 00 00 00 9d 00 00 00 00 00 00 00	........A.......................
0ee0	43 00 00 00 00 00 00 00 00 00 00 00 2a 00 00 00 a8 00 00 00 1b 00 00 00 00 00 00 00 00 00 00 00	C...........*...................
0f00	57 00 00 00 a7 00 00 00 60 00 00 00 09 00 00 00 74 00 00 00 a2 00 00 00 c3 00 00 00 61 00 00 00	W.......`.......t...........a...
0f20	00 00 00 00 7f 00 00 00 94 00 00 00 47 00 00 00 00 00 00 00 20 00 00 00 59 00 00 00 1a 00 00 00	............G...........Y.......
0f40	00 00 00 00 93 00 00 00 1c 00 00 00 00 00 00 00 48 00 00 00 a6 00 00 00 00 00 00 00 0e 00 00 00	................H...............
0f60	00 00 00 00 ae 00 00 00 63 00 00 00 5e 00 00 00 00 00 00 00 00 00 00 00 bf 00 00 00 00 00 00 00	........c...^...................
0f80	76 00 00 00 5f 00 00 00 34 00 00 00 7e 00 00 00 02 00 00 00 00 00 00 00 42 00 00 00 69 00 00 00	v..._...4...~...........B...i...
0fa0	54 00 00 00 33 00 00 00 00 00 00 00 71 00 00 00 9a 00 00 00 55 00 00 00 98 00 00 00 00 00 00 00	T...3.......q.......U...........
0fc0	23 00 00 00 ac 00 00 00 7b 00 00 00 13 00 00 00 b9 00 00 00 00 00 00 00 00 00 00 00 b4 00 00 00	#.......{.......................
0fe0	5b 00 00 00 03 00 00 00 00 00 00 00 00 00 00 00 c0 00 00 00 79 00 00 00 66 00 00 00 c7 00 00 00	[...................y...f.......
1000	3c 00 00 00 58 00 00 00 a3 00 00 00 07 00 00 00 00 00 00 00 8b 00 00 00 bb 00 00 00 84 00 00 00	<...X...........................
1020	68 00 00 00 5c 00 00 00 2c 00 00 00 00 00 00 00 52 00 00 00 4f 00 00 00 5d 00 00 00 8d 00 00 00	h...\...,.......R...O...].......
1040	06 00 00 00 45 00 00 00 00 00 00 00 96 00 00 00 0c 00 00 00 00 00 00 00 00 00 00 00 08 00 00 00	....E...........................
1060	00 00 00 00 00 00 00 00 56 00 00 00 16 00 00 00 6e 00 00 00 8e 00 00 00 00 00 00 00 3a 00 00 00	........V.......n...........:...
1080	37 00 00 00 67 00 00 00 b5 00 00 00 83 00 00 00 4e 00 00 00 27 00 00 00 04 00 00 00 4a 00 00 00	7...g...........N...'.......J...
10a0	00 00 00 00 91 00 00 00 00 00 00 00 bc 00 00 00 85 00 00 00 0b 00 00 00 0f 00 00 00 3b 00 00 00	............................;...
10c0	00 00 00 00 50 00 00 00 00 00 00 00 a9 00 00 00 00 00 00 00 b0 00 00 00 9b 00 00 00 82 00 00 00	....P...........................
10e0	05 00 00 00 77 00 00 00 8a 00 00 00 00 00 00 00 00 2a 2a 4e 4f 54 45 2a 2a 3a 20 62 65 20 63 61	....w............**NOTE**:.be.ca
1100	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 67	refull.while.copying.and.pasting
1120	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 73	.previous.commands..Doble.quotes
1140	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 74	.may.need.to.be.corrected..**met
1160	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 2e	a-data**:.empty.file.(required).
1180	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 61	.**network-config**.file.only.ha
11a0	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 68	s.configuration.that.disables.th
11c0	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 74	e.automatic.dhcp.client.on.first
11e0	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 20	.interface..**network-config**:.
1200	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 64	file.that.will.indicate.to.avoid
1220	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 2e	.dhcp.client.on.first.interface.
1240	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 77	.**user-data**.file.must.start.w
1260	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 69	ith.``#cloud-config``.and.contai
1280	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 2a	ns.vyos-commands..For.example:.*
12a0	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 6d	*user-data**:.includes.vyos-comm
12c0	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 67	ands../config-file./configure./g
12e0	65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 72 65 73 65 74 00 2f 72 65 74 72 69 65 76 65 00	enerate./image./reset./retrieve.
1300	2f 73 68 6f 77 00 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	/show.A.VyOS.qcow.image.with.clo
1320	75 64 2d 69 6e 69 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	ud-init.options.is.needed..This.
1340	63 61 6e 20 62 65 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	can.be.obtained.using.`vyos-vm-i
1360	6d 61 67 65 73 60 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	mages`_.repo..After.clonning.the
1380	20 72 65 70 6f 2c 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	.repo,.edit.the.file.**qemu.yml*
13a0	2a 20 61 6e 64 20 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	*.and.comment.the.**download-iso
13c0	2a 2a 20 72 6f 6c 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	**.role..A.cloud-config.document
13e0	20 69 73 20 77 72 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	.is.written.in.YAML..The.file.mu
1400	73 74 20 62 65 67 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	st.begin.with.``#cloud-config``.
1420	6c 69 6e 65 2e 20 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	line..The.only.supported.top-lev
1440	65 6c 20 6b 65 79 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	el.keys.are.``vyos_config_comman
1460	64 73 60 60 20 61 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	ds``.and.``write_files``..The.us
1480	65 20 6f 66 20 74 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	e.of.these.keys.is.described.in.
14a0	74 68 65 20 66 6f 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	the.following.two.sections..A.si
14c0	6d 70 6c 65 20 65 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	mple.example.is.shown.below,.whe
14e0	72 65 20 74 68 65 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	re.the.ops.command.executed.in.t
1500	68 65 20 70 6f 73 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	he.post-hook.script.is."show.int
1520	65 72 66 61 63 65 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	erfaces"..A.single-quote.symbol.
1540	69 73 20 6e 6f 74 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	is.not.allowed.inside.command.or
1560	20 76 61 6c 75 65 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	.value..API.Endpoints.Accept.min
1580	69 6f 6e 20 6b 65 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	ion.key.All.endpoints.only.liste
15a0	6e 20 6f 6e 20 48 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	n.on.HTTP.POST.requests.and.the.
15c0	41 50 49 20 4b 45 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	API.KEY.must.set.as.``key``.in.t
15e0	68 65 20 66 6f 72 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	he.formdata..All.of.these.can.be
1600	20 6f 76 65 72 72 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	.overridden.using.the.configurat
1620	69 6f 6e 20 69 6e 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	ion.in.user-data..Also,.this.lab
1640	20 63 6f 6e 73 69 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	.considers:.Ansible.Any.modifica
1660	74 69 6f 6e 73 20 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	tions.were.done.to.work.around.u
1680	6e 66 69 78 65 64 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	nfixed.bugs.and.implement.enhanc
16a0	65 6d 65 6e 74 73 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	ements.that.are.not.complete.in.
16c0	74 68 65 20 56 79 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	the.VyOS.system.can.be.placed.he
16e0	72 65 2e 00 41 74 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	re..At.this.step.we.can.get.some
1700	20 6f 70 2d 6d 6f 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	.op-mode.information.from.VyOS.n
1720	6f 64 65 73 3a 00 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	odes:.Authentication.Before.star
1740	74 69 6e 67 2c 20 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	ting,.please.refer.to.cloud-init
1760	20 60 6e 65 74 77 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	.`network-config-docs`_.in.order
1780	20 74 6f 20 6b 6e 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	.to.know.how.to.import.user.and.
17a0	6e 65 74 77 6f 72 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	network.configurations..Below.se
17c0	65 20 6f 6e 65 20 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	e.one.example.for.curl.and.one.f
17e0	6f 72 20 70 79 74 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	or.python..The.rest.of.the.docum
1800	65 6e 74 61 74 69 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	entation.is.reduced.to.curl..Che
1820	63 6b 20 73 61 6c 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	ck.salt-keys.on.the.salt.master.
1840	43 68 65 63 6b 20 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	Check.that.proxy.minion.is.alive
1860	3a 00 43 68 65 63 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	:.Check.that.salt.master.can.com
1880	6d 75 6e 69 63 61 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	municate.with.minions.Cloud.and.
18a0	76 69 72 74 75 61 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	virtualized.instances.of.VyOS.ar
18c0	65 20 69 6e 69 74 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	e.initialized.using.the.industry
18e0	2d 73 74 61 6e 64 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	-standard.cloud-init..Via.cloud-
1900	69 6e 69 74 2c 20 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	init,.the.system.performs.tasks.
1920	73 75 63 68 20 61 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	such.as.injecting.SSH.keys.and.c
1940	6f 6e 66 69 67 75 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	onfiguring.the.network..In.addit
1960	69 6f 6e 2c 20 74 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	ion,.the.user.can.supply.a.custo
1980	6d 20 63 6f 6e 66 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	m.configuration.at.the.time.of.i
19a0	6e 73 74 61 6e 63 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	nstance.launch..Cloud-config.mod
19c0	75 6c 65 73 00 43 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	ules.Cloud-init.`network-config-
19e0	64 6f 63 73 60 5f 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	docs`_..Cloud-init.on.Proxmox.Co
1a00	6d 6d 61 6e 64 20 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	mmand.Execution.at.Initial.Boot.
1a20	43 6f 6d 6d 61 6e 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	Command.Scripting.Command.for.ge
1a40	6e 65 72 61 74 69 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	nerating.``seed.iso``.Commands.r
1a60	65 71 75 69 72 65 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	equirements:.Config.Sources.Conf
1a80	69 67 75 72 61 74 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	iguration.Configuration.commands
1aa0	20 61 72 65 20 65 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	.are.executed.just.like.from.a.n
1ac0	6f 72 6d 61 6c 20 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	ormal.config.session..For.exampl
1ae0	65 2c 20 69 66 20 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	e,.if.you.want.to.disable.a.BGP.
1b00	70 65 65 72 20 6f 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	peer.on.VRRP.transition.to.backu
1b20	70 3a 00 43 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	p:.Content.of.commands.conf.Cont
1b40	65 6e 74 20 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	ent.of.network-config.file:.Crea
1b60	74 65 20 73 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	te.seed.iso.Create.text.files.na
1b80	6d 65 64 20 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	med.user-data.and.meta-data..On.
1ba0	6c 69 6e 75 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	linux-based.systems,.the.mkisofs
1bc0	20 75 74 69 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	.utility.can.be.used.to.create.t
1be0	68 65 20 73 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	he.seed.ISO..The.following.synta
1c00	78 20 77 69 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	x.will.add.these.files.to.the.IS
1c20	4f 20 39 36 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	O.9660.file.system..Creating.the
1c40	20 56 4d 00 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	.VM.Custom.scripts.are.not.execu
1c60	74 65 64 20 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	ted.with.root.privileges.(Use.su
1c80	64 6f 20 69 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	do.inside.if.this.is.necessary).
1ca0	00 44 48 43 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	.DHCP.on.first.Ethernet.interfac
1cc0	65 20 69 66 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	e.if.no.network.configuration.is
1ce0	20 70 72 6f 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	.provided..Example.Example.of.co
1d00	6e 66 69 67 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	nfiguration.commands.from.the.fi
1d20	6c 65 20 22 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	le."/srv/salt/states/commands.tx
1d40	74 22 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 3a 00 45 78 61	t".Example.of.configuration:.Exa
1d60	6d 70 6c 65 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	mple.of.op-mode:.Examples.Execut
1d80	69 6e 67 20 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	ing.Configuration.Scripts.Execut
1da0	69 6e 67 20 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	ing.pre-hooks/post-hooks.Scripts
1dc0	00 46 69 6c 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	.File.contents.File.generated.wi
1de0	74 68 20 70 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	th.previous.command:.``/tmp/vyos
1e00	2d 31 2e 33 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	-1.3.0-cloud-init-10G-qemu.qcow2
1e20	60 60 00 46 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	``.Finaly,.file.**meta-data**.ha
1e40	73 20 6e 6f 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	s.no.content,.but.it's.required.
1e60	00 46 6f 72 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	.For.configuration.and.enabling.
1e80	74 68 65 20 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	the.API.see.:ref:`http-api`.For.
1ea0	63 6f 6e 66 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	configuration/upgrade.management
1ec0	20 69 73 73 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	.issues,.modification.of.this.sc
1ee0	72 69 70 74 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	ript.should.be.the.last.option..
1f00	41 6c 77 61 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	Always.try.to.find.solutions.bas
1f20	65 64 20 6f 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	ed.on.CLI.commands.first..For.ex
1f40	61 6d 70 6c 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	ample,.get.the.addresses.of.a.``
1f60	64 75 6d 30 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	dum0``.interface..For.example,.s
1f80	68 6f 77 20 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	how.which.images.are.installed..
1fa0	46 6f 72 20 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	For.more.information.on.the.NoCl
1fc0	6f 75 64 20 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	oud.data.source,.visit.its.`page
1fe0	20 3c 68 74 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	.<https://cloudinit.readthedocs.
2000	69 6f 2f 65 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	io/en/latest/reference/datasourc
2020	65 73 2f 6e 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	es/nocloud.html>`_.in.the.cloud-
2040	69 6e 69 74 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	init.documentation..From.cli.or.
2060	47 55 49 2c 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	GUI,.power.on.VM,.and.after.it.b
2080	6f 6f 74 73 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	oots,.verify.configuration.Gener
20a0	61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 48 65 72 65 20 69 73 20 61 20 73 69 6d 70 6c 65 20	ate.qcow.image.Here.is.a.simple.
20c0	65 78 61 6d 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	example:.Here.is.an.example.clou
20e0	64 2d 63 6f 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	d-config.that.appends.configurat
2100	69 6f 6e 20 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	ion.at.the.time.of.first.boot..I
2120	53 4f 20 66 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	SO.files.storage:.``local``.volu
2140	6d 65 20 69 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	me.is.used.for.``.iso``.file.sto
2160	72 61 67 65 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	rage..In.this.scenario.``local``
2180	20 76 6f 6c 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	.volume.type.is.set.to.**directo
21a0	72 79 2a 2a 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	ry**,.abd.attached.to.``/var/lib
21c0	2f 76 7a 60 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	/vz``..If.command.ends.in.a.valu
21e0	65 2c 20 69 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	e,.it.must.be.inside.single.quot
2200	65 73 2e 00 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	es..If.no.networking.configurati
2220	6f 6e 20 69 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	on.is.provided,.then.dhcp.client
2240	20 69 73 20 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	.is.going.to.be.enabled.on.first
2260	20 69 6e 74 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	.interface..Bare.in.mind.that.th
2280	69 73 20 63 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	is.configuration.will.be.inyecte
22a0	64 20 61 74 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	d.at.an.OS.level,.so.don't.expec
22c0	74 20 74 6f 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	t.to.find.dhcp.client.configurat
22e0	69 6f 6e 20 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	ion.on.vyos.cli..Because.of.this
2300	20 62 65 68 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	.behavior,.in.next.example.lab.w
2320	65 20 77 69 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	e.will.disable.dhcp-client.confi
2340	67 75 72 61 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	guration.on.eth0..If.you.encount
2360	65 72 20 70 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	er.problems,.verify.that.the.clo
2380	75 64 2d 63 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	ud-config.document.contains.vali
23a0	64 20 59 41 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	d.YAML..Online.resources.such.as
23c0	20 68 74 74 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	.https://www.yamllint.com/.provi
23e0	64 65 20 61 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	de.a.simple.tool.for.validating.
2400	59 41 4d 4c 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	YAML..If.you.need.to.gather.info
2420	72 6d 61 74 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	rmation.from.linux.commands.to.c
2440	6f 6e 66 69 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	onfigure.VyOS,.you.can.execute.c
2460	6f 6d 6d 61 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	ommands.and.then.configure.VyOS.
2480	69 6e 20 74 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	in.the.same.script..If.you.want.
24a0	74 6f 20 73 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	to.script.the.configs.in.a.langu
24c0	61 67 65 20 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	age.other.than.bash.you.can.have
24e0	20 79 6f 75 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	.your.script.output.commands.and
2500	20 74 68 65 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	.then.source.them.in.a.bash.scri
2520	70 74 2e 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 20 74 68 72 65 65 20 66 69 6c 65	pt..In.Proxmox.server.three.file
2540	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 72 20 74 68 69 73 20	s.are.going.to.be.used.for.this.
2560	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 74 2c 20 65 6e 61 62	setup:.In.VyOS,.by.default,.enab
2580	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 74 68 69 73 20 6c 61	les.only.two.modules:.In.this.la
25a0	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 69 6e 20 60 60 2f 74	b,.all.files.are.located.in.``/t
25c0	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 6e 2c 20 6c 65 74 73	mp/``..So,.before.going.on,.lets
25e0	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 49 6e 20 74 68 69 73	.move.to.that.directory:.In.this
2600	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 56 79 4f 53 20 76 65	.lab,.we.are.using.1.3.0.VyOS.ve
2620	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 6f 66 20 31 30 47 2e	rsion.and.setting.a.disk.of.10G.
2640	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 61 6e 64 20 73 61 76	.Download.VyOS..iso.file.and.sav
2660	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 2e 20 43 6f 6d 6d 61	e.it.as.``/tmp/vyos.iso``..Comma
2680	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 6f 77 20 69 6d 61 67	nd.used.for.generating.qcow.imag
26a0	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 49 6e 6a 65 63 74 69	e:.Initial.Configuration.Injecti
26c0	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 6f 74 20 6c 69 6d	ng.configuration.data.is.not.lim
26e0	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 73 65 72 73 20 63	ited.to.cloud.platforms..Users.c
2700	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 20 73 6f 75 72 63	an.employ.the.NoCloud.data.sourc
2720	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 6d 65 74 61 2d 64	e.to.inject.user-data.and.meta-d
2740	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 66 6f 72 6d 73 20	ata.on.virtualization.platforms.
2760	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 64 20 4b 56 4d 2e	such.as.VMware,.Hyper-V.and.KVM.
2780	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 6f 64 75 6c 65 00	.Install.``napalm-vyos``.module.
27a0	49 74 20 69 73 20 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	It.is.possible.to.configure.VyOS
27c0	20 76 69 61 20 6e 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	.via.netmiko_.proxy.module..It.r
27e0	65 71 75 69 72 65 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	equires.a.minion.with.installed.
2800	70 61 63 6b 65 74 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	packet..``python3-netmiko``.modu
2820	6c 65 20 77 68 6f 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	le.who.has.a.connection.to.VyOS.
2840	6e 6f 64 65 73 2e 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	nodes..Salt-minion.have.to.commu
2860	6e 69 63 61 74 65 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	nicate.with.salt.master.Major.cl
2880	6f 75 64 20 70 72 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	oud.providers.offer.a.means.of.p
28a0	72 6f 76 69 64 69 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	roviding.user-data.at.the.time.o
28c0	66 20 69 6e 73 74 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	f.instance.launch..It.can.be.pro
28e0	76 69 64 65 64 20 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	vided.as.plain.text.or.as.base64
2900	2d 65 6e 63 6f 64 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	-encoded.text,.depending.on.clou
2920	64 20 70 72 6f 76 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	d.provider..Also,.it.can.be.comp
2940	72 65 73 73 65 64 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	ressed.using.gzip,.which.makes.s
2960	65 6e 73 65 20 77 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	ense.with.a.long.configuration.c
2980	6f 6d 6d 61 6e 64 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	ommands.list,.because.of.the.har
29a0	64 20 6c 69 6d 69 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	d.limit.to.~16384.bytes.for.the.
29c0	77 68 6f 6c 65 20 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	whole.user-data..Metadata.-.Meta
29e0	64 61 74 61 20 69 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	data.is.sourced.by.the.cloud.pla
2a00	74 66 6f 72 6d 20 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	tform.or.hypervisor..In.some.clo
2a20	75 64 73 2c 20 74 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	uds,.there.is.implemented.as.an.
2a40	48 54 54 50 20 65 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	HTTP.endpoint.at.``http://169.25
2a60	34 2e 31 36 39 2e 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	4.169.254``..Most.important.keys
2a80	20 74 68 61 74 20 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	.that.needs.to.be.considered:.Na
2aa0	70 61 6c 6d 00 4e 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	palm.Netmiko.Netmiko-proxy.Netwo
2ac0	72 6b 20 63 6f 6e 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	rk.configuration.-.This.config.s
2ae0	6f 75 72 63 65 20 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	ource.informs.the.system.about.t
2b00	68 65 20 6e 65 74 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	he.network.settings.like.IP.addr
2b20	65 73 73 65 73 2c 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	esses,.routes,.DNS..Available.on
2b40	6c 79 20 69 6e 20 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	ly.in.several.cloud.and.virtuali
2b60	7a 61 74 69 6f 6e 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	zation.platforms..Networking.con
2b80	66 69 67 75 72 61 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	figurations.shouldn't.be.passed.
2ba0	69 6e 20 75 73 65 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	in.user-data.file..NoCloud.Norni
2bc0	72 00 4e 6f 74 65 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	r.Note.that.the./opt/vyatta/etc/
2be0	63 6f 6e 66 69 67 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	config.is.used.instead.of.the./c
2c00	6f 6e 66 69 67 2f 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	onfig/scripts.directory.referenc
2c20	65 64 20 69 6e 20 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	ed.in.the.:ref:`command-scriptin
2c40	67 60 20 73 65 63 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	g`.section.of.the.documentation.
2c60	62 65 63 61 75 73 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	because.the./config/script.direc
2c80	74 6f 72 79 20 69 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	tory.isn't.mounted.when.the.``wr
2ca0	69 74 65 5f 66 69 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	ite_files``.module.executes..Not
2cc0	65 73 20 66 6f 72 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	es.for.this.particular.example,.
2ce0	74 68 61 74 20 6d 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	that.may.need.to.be.modified.in.
2d00	6f 74 68 65 72 20 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	other.setups:.Now,.that.file.nee
2d20	64 73 20 74 6f 20 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	ds.to.be.copied.to.proxmox.serve
2d40	72 3a 00 4f 6e 20 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	r:.On.VyOS.this.will.cause.the.f
2d60	6f 6c 6c 6f 77 69 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	ollowing.problem:.After.modifyin
2d80	67 20 74 68 65 20 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	g.the.configuration.via.script.l
2da0	69 6b 65 20 74 68 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	ike.this.once,.it.is.not.possibl
2dc0	65 20 74 6f 20 6d 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	e.to.manually.modify.the.config.
2de0	61 6e 79 6d 6f 72 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	anymore:.On.proxmox.server:.Once
2e00	20 74 68 65 20 74 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	.the.three.files.were.created,.i
2e20	74 27 73 20 74 69 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	t's.time.to.generate.the.``seed.
2e40	69 73 6f 60 60 20 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	iso``.image,.which.needs.to.be.m
2e60	6f 75 6e 74 65 64 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	ounted.to.the.new.VM.as.a.cd..On
2e80	65 20 63 6f 6d 6d 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	e.command.per.line..Op-mode.Othe
2ea0	72 20 73 63 72 69 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	r.script.languages.Output.Output
2ec0	20 6f 70 2d 6d 6f 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	.op-mode.Please.take.a.look.at.t
2ee0	68 65 20 43 6f 6e 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	he.Contributing.Guide.for.our.:r
2f00	65 66 3a 60 64 6f 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	ef:`documentation`..Postconfig.o
2f20	6e 20 62 6f 6f 74 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	n.boot.Power.on.VM.and.verificat
2f40	69 6f 6e 73 00 50 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	ions.Preconfig.on.boot.Prepare.c
2f60	6c 6f 75 64 2d 69 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	loud-init.files.Proxmox.IP.addre
2f80	73 73 3a 20 2a 2a 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	ss:.**192.168.0.253/24**.Proxmox
2fa0	20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 53 75 70 70 6f 72 74 60 5f 2e 00 52 65 66 65 72 65 6e 63	.`Cloud-init-Support`_..Referenc
2fc0	65 73 00 52 65 6d 6f 76 65 20 64 65 66 61 75 6c 74 20 64 68 63 70 20 63 6c 69 65 6e 74 20 6f 6e	es.Remove.default.dhcp.client.on
2fe0	20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2c 20 61 6e 64 20 6c 6f 61 64 20 6f 74 68 65 72	.first.interface,.and.load.other
3000	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 75 72 69 6e 67 20 66 69 72 73 74 20 62 6f 6f 74	.configuration.during.first.boot
3020	2c 20 75 73 69 6e 67 20 63 6c 6f 75 64 2d 69 6e 69 74 2e 00 52 75 6e 20 61 6e 73 69 62 6c 65 00	,.using.cloud-init..Run.ansible.
3040	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 69 67	Run.commands.remotely.Run.config
3060	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 61 6c	uration.commands.Run.operational
3080	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 20 70	.commands.SSH.is.configured.on.p
30a0	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 67 75	ort.22..Salt.Salt.master.configu
30c0	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 72 61	ration:.Save.a.running.configura
30e0	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 20 63	tion.to.a.file..Save.a.running.c
3100	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 6e 66	onfiguration.to.the.startup.conf
3120	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 69 66	iguration..When.you.don't.specif
3140	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 65 73	y.the.file.when.saving,.it.saves
3160	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 63 72	.to.``/config/config.boot``..Scr
3180	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 20 72	ipt.vyos-napalm.py.Scripts.are.r
31a0	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 72 20	un.in.alphabetical.order..Their.
31c0	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 20 41	names.must.consist.entirely.of.A
31e0	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 74 65	SCII.upper-.and.lower-case.lette
3200	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 6f 72	rs,ASCII.digits,.ASCII.underscor
3220	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 20 6f	es,.and.ASCII.minus-hyphens.No.o
3240	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 6f 6d	ther.characters.are.allowed..Som
3260	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 6f 20 65 78 65 63 75	etimes.you.simply.wan't.to.execu
3280	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 6d 61 6e 64 73 20 76	te.a.bunch.of.op-mode.commands.v
32a0	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 79 73 74 65 6d 2e 00	ia.SSH.on.a.remote.VyOS.system..
32c0	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 61 6c 2c 20 77 68 69	Storaged.used:.volume.local,.whi
32e0	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 79 20 2a 2a 2f 76 61	ch.is.mounted.on.directory.**/va
3300	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 61 6c 6c 20 74 79 70	r/lib/vz**,.and.contains.all.typ
3320	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 6e 69 70 70 65 74 73	e.of.content,.including.snippets
3340	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 00 53 74 72 75 63 74	..Structure.of./srv/salt:.Struct
3360	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 6c 74 73 2f 46 61 6c	ure.of.files.System.Defaults/Fal
3380	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 72 79 20 72 65 71 75	lbacks.The.API.pushes.every.requ
33a0	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 69 74 20 69 74 2e 20	est.to.a.session.and.commit.it..
33c0	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 74 73 20 6c 69 6b 65	But.some.of.VyOS.components.like
33e0	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 49 50 53 65 63 2c 20	.DHCP.and.PPPoE.Servers,.IPSec,.
3400	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 72 65 71 75 69 72 65	VXLAN,.and.other.tunnels.require
3420	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 6f 6d 6d 69 74 2e 20	.full.configuration.for.commit..
3440	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 20 6d 75 6c 74 69 70	The.endpoint.will.process.multip
3460	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 20 74 68 65 6d 20 61	le.commands.when.you.pass.them.a
3480	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 66 69 65 6c 64 2e 00	s.a.list.to.the.``data``.field..
34a0	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 70 6f 73 74 63	The.``/config/scripts/vyos-postc
34c0	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 20 69 73 20	onfig-bootup.script``.script.is.
34e0	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 56 79 4f 53 20 63 6f	called.on.boot.after.the.VyOS.co
3500	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 69 65 64 2e 00 54 68	nfiguration.is.fully.applied..Th
3520	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 70 72 65 63 6f 6e 66	e.``/config/scripts/vyos-preconf
3540	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 20 69 73 20 63 61 6c	ig-bootup.script``.script.is.cal
3560	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 4f 53 20 63 6f 6e 66	led.on.boot.before.the.VyOS.conf
3580	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 63 65 73 73 2e 00 54	iguration.during.boot.process..T
35a0	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 74 6f 20 73 68 6f 77	he.``/show``.endpoint.is.to.show
35c0	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 69 6f 6e 61 6c 20 6d	.everything.in.the.operational.m
35e0	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 70 6f 69 6e 74 20 72	ode..The.``generate``.endpoint.r
3600	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 2e 00 54 68 65 20 60	un.a.``generate``.command..The.`
3620	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 60 72 65 73 65 74 60	`reset``.endpoint.run.a.``reset`
3640	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 69 73 74 20 70 72 6f	`.command..The.commands.list.pro
3660	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 67 75 72 61 74 69 6f	duced.by.the.``show.configuratio
3680	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 20 56 79 4f 53 20 72	n.commands``.command.on.a.VyOS.r
36a0	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 61 6c 6c 20 74 68 65	outer.should.comply.with.all.the
36c0	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 61 73 79 20 74 6f 20	.requirements,.so.it.is.easy.to.
36e0	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 74 20 62 79 20 63 6f	get.a.proper.commands.list.by.co
3700	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 74 65 72 2e 00 54 68	pying.it.from.another.router..Th
3720	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 20 69 6e 20 74 68 65	e.configuration.specified.in.the
3740	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 65 72 77 72 69 74 65	.cloud-config.document.overwrite
3760	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 61 6c 75 65 73 20 61	s.default.configuration.values.a
3780	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 4d 65 74 61 64 61 74	nd.values.configured.via.Metadat
37a0	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 73 20 77 68 65 72 65	a..The.default.directories.where
37c0	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 6c 64 20 62 65 20 6c	.your.custom.Scripts.should.be.l
37e0	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 69 6c 65 20 6c 6f 6f	ocated.are:.The.default.file.loo
3800	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 20 77 61 79 20 74 6f	ks.like.this:.The.easiest.way.to
3820	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 20 75 73 65 72 2d 64	.configure.the.system.via.user-d
3840	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 79 6e 74 61 78 20 64	ata.is.the.Cloud-config.syntax.d
3860	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 69 6e 74 20 60 60 2f	escribed.below..The.endpoint.``/
3880	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 6f 72 20 6c 6f 61 64	config-file``.is.to.save.or.load
38a0	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 6c 6f 77 69 6e 67 20	.a.configuration..The.following.
38c0	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 20 62 61 73 65 64 20	example.sets.the.hostname.based.
38e0	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 72 20 6f 62 74 61 69	on.the.instance.identifier.obtai
3900	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 20 73 65 72 76 69 63	ned.from.the.EC2.metadata.servic
3920	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 73 68 6f 77 73 20 68	e..The.following.example.shows.h
3940	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 74 65 72 20 74 68 65	ow.to.execute.commands.after.the
3960	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 68 65 20 6b 65 79 20	.initial.configuration..The.key.
3980	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 63 6f 6e 66 69 67 75	used.to.designate.a.VyOS.configu
39a0	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 6f 6d 6d 61 6e 64 73	ration.is.``vyos_config_commands
39c0	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 63 6f 6e 66 69 67 75	``..What.follows.is.VyOS.configu
39e0	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 6c 65 22 20 73 79 6e	ration.using.the."set-style".syn
3a00	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 74 65 22 20 63 6f 6d	tax..Both."set".and."delete".com
3a20	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 73 65 65 64 2e 69 73	mands.are.supported..The.seed.is
3a40	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 20 74 68 65 20 76 69	o.file.can.be.attached.to.the.vi
3a60	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 70 6c 65 2c 20 74 68	rtual.machine..As.an.example,.th
3a80	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 63 68 20 74 68 65 20	e.method.with.KVM.to.attach.the.
3aa0	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 2e 00 54 68 65 72 65	ISO.as.a.CD.drive.follows..There
3ac0	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 67 20 77 69 74 68 20	.is.a.pitfall.when.working.with.
3ae0	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 20 69 73 20 74 65 6d	configuration.scripts..It.is.tem
3b00	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 6f 6e 20 73 63 72 69	pting.to.call.configuration.scri
3b20	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 6d 70 6f 72 61 72 79	pts.with."sudo".(i.e.,.temporary
3b40	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 73 65 20 74 68 61 74	.root.permissions),.because.that
3b60	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 20 4c 69 6e 75 78 20	's.the.common.way.on.most.Linux.
3b80	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 63 6f 6d 6d 61 6e 64	platforms.to.call.system.command
3ba0	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 61 75 6c 74 73 20 61	s..These.are.the.VyOS.defaults.a
3bc0	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 6e 20 6e 65 65 64 73	nd.fallbacks..This.section.needs
3be0	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 6e 64 20 65 78 70 6c	.improvements,.examples.and.expl
3c00	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 74 20 69 6e 20 74 68	anations..This.will.result.in.th
3c20	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 3a 20 60 60 53 65 74	e.following.error.message:.``Set
3c40	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 2c 20 61 20 72 65 62	.failed``.If.this.happens,.a.reb
3c60	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 65 20 74 6f 20 65 64	oot.is.required.to.be.able.to.ed
3c80	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 61 69 6e 2e 00 54 6f	it.the.config.manually.again..To
3ca0	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 65 2e 00 54 6f 20 61	.Load.a.configuration.file..To.a
3cc0	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 65 20 74 68 65 20 60	dd.or.delete.an.image,.use.the.`
3ce0	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 6f 69 64 20 74 68 65	`/image``.endpoint..To.avoid.the
3d00	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 61 79 20 69 73 20 74	se.problems,.the.proper.way.is.t
3d20	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 60 60 76 79 61 74 74	o.call.a.script.with.the.``vyatt
3d40	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 69 6e 67 20 74 68 65	acfg``.group,.e.g.,.by.using.the
3d60	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 6d 6d 61 6e 64 3a 00	.``sg``.(switch.group).command:.
3d80	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 61 74 69 6f 6e 2c 20	To.get.the.whole.configuration,.
3da0	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 20 60 60 70 61 74 68	pass.an.empty.list.to.the.``path
3dc0	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 73 70 65 63 69 66 69	``.field.To.include.VyOS.specifi
3de0	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 6f 75 20 6e 65 65 64	c.functions.and.aliases.you.need
3e00	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 65 74 63 2f 66 75 6e	.to.``source./opt/vyatta/etc/fun
3e20	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 66 69 6c 65 73 20 61	ctions/script-template``.files.a
3e40	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 00 54 6f 20 6d 61 6b	t.the.top.of.your.script..To.mak
3e60	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
3e80	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
3ea0	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.
3ec0	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
3ee0	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
3f00	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``
3f20	2e 00 54 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 00 55 6e 6c 69 6b 65 20 61 20 6e 6f 72 6d 61	..Troubleshooting.Unlike.a.norma
3f40	6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 65 73 73 69 6f 6e 2c 20 61 6c 6c 20 6f 70 65	l.configuration.session,.all.ope
3f60	72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 6d 75 73 74 20 62 65 20 70 72 65 70 65 6e	rational.commands.must.be.prepen
3f80	64 65 64 20 77 69 74 68 20 60 60 72 75 6e 60 60 2c 20 65 76 65 6e 20 69 66 20 79 6f 75 20 68 61	ded.with.``run``,.even.if.you.ha
3fa0	76 65 6e 27 74 20 63 72 65 61 74 65 64 20 61 20 73 65 73 73 69 6f 6e 20 77 69 74 68 20 63 6f 6e	ven't.created.a.session.with.con
3fc0	66 69 67 75 72 65 2e 00 55 73 65 72 2d 64 61 74 61 00 55 73 65 72 2d 64 61 74 61 20 2d 20 55 73	figure..User-data.User-data.-.Us
3fe0	65 72 2d 64 61 74 61 20 69 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20 75 73 65 72	er-data.is.specified.by.the.user
4000	2e 20 54 68 69 73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 20 6f 66 66 65 72 73 20 74 68 65 20	..This.config.source.offers.the.
4020	61 62 69 6c 69 74 79 20 74 6f 20 69 6e 73 65 72 74 20 61 6e 79 20 43 4c 49 20 63 6f 6e 66 69 67	ability.to.insert.any.CLI.config
4040	75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 74 6f 20 74 68 65 20 63 6f 6e 66 69 67	uration.commands.into.the.config
4060	75 72 61 74 69 6f 6e 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74 2e 00 56	uration.before.the.first.boot..V
4080	4d 20 49 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	M.ID:.in.this.example,.VM.ID.use
40a0	64 20 69 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	d.is.555..VM.Resources:.these.pa
40c0	72 61 6d 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	rameters.can.be.modified.as.need
40e0	65 64 2e 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	ed..VM.Storage:.``local``.volume
4100	20 69 73 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	.is.used..VyOS.API.VyOS.Automati
4120	6f 6e 00 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	on.VyOS.`cloud-init-docs`_..VyOS
4140	20 63 6c 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	.cloud-init.VyOS.configuration.c
4160	6f 6d 6d 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	ommands.are.defined.in.user-data
4180	20 66 69 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	.file..VyOS.has.the.ability.to.r
41a0	75 6e 20 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	un.custom..scripts.before.and.af
41c0	74 65 72 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	ter.each.commit.VyOS.support.thr
41e0	65 65 20 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	ee.types.of.config.sources..VyOS
4200	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 61 6e 73 69	.supports.configuration.via.ansi
4220	62 6c 65 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	ble..Need.to.install.``ansible``
4240	20 61 6e 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	.and.``python3-paramiko``.module
4260	00 56 79 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	.VyOS.supports.configuration.via
4280	20 6e 65 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	.netmiko_..It.requires.to.instal
42a0	6c 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 2e 00 56 79	l.``python3-netmiko``.module..Vy
42c0	4f 53 20 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	OS.supports.executing.configurat
42e0	69 6f 6e 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	ion.and.operational.commands.non
4300	2d 69 6e 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	-interactively.from.shell.script
4320	73 2e 00 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	s..VyOS.supports.op-mode.and.con
4340	66 69 67 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	figuration.via.salt_..VyOS.suppo
4360	72 74 73 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	rts.some.napalm_.functions.for.c
4380	6f 6e 66 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	onfiguration.and.op-mode..It.req
43a0	75 69 72 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	uires.more.tests..VyOS.supports.
43c0	74 68 65 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	the.execution.of.operational.com
43e0	6d 61 6e 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	mands.and.linux.commands.at.init
4400	69 61 6c 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	ial.boot..This.is.accomplished.u
4420	73 69 6e 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	sing.``write_files``.to.certain.
4440	66 69 6c 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	files.in.the./opt/vyatta/etc/con
4460	66 69 67 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	fig/scripts.directory..Commands.
4480	73 70 65 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	specified.in.opt/vyatta/etc/conf
44a0	69 67 2f 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	ig/scripts/vyos-preconfig-bootup
44c0	2e 73 63 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	.script.are.executed.prior.to.co
44e0	6e 66 69 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	nfiguration..The./opt/vyatta/etc
4500	2f 63 6f 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	/config/scripts/vyos-postconfig-
4520	62 6f 6f 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	bootup.script.file.contains.comm
4540	61 6e 64 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	ands.to.be.executed.after.config
4560	75 72 61 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	uration..In.both.cases,.commands
4580	20 61 72 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	.are.executed.as.the.root.user..
45a0	57 65 20 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	We.need.2.files,.commands.conf.a
45c0	6e 64 20 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	nd.script.itself..While.other.me
45e0	74 68 6f 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	thods.exist,.the.most.straightfo
4600	72 77 61 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	rward.method.for.using.the.NoClo
4620	75 64 20 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	ud.data.source.is.creating.a.see
4640	64 20 49 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	d.ISO.and.attaching.it.to.the.vi
4660	72 74 75 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	rtual.machine.as.a.CD.drive..The
4680	20 76 6f 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	.volume.must.be.formatted.as.a.v
46a0	66 61 74 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	fat.or.ISO.9660.file.system.with
46c0	20 74 68 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	.the.label."cidata".or."CIDATA".
46e0	00 57 69 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	.Will.return:.With.the.``retriev
4700	65 60 60 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	e``.endpoint.you.get.parts.or.th
4720	65 20 77 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	e.whole.configuration..Without.p
4740	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 20 63 6f 6e	roxy.it.requires.VyOS.minion.con
4760	66 69 67 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	figuration.and.support.op-mode.d
4780	61 74 61 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	ata:.Without.proxy.it.requires.V
47a0	79 4f 53 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	yOS.minion.configuration.and.sup
47c0	70 6f 72 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 70 61 73 73	ports.op-mode.data:.You.can.pass
47e0	20 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	.a.``set``,.``delete``.or.``comm
4800	65 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	ent``.command.to.the.``/configur
4820	65 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	e``.endpoint..``delete``.a.singl
4840	65 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	e.command.``seed.iso``.was.previ
4860	6f 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	ously.created.in.directory.``/tm
4880	70 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	p/``..It's.necessary.to.move.it.
48a0	74 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	to.``/var/lib/vz/template/iso``.
48c0	60 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	``set``.a.single.command.``vyos_
48e0	75 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	userdata``.-.the.module.accepts.
4900	61 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	a.list.of.CLI.configuration.comm
4920	61 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	ands.in.a.``vyos_config_commands
4940	60 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	``.section,.which.gives.an.easy.
4960	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 64 75 72 69	way.to.configure.the.system.duri
4980	6e 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	ng.deployment..``vyos``/``vyos``
49a0	20 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	.credentials.if.no.others.specif
49c0	69 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	ied.by.data.source..``write_file
49e0	73 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	s``.-.this.module.allows.to.inse
4a00	72 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	rt.any.files.into.the.filesystem
4a20	20 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	.before.the.first.boot,.for.exam
4a40	70 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	ple,.pre-generated.encryption.ke
4a60	79 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	ys,.certificates,.or.even.a.whol
4a80	65 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	e.``config.boot``.file..The.form
4aa0	61 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	at.is.described.in.the.cloudinit
4ac0	20 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	.documentation.`Cloud-init-write
4ae0	5f 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	_files`_..add.an.image.ansible.c
4b00	66 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	fg.cloud-config.file.format.clou
4b20	64 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	d-init.logs.to./var/log/cloud-in
4b40	69 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	it.log..This.file.can.be.helpful
4b60	20 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	.in.determining.why.the.configur
4b80	61 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	ation.varies.from.what.you.expec
4ba0	74 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	t..You.can.fetch.the.most.import
4bc0	61 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	ant.data.filtering.output.for.``
4be0	76 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	vyos``.keyword:.commands.txt.del
4c00	65 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	ete.an.image,.for.example.``1.3-
4c20	72 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	rolling-202006070117``.hosts.id_
4c40	72 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	rsa_docker.pub..Needs.to.declare
4c60	20 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	.only.public.key.exactly..if.you
4c80	20 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	.just.want.the.Value.of.a.multi-
4ca0	76 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	valued.node,.use.the.``returnVal
4cc0	75 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	ues``.operation..main.yml.r11-pr
4ce0	6f 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	oxy.sls.Includes.parameters.for.
4d00	63 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	connecting.to.salt-proxy.minion.
4d20	73 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	startup.scripts.top.sls.MIME-Ver
4d40	73 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	sion:.1.0.Content-Type:.text/pla
4d60	69 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	in;.charset=UTF-8.Content-Transf
4d80	65 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	er-Encoding:.8bit.X-Generator:.L
4da0	6f 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	ocalazy.(https://localazy.com).P
4dc0	72 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 70 74	roject-Id-Version:..Language:.pt
4de0	0a 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	.Plural-Forms:.nplurals=2;.plura
4e00	6c 3d 28 6e 3e 3d 30 20 26 26 20 6e 3c 3d 31 29 20 3f 20 30 20 3a 20 31 3b 0a 00 2a 2a 4e 4f 54	l=(n>=0.&&.n<=1).?.0.:.1;..**NOT
4e20	45 2a 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	E**:.be.carefull.while.copying.a
4e40	6e 64 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	nd.pasting.previous.commands..Do
4e60	62 6c 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	ble.quotes.may.need.to.be.correc
4e80	74 65 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	ted..**meta-data**:.empty.file.(
4ea0	72 65 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	required)..**network-config**.fi
4ec0	6c 65 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	le.only.has.configuration.that.d
4ee0	69 73 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	isables.the.automatic.dhcp.clien
4f00	74 20 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	t.on.first.interface..**network-
4f20	63 6f 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	config**:.file.that.will.indicat
4f40	65 20 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	e.to.avoid.dhcp.client.on.first.
4f60	69 6e 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	interface..**user-data**.file.mu
4f80	73 74 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	st.start.with.``#cloud-config``.
4fa0	61 6e 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	and.contains.vyos-commands..For.
4fc0	65 78 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	example:.**user-data**:.includes
4fe0	20 76 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	.vyos-commands../config-file./co
5000	6e 66 69 67 75 72 65 00 2f 67 65 6e 65 72 61 74 65 00 2f 69 6d 61 67 65 00 2f 72 65 73 65 74 00	nfigure./generate./image./reset.
5020	2f 72 65 74 72 69 65 76 65 00 2f 73 68 6f 77 00 41 20 56 79 4f 53 20 71 63 6f 77 20 69 6d 61 67	/retrieve./show.A.VyOS.qcow.imag
5040	65 20 77 69 74 68 20 63 6c 6f 75 64 2d 69 6e 69 74 20 6f 70 74 69 6f 6e 73 20 69 73 20 6e 65 65	e.with.cloud-init.options.is.nee
5060	64 65 64 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 6f 62 74 61 69 6e 65 64 20 75 73 69 6e 67 20	ded..This.can.be.obtained.using.
5080	60 76 79 6f 73 2d 76 6d 2d 69 6d 61 67 65 73 60 5f 20 72 65 70 6f 2e 20 41 66 74 65 72 20 63 6c	`vyos-vm-images`_.repo..After.cl
50a0	6f 6e 6e 69 6e 67 20 74 68 65 20 72 65 70 6f 2c 20 65 64 69 74 20 74 68 65 20 66 69 6c 65 20 2a	onning.the.repo,.edit.the.file.*
50c0	2a 71 65 6d 75 2e 79 6d 6c 2a 2a 20 61 6e 64 20 63 6f 6d 6d 65 6e 74 20 74 68 65 20 2a 2a 64 6f	*qemu.yml**.and.comment.the.**do
50e0	77 6e 6c 6f 61 64 2d 69 73 6f 2a 2a 20 72 6f 6c 65 2e 00 41 20 63 6c 6f 75 64 2d 63 6f 6e 66 69	wnload-iso**.role..A.cloud-confi
5100	67 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 20 59 41 4d 4c 2e 20 54	g.document.is.written.in.YAML..T
5120	68 65 20 66 69 6c 65 20 6d 75 73 74 20 62 65 67 69 6e 20 77 69 74 68 20 60 60 23 63 6c 6f 75 64	he.file.must.begin.with.``#cloud
5140	2d 63 6f 6e 66 69 67 60 60 20 6c 69 6e 65 2e 20 54 68 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74	-config``.line..The.only.support
5160	65 64 20 74 6f 70 2d 6c 65 76 65 6c 20 6b 65 79 73 20 61 72 65 20 60 60 76 79 6f 73 5f 63 6f 6e	ed.top-level.keys.are.``vyos_con
5180	66 69 67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 61 6e 64 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73	fig_commands``.and.``write_files
51a0	60 60 2e 20 54 68 65 20 75 73 65 20 6f 66 20 74 68 65 73 65 20 6b 65 79 73 20 69 73 20 64 65 73	``..The.use.of.these.keys.is.des
51c0	63 72 69 62 65 64 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 73 65 63 74	cribed.in.the.following.two.sect
51e0	69 6f 6e 73 2e 00 41 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 20 69 73 20 73 68 6f 77 6e 20	ions..A.simple.example.is.shown.
5200	62 65 6c 6f 77 2c 20 77 68 65 72 65 20 74 68 65 20 6f 70 73 20 63 6f 6d 6d 61 6e 64 20 65 78 65	below,.where.the.ops.command.exe
5220	63 75 74 65 64 20 69 6e 20 74 68 65 20 70 6f 73 74 2d 68 6f 6f 6b 20 73 63 72 69 70 74 20 69 73	cuted.in.the.post-hook.script.is
5240	20 22 73 68 6f 77 20 69 6e 74 65 72 66 61 63 65 73 22 2e 00 41 20 73 69 6e 67 6c 65 2d 71 75 6f	."show.interfaces"..A.single-quo
5260	74 65 20 73 79 6d 62 6f 6c 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 20 69 6e 73 69 64 65 20	te.symbol.is.not.allowed.inside.
5280	63 6f 6d 6d 61 6e 64 20 6f 72 20 76 61 6c 75 65 2e 00 41 50 49 20 45 6e 64 70 6f 69 6e 74 73 00	command.or.value..API.Endpoints.
52a0	41 63 63 65 70 74 20 6d 69 6e 69 6f 6e 20 6b 65 79 00 41 6c 6c 20 65 6e 64 70 6f 69 6e 74 73 20	Accept.minion.key.All.endpoints.
52c0	6f 6e 6c 79 20 6c 69 73 74 65 6e 20 6f 6e 20 48 54 54 50 20 50 4f 53 54 20 72 65 71 75 65 73 74	only.listen.on.HTTP.POST.request
52e0	73 20 61 6e 64 20 74 68 65 20 41 50 49 20 4b 45 59 20 6d 75 73 74 20 73 65 74 20 61 73 20 60 60	s.and.the.API.KEY.must.set.as.``
5300	6b 65 79 60 60 20 69 6e 20 74 68 65 20 66 6f 72 6d 64 61 74 61 2e 00 41 6c 6c 20 6f 66 20 74 68	key``.in.the.formdata..All.of.th
5320	65 73 65 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 75 73 69 6e 67 20 74 68 65 20	ese.can.be.overridden.using.the.
5340	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e 20 75 73 65 72 2d 64 61 74 61 2e 00 41 6c 73 6f	configuration.in.user-data..Also
5360	2c 20 74 68 69 73 20 6c 61 62 20 63 6f 6e 73 69 64 65 72 73 3a 00 41 6e 73 69 62 6c 65 00 41 6e	,.this.lab.considers:.Ansible.An
5380	79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 77 65 72 65 20 64 6f 6e 65 20 74 6f 20 77 6f 72	y.modifications.were.done.to.wor
53a0	6b 20 61 72 6f 75 6e 64 20 75 6e 66 69 78 65 64 20 62 75 67 73 20 61 6e 64 20 69 6d 70 6c 65 6d	k.around.unfixed.bugs.and.implem
53c0	65 6e 74 20 65 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 63 6f	ent.enhancements.that.are.not.co
53e0	6d 70 6c 65 74 65 20 69 6e 20 74 68 65 20 56 79 4f 53 20 73 79 73 74 65 6d 20 63 61 6e 20 62 65	mplete.in.the.VyOS.system.can.be
5400	20 70 6c 61 63 65 64 20 68 65 72 65 2e 00 41 74 20 74 68 69 73 20 73 74 65 70 20 77 65 20 63 61	.placed.here..At.this.step.we.ca
5420	6e 20 67 65 74 20 73 6f 6d 65 20 6f 70 2d 6d 6f 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66	n.get.some.op-mode.information.f
5440	72 6f 6d 20 56 79 4f 53 20 6e 6f 64 65 73 3a 00 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 00 42	rom.VyOS.nodes:.Authentication.B
5460	65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 2c 20 70 6c 65 61 73 65 20 72 65 66 65 72 20 74 6f 20	efore.starting,.please.refer.to.
5480	63 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	cloud-init.`network-config-docs`
54a0	5f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 6b 6e 6f 77 20 68 6f 77 20 74 6f 20 69 6d 70 6f 72 74	_.in.order.to.know.how.to.import
54c0	20 75 73 65 72 20 61 6e 64 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73	.user.and.network.configurations
54e0	2e 00 42 65 6c 6f 77 20 73 65 65 20 6f 6e 65 20 65 78 61 6d 70 6c 65 20 66 6f 72 20 63 75 72 6c	..Below.see.one.example.for.curl
5500	20 61 6e 64 20 6f 6e 65 20 66 6f 72 20 70 79 74 68 6f 6e 2e 20 54 68 65 20 72 65 73 74 20 6f 66	.and.one.for.python..The.rest.of
5520	20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 72 65 64 75 63 65 64 20 74 6f	.the.documentation.is.reduced.to
5540	20 63 75 72 6c 2e 00 43 68 65 63 6b 20 73 61 6c 74 2d 6b 65 79 73 20 6f 6e 20 74 68 65 20 73 61	.curl..Check.salt-keys.on.the.sa
5560	6c 74 20 6d 61 73 74 65 72 00 43 68 65 63 6b 20 74 68 61 74 20 70 72 6f 78 79 20 6d 69 6e 69 6f	lt.master.Check.that.proxy.minio
5580	6e 20 69 73 20 61 6c 69 76 65 3a 00 43 68 65 63 6b 20 74 68 61 74 20 73 61 6c 74 20 6d 61 73 74	n.is.alive:.Check.that.salt.mast
55a0	65 72 20 63 61 6e 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 77 69 74 68 20 6d 69 6e 69 6f 6e 73 00	er.can.communicate.with.minions.
55c0	43 6c 6f 75 64 20 61 6e 64 20 76 69 72 74 75 61 6c 69 7a 65 64 20 69 6e 73 74 61 6e 63 65 73 20	Cloud.and.virtualized.instances.
55e0	6f 66 20 56 79 4f 53 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 74 68	of.VyOS.are.initialized.using.th
5600	65 20 69 6e 64 75 73 74 72 79 2d 73 74 61 6e 64 61 72 64 20 63 6c 6f 75 64 2d 69 6e 69 74 2e 20	e.industry-standard.cloud-init..
5620	56 69 61 20 63 6c 6f 75 64 2d 69 6e 69 74 2c 20 74 68 65 20 73 79 73 74 65 6d 20 70 65 72 66 6f	Via.cloud-init,.the.system.perfo
5640	72 6d 73 20 74 61 73 6b 73 20 73 75 63 68 20 61 73 20 69 6e 6a 65 63 74 69 6e 67 20 53 53 48 20	rms.tasks.such.as.injecting.SSH.
5660	6b 65 79 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 74 68 65 20 6e 65 74 77 6f 72 6b	keys.and.configuring.the.network
5680	2e 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 74 68 65 20 75 73 65 72 20 63 61 6e 20 73 75 70 70	..In.addition,.the.user.can.supp
56a0	6c 79 20 61 20 63 75 73 74 6f 6d 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 74 20 74 68 65	ly.a.custom.configuration.at.the
56c0	20 74 69 6d 65 20 6f 66 20 69 6e 73 74 61 6e 63 65 20 6c 61 75 6e 63 68 2e 00 43 6c 6f 75 64 2d	.time.of.instance.launch..Cloud-
56e0	63 6f 6e 66 69 67 20 6d 6f 64 75 6c 65 73 00 43 6c 6f 75 64 2d 69 6e 69 74 20 60 6e 65 74 77 6f	config.modules.Cloud-init.`netwo
5700	72 6b 2d 63 6f 6e 66 69 67 2d 64 6f 63 73 60 5f 2e 00 43 6c 6f 75 64 2d 69 6e 69 74 20 6f 6e 20	rk-config-docs`_..Cloud-init.on.
5720	50 72 6f 78 6d 6f 78 00 43 6f 6d 6d 61 6e 64 20 45 78 65 63 75 74 69 6f 6e 20 61 74 20 49 6e 69	Proxmox.Command.Execution.at.Ini
5740	74 69 61 6c 20 42 6f 6f 74 00 43 6f 6d 6d 61 6e 64 20 53 63 72 69 70 74 69 6e 67 00 43 6f 6d 6d	tial.Boot.Command.Scripting.Comm
5760	61 6e 64 20 66 6f 72 20 67 65 6e 65 72 61 74 69 6e 67 20 60 60 73 65 65 64 2e 69 73 6f 60 60 00	and.for.generating.``seed.iso``.
5780	43 6f 6d 6d 61 6e 64 73 20 72 65 71 75 69 72 65 6d 65 6e 74 73 3a 00 43 6f 6e 66 69 67 20 53 6f	Commands.requirements:.Config.So
57a0	75 72 63 65 73 00 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 00 43 6f 6e 66 69 67 75 72 61 74 69 6f	urces.Configuration.Configuratio
57c0	6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 78 65 63 75 74 65 64 20 6a 75 73 74 20 6c 69 6b	n.commands.are.executed.just.lik
57e0	65 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 63 6f 6e 66 69 67 20 73 65 73 73 69 6f 6e 2e 20	e.from.a.normal.config.session..
5800	46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 69 73 61	For.example,.if.you.want.to.disa
5820	62 6c 65 20 61 20 42 47 50 20 70 65 65 72 20 6f 6e 20 56 52 52 50 20 74 72 61 6e 73 69 74 69 6f	ble.a.BGP.peer.on.VRRP.transitio
5840	6e 20 74 6f 20 62 61 63 6b 75 70 3a 00 43 6f 6e 74 65 6e 74 20 6f 66 20 63 6f 6d 6d 61 6e 64 73	n.to.backup:.Content.of.commands
5860	2e 63 6f 6e 66 00 43 6f 6e 74 65 6e 74 20 6f 66 20 6e 65 74 77 6f 72 6b 2d 63 6f 6e 66 69 67 20	.conf.Content.of.network-config.
5880	66 69 6c 65 3a 00 43 72 65 61 74 65 20 73 65 65 64 2e 69 73 6f 00 43 72 65 61 74 65 20 74 65 78	file:.Create.seed.iso.Create.tex
58a0	74 20 66 69 6c 65 73 20 6e 61 6d 65 64 20 75 73 65 72 2d 64 61 74 61 20 61 6e 64 20 6d 65 74 61	t.files.named.user-data.and.meta
58c0	2d 64 61 74 61 2e 20 4f 6e 20 6c 69 6e 75 78 2d 62 61 73 65 64 20 73 79 73 74 65 6d 73 2c 20 74	-data..On.linux-based.systems,.t
58e0	68 65 20 6d 6b 69 73 6f 66 73 20 75 74 69 6c 69 74 79 20 63 61 6e 20 62 65 20 75 73 65 64 20 74	he.mkisofs.utility.can.be.used.t
5900	6f 20 63 72 65 61 74 65 20 74 68 65 20 73 65 65 64 20 49 53 4f 2e 20 54 68 65 20 66 6f 6c 6c 6f	o.create.the.seed.ISO..The.follo
5920	77 69 6e 67 20 73 79 6e 74 61 78 20 77 69 6c 6c 20 61 64 64 20 74 68 65 73 65 20 66 69 6c 65 73	wing.syntax.will.add.these.files
5940	20 74 6f 20 74 68 65 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65 20 73 79 73 74 65 6d 2e 00 43 72	.to.the.ISO.9660.file.system..Cr
5960	65 61 74 69 6e 67 20 74 68 65 20 56 4d 00 43 75 73 74 6f 6d 20 73 63 72 69 70 74 73 20 61 72 65	eating.the.VM.Custom.scripts.are
5980	20 6e 6f 74 20 65 78 65 63 75 74 65 64 20 77 69 74 68 20 72 6f 6f 74 20 70 72 69 76 69 6c 65 67	.not.executed.with.root.privileg
59a0	65 73 20 28 55 73 65 20 73 75 64 6f 20 69 6e 73 69 64 65 20 69 66 20 74 68 69 73 20 69 73 20 6e	es.(Use.sudo.inside.if.this.is.n
59c0	65 63 65 73 73 61 72 79 29 2e 00 44 48 43 50 20 6f 6e 20 66 69 72 73 74 20 45 74 68 65 72 6e 65	ecessary)..DHCP.on.first.Etherne
59e0	74 20 69 6e 74 65 72 66 61 63 65 20 69 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67	t.interface.if.no.network.config
5a00	75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 76 69 64 65 64 2e 00 45 78 61 6d 70 6c 65 00 45 78 61	uration.is.provided..Example.Exa
5a20	6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 66	mple.of.configuration.commands.f
5a40	72 6f 6d 20 74 68 65 20 66 69 6c 65 20 22 2f 73 72 76 2f 73 61 6c 74 2f 73 74 61 74 65 73 2f 63	rom.the.file."/srv/salt/states/c
5a60	6f 6d 6d 61 6e 64 73 2e 74 78 74 22 00 45 78 61 6d 70 6c 65 20 6f 66 20 63 6f 6e 66 69 67 75 72	ommands.txt".Example.of.configur
5a80	61 74 69 6f 6e 3a 00 45 78 61 6d 70 6c 65 20 6f 66 20 6f 70 2d 6d 6f 64 65 3a 00 45 78 61 6d 70	ation:.Example.of.op-mode:.Examp
5aa0	6c 65 73 00 45 78 65 63 75 74 69 6e 67 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 53 63 72 69	les.Executing.Configuration.Scri
5ac0	70 74 73 00 45 78 65 63 75 74 69 6e 67 20 70 72 65 2d 68 6f 6f 6b 73 2f 70 6f 73 74 2d 68 6f 6f	pts.Executing.pre-hooks/post-hoo
5ae0	6b 73 20 53 63 72 69 70 74 73 00 46 69 6c 65 20 63 6f 6e 74 65 6e 74 73 00 46 69 6c 65 20 67 65	ks.Scripts.File.contents.File.ge
5b00	6e 65 72 61 74 65 64 20 77 69 74 68 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 3a 20 60	nerated.with.previous.command:.`
5b20	60 2f 74 6d 70 2f 76 79 6f 73 2d 31 2e 33 2e 30 2d 63 6c 6f 75 64 2d 69 6e 69 74 2d 31 30 47 2d	`/tmp/vyos-1.3.0-cloud-init-10G-
5b40	71 65 6d 75 2e 71 63 6f 77 32 60 60 00 46 69 6e 61 6c 79 2c 20 66 69 6c 65 20 2a 2a 6d 65 74 61	qemu.qcow2``.Finaly,.file.**meta
5b60	2d 64 61 74 61 2a 2a 20 68 61 73 20 6e 6f 20 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 69 74 27 73	-data**.has.no.content,.but.it's
5b80	20 72 65 71 75 69 72 65 64 2e 00 46 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64	.required..For.configuration.and
5ba0	20 65 6e 61 62 6c 69 6e 67 20 74 68 65 20 41 50 49 20 73 65 65 20 3a 72 65 66 3a 60 68 74 74 70	.enabling.the.API.see.:ref:`http
5bc0	2d 61 70 69 60 00 46 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2f 75 70 67 72 61 64 65 20	-api`.For.configuration/upgrade.
5be0	6d 61 6e 61 67 65 6d 65 6e 74 20 69 73 73 75 65 73 2c 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20	management.issues,.modification.
5c00	6f 66 20 74 68 69 73 20 73 63 72 69 70 74 20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 6c 61 73	of.this.script.should.be.the.las
5c20	74 20 6f 70 74 69 6f 6e 2e 20 41 6c 77 61 79 73 20 74 72 79 20 74 6f 20 66 69 6e 64 20 73 6f 6c	t.option..Always.try.to.find.sol
5c40	75 74 69 6f 6e 73 20 62 61 73 65 64 20 6f 6e 20 43 4c 49 20 63 6f 6d 6d 61 6e 64 73 20 66 69 72	utions.based.on.CLI.commands.fir
5c60	73 74 2e 00 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 67 65 74 20 74 68 65 20 61 64 64 72 65 73 73	st..For.example,.get.the.address
5c80	65 73 20 6f 66 20 61 20 60 60 64 75 6d 30 60 60 20 69 6e 74 65 72 66 61 63 65 2e 00 46 6f 72 20	es.of.a.``dum0``.interface..For.
5ca0	65 78 61 6d 70 6c 65 2c 20 73 68 6f 77 20 77 68 69 63 68 20 69 6d 61 67 65 73 20 61 72 65 20 69	example,.show.which.images.are.i
5cc0	6e 73 74 61 6c 6c 65 64 2e 00 46 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f	nstalled..For.more.information.o
5ce0	6e 20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 64 61 74 61 20 73 6f 75 72 63 65 2c 20 76 69 73 69 74	n.the.NoCloud.data.source,.visit
5d00	20 69 74 73 20 60 70 61 67 65 20 3c 68 74 74 70 73 3a 2f 2f 63 6c 6f 75 64 69 6e 69 74 2e 72 65	.its.`page.<https://cloudinit.re
5d20	61 64 74 68 65 64 6f 63 73 2e 69 6f 2f 65 6e 2f 6c 61 74 65 73 74 2f 72 65 66 65 72 65 6e 63 65	adthedocs.io/en/latest/reference
5d40	2f 64 61 74 61 73 6f 75 72 63 65 73 2f 6e 6f 63 6c 6f 75 64 2e 68 74 6d 6c 3e 60 5f 20 69 6e 20	/datasources/nocloud.html>`_.in.
5d60	74 68 65 20 63 6c 6f 75 64 2d 69 6e 69 74 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 00 46 72	the.cloud-init.documentation..Fr
5d80	6f 6d 20 63 6c 69 20 6f 72 20 47 55 49 2c 20 70 6f 77 65 72 20 6f 6e 20 56 4d 2c 20 61 6e 64 20	om.cli.or.GUI,.power.on.VM,.and.
5da0	61 66 74 65 72 20 69 74 20 62 6f 6f 74 73 2c 20 76 65 72 69 66 79 20 63 6f 6e 66 69 67 75 72 61	after.it.boots,.verify.configura
5dc0	74 69 6f 6e 00 47 65 6e 65 72 61 74 65 20 71 63 6f 77 20 69 6d 61 67 65 00 48 65 72 65 20 69 73	tion.Generate.qcow.image.Here.is
5de0	20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c 65 3a 00 48 65 72 65 20 69 73 20 61 6e 20 65 78	.a.simple.example:.Here.is.an.ex
5e00	61 6d 70 6c 65 20 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 74 68 61 74 20 61 70 70 65 6e 64 73 20	ample.cloud-config.that.appends.
5e20	63 6f 6e 66 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 66 69 72	configuration.at.the.time.of.fir
5e40	73 74 20 62 6f 6f 74 2e 00 49 53 4f 20 66 69 6c 65 73 20 73 74 6f 72 61 67 65 3a 20 60 60 6c 6f	st.boot..ISO.files.storage:.``lo
5e60	63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 69 73 20 75 73 65 64 20 66 6f 72 20 60 60 2e 69 73 6f 60	cal``.volume.is.used.for.``.iso`
5e80	60 20 66 69 6c 65 20 73 74 6f 72 61 67 65 2e 20 49 6e 20 74 68 69 73 20 73 63 65 6e 61 72 69 6f	`.file.storage..In.this.scenario
5ea0	20 60 60 6c 6f 63 61 6c 60 60 20 76 6f 6c 75 6d 65 20 74 79 70 65 20 69 73 20 73 65 74 20 74 6f	.``local``.volume.type.is.set.to
5ec0	20 2a 2a 64 69 72 65 63 74 6f 72 79 2a 2a 2c 20 61 62 64 20 61 74 74 61 63 68 65 64 20 74 6f 20	.**directory**,.abd.attached.to.
5ee0	60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 60 60 2e 00 49 66 20 63 6f 6d 6d 61 6e 64 20 65 6e 64 73	``/var/lib/vz``..If.command.ends
5f00	20 69 6e 20 61 20 76 61 6c 75 65 2c 20 69 74 20 6d 75 73 74 20 62 65 20 69 6e 73 69 64 65 20 73	.in.a.value,.it.must.be.inside.s
5f20	69 6e 67 6c 65 20 71 75 6f 74 65 73 2e 00 49 66 20 6e 6f 20 6e 65 74 77 6f 72 6b 69 6e 67 20 63	ingle.quotes..If.no.networking.c
5f40	6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 73 20 70 72 6f 76 69 64 65 64 2c 20 74 68 65 6e 20 64	onfiguration.is.provided,.then.d
5f60	68 63 70 20 63 6c 69 65 6e 74 20 69 73 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 65 6e 61 62 6c 65	hcp.client.is.going.to.be.enable
5f80	64 20 6f 6e 20 66 69 72 73 74 20 69 6e 74 65 72 66 61 63 65 2e 20 42 61 72 65 20 69 6e 20 6d 69	d.on.first.interface..Bare.in.mi
5fa0	6e 64 20 74 68 61 74 20 74 68 69 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 77 69 6c 6c 20	nd.that.this.configuration.will.
5fc0	62 65 20 69 6e 79 65 63 74 65 64 20 61 74 20 61 6e 20 4f 53 20 6c 65 76 65 6c 2c 20 73 6f 20 64	be.inyected.at.an.OS.level,.so.d
5fe0	6f 6e 27 74 20 65 78 70 65 63 74 20 74 6f 20 66 69 6e 64 20 64 68 63 70 20 63 6c 69 65 6e 74 20	on't.expect.to.find.dhcp.client.
6000	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 6e 20 76 79 6f 73 20 63 6c 69 2e 20 42 65 63 61 75	configuration.on.vyos.cli..Becau
6020	73 65 20 6f 66 20 74 68 69 73 20 62 65 68 61 76 69 6f 72 2c 20 69 6e 20 6e 65 78 74 20 65 78 61	se.of.this.behavior,.in.next.exa
6040	6d 70 6c 65 20 6c 61 62 20 77 65 20 77 69 6c 6c 20 64 69 73 61 62 6c 65 20 64 68 63 70 2d 63 6c	mple.lab.we.will.disable.dhcp-cl
6060	69 65 6e 74 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 6e 20 65 74 68 30 2e 00 49 66 20 79	ient.configuration.on.eth0..If.y
6080	6f 75 20 65 6e 63 6f 75 6e 74 65 72 20 70 72 6f 62 6c 65 6d 73 2c 20 76 65 72 69 66 79 20 74 68	ou.encounter.problems,.verify.th
60a0	61 74 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 63 6f 6e	at.the.cloud-config.document.con
60c0	74 61 69 6e 73 20 76 61 6c 69 64 20 59 41 4d 4c 2e 20 4f 6e 6c 69 6e 65 20 72 65 73 6f 75 72 63	tains.valid.YAML..Online.resourc
60e0	65 73 20 73 75 63 68 20 61 73 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 79 61 6d 6c 6c 69 6e 74 2e	es.such.as.https://www.yamllint.
6100	63 6f 6d 2f 20 70 72 6f 76 69 64 65 20 61 20 73 69 6d 70 6c 65 20 74 6f 6f 6c 20 66 6f 72 20 76	com/.provide.a.simple.tool.for.v
6120	61 6c 69 64 61 74 69 6e 67 20 59 41 4d 4c 2e 00 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 67	alidating.YAML..If.you.need.to.g
6140	61 74 68 65 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 6c 69 6e 75 78 20 63 6f 6d	ather.information.from.linux.com
6160	6d 61 6e 64 73 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 56 79 4f 53 2c 20 79 6f 75 20 63 61 6e	mands.to.configure.VyOS,.you.can
6180	20 65 78 65 63 75 74 65 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 6e 20 63 6f 6e 66 69	.execute.commands.and.then.confi
61a0	67 75 72 65 20 56 79 4f 53 20 69 6e 20 74 68 65 20 73 61 6d 65 20 73 63 72 69 70 74 2e 00 49 66	gure.VyOS.in.the.same.script..If
61c0	20 79 6f 75 20 77 61 6e 74 20 74 6f 20 73 63 72 69 70 74 20 74 68 65 20 63 6f 6e 66 69 67 73 20	.you.want.to.script.the.configs.
61e0	69 6e 20 61 20 6c 61 6e 67 75 61 67 65 20 6f 74 68 65 72 20 74 68 61 6e 20 62 61 73 68 20 79 6f	in.a.language.other.than.bash.yo
6200	75 20 63 61 6e 20 68 61 76 65 20 79 6f 75 72 20 73 63 72 69 70 74 20 6f 75 74 70 75 74 20 63 6f	u.can.have.your.script.output.co
6220	6d 6d 61 6e 64 73 20 61 6e 64 20 74 68 65 6e 20 73 6f 75 72 63 65 20 74 68 65 6d 20 69 6e 20 61	mmands.and.then.source.them.in.a
6240	20 62 61 73 68 20 73 63 72 69 70 74 2e 00 49 6e 20 50 72 6f 78 6d 6f 78 20 73 65 72 76 65 72 20	.bash.script..In.Proxmox.server.
6260	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 75 73 65 64	three.files.are.going.to.be.used
6280	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 20 64 65 66	.for.this.setup:.In.VyOS,.by.def
62a0	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 65 73 3a 00	ault,.enables.only.two.modules:.
62c0	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 6f 63 61 74	In.this.lab,.all.files.are.locat
62e0	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 67 6f 69 6e	ed.in.``/tmp/``..So,.before.goin
6300	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 63 74 6f 72	g.on,.lets.move.to.that.director
6320	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 20 31 2e 33	y:.In.this.lab,.we.are.using.1.3
6340	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 61 20 64 69	.0.VyOS.version.and.setting.a.di
6360	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 6f 20 66 69	sk.of.10G..Download.VyOS..iso.fi
6380	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 73 2e 69 73	le.and.save.it.as.``/tmp/vyos.is
63a0	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 74 69 6e 67	o``..Command.used.for.generating
63c0	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 72 61 74 69	.qcow.image:.Initial.Configurati
63e0	6f 6e 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 74 61 20	on.Injecting.configuration.data.
6400	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 6f 72 6d	is.not.limited.to.cloud.platform
6420	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 75 64 20	s..Users.can.employ.the.NoCloud.
6440	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 74 61 20	data.source.to.inject.user-data.
6460	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 6f 6e 20	and.meta-data.on.virtualization.
6480	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 65 72 2d	platforms.such.as.VMware,.Hyper-
64a0	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 79 6f 73	V.and.KVM..Install.``napalm-vyos
64c0	60 60 20 6d 6f 64 75 6c 65 00 49 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 6f 6e 66	``.module.It.is.possible.to.conf
64e0	69 67 75 72 65 20 56 79 4f 53 20 76 69 61 20 6e 65 74 6d 69 6b 6f 5f 20 70 72 6f 78 79 20 6d 6f	igure.VyOS.via.netmiko_.proxy.mo
6500	64 75 6c 65 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 61 20 6d 69 6e 69 6f 6e 20 77 69 74 68 20	dule..It.requires.a.minion.with.
6520	69 6e 73 74 61 6c 6c 65 64 20 70 61 63 6b 65 74 20 20 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d	installed.packet..``python3-netm
6540	69 6b 6f 60 60 20 6d 6f 64 75 6c 65 20 77 68 6f 20 68 61 73 20 61 20 63 6f 6e 6e 65 63 74 69 6f	iko``.module.who.has.a.connectio
6560	6e 20 74 6f 20 56 79 4f 53 20 6e 6f 64 65 73 2e 20 53 61 6c 74 2d 6d 69 6e 69 6f 6e 20 68 61 76	n.to.VyOS.nodes..Salt-minion.hav
6580	65 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 77 69 74 68 20 73 61 6c 74 20 6d 61 73 74 65	e.to.communicate.with.salt.maste
65a0	72 00 4d 61 6a 6f 72 20 63 6c 6f 75 64 20 70 72 6f 76 69 64 65 72 73 20 6f 66 66 65 72 20 61 20	r.Major.cloud.providers.offer.a.
65c0	6d 65 61 6e 73 20 6f 66 20 70 72 6f 76 69 64 69 6e 67 20 75 73 65 72 2d 64 61 74 61 20 61 74 20	means.of.providing.user-data.at.
65e0	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 68 2e 20 49 74 20	the.time.of.instance.launch..It.
6600	63 61 6e 20 62 65 20 70 72 6f 76 69 64 65 64 20 61 73 20 70 6c 61 69 6e 20 74 65 78 74 20 6f 72	can.be.provided.as.plain.text.or
6620	20 61 73 20 62 61 73 65 36 34 2d 65 6e 63 6f 64 65 64 20 74 65 78 74 2c 20 64 65 70 65 6e 64 69	.as.base64-encoded.text,.dependi
6640	6e 67 20 6f 6e 20 63 6c 6f 75 64 20 70 72 6f 76 69 64 65 72 2e 20 41 6c 73 6f 2c 20 69 74 20 63	ng.on.cloud.provider..Also,.it.c
6660	61 6e 20 62 65 20 63 6f 6d 70 72 65 73 73 65 64 20 75 73 69 6e 67 20 67 7a 69 70 2c 20 77 68 69	an.be.compressed.using.gzip,.whi
6680	63 68 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 77 69 74 68 20 61 20 6c 6f 6e 67 20 63 6f 6e 66 69	ch.makes.sense.with.a.long.confi
66a0	67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 73 74 2c 20 62 65 63 61 75 73 65 20	guration.commands.list,.because.
66c0	6f 66 20 74 68 65 20 68 61 72 64 20 6c 69 6d 69 74 20 74 6f 20 7e 31 36 33 38 34 20 62 79 74 65	of.the.hard.limit.to.~16384.byte
66e0	73 20 66 6f 72 20 74 68 65 20 77 68 6f 6c 65 20 75 73 65 72 2d 64 61 74 61 2e 00 4d 65 74 61 64	s.for.the.whole.user-data..Metad
6700	61 74 61 20 2d 20 4d 65 74 61 64 61 74 61 20 69 73 20 73 6f 75 72 63 65 64 20 62 79 20 74 68 65	ata.-.Metadata.is.sourced.by.the
6720	20 63 6c 6f 75 64 20 70 6c 61 74 66 6f 72 6d 20 6f 72 20 68 79 70 65 72 76 69 73 6f 72 2e 20 49	.cloud.platform.or.hypervisor..I
6740	6e 20 73 6f 6d 65 20 63 6c 6f 75 64 73 2c 20 74 68 65 72 65 20 69 73 20 69 6d 70 6c 65 6d 65 6e	n.some.clouds,.there.is.implemen
6760	74 65 64 20 61 73 20 61 6e 20 48 54 54 50 20 65 6e 64 70 6f 69 6e 74 20 61 74 20 60 60 68 74 74	ted.as.an.HTTP.endpoint.at.``htt
6780	70 3a 2f 2f 31 36 39 2e 32 35 34 2e 31 36 39 2e 32 35 34 60 60 2e 00 4d 6f 73 74 20 69 6d 70 6f	p://169.254.169.254``..Most.impo
67a0	72 74 61 6e 74 20 6b 65 79 73 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 6e 73	rtant.keys.that.needs.to.be.cons
67c0	69 64 65 72 65 64 3a 00 4e 61 70 61 6c 6d 00 4e 65 74 6d 69 6b 6f 00 4e 65 74 6d 69 6b 6f 2d 70	idered:.Napalm.Netmiko.Netmiko-p
67e0	72 6f 78 79 00 4e 65 74 77 6f 72 6b 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 2d 20 54 68 69	roxy.Network.configuration.-.Thi
6800	73 20 63 6f 6e 66 69 67 20 73 6f 75 72 63 65 20 69 6e 66 6f 72 6d 73 20 74 68 65 20 73 79 73 74	s.config.source.informs.the.syst
6820	65 6d 20 61 62 6f 75 74 20 74 68 65 20 6e 65 74 77 6f 72 6b 20 73 65 74 74 69 6e 67 73 20 6c 69	em.about.the.network.settings.li
6840	6b 65 20 49 50 20 61 64 64 72 65 73 73 65 73 2c 20 72 6f 75 74 65 73 2c 20 44 4e 53 2e 20 41 76	ke.IP.addresses,.routes,.DNS..Av
6860	61 69 6c 61 62 6c 65 20 6f 6e 6c 79 20 69 6e 20 73 65 76 65 72 61 6c 20 63 6c 6f 75 64 20 61 6e	ailable.only.in.several.cloud.an
6880	64 20 76 69 72 74 75 61 6c 69 7a 61 74 69 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 2e 00 4e 65 74 77	d.virtualization.platforms..Netw
68a0	6f 72 6b 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64 6e 27 74 20	orking.configurations.shouldn't.
68c0	62 65 20 70 61 73 73 65 64 20 69 6e 20 75 73 65 72 2d 64 61 74 61 20 66 69 6c 65 2e 00 4e 6f 43	be.passed.in.user-data.file..NoC
68e0	6c 6f 75 64 00 4e 6f 72 6e 69 72 00 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 2f 6f 70 74 2f 76	loud.Nornir.Note.that.the./opt/v
6900	79 61 74 74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64	yatta/etc/config.is.used.instead
6920	20 6f 66 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72	.of.the./config/scripts.director
6940	79 20 72 65 66 65 72 65 6e 63 65 64 20 69 6e 20 74 68 65 20 3a 72 65 66 3a 60 63 6f 6d 6d 61 6e	y.referenced.in.the.:ref:`comman
6960	64 2d 73 63 72 69 70 74 69 6e 67 60 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 64 6f 63 75	d-scripting`.section.of.the.docu
6980	6d 65 6e 74 61 74 69 6f 6e 20 62 65 63 61 75 73 65 20 74 68 65 20 2f 63 6f 6e 66 69 67 2f 73 63	mentation.because.the./config/sc
69a0	72 69 70 74 20 64 69 72 65 63 74 6f 72 79 20 69 73 6e 27 74 20 6d 6f 75 6e 74 65 64 20 77 68 65	ript.directory.isn't.mounted.whe
69c0	6e 20 74 68 65 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 6d 6f 64 75 6c 65 20 65 78 65	n.the.``write_files``.module.exe
69e0	63 75 74 65 73 2e 00 4e 6f 74 65 73 20 66 6f 72 20 74 68 69 73 20 70 61 72 74 69 63 75 6c 61 72	cutes..Notes.for.this.particular
6a00	20 65 78 61 6d 70 6c 65 2c 20 74 68 61 74 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 6f	.example,.that.may.need.to.be.mo
6a20	64 69 66 69 65 64 20 69 6e 20 6f 74 68 65 72 20 73 65 74 75 70 73 3a 00 4e 6f 77 2c 20 74 68 61	dified.in.other.setups:.Now,.tha
6a40	74 20 66 69 6c 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 63 6f 70 69 65 64 20 74 6f 20 70 72 6f	t.file.needs.to.be.copied.to.pro
6a60	78 6d 6f 78 20 73 65 72 76 65 72 3a 00 4f 6e 20 56 79 4f 53 20 74 68 69 73 20 77 69 6c 6c 20 63	xmox.server:.On.VyOS.this.will.c
6a80	61 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 62 6c 65 6d 3a 20 41 66 74 65	ause.the.following.problem:.Afte
6aa0	72 20 6d 6f 64 69 66 79 69 6e 67 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69	r.modifying.the.configuration.vi
6ac0	61 20 73 63 72 69 70 74 20 6c 69 6b 65 20 74 68 69 73 20 6f 6e 63 65 2c 20 69 74 20 69 73 20 6e	a.script.like.this.once,.it.is.n
6ae0	6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d 61 6e 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74	ot.possible.to.manually.modify.t
6b00	68 65 20 63 6f 6e 66 69 67 20 61 6e 79 6d 6f 72 65 3a 00 4f 6e 20 70 72 6f 78 6d 6f 78 20 73 65	he.config.anymore:.On.proxmox.se
6b20	72 76 65 72 3a 00 4f 6e 63 65 20 74 68 65 20 74 68 72 65 65 20 66 69 6c 65 73 20 77 65 72 65 20	rver:.Once.the.three.files.were.
6b40	63 72 65 61 74 65 64 2c 20 69 74 27 73 20 74 69 6d 65 20 74 6f 20 67 65 6e 65 72 61 74 65 20 74	created,.it's.time.to.generate.t
6b60	68 65 20 60 60 73 65 65 64 2e 69 73 6f 60 60 20 69 6d 61 67 65 2c 20 77 68 69 63 68 20 6e 65 65	he.``seed.iso``.image,.which.nee
6b80	64 73 20 74 6f 20 62 65 20 6d 6f 75 6e 74 65 64 20 74 6f 20 74 68 65 20 6e 65 77 20 56 4d 20 61	ds.to.be.mounted.to.the.new.VM.a
6ba0	73 20 61 20 63 64 2e 00 4f 6e 65 20 63 6f 6d 6d 61 6e 64 20 70 65 72 20 6c 69 6e 65 2e 00 4f 70	s.a.cd..One.command.per.line..Op
6bc0	2d 6d 6f 64 65 00 4f 74 68 65 72 20 73 63 72 69 70 74 20 6c 61 6e 67 75 61 67 65 73 00 4f 75 74	-mode.Other.script.languages.Out
6be0	70 75 74 00 4f 75 74 70 75 74 20 6f 70 2d 6d 6f 64 65 00 50 6c 65 61 73 65 20 74 61 6b 65 20 61	put.Output.op-mode.Please.take.a
6c00	20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 43 6f 6e 74 72 69 62 75 74 69 6e 67 20 47 75 69 64 65 20	.look.at.the.Contributing.Guide.
6c20	66 6f 72 20 6f 75 72 20 3a 72 65 66 3a 60 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 60 2e 00 50 6f	for.our.:ref:`documentation`..Po
6c40	73 74 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74 00 50 6f 77 65 72 20 6f 6e 20 56 4d 20 61 6e 64	stconfig.on.boot.Power.on.VM.and
6c60	20 76 65 72 69 66 69 63 61 74 69 6f 6e 73 00 50 72 65 63 6f 6e 66 69 67 20 6f 6e 20 62 6f 6f 74	.verifications.Preconfig.on.boot
6c80	00 50 72 65 70 61 72 65 20 63 6c 6f 75 64 2d 69 6e 69 74 20 66 69 6c 65 73 00 50 72 6f 78 6d 6f	.Prepare.cloud-init.files.Proxmo
6ca0	78 20 49 50 20 61 64 64 72 65 73 73 3a 20 2a 2a 31 39 32 2e 31 36 38 2e 30 2e 32 35 33 2f 32 34	x.IP.address:.**192.168.0.253/24
6cc0	2a 2a 00 50 72 6f 78 6d 6f 78 20 60 43 6c 6f 75 64 2d 69 6e 69 74 2d 53 75 70 70 6f 72 74 60 5f	**.Proxmox.`Cloud-init-Support`_
6ce0	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 64 68 63 70	..References.Remove.default.dhcp
6d00	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 61 6e 64 20	.client.on.first.interface,.and.
6d20	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 69 6e 67 20	load.other.configuration.during.
6d40	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 2e 00 52 75	first.boot,.using.cloud-init..Ru
6d60	6e 20 61 6e 73 69 62 6c 65 00 52 75 6e 20 63 6f 6d 6d 61 6e 64 73 20 72 65 6d 6f 74 65 6c 79 00	n.ansible.Run.commands.remotely.
6d80	52 75 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 00 52 75 6e 20 6f	Run.configuration.commands.Run.o
6da0	70 65 72 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 00 53 53 48 20 69 73 20 63 6f 6e 66 69	perational.commands.SSH.is.confi
6dc0	67 75 72 65 64 20 6f 6e 20 70 6f 72 74 20 32 32 2e 00 53 61 6c 74 00 53 61 6c 74 20 6d 61 73 74	gured.on.port.22..Salt.Salt.mast
6de0	65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 00 53 61 76 65 20 61 20 72 75 6e 6e 69 6e 67	er.configuration:.Save.a.running
6e00	20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 61 20 66 69 6c 65 2e 00 53 61 76 65 20 61	.configuration.to.a.file..Save.a
6e20	20 72 75 6e 6e 69 6e 67 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 74 6f 20 74 68 65 20 73 74	.running.configuration.to.the.st
6e40	61 72 74 75 70 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 57 68 65 6e 20 79 6f 75 20 64 6f	artup.configuration..When.you.do
6e60	6e 27 74 20 73 70 65 63 69 66 79 20 74 68 65 20 66 69 6c 65 20 77 68 65 6e 20 73 61 76 69 6e 67	n't.specify.the.file.when.saving
6e80	2c 20 69 74 20 73 61 76 65 73 20 74 6f 20 60 60 2f 63 6f 6e 66 69 67 2f 63 6f 6e 66 69 67 2e 62	,.it.saves.to.``/config/config.b
6ea0	6f 6f 74 60 60 2e 00 53 63 72 69 70 74 20 76 79 6f 73 2d 6e 61 70 61 6c 6d 2e 70 79 00 53 63 72	oot``..Script.vyos-napalm.py.Scr
6ec0	69 70 74 73 20 61 72 65 20 72 75 6e 20 69 6e 20 61 6c 70 68 61 62 65 74 69 63 61 6c 20 6f 72 64	ipts.are.run.in.alphabetical.ord
6ee0	65 72 2e 20 54 68 65 69 72 20 6e 61 6d 65 73 20 6d 75 73 74 20 63 6f 6e 73 69 73 74 20 65 6e 74	er..Their.names.must.consist.ent
6f00	69 72 65 6c 79 20 6f 66 20 41 53 43 49 49 20 75 70 70 65 72 2d 20 61 6e 64 20 6c 6f 77 65 72 2d	irely.of.ASCII.upper-.and.lower-
6f20	63 61 73 65 20 6c 65 74 74 65 72 73 2c 41 53 43 49 49 20 64 69 67 69 74 73 2c 20 41 53 43 49 49	case.letters,ASCII.digits,.ASCII
6f40	20 75 6e 64 65 72 73 63 6f 72 65 73 2c 20 61 6e 64 20 41 53 43 49 49 20 6d 69 6e 75 73 2d 68 79	.underscores,.and.ASCII.minus-hy
6f60	70 68 65 6e 73 2e 4e 6f 20 6f 74 68 65 72 20 63 68 61 72 61 63 74 65 72 73 20 61 72 65 20 61 6c	phens.No.other.characters.are.al
6f80	6c 6f 77 65 64 2e 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	lowed..Sometimes.you.simply.wan'
6fa0	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 6f 64 65 20	t.to.execute.a.bunch.of.op-mode.
6fc0	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 20 56 79 4f	commands.via.SSH.on.a.remote.VyO
6fe0	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 75 6d 65 20	S.system..Storaged.used:.volume.
7000	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 69 72 65 63	local,.which.is.mounted.on.direc
7020	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 6e 74 61 69	tory.**/var/lib/vz**,.and.contai
7040	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 75 64 69 6e	ns.all.type.of.content,.includin
7060	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 76 2f 73 61	g.snippets..Structure.of./srv/sa
7080	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 6d 20 44 65	lt:.Structure.of.files.System.De
70a0	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 68 65 73 20	faults/Fallbacks.The.API.pushes.
70c0	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 6e 64 20 63	every.request.to.a.session.and.c
70e0	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 6f 6d 70 6f	ommit.it..But.some.of.VyOS.compo
7100	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 72 76 65 72	nents.like.DHCP.and.PPPoE.Server
7120	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 75 6e 6e 65	s,.IPSec,.VXLAN,.and.other.tunne
7140	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 6e 20 66 6f	ls.require.full.configuration.fo
7160	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 70 72 6f 63	r.commit..The.endpoint.will.proc
7180	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 6f 75 20 70	ess.multiple.commands.when.you.p
71a0	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 64 61 74 61	ass.them.as.a.list.to.the.``data
71c0	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 70 74 73 2f	``.field..The.``/config/scripts/
71e0	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 74 60 60 20	vyos-postconfig-bootup.script``.
7200	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 65 72 20 74	script.is.called.on.boot.after.t
7220	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 6c 79 20 61	he.VyOS.configuration.is.fully.a
7240	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 73 2f 76 79	pplied..The.``/config/scripts/vy
7260	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 20 73 63 72	os-preconfig-bootup.script``.scr
7280	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 20 74 68 65	ipt.is.called.on.boot.before.the
72a0	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 6f 6f 74 20	.VyOS.configuration.during.boot.
72c0	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 69 6e 74 20	process..The.``/show``.endpoint.
72e0	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 20 6f 70 65	is.to.show.everything.in.the.ope
7300	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 65 60 60 20	rational.mode..The.``generate``.
7320	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 63 6f 6d 6d	endpoint.run.a.``generate``.comm
7340	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 72 75 6e 20	and..The.``reset``.endpoint.run.
7360	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 6d 61 6e 64	a.``reset``.command..The.command
7380	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 77 20 63 6f	s.list.produced.by.the.``show.co
73a0	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 6e 64 20 6f	nfiguration.commands``.command.o
73c0	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 79 20 77 69	n.a.VyOS.router.should.comply.wi
73e0	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 69 74 20 69	th.all.the.requirements,.so.it.i
7400	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 6e 64 73 20	s.easy.to.get.a.proper.commands.
7420	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 68 65 72 20	list.by.copying.it.from.another.
7440	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 65 63 69 66	router..The.configuration.specif
7460	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 6d 65 6e 74	ied.in.the.cloud-config.document
7480	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 61 74 69 6f	.overwrites.default.configuratio
74a0	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 65 64 20 76	n.values.and.values.configured.v
74c0	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 65 63 74 6f	ia.Metadata..The.default.directo
74e0	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 74 73 20 73	ries.where.your.custom.Scripts.s
7500	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 66 61 75 6c	hould.be.located.are:.The.defaul
7520	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 65 61 73 69	t.file.looks.like.this:.The.easi
7540	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 74 65 6d 20	est.way.to.configure.the.system.
7560	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 6f 6e 66 69	via.user-data.is.the.Cloud-confi
7580	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 65 20 65 6e	g.syntax.described.below..The.en
75a0	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 6f 20 73 61	dpoint.``/config-file``.is.to.sa
75c0	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 54 68 65 20	ve.or.load.a.configuration..The.
75e0	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 6f 73 74 6e	following.example.sets.the.hostn
7600	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 65 6e 74 69	ame.based.on.the.instance.identi
7620	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 65 74 61 64	fier.obtained.from.the.EC2.metad
7640	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 78 61 6d 70	ata.service..The.following.examp
7660	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 61 6e 64 73	le.shows.how.to.execute.commands
7680	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 74 69 6f 6e	.after.the.initial.configuration
76a0	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 61 20 56 79	..The.key.used.to.designate.a.Vy
76c0	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 6f 6e 66 69	OS.configuration.is.``vyos_confi
76e0	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 73 20 56 79	g_commands``..What.follows.is.Vy
7700	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 73 65 74 2d	OS.configuration.using.the."set-
7720	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 64 20 22 64	style".syntax..Both."set".and."d
7740	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 64 2e 00 54	elete".commands.are.supported..T
7760	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 63 68 65 64	he.seed.iso.file.can.be.attached
7780	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 61 6e 20 65	.to.the.virtual.machine..As.an.e
77a0	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 74 6f 20 61	xample,.the.method.with.KVM.to.a
77c0	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 66 6f 6c 6c	ttach.the.ISO.as.a.CD.drive.foll
77e0	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 20 77 6f 72	ows..There.is.a.pitfall.when.wor
7800	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 70 74 73 2e	king.with.configuration.scripts.
7820	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 69 67 75 72	.It.is.tempting.to.call.configur
7840	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 2e 65 2e 2c	ation.scripts.with."sudo".(i.e.,
7860	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 2c 20 62 65	.temporary.root.permissions),.be
7880	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 6f 6e 20 6d	cause.that's.the.common.way.on.m
78a0	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 73 79 73 74	ost.Linux.platforms.to.call.syst
78c0	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 79 4f 53 20	em.commands..These.are.the.VyOS.
78e0	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 20 73 65 63	defaults.and.fallbacks..This.sec
7900	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 6d 70 6c 65	tion.needs.improvements,.example
7920	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 6c 20 72 65	s.and.explanations..This.will.re
7940	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 6d 65 73 73	sult.in.the.following.error.mess
7960	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 68 61 70 70	age:.``Set.failed``.If.this.happ
7980	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 20 62 65 20	ens,.a.reboot.is.required.to.be.
79a0	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 61 6c 6c 79	able.to.edit.the.config.manually
79c0	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 69 6f 6e 20	.again..To.Load.a.configuration.
79e0	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 61 67 65 2c	file..To.add.or.delete.an.image,
7a00	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 2e 00 54 6f	.use.the.``/image``.endpoint..To
7a20	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 72 6f 70 65	.avoid.these.problems,.the.prope
7a40	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 74 68 20 74	r.way.is.to.call.a.script.with.t
7a60	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 2c 20 62 79	he.``vyattacfg``.group,.e.g.,.by
7a80	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 6f 75 70 29	.using.the.``sg``.(switch.group)
7aa0	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 6f 6e 66 69	.command:.To.get.the.whole.confi
7ac0	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 20 74 6f 20	guration,.pass.an.empty.list.to.
7ae0	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 65 20 56 79	the.``path``.field.To.include.Vy
7b00	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 69 61 73 65	OS.specific.functions.and.aliase
7b20	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 76 79 61 74	s.you.need.to.``source./opt/vyat
7b40	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 6c 61 74 65	ta/etc/functions/script-template
7b60	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 73 63 72 69	``.files.at.the.top.of.your.scri
7b80	70 74 2e 00 54 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 61 20 73 63 72 69 70 74 20 69	pt..To.make.sure.that.a.script.i
7ba0	73 20 6e 6f 74 20 61 63 63 69 64 65 6e 74 61 6c 6c 79 20 63 61 6c 6c 65 64 20 77 69 74 68 6f 75	s.not.accidentally.called.withou
7bc0	74 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 74 68 65 20 73	t.the.``vyattacfg``.group,.the.s
7be0	63 72 69 70 74 20 63 61 6e 20 62 65 20 73 61 66 65 67 75 61 72 64 65 64 20 6c 69 6b 65 20 74 68	cript.can.be.safeguarded.like.th
7c00	69 73 3a 00 54 6f 20 6f 6e 6c 79 20 67 65 74 20 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f	is:.To.only.get.a.part.of.the.co
7c20	6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 60 60 73 79 73 74 65	nfiguration,.for.example.``syste
7c40	6d 20 73 79 73 6c 6f 67 60 60 2e 00 54 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 00 55 6e 6c 69	m.syslog``..Troubleshooting.Unli
7c60	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 73 65 73 73 69 6f	ke.a.normal.configuration.sessio
7c80	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 73 20 6d 75 73 74	n,.all.operational.commands.must
7ca0	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 2c 20 65 76 65 6e	.be.prepended.with.``run``,.even
7cc0	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 73 65 73 73 69 6f	.if.you.haven't.created.a.sessio
7ce0	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 61 00 55 73 65 72	n.with.configure..User-data.User
7d00	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 66 69 65 64 20 62	-data.-.User-data.is.specified.b
7d20	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 75 72 63 65 20 6f	y.the.user..This.config.source.o
7d40	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 74 20 61 6e 79 20	ffers.the.ability.to.insert.any.
7d60	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 74 6f 20	CLI.configuration.commands.into.
7d80	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 68 65 20 66 69 72	the.configuration.before.the.fir
7da0	73 74 20 62 6f 6f 74 2e 00 56 4d 20 49 44 3a 20 69 6e 20 74 68 69 73 20 65 78 61 6d 70 6c 65 2c	st.boot..VM.ID:.in.this.example,
7dc0	20 56 4d 20 49 44 20 75 73 65 64 20 69 73 20 35 35 35 2e 00 56 4d 20 52 65 73 6f 75 72 63 65 73	.VM.ID.used.is.555..VM.Resources
7de0	3a 20 74 68 65 73 65 20 70 61 72 61 6d 65 74 65 72 73 20 63 61 6e 20 62 65 20 6d 6f 64 69 66 69	:.these.parameters.can.be.modifi
7e00	65 64 20 61 73 20 6e 65 65 64 65 64 2e 00 56 4d 20 53 74 6f 72 61 67 65 3a 20 60 60 6c 6f 63 61	ed.as.needed..VM.Storage:.``loca
7e20	6c 60 60 20 76 6f 6c 75 6d 65 20 69 73 20 75 73 65 64 2e 00 56 79 4f 53 20 41 50 49 00 56 79 4f	l``.volume.is.used..VyOS.API.VyO
7e40	53 20 41 75 74 6f 6d 61 74 69 6f 6e 00 56 79 4f 53 20 60 63 6c 6f 75 64 2d 69 6e 69 74 2d 64 6f	S.Automation.VyOS.`cloud-init-do
7e60	63 73 60 5f 2e 00 56 79 4f 53 20 63 6c 6f 75 64 2d 69 6e 69 74 00 56 79 4f 53 20 63 6f 6e 66 69	cs`_..VyOS.cloud-init.VyOS.confi
7e80	67 75 72 61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e	guration.commands.are.defined.in
7ea0	20 75 73 65 72 2d 64 61 74 61 20 66 69 6c 65 2e 00 56 79 4f 53 20 68 61 73 20 74 68 65 20 61 62	.user-data.file..VyOS.has.the.ab
7ec0	69 6c 69 74 79 20 74 6f 20 72 75 6e 20 63 75 73 74 6f 6d 20 20 73 63 72 69 70 74 73 20 62 65 66	ility.to.run.custom..scripts.bef
7ee0	6f 72 65 20 61 6e 64 20 61 66 74 65 72 20 65 61 63 68 20 63 6f 6d 6d 69 74 00 56 79 4f 53 20 73	ore.and.after.each.commit.VyOS.s
7f00	75 70 70 6f 72 74 20 74 68 72 65 65 20 74 79 70 65 73 20 6f 66 20 63 6f 6e 66 69 67 20 73 6f 75	upport.three.types.of.config.sou
7f20	72 63 65 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f	rces..VyOS.supports.configuratio
7f40	6e 20 76 69 61 20 61 6e 73 69 62 6c 65 2e 20 4e 65 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 60	n.via.ansible..Need.to.install.`
7f60	60 61 6e 73 69 62 6c 65 60 60 20 61 6e 64 20 60 60 70 79 74 68 6f 6e 33 2d 70 61 72 61 6d 69 6b	`ansible``.and.``python3-paramik
7f80	6f 60 60 20 6d 6f 64 75 6c 65 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 63 6f 6e 66 69 67 75	o``.module.VyOS.supports.configu
7fa0	72 61 74 69 6f 6e 20 76 69 61 20 6e 65 74 6d 69 6b 6f 5f 2e 20 49 74 20 72 65 71 75 69 72 65 73	ration.via.netmiko_..It.requires
7fc0	20 74 6f 20 69 6e 73 74 61 6c 6c 20 60 60 70 79 74 68 6f 6e 33 2d 6e 65 74 6d 69 6b 6f 60 60 20	.to.install.``python3-netmiko``.
7fe0	6d 6f 64 75 6c 65 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 65 78 65 63 75 74 69 6e 67 20	module..VyOS.supports.executing.
8000	63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 65 72 61 74 69 6f 6e 61 6c 20 63 6f	configuration.and.operational.co
8020	6d 6d 61 6e 64 73 20 6e 6f 6e 2d 69 6e 74 65 72 61 63 74 69 76 65 6c 79 20 66 72 6f 6d 20 73 68	mmands.non-interactively.from.sh
8040	65 6c 6c 20 73 63 72 69 70 74 73 2e 00 56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d 6f	ell.scripts..VyOS.supports.op-mo
8060	64 65 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 69 61 20 73 61 6c 74 5f 2e 00	de.and.configuration.via.salt_..
8080	56 79 4f 53 20 73 75 70 70 6f 72 74 73 20 73 6f 6d 65 20 6e 61 70 61 6c 6d 5f 20 66 75 6e 63 74	VyOS.supports.some.napalm_.funct
80a0	69 6f 6e 73 20 66 6f 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 6e 64 20 6f 70 2d 6d 6f	ions.for.configuration.and.op-mo
80c0	64 65 2e 20 49 74 20 72 65 71 75 69 72 65 73 20 6d 6f 72 65 20 74 65 73 74 73 2e 00 56 79 4f 53	de..It.requires.more.tests..VyOS
80e0	20 73 75 70 70 6f 72 74 73 20 74 68 65 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 6f 70 65 72 61	.supports.the.execution.of.opera
8100	74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 6c 69 6e 75 78 20 63 6f 6d 6d 61 6e	tional.commands.and.linux.comman
8120	64 73 20 61 74 20 69 6e 69 74 69 61 6c 20 62 6f 6f 74 2e 20 54 68 69 73 20 69 73 20 61 63 63 6f	ds.at.initial.boot..This.is.acco
8140	6d 70 6c 69 73 68 65 64 20 75 73 69 6e 67 20 60 60 77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 74	mplished.using.``write_files``.t
8160	6f 20 63 65 72 74 61 69 6e 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 2f 6f 70 74 2f 76 79 61 74	o.certain.files.in.the./opt/vyat
8180	74 61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 20 64 69 72 65 63 74 6f 72 79 2e	ta/etc/config/scripts.directory.
81a0	20 43 6f 6d 6d 61 6e 64 73 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 6f 70 74 2f 76 79 61 74 74	.Commands.specified.in.opt/vyatt
81c0	61 2f 65 74 63 2f 63 6f 6e 66 69 67 2f 73 63 72 69 70 74 73 2f 76 79 6f 73 2d 70 72 65 63 6f 6e	a/etc/config/scripts/vyos-precon
81e0	66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 20 61 72 65 20 65 78 65 63 75 74 65 64 20 70	fig-bootup.script.are.executed.p
8200	72 69 6f 72 20 74 6f 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 54 68 65 20 2f 6f 70 74 2f	rior.to.configuration..The./opt/
8220	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 2f 76 79 6f 73 2d 70	vyatta/etc/config/scripts/vyos-p
8240	6f 73 74 63 6f 6e 66 69 67 2d 62 6f 6f 74 75 70 2e 73 63 72 69 70 74 20 66 69 6c 65 20 63 6f 6e	ostconfig-bootup.script.file.con
8260	74 61 69 6e 73 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 61 66	tains.commands.to.be.executed.af
8280	74 65 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73	ter.configuration..In.both.cases
82a0	2c 20 63 6f 6d 6d 61 6e 64 73 20 61 72 65 20 65 78 65 63 75 74 65 64 20 61 73 20 74 68 65 20 72	,.commands.are.executed.as.the.r
82c0	6f 6f 74 20 75 73 65 72 2e 00 57 65 20 6e 65 65 64 20 32 20 66 69 6c 65 73 2c 20 63 6f 6d 6d 61	oot.user..We.need.2.files,.comma
82e0	6e 64 73 2e 63 6f 6e 66 20 61 6e 64 20 73 63 72 69 70 74 20 69 74 73 65 6c 66 2e 00 57 68 69 6c	nds.conf.and.script.itself..Whil
8300	65 20 6f 74 68 65 72 20 6d 65 74 68 6f 64 73 20 65 78 69 73 74 2c 20 74 68 65 20 6d 6f 73 74 20	e.other.methods.exist,.the.most.
8320	73 74 72 61 69 67 68 74 66 6f 72 77 61 72 64 20 6d 65 74 68 6f 64 20 66 6f 72 20 75 73 69 6e 67	straightforward.method.for.using
8340	20 74 68 65 20 4e 6f 43 6c 6f 75 64 20 64 61 74 61 20 73 6f 75 72 63 65 20 69 73 20 63 72 65 61	.the.NoCloud.data.source.is.crea
8360	74 69 6e 67 20 61 20 73 65 65 64 20 49 53 4f 20 61 6e 64 20 61 74 74 61 63 68 69 6e 67 20 69 74	ting.a.seed.ISO.and.attaching.it
8380	20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 61 73 20 61 20 43 44 20	.to.the.virtual.machine.as.a.CD.
83a0	64 72 69 76 65 2e 20 54 68 65 20 76 6f 6c 75 6d 65 20 6d 75 73 74 20 62 65 20 66 6f 72 6d 61 74	drive..The.volume.must.be.format
83c0	74 65 64 20 61 73 20 61 20 76 66 61 74 20 6f 72 20 49 53 4f 20 39 36 36 30 20 66 69 6c 65 20 73	ted.as.a.vfat.or.ISO.9660.file.s
83e0	79 73 74 65 6d 20 77 69 74 68 20 74 68 65 20 6c 61 62 65 6c 20 22 63 69 64 61 74 61 22 20 6f 72	ystem.with.the.label."cidata".or
8400	20 22 43 49 44 41 54 41 22 2e 00 57 69 6c 6c 20 72 65 74 75 72 6e 3a 00 57 69 74 68 20 74 68 65	."CIDATA"..Will.return:.With.the
8420	20 60 60 72 65 74 72 69 65 76 65 60 60 20 65 6e 64 70 6f 69 6e 74 20 79 6f 75 20 67 65 74 20 70	.``retrieve``.endpoint.you.get.p
8440	61 72 74 73 20 6f 72 20 74 68 65 20 77 68 6f 6c 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e	arts.or.the.whole.configuration.
8460	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 20	.Without.proxy.it.requires.VyOS.
8480	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 74	minion.configuration.and.support
84a0	20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 57 69 74 68 6f 75 74 20 70 72 6f 78 79 20 69 74 20	.op-mode.data:.Without.proxy.it.
84c0	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 75 72 61 74 69	requires.VyOS.minion.configurati
84e0	6f 6e 20 61 6e 64 20 73 75 70 70 6f 72 74 73 20 6f 70 2d 6d 6f 64 65 20 64 61 74 61 3a 00 59 6f	on.and.supports.op-mode.data:.Yo
8500	75 20 63 61 6e 20 70 61 73 73 20 61 20 60 60 73 65 74 60 60 2c 20 60 60 64 65 6c 65 74 65 60 60	u.can.pass.a.``set``,.``delete``
8520	20 6f 72 20 60 60 63 6f 6d 6d 65 6e 74 60 60 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 74 68 65 20 60	.or.``comment``.command.to.the.`
8540	60 2f 63 6f 6e 66 69 67 75 72 65 60 60 20 65 6e 64 70 6f 69 6e 74 2e 00 60 60 64 65 6c 65 74 65	`/configure``.endpoint..``delete
8560	60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61 6e 64 00 60 60 73 65 65 64 2e 69 73 6f 60 60	``.a.single.command.``seed.iso``
8580	20 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 63 72 65 61 74 65 64 20 69 6e 20 64 69 72 65 63	.was.previously.created.in.direc
85a0	74 6f 72 79 20 60 60 2f 74 6d 70 2f 60 60 2e 20 49 74 27 73 20 6e 65 63 65 73 73 61 72 79 20 74	tory.``/tmp/``..It's.necessary.t
85c0	6f 20 6d 6f 76 65 20 69 74 20 74 6f 20 60 60 2f 76 61 72 2f 6c 69 62 2f 76 7a 2f 74 65 6d 70 6c	o.move.it.to.``/var/lib/vz/templ
85e0	61 74 65 2f 69 73 6f 60 60 00 60 60 73 65 74 60 60 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 6d 61	ate/iso``.``set``.a.single.comma
8600	6e 64 00 60 60 76 79 6f 73 5f 75 73 65 72 64 61 74 61 60 60 20 2d 20 74 68 65 20 6d 6f 64 75 6c	nd.``vyos_userdata``.-.the.modul
8620	65 20 61 63 63 65 70 74 73 20 61 20 6c 69 73 74 20 6f 66 20 43 4c 49 20 63 6f 6e 66 69 67 75 72	e.accepts.a.list.of.CLI.configur
8640	61 74 69 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 20 61 20 60 60 76 79 6f 73 5f 63 6f 6e 66 69	ation.commands.in.a.``vyos_confi
8660	67 5f 63 6f 6d 6d 61 6e 64 73 60 60 20 73 65 63 74 69 6f 6e 2c 20 77 68 69 63 68 20 67 69 76 65	g_commands``.section,.which.give
8680	73 20 61 6e 20 65 61 73 79 20 77 61 79 20 74 6f 20 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 73	s.an.easy.way.to.configure.the.s
86a0	79 73 74 65 6d 20 64 75 72 69 6e 67 20 64 65 70 6c 6f 79 6d 65 6e 74 2e 00 60 60 76 79 6f 73 60	ystem.during.deployment..``vyos`
86c0	60 2f 60 60 76 79 6f 73 60 60 20 63 72 65 64 65 6e 74 69 61 6c 73 20 69 66 20 6e 6f 20 6f 74 68	`/``vyos``.credentials.if.no.oth
86e0	65 72 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 64 61 74 61 20 73 6f 75 72 63 65 2e 00 60 60	ers.specified.by.data.source..``
8700	77 72 69 74 65 5f 66 69 6c 65 73 60 60 20 2d 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 6c 6c 6f	write_files``.-.this.module.allo
8720	77 73 20 74 6f 20 69 6e 73 65 72 74 20 61 6e 79 20 66 69 6c 65 73 20 69 6e 74 6f 20 74 68 65 20	ws.to.insert.any.files.into.the.
8740	66 69 6c 65 73 79 73 74 65 6d 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 62 6f 6f 74	filesystem.before.the.first.boot
8760	2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 70 72 65 2d 67 65 6e 65 72 61 74 65 64 20 65 6e 63	,.for.example,.pre-generated.enc
8780	72 79 70 74 69 6f 6e 20 6b 65 79 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 73 2c 20 6f 72 20 65	ryption.keys,.certificates,.or.e
87a0	76 65 6e 20 61 20 77 68 6f 6c 65 20 60 60 63 6f 6e 66 69 67 2e 62 6f 6f 74 60 60 20 66 69 6c 65	ven.a.whole.``config.boot``.file
87c0	2e 20 54 68 65 20 66 6f 72 6d 61 74 20 69 73 20 64 65 73 63 72 69 62 65 64 20 69 6e 20 74 68 65	..The.format.is.described.in.the
87e0	20 63 6c 6f 75 64 69 6e 69 74 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 60 43 6c 6f 75 64 2d	.cloudinit.documentation.`Cloud-
8800	69 6e 69 74 2d 77 72 69 74 65 5f 66 69 6c 65 73 60 5f 2e 00 61 64 64 20 61 6e 20 69 6d 61 67 65	init-write_files`_..add.an.image
8820	00 61 6e 73 69 62 6c 65 2e 63 66 67 00 63 6c 6f 75 64 2d 63 6f 6e 66 69 67 20 66 69 6c 65 20 66	.ansible.cfg.cloud-config.file.f
8840	6f 72 6d 61 74 00 63 6c 6f 75 64 2d 69 6e 69 74 20 6c 6f 67 73 20 74 6f 20 2f 76 61 72 2f 6c 6f	ormat.cloud-init.logs.to./var/lo
8860	67 2f 63 6c 6f 75 64 2d 69 6e 69 74 2e 6c 6f 67 2e 20 54 68 69 73 20 66 69 6c 65 20 63 61 6e 20	g/cloud-init.log..This.file.can.
8880	62 65 20 68 65 6c 70 66 75 6c 20 69 6e 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 79 20 74 68	be.helpful.in.determining.why.th
88a0	65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 76 61 72 69 65 73 20 66 72 6f 6d 20 77 68 61 74	e.configuration.varies.from.what
88c0	20 79 6f 75 20 65 78 70 65 63 74 2e 20 59 6f 75 20 63 61 6e 20 66 65 74 63 68 20 74 68 65 20 6d	.you.expect..You.can.fetch.the.m
88e0	6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 64 61 74 61 20 66 69 6c 74 65 72 69 6e 67 20 6f 75 74	ost.important.data.filtering.out
8900	70 75 74 20 66 6f 72 20 60 60 76 79 6f 73 60 60 20 6b 65 79 77 6f 72 64 3a 00 63 6f 6d 6d 61 6e	put.for.``vyos``.keyword:.comman
8920	64 73 2e 74 78 74 00 64 65 6c 65 74 65 20 61 6e 20 69 6d 61 67 65 2c 20 66 6f 72 20 65 78 61 6d	ds.txt.delete.an.image,.for.exam
8940	70 6c 65 20 60 60 31 2e 33 2d 72 6f 6c 6c 69 6e 67 2d 32 30 32 30 30 36 30 37 30 31 31 37 60 60	ple.``1.3-rolling-202006070117``
8960	00 68 6f 73 74 73 00 69 64 5f 72 73 61 5f 64 6f 63 6b 65 72 2e 70 75 62 2e 20 4e 65 65 64 73 20	.hosts.id_rsa_docker.pub..Needs.
8980	74 6f 20 64 65 63 6c 61 72 65 20 6f 6e 6c 79 20 70 75 62 6c 69 63 20 6b 65 79 20 65 78 61 63 74	to.declare.only.public.key.exact
89a0	6c 79 2e 00 69 66 20 79 6f 75 20 6a 75 73 74 20 77 61 6e 74 20 74 68 65 20 56 61 6c 75 65 20 6f	ly..if.you.just.want.the.Value.o
89c0	66 20 61 20 6d 75 6c 74 69 2d 76 61 6c 75 65 64 20 6e 6f 64 65 2c 20 75 73 65 20 74 68 65 20 60	f.a.multi-valued.node,.use.the.`
89e0	60 72 65 74 75 72 6e 56 61 6c 75 65 73 60 60 20 6f 70 65 72 61 74 69 6f 6e 2e 00 6d 61 69 6e 2e	`returnValues``.operation..main.
8a00	79 6d 6c 00 72 31 31 2d 70 72 6f 78 79 2e 73 6c 73 20 49 6e 63 6c 75 64 65 73 20 70 61 72 61 6d	yml.r11-proxy.sls.Includes.param
8a20	65 74 65 72 73 20 66 6f 72 20 63 6f 6e 6e 65 63 74 69 6e 67 20 74 6f 20 73 61 6c 74 2d 70 72 6f	eters.for.connecting.to.salt-pro
8a40	78 79 20 6d 69 6e 69 6f 6e 00 73 74 61 72 74 75 70 20 73 63 72 69 70 74 73 00 74 6f 70 2e 73 6c	xy.minion.startup.scripts.top.sl
8a60	73 00	s.