Rework of the installation documentation

This commit is contained in:
Martin Beckert 2018-08-24 12:26:45 +02:00 committed by Thomas Lamprecht
parent 2e353dfb5f
commit bb9d386588

View File

@ -1,25 +1,41 @@
= Setup PVE Development Environment = = Setup PVE Development Environment =
1. Install Debian 'stretch' 0. Read https://pve.proxmox.com/wiki/Developer_Documentation
2. Configure pvetest repository in apt sources.list 1. Install Debian 9 'stretch'
2. Configure the network interface(s)
3. Change the IP address of your hostname for proper name resolution
in /etc/hosts
Using 127.0.1.1 will not work, so change it to an IP address from your
local network!
deb http://download.proxmox.com/debian stretch pvetest 4: Check that the Debian repositories are set properly.
See https://wiki.debian.org/SourcesList for more information.
3. Add our repository key with apt-key: 5. Optional: Install openssh-server and connect via ssh to the host.
wget -O- "http://download.proxmox.com/debian/key.asc" | apt-key add - run: apt-get update && apt-get install openssh-server
Connect via ssh to host and switch user to root
4. make sure you have a read IP address for your hostname in /etc/hosts 6. Configure 'pvetest' repository in /etc/apt/sources.list.d/:
(using 127.0.1.1 will not work)
5. run: apt-get update run: echo "deb http://download.proxmox.com/debian stretch pvetest" > /etc/apt/sources.list.d/pve-development.list
6. run: apt-get dist-upgrade
7. run: apt-get install proxmox-ve 7. Add the repository key:
run: wget -O- "http://download.proxmox.com/debian/proxmox-ve-release-5.x.gpg" | apt-key add -
8. run: apt-get update && apt-get dist-upgrade
9. run: apt-get install proxmox-ve
10. run: mv /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/pve-enterprise.list.bak
11. You should now have a working Proxmox VE installation.
Open a browser: https://<host_IP_address>:8006 e.g. https://10.0.0.90:8006
You should now have a working Proxmox VE installation.
= Install build prerequisites for development environment = = Install build prerequisites for development environment =
12. run:
apt-get install build-essential git git-email debhelper \ apt-get install build-essential git git-email debhelper \
autotools-dev autogen dh-autoreconf dkms doxygen check pkg-config \ autotools-dev autogen dh-autoreconf dkms doxygen check pkg-config \
groff quilt dpatch automake autoconf libtool lintian libdevel-cycle-perl \ groff quilt dpatch automake autoconf libtool lintian libdevel-cycle-perl \
@ -45,56 +61,30 @@ liblzma-dev dosfstools mtools libxen-dev libfuse-dev corosync-dev \
libcpg-dev libquorum-dev libcmap-dev libuuid-perl \ libcpg-dev libquorum-dev libcmap-dev libuuid-perl \
libqb-dev libapparmor-dev docbook2x libcap-dev dh-apparmor \ libqb-dev libapparmor-dev docbook2x libcap-dev dh-apparmor \
graphviz libseccomp-dev libglib-perl libgtk3-perl libnss3-dev libdlm-dev \ graphviz libseccomp-dev libglib-perl libgtk3-perl libnss3-dev libdlm-dev \
libudev-dev asciidoc-dblatex source-highlight libiscsi-dev libiscsi7 libudev-dev asciidoc-dblatex source-highlight libiscsi-dev libiscsi7 \
librsvg2-bin
= Compile PVE packages from Source = = Compile PVE packages from Source =
Download and install the following git modules in order from top to bottom: 13: Download and install git repositories as Proxmox modules:
# git clone git://git.proxmox.com/git/<PACKAGE.git> run: mkdir /root/proxmox && cd /root/proxmox
You currently need the following packages: run: git clone git://git.proxmox.com/git/pve-common.git
pve-common.git 'pve-common.git' is some kind of starting repository and needed for some
libpve-http-server-perl.git other repositories as dependency.
libpve-apiclient-perl.git Install this to get an idea of how the installation process is working.
pve-docs.git
pve-cluster.git
pve-access-control.git
pve-storage.git
pve-guest-common.git
pve-firewall.git
pve-qemu-kvm.git
qemu-server.git
vncterm.git
spiceterm.git
#vzquota.git
#vzctl.git
#fence-agents-pve.git
#resource-agents-pve.git
extjs.git
pve-manager.git
#pve-kernel-3.10.0.git
#libiscsi.git
#gfs2-utils.git
ksm-control-daemon.git
pve-container.git
pve-kernel.git
Most packages can be installed with 'make dinstall' command. See https://git.proxmox.com/ for all available repositories.
4. Reboot the system. 14: Most packages can be installed with 'make dinstall' command.
5. Learn to use the quilt patch scripts. run: cd pve-common && make dinstall
6. Happy coding.
There is an experimental package containing the API documentation 15: Reboot the system.
as ExtJS application: 16. Learn to use the quilt patch scripts.
17. Happy coding!
pve2-api-doc.git
You can view the source code at:
https://git.proxmox.com
= REST vs. SOAP = = REST vs. SOAP =