{"id":480,"date":"2016-07-09T21:16:29","date_gmt":"2016-07-09T21:16:29","guid":{"rendered":"http:\/\/www.scmgalaxy.com\/tutorials\/2016\/07\/09\/setup-a-puppet-learning-vm\/"},"modified":"2021-11-19T06:25:52","modified_gmt":"2021-11-19T06:25:52","slug":"setup-a-puppet-learning-vm","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/setup-a-puppet-learning-vm\/","title":{"rendered":"How to Setup Puppet Learning VM &#8211; Complete Process\/Guide"},"content":{"rendered":"<div><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2889 size-full\" src=\"http:\/\/www.scmgalaxy.com\/tutorials\/wp-content\/uploads\/2016\/07\/setup-a-puppet-learning-vm-1.png\" alt=\"setup-a-puppet-learning-vm\" width=\"600\" height=\"400\" srcset=\"https:\/\/www.devopsschool.com\/blog\/wp-content\/uploads\/2016\/07\/setup-a-puppet-learning-vm-1.png 600w, https:\/\/www.devopsschool.com\/blog\/wp-content\/uploads\/2016\/07\/setup-a-puppet-learning-vm-1-300x200.png 300w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><\/div>\n<div><strong>Download the VM(Zip File here)<\/strong><\/div>\n<div><a href=\"https:\/\/pe-education-vms.s3.amazonaws.com\/learning\/learning_puppet_vm.zip\" target=\"_blank\" rel=\"noopener\">https:\/\/pe-education-vms.s3.amazonaws.com\/learning\/learning_puppet_vm.zip<\/a><\/div>\n<div>\n<p>\u00a0<\/p>\n<div class=\"sys-requirements-section\" style=\"box-sizing: border-box; font-size: 1.3rem; margin-top: 40px; color: #222222; font-family: 'Calibre Web Regular', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">\n<h3 style=\"box-sizing: border-box; margin: 0px; font-weight: normal; font-family: 'Calibre Web Semibold'; font-size: 1.6rem; letter-spacing: 1px; -webkit-font-smoothing: antialiased !important;\">Minimum requirements<\/h3>\n<ul style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">Internet-enabled Windows, OS X, or Linux computer with 10GB free space and a VT-x\/AMD-V enabled processor.<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">Up to date virtualization software. See the setup instructions below for details.<\/li>\n<\/ul>\n<\/div>\n<div class=\"resources-section\" style=\"box-sizing: border-box; font-size: 1.3rem; margin-top: 40px; color: #222222; font-family: 'Calibre Web Regular', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">\n<h3 style=\"box-sizing: border-box; margin: 0px; font-weight: normal; font-family: 'Calibre Web Semibold'; font-size: 1.6rem; letter-spacing: 1px; -webkit-font-smoothing: antialiased !important;\">Setting up the Learning VM<\/h3>\n<ol style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\">Before beginning, you may want to use the MD5 sum provided at the VM download page to verify your download. On Mac OS X and *nix systems, you can use the command\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">md5 learning_puppet_vm.zip<\/code>\u00a0and compare the output to the text contents of the<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">learning_puppet_vm.zip.md5<\/code>\u00a0file provided on the download page. On Windows systems, you will need to download and use a tool such as the\u00a0<a style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; color: #ffad1a; text-decoration: none; transition: color 0.2s linear; background-color: transparent;\" href=\"https:\/\/www.microsoft.com\/en-us\/download\/details.aspx?id=11533\" target=\"_blank\" rel=\"noopener\">Microsoft File Checksum Integrity Verifier<\/a>.<\/p>\n<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\">Get an up-to-date version of your virtualization software. We suggest using either VirtualBox or a VMware application appropriate for your platform.\u00a0<a style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; color: #ffad1a; text-decoration: none; transition: color 0.2s linear; background-color: transparent;\" href=\"https:\/\/www.virtualbox.org\/wiki\/Downloads\" target=\"_blank\" rel=\"noopener\">VirtualBox<\/a>\u00a0is free and available for Linux, OS X, and Windows. VMware has several desktop virtualization applications, including\u00a0<a style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; color: #ffad1a; text-decoration: none; transition: color 0.2s linear; background-color: transparent;\" href=\"https:\/\/www.vmware.com\/products\/fusion\/\" target=\"_blank\" rel=\"noopener\">VMWare Fusion<\/a>\u00a0for Mac and\u00a0<a style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; color: #ffad1a; text-decoration: none; transition: color 0.2s linear; background-color: transparent;\" href=\"https:\/\/www.vmware.com\/products\/workstation\/\" target=\"_blank\" rel=\"noopener\">VMware Workstation<\/a>\u00a0for Windows.<\/p>\n<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\">The Learning VM&#8217;s Open Virtualization Archive format must be\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">imported<\/span>\u00a0rather than opened directly. Launch your virtualization software and find an option for\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Import<\/span>\u00a0or\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Import Appliance<\/span>. (This will usually be in a\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">File<\/span>\u00a0menu. If you cannot locate an\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Import<\/span>\u00a0option, please refer to your virtualization software&#8217;s documentation.)<\/p>\n<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\"><span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Before<\/span>\u00a0starting the VM for the first time, you will need to adjust its settings. We recommend allocating 4GB of memory for the best performance. If you don&#8217;t have enough memory on your host machine, you may leave the allocation at 3GB or lower it to 2GB, though you may encounter stability and performance issues. Set the\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Network Adapter<\/span>\u00a0to\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Bridged<\/span>. Use an\u00a0<span style=\"box-sizing: border-box; font-family: 'Calibre Web Light Italic', Helvetica, Tahoma, Arial, sans-serif; -webkit-font-smoothing: antialiased !important;\">Autodetect<\/span>\u00a0setting if available, or accept the default Network Adapter name. (If you started the VM before making these changes, you may need to restart the VM before the settings will be applied correctly.) If you are unable to use a bridged network, we suggest using the port-forwarding instructions provided in the troubleshooting guide.<\/p>\n<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\">Start the VM. When it is started, make a note of the IP address and password displayed on the splash page. Rather than logging in directly, we highly recommend using SSH. On OS X, you can use the default Terminal application or a third-party application like iTerm. For Windows, we suggest the free SSH client\u00a0<a style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; color: #ffad1a; text-decoration: none; transition: color 0.2s linear; background-color: transparent;\" href=\"http:\/\/www.putty.org\/\" target=\"_blank\" rel=\"noopener\">PuTTY<\/a>. Connect to the Learning VM with the login\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">root<\/code>\u00a0and password you noted from the splash page. (e.g.\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">ssh root@&lt;IPADDRESS&gt;<\/code>) Be aware that it might take several minutes for the services in the PE stack to fully start after the VM boots. Once you&#8217;re connected to the VM, we suggest updating the clock with\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">ntpdate pool.ntp.org<\/code>.<\/p>\n<\/li>\n<li style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important;\">\n<p style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; margin: 20px 0px;\">You can access this Quest Guide via a webserver running on the Learning VM itself. Open a web broswer on your host and enter the Learning VM&#8217;s IP address in the address bar. (Be sure to use\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">http:\/\/&lt;ADDRESS&gt;<\/code>\u00a0for the Quest Guide, as\u00a0<code style=\"box-sizing: border-box; -webkit-font-smoothing: antialiased !important; font-family: Inconsolata, 'Andale Mono', 'Lucida Console', Monaco, 'Courier New', Courier, monospace; font-size: 1em;\">https:\/\/&lt;ADDRESS&gt;<\/code>\u00a0will take you to the PE console.<\/p>\n<\/li>\n<\/ol>\n<p>\u00a0<\/p>\n<h1 style=\"box-sizing: border-box; font-size: 2.25em; margin: 1em 0px 16px; line-height: 1.2; padding-bottom: 0.3em; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: #eeeeee; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\">Troubleshooting<\/h1>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">For the most up-to-date version of this troubleshooting information,\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#troubleshooting\" target=\"_blank\" rel=\"noopener\">check the GitHub repository<\/a>. If nothing here resolves your issue, feel free to email us at\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"mailto:learningvm@puppetlabs.com\">learningvm@puppetlabs.com<\/a>\u00a0and we&#8217;ll do our best to address your issue.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">For issues with Puppet Enterprise that are not specific to the Learning VM, see the Puppet Enterprise\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"https:\/\/docs.puppetlabs.com\/pe\/latest\/release_notes_known_issues.html\" target=\"_blank\" rel=\"noopener\">Known Issues<\/a>\u00a0page.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-the-cowsay-package-wont-install\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#the-cowsay-package-wont-install\" target=\"_blank\" rel=\"noopener\"><\/a>The cowsay package won&#8217;t install<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">The Learning VM version 2.29 has an error in the instructions for this quest. The cowsay package declaration should include<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">provider =&gt; 'gem'<\/code>, rather than\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">ensure =&gt; 'gem'<\/code>.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">If you continue to get puppet run failures related to the gem, you can install the cached version manually:\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">gem install \/var\/cache\/rubygems\/gems\/cowsay-0.2.0.gem<\/code><\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-i-completed-a-task-but-the-quest-tool-doesnt-show-it-as-complete\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#i-completed-a-task-but-the-quest-tool-doesnt-show-it-as-complete\" target=\"_blank\" rel=\"noopener\"><\/a>I completed a task, but the quest tool doesn&#8217;t show it as complete<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">The quest tool uses a series of\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"http:\/\/serverspec.org\/\" target=\"_blank\" rel=\"noopener\">Serverspec<\/a>\u00a0tests for each quest to track task progress. Certain tasks simply check your bash history for an entered command. In some cases, the\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">\/root\/.bash_history<\/code>\u00a0won&#8217;t be properly initialized, causing these tests to fail. Exiting the VM and logging in again will fix this issue.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">It is also possible that we have written the test for a task in a way that is too restrictive and doesn&#8217;t correctly capture a valid syntactical variation in your Puppet code or another relevant file. You can check the specific matchers by looking at a quest&#8217;s spec file in the\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">~\/.testing\/spec\/localhost\/<\/code>\u00a0directory. If you find an issue here, please let us know by sending an email to<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"mailto:learningvm@puppetlabs.com\">learningvm@puppetlabs.com<\/a>.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-password-required-for-the-quest-guide\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#password-required-for-the-quest-guide\" target=\"_blank\" rel=\"noopener\"><\/a>Password Required for the Quest Guide<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">The Learning VM&#8217;s Quest Guide is accessible at\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">http:\/\/&lt;VM's IP Address&gt;<\/code>. Note that this is\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">http<\/code>\u00a0and not\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">https<\/code>\u00a0which is reserved for the PE console. The PE console will prompt you for a password, while no password is required for the Quest Guide. (The Quest Guide includes a password for the PE console in the Power of Puppet quest:\u00a0<span style=\"box-sizing: border-box; font-weight: bolder;\">admin\/puppetlabs<\/span>)<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-i-cant-find-the-vm-password\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#i-cant-find-the-vm-password\" target=\"_blank\" rel=\"noopener\"><\/a>I can&#8217;t find the VM password<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">The password to log in to the VM is generated randomly and will be displayed on the splash page displayed on the terminal of your virtualization software when you start the VM.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">If you are already logged in via your virtualization software&#8217;s terminal, you can use the following command to view the password:\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">cat \/var\/local\/password<\/code>.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-does-the-learning-vm-work-on-vsphere-esxi-etc\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#does-the-learning-vm-work-on-vsphere-esxi-etc\" target=\"_blank\" rel=\"noopener\"><\/a>Does the Learning VM work on vSphere, ESXi, etc.?<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Possibly, but we don&#8217;t currently have the resources to test or support the Learning VM on these platforms.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-my-puppet-run-fails-andor-i-cannot-connect-to-the-pe-console\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#my-puppet-run-fails-andor-i-cannot-connect-to-the-pe-console\" target=\"_blank\" rel=\"noopener\"><\/a>My puppet run fails and\/or I cannot connect to the PE console<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">It may take some time after the VM is started before all the Puppet services are fully started. If you recently started or restarted the VM, please wait a few minutes and try to access the console or trigger your puppet run again.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Also, because the Learning VM&#8217;s puppet services are configured to run in an environment with restricted resources, they are more prone to crashes than a default installation with dedicated resources.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">You can check the status of puppet services with the following command:<\/p>\n<pre style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; margin-top: 0px; margin-bottom: 16px; font-stretch: normal; line-height: 1.45; word-wrap: normal; padding: 16px; overflow: auto; border-radius: 3px; color: #333333; background-color: #f7f7f7;\"><code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0px; margin: 0px; border-radius: 3px; word-break: normal; border: 0px; display: inline; overflow: visible; line-height: inherit; word-wrap: normal; background: transparent;\">systemctl --all | grep pe- <\/code><\/pre>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">If you notice any stopped puppet-related services (e.g. pe-puppetdb), double check that you have sufficient memory allocated to the VM and available on your host before you try starting them (e.g.\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">service pe-puppetdb start<\/code>).<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">If you get an error along the lines of\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">Error 400 on SERVER: Unknown function union...<\/code>\u00a0it is likely because the\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">puppetlabs-stdlib<\/code>\u00a0module has not been installed. This module is a dependency for many modules, and provides a set of common functions. If you are running the Learning VM offline, you cannot rely on the Puppet Forge&#8217;s dependency resolution. We have this module and all other modules required for the Learning VM cached, with instructions to install them in the Power of Puppet quest. If that installation fails, you may try adding the\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">--force<\/code>\u00a0flag after the\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">--ignore-dependencies<\/code>\u00a0flag.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-i-cant-import-the-ova\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#i-cant-import-the-ova\" target=\"_blank\" rel=\"noopener\"><\/a>I can&#8217;t import the OVA<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">First, ensure that you have an up-to-date version of your virtualization software installed. Note that the &#8220;check for updates&#8221; feature of VirtualBox may not always work as expected, so check the website for the most recent version.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-the-learning-vm-has-no-ip-address-or-the-ip-address-will-not-respond\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#the-learning-vm-has-no-ip-address-or-the-ip-address-will-not-respond\" target=\"_blank\" rel=\"noopener\"><\/a>The Learning VM has no IP address or the IP address will not respond.<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">If your network connection has changed since you loaded the VM, it&#8217;s possible that your IP address is different from that displayed on the Learning VM splash screen. Log in to the VM via the virtualization directly (rather than SSH) and use the<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">facter ipaddress<\/code>\u00a0command the check the current address.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Some network configurations may still prevent you from accessing the Learning VM. If this is the case, you can still access the Learning VM by configuring port forwarding.<\/p>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Change your VM&#8217;s network adapter to NAT, and configure port forwarding as follows:<\/p>\n<pre style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; margin-top: 0px; margin-bottom: 16px; font-stretch: normal; line-height: 1.45; word-wrap: normal; padding: 16px; overflow: auto; border-radius: 3px; color: #333333; background-color: #f7f7f7;\"><code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0px; margin: 0px; border-radius: 3px; word-break: normal; border: 0px; display: inline; overflow: visible; line-height: inherit; word-wrap: normal; background: transparent;\">Name   -   Protocol - HostIP -   HostPort - GuestIP - GuestPort SSH        TCP        127.0.0.1  2222                 22 HTTP       TCP        127.0.0.1  8080                 80 HTTPS      TCP        127.0.0.1  8443                 443 GRAPHITE   TCP        127.0.0.1  8090                 90 <\/code><\/pre>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Once you have set up port forwarding, you can use those ports to access the VM via ssh (<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">ssh -p 2222 root@localhost<\/code>) and access the Quest Guide and PE console by entering\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">http:\/\/localhost:8080<\/code>\u00a0and\u00a0<code style=\"box-sizing: border-box; font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace; font-size: 13.6px; padding: 0.2em 0px; margin: 0px; border-radius: 3px; background-color: rgba(0, 0, 0, 0.0392157);\">https:\/\/localhost:8443<\/code>\u00a0in your browser address bar.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-i-cant-scroll-up-in-my-terminal\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#i-cant-scroll-up-in-my-terminal\" target=\"_blank\" rel=\"noopener\"><\/a>I can&#8217;t scroll up in my terminal<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">The Learning VM uses a tool called tmux to allow us to display the quest status. You can scroll in tmux by first hitting control-b, then [ (left bracket). You will then be able to use the arrow keys to scroll. Press q to exit scrolling.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-running-the-vm-in-virtualbox-i-encounter-a-series-of-rejecting-io-input-from-offline-devices\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#running-the-vm-in-virtualbox-i-encounter-a-series-of-rejecting-io-input-from-offline-devices\" target=\"_blank\" rel=\"noopener\"><\/a>Running the VM in VirtualBox, I encounter a series of &#8220;Rejecting I\/O input from offline devices&#8221;<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; margin-bottom: 16px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px;\">Reduce the VM&#8217;s processors to 1 and disable the &#8220;I\/O APIC&#8221; option in the system section of the settings menu.<\/p>\n<h3 style=\"box-sizing: border-box; margin-top: 1em; margin-bottom: 16px; line-height: 1.43; font-size: 1.5em; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';\"><a id=\"user-content-still-need-help\" class=\"anchor\" style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; display: inline-block; padding-right: 2px; margin-left: -18px; line-height: 1.2; background-color: transparent;\" href=\"https:\/\/github.com\/puppetlabs\/courseware-lvm\/blob\/master\/SETUP.md#still-need-help\" target=\"_blank\" rel=\"noopener\"><\/a>Still need help?<\/h3>\n<p style=\"box-sizing: border-box; margin-top: 0px; color: #333333; font-family: 'Helvetica Neue', Helvetica, 'Segoe UI', Arial, freesans, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'; font-size: 16px; line-height: 25.6px; margin-bottom: 0px !important;\">If your puppet runs still fail after trying the steps above, feel free to contact us at\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"mailto:learningvm@puppetlabs.com\">learningvm@puppetlabs.com<\/a>\u00a0or check the Puppet Enterprise\u00a0<a style=\"box-sizing: border-box; color: #4078c0; text-decoration: none; background-color: transparent;\" href=\"https:\/\/docs.puppetlabs.com\/pe\/latest\/release_notes_known_issues.html\" target=\"_blank\" rel=\"noopener\">Known Issues<\/a>\u00a0page.<\/p>\n<\/div>\n<\/div>\n\n<div class=\"epyt-gallery\" data-currpage=\"1\" id=\"epyt_gallery_27562\"><iframe loading=\"lazy\"  id=\"_ytid_41025\"  width=\"760\" height=\"427\"  data-origwidth=\"760\" data-origheight=\"427\" src=\"https:\/\/www.youtube.com\/embed\/?enablejsapi=1&#038;autoplay=0&#038;cc_load_policy=0&#038;cc_lang_pref=&#038;iv_load_policy=1&#038;loop=0&#038;rel=1&#038;fs=1&#038;playsinline=0&#038;autohide=2&#038;theme=dark&#038;color=red&#038;controls=1&#038;disablekb=0&#038;\" class=\"__youtube_prefs__  no-lazyload\" title=\"YouTube player\"  data-epytgalleryid=\"epyt_gallery_27562\"  allow=\"fullscreen; accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen data-no-lazy=\"1\" data-skipgform_ajax_framebjll=\"\"><\/iframe><div class=\"epyt-gallery-list\"><div>Sorry, there was a YouTube error.<\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>Download the VM(Zip File here) https:\/\/pe-education-vms.s3.amazonaws.com\/learning\/learning_puppet_vm.zip \u00a0 Minimum requirements Internet-enabled Windows, OS X, or Linux computer with 10GB free space and a VT-x\/AMD-V enabled processor. Up to date virtualization software&#8230;. <\/p>\n","protected":false},"author":1,"featured_media":2889,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[89],"tags":[1122,545,1179,664,661,593,159,663,230,968,662],"class_list":["post-480","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-puppet","tag-guide","tag-how","tag-how-to-setup-puppet-learning-vm","tag-learn-puppet","tag-learning-vm","tag-process","tag-puppet","tag-puppet-tutorial","tag-setup","tag-virtual-machine","tag-vm"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/480","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=480"}],"version-history":[{"count":4,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/480\/revisions"}],"predecessor-version":[{"id":25790,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/480\/revisions\/25790"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media\/2889"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=480"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=480"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=480"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}