System administrators
From Openpanel Documentation Wiki
Please refer to the Download page.
Contents |
From Source
Don't install from source - use our packages.
But if you insist:
The OpenPanel build process is centered around our Mercurial repository. To get started you should install Mercurial on your machine. Once you have these up, you can use the wharf tool to create builds. First order of business is cloning wharf:
bash% mkdir openpanel-src bash% cd openpanel-src bash% hg clone http://hg.openpanel.com/wharf bash% mkdir wharfstates bash% cd wharf
Now to create a full build, just type "make" and wharf will clone/pull all the necessary components and compile them. You should end up with a complete build tree inside the wharf/tree directory.
Source tarballs are available at our repository site but no automated buildscript for them is provided right now.
Installing a tree
Easiest way to go from a built tree to an operational installation of openpanel (sans GUI) is to copy wharf/tree/opencore to /var/opencore and start your systems. Note that the build system does not handle any of the dependencies on external components (that's all packaging-based).
Backups
Currently OpenPanel does not yet offer a built-in backup function. In order to be able to restore your system, it is recommended to backup your system just as you would backup it as if OpenPanel would not run on it. As far as OpenPanel is concerned you need at least:
/home/openadmin /etc /var/opencore/db
Also, do not forget to backup your mysql data. This is sometimes done by including /var/lib/mysql in the backup. Another way is to use a small script such as Automysqlbackup to do that for you. Also, people's home dirs do not automatically backup, so include /home if you want them to return after any recovery.
A word about restore
The OpenPanel data resides in two sqlite db files in /var/opencore/db. In theory, if you put those two files back, and all the unix users, you can recreate all the objects in OpenPanel by updating them in the gui or cli without changing them.
