{"action":"created","issue":{"url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/112","repository_url":"https://api.github.com/repos/CanonicalLtd/maas-docs","labels_url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/112/labels{/name}","comments_url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/112/comments","events_url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/112/events","html_url":"https://github.com/CanonicalLtd/maas-docs/issues/112","id":177617440,"number":112,"title":"Installation instructions do not lead new users on right path","user":{"login":"cstackpole","id":1934264,"avatar_url":"https://avatars.githubusercontent.com/u/1934264?v=3","gravatar_id":"","url":"https://api.github.com/users/cstackpole","html_url":"https://github.com/cstackpole","followers_url":"https://api.github.com/users/cstackpole/followers","following_url":"https://api.github.com/users/cstackpole/following{/other_user}","gists_url":"https://api.github.com/users/cstackpole/gists{/gist_id}","starred_url":"https://api.github.com/users/cstackpole/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cstackpole/subscriptions","organizations_url":"https://api.github.com/users/cstackpole/orgs","repos_url":"https://api.github.com/users/cstackpole/repos","events_url":"https://api.github.com/users/cstackpole/events{/privacy}","received_events_url":"https://api.github.com/users/cstackpole/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":{"login":"pmatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/pmatulis","html_url":"https://github.com/pmatulis","followers_url":"https://api.github.com/users/pmatulis/followers","following_url":"https://api.github.com/users/pmatulis/following{/other_user}","gists_url":"https://api.github.com/users/pmatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/pmatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pmatulis/subscriptions","organizations_url":"https://api.github.com/users/pmatulis/orgs","repos_url":"https://api.github.com/users/pmatulis/repos","events_url":"https://api.github.com/users/pmatulis/events{/privacy}","received_events_url":"https://api.github.com/users/pmatulis/received_events","type":"User","site_admin":false},"assignees":[{"login":"pmatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/pmatulis","html_url":"https://github.com/pmatulis","followers_url":"https://api.github.com/users/pmatulis/followers","following_url":"https://api.github.com/users/pmatulis/following{/other_user}","gists_url":"https://api.github.com/users/pmatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/pmatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pmatulis/subscriptions","organizations_url":"https://api.github.com/users/pmatulis/orgs","repos_url":"https://api.github.com/users/pmatulis/repos","events_url":"https://api.github.com/users/pmatulis/events{/privacy}","received_events_url":"https://api.github.com/users/pmatulis/received_events","type":"User","site_admin":false}],"milestone":null,"comments":20,"created_at":"2016-09-17T23:26:32Z","updated_at":"2016-10-22T17:52:24Z","closed_at":null,"body":"Greetings,\r\nI have been \"using\" MAAS for <2hrs now. That is how new to this I am. I must say I am stumped and do not have a working system....So I am going to file my report of changes I would like to see and take a break.\r\n\r\nStarting off, I did an install from the ISO using the instructions here: http://maas.io/docs/installconfig-server-iso\r\n\r\nOnce installed, I took this statement to mean \"run updates after reboot\":\r\n> \"It is important to set updates appropriately so you will receive timely updates of the MAAS server software, as well as other essential services that may run on this server.\" \r\n\r\nSo after the server is back online I ran \"sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade && sudo init 6\". W00T! Got a fully updated server to work with now: \"MAAS Version 2.0.0+bzr5189-0ubuntu1 (16.04.1)\".\r\n\r\nNext step log into the webserver. Check!\r\n\r\nNext step says: \r\n> See Add Nodes for details on adding resources to MAAS.\r\n\r\nAnd the link goes to: http://maas.io/docs/installconfig-add-nodes\r\n\r\nOK. So off I go to add nodes!\r\n\r\nSecond sentence on that page says:\r\n> If you have set up DHCP correctly, and your nodes can boot via PXE \r\n\r\n**Problem 1**\r\nSay whaaaaa? I haven't set up DHCP nor PXE. That wasn't a part of /any/ of the instructions so far. \r\n\r\nOK. Lets go back to the menu and just follow that order...read about gui (which I already have done in the instructions)...read about zones which I don't need to setup right now as this is my _very_first_time_ and I am OK with default. Ah ha! Setting up the network! http://maas.io/docs/installconfig-network2 \r\n\r\n**Problem 2**\r\n> To define a network in the user interface, click on Networks in the top bar. This will take you to the listing of known networks. Click the Add network button to start entering your network's information.\r\n\r\nOK....Networks...Add...and Umm...my page looks NOTHING like the screen shot. At all. I have the ability to add Fabric, VLAN, Space, or Subnet. Nothing else.\r\n\r\n**Problem 3**\r\nOK. Well, I know I need to enable DHCP so lets just poke around in the menu till I find it. Ah, here it is under the VLAN->Take Action. \r\n> No subnets are available on this VLAN. DHCP cannot be enabled.\r\n\r\nErr...what?? Nothing I do seems to work. Including setting up Subnets! In fact, something is /really/ wrong about setting up subnets...(more on this below where I figured it out)\r\n\r\n**Problem 4**\r\nFine, lets click the link to go to the CLI. I like the CLI! End up here: http://maas.io/docs/manage-cli-common in the section \"Enable DHCP\"\r\n\r\nUh oh. Error when running the command...\r\n> {\"primary_rack\": [\"Select a valid choice. UbuntuMaas.maas is not one of the available choices.\"], \"dhcp_on\": [\"dhcp can only be turned on when a dynamic IP range is defined.\"]}\r\n\r\nOK. Time to ask for help in the channel.... _no_one_responds_. (If anyone keeps logs and cares, my ID was Guest17230)\r\n\r\nSo off I go to spend an hour debugging DHCP. Only after I manually configure the second network card and manually start up services do things start \"working\" in the GUI. Also, it wouldn't allow me to create a DHCP pool until /after/ I had done a bunch of things with the subnet all of which was out of order with the documentation!\r\n\r\n**Problem 5**\r\nWhy wasn't the second network card configured? Where are there _any_ directions for configuring that? If I am letting MAAS handle everything on this network, it should be a step. At least a \"verify your network is setup\" step.\r\n\r\nOK. Fine. I now have a DHCP pool working and supposed PXE working. Lets try it out. Fire up the first computer....and hrm...it booted PXE but no one gave it a DHCP...Try this again...nope...doesn't appear that this is working at all....ballz.\r\n\r\nThis is the third application for server deployment and management that I have looked at today and I am tired. My brain hurts and this documentation isn't helping. So I am going to take a break and come back to it later. This looks really promising and I would really like to see it work properly, but I've got no one else to help me so i kinda have to rely on the documentation and right now I feel like it is a choose-your-own-adventure style guide to confusion...\r\n\r\n**Bonus issues**\r\nI am still unsure of:\r\n1: What are the minimum requirements for anything? My test equipment isn't the greatest so I am just winging it with the minimum requirements of Ubuntu in a few cases...\r\n2: The MAAS server will have two networks. One on a network that it will get a DHCP out to the Internet and SHOULDN'T do *ANYTHING* with. The second is the network I want to provision hosts on. Will the MAAS server act as a gateway device? Or will I need a second server to act as the bridge for the nodes to get to the Internet? I found a few things in the documentation that alludes to this, but nothing explicitly stating it and a few things that don't line up.\r\n\r\nThanks!\r\n"},"comment":{"url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/comments/255543284","html_url":"https://github.com/CanonicalLtd/maas-docs/issues/112#issuecomment-255543284","issue_url":"https://api.github.com/repos/CanonicalLtd/maas-docs/issues/112","id":255543284,"user":{"login":"cstackpole","id":1934264,"avatar_url":"https://avatars.githubusercontent.com/u/1934264?v=3","gravatar_id":"","url":"https://api.github.com/users/cstackpole","html_url":"https://github.com/cstackpole","followers_url":"https://api.github.com/users/cstackpole/followers","following_url":"https://api.github.com/users/cstackpole/following{/other_user}","gists_url":"https://api.github.com/users/cstackpole/gists{/gist_id}","starred_url":"https://api.github.com/users/cstackpole/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cstackpole/subscriptions","organizations_url":"https://api.github.com/users/cstackpole/orgs","repos_url":"https://api.github.com/users/cstackpole/repos","events_url":"https://api.github.com/users/cstackpole/events{/privacy}","received_events_url":"https://api.github.com/users/cstackpole/received_events","type":"User","site_admin":false},"created_at":"2016-10-22T17:52:23Z","updated_at":"2016-10-22T17:52:23Z","body":"Greetings,\r\nNothing in the logs that I can see when I toggle DHCP on/off. As soon as I reboot, it starts working.\r\n\r\nThere is an interesting error about something else though:\r\n  [Errno 1] Operation not permitted: '/var/lib/maas/boot-resources/cache/root-tgz-3eacec1c000dd0b73f4ardhr279c19c1v13f565cd7ds2effsdea837fa6aeee9' -> '/var/lib/maas/boot-resources/snapshot-20161022-175112/ubuntu/amd64/generic/xenial/daily/root-tgz'\r\n\r\n"}}
{"actor":{"display_login":"cstackpole"}}