sureshanaparti commented on code in PR #404: URL: https://github.com/apache/cloudstack-documentation/pull/404#discussion_r1634520622
########## source/developersguide/developer_guide.rst: ########## @@ -168,122 +183,38 @@ Start jetty with the simulator enabled :: - mvn -Dsimulator -Dorg.eclipse.jetty.annotations.maxWait=120 -pl :cloud-client-ui jetty:run + mvn -Dsimulator -pl :cloud-client-ui jetty:run Setup a basic or advanced zone with Marvin. In a separate shell:// :: - python tools/marvin/marvin/deployDataCenter.py -i setup/dev/basic.cfg + python3 tools/marvin/marvin/deployDataCenter.py -i setup/dev/basic.cfg OR - python tools/marvin/marvin/deployDataCenter.py -i setup/dev/advanced.cfg + python3 tools/marvin/marvin/deployDataCenter.py -i setup/dev/advanced.cfg -At this stage log in the CloudStack management server at -http://localhost:8080/client with the credentials admin/password, you -should see a fully configured zone infrastructure. +At this stage log in the CloudStack management server UI at +http://localhost:5050 or using CLI with the API endpoint at +http://localhost:8080/client with the credentials admin/password, you should see +a fully configured zone infrastructure. You can now run integration tests, use the API etc. -Building non-free Packages --------------------------- - -Certain CloudStack packages are not built by default because they depend on -libraries without redistribution rights. To build these, you need to install -the dependencies manually. - -:: - - git clone https://github.com/rhtyd/cloudstack-nonoss - cd cloudstack-nonoss - ./install-non-oss.sh - -You can then build and run CloudStack as normal by adding the `-Dnodist` flag -to build and run lines, e.g. - -:: - - mvn -Dsimulator -Dnoredist -Dorg.eclipse.jetty.annotations.maxWait=120 -pl :cloud-client-ui jetty:run - -Using DevCloud --------------- +Using Appliance for development +------------------------------- The Installing from source section will only get you to the point of runnign the management server, it does not get you any hypervisors. The -simulator section gets you a simulated datacenter for testing. With -DevCloud you can run at least one hypervisor and add it to your -management server the way you would a real physical machine. - -`DevCloud <https://cwiki.apache.org/confluence/display/CLOUDSTACK/DevCloud>`__ -is the CloudStack sandbox, the standard version is a VirtualBox based -image. There is also a KVM based image for it. Here we only show steps -with the VirtualBox image. For KVM see the -`wiki <https://cwiki.apache.org/confluence/display/CLOUDSTACK/devcloud-kvm>`__. - -\*\* DevCloud Pre-requisites - -#. Install `VirtualBox <http://www.virtualbox.org>`__ on your machine - -#. Run VirtualBox and under >Preferences create a *host-only interface* - on which you disable the DHCP server +simulator section gets you a simulated datacenter for testing. An appliance +based development such as using ``mbx`` can allow you to run at least one +hypervisor and add it to your management server the way you would a real physical machine. -#. Download the DevCloud `image - <http://people.apache.org/~bhaisaab/cloudstack/devcloud/devcloud2.ova>`__ - -#. In VirtualBox, under File > Import Appliance import the DevCloud - image. - -#. Verify the settings under > Settings and check the ``enable PAE`` - option in the processor menu - -#. Once the Instance has booted try to ``ssh`` to it with credentials: - ``root/password`` - - ssh root@192.168.56.10 - - -Adding DevCloud as an Hypervisor -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Picking up from a clean build: - -:: - - mvn -Pdeveloper,systemvm clean install - mvn -P developer -pl developer,tools/devcloud -Ddeploydb - -At this stage install marvin similarly than with the simulator: - -:: - - pip install tools/marvin/dist/Marvin-|release|.tar.gz - -Start the management server - -:: - - mvn -pl client jetty:run - -Then you are going to configure CloudStack to use the running DevCloud -Instance: - -:: - - cd tools/devcloud - python ../marvin/marvin/deployDataCenter.py -i devcloud.cfg - -If you are curious, check the ``devcloud.cfg`` file and see how the data -center is defined: 1 Zone, 1 Pod, 1 Cluster, 1 Host, 1 primary Storage, -1 Seondary Storage, all provided by Devcloud. - -You can now log in the management server at -``http://localhost:8080/client`` and start experimenting with the UI or -the API. - -Do note that the management server is running in your local machine and -that DevCloud is used only as a n Hypervisor. You could potentially run -the management server within DevCloud as well, or memory granted, run -multiple DevClouds. +MonkeyBox or `mbx <https://github.com/shapeblue/mbx>`__ +enable VM/appliance-based CloudStack development. It is tested with Ubuntu and +uses KVM and prebuilt imagesbto deploy QA and dev environments for anybody to Review Comment: ```suggestion uses KVM and prebuilt images to deploy QA and dev environments for anybody to ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@cloudstack.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org