From 73f70b905cdf0e5084d2522679dd909816ef159b Mon Sep 17 00:00:00 2001 From: cajus Date: Fri, 26 Sep 2008 09:30:16 +0000 Subject: [PATCH] Updated for 2.6 git-svn-id: https://oss.gonicus.de/repositories/gosa/trunk@12549 594d385d-05f5-0310-b6e9-bd551577e9d8 --- gosa-core/DEVEL | 131 ---------------------------------------------- gosa-core/INSTALL | 84 ++++++++++++++--------------- 2 files changed, 42 insertions(+), 173 deletions(-) delete mode 100644 gosa-core/DEVEL diff --git a/gosa-core/DEVEL b/gosa-core/DEVEL deleted file mode 100644 index b67c82cfd..000000000 --- a/gosa-core/DEVEL +++ /dev/null @@ -1,131 +0,0 @@ -* How to get plugged in - -Lets explain how to create a simple GOsa plugin. The example shows a dummy plugin which is not -directly related with LDAP. Independently of beeing an LDAP style or LDAP unrelated plugin, you -may start a new plugin, by creating a new directory below the plugin directory structure. To be up to -date, get a fresh CVS checkout: - -Create a ~/.cvsrc with the following content: -cvs -z4 -q -diff -u3 -p -update -dP -checkout -P - -Change to the directory which will contain your GOsa checkout. -# cd ~projects -# export CVSROOT=:pserver:anonymous@cvs.alioth.debian.org:/cvsroot/gosa -# cvs login -# cvs co gosa - -The gosa directory will contain your initial checkout now. In order to update from CVS -you simply can call "cvs up". There's no need to set the CVSROOT directory anymore, -as long as you cal all cvs commands inside the gosa directory and its subdirectories. - -Now you've an up to date GOsa. Not that this is CVS HEAD, so there may be something -broken. Continue by choosing a name and creating the directories: - -# cd plugins/addons -# mkdir dummyplug && cd dummyplug - -GOsa expects a file named "main.inc" inside of this plugin directory. It is needed because some -plugins may need no standard handling and GOsa itself may not know how to initialize the plugin -classes. Here's our example: - ---- -execute (); - - /* The ignore field controls if GOsa should ignore the users tries to leave the plugin without - saving. For the dummy plugin, you can leave all the time without loosing data. */ - $display.= "\n"; - - /* After executing the plugin, some data may have changed, so we need to put the plugin back - to the session. */ - $_SESSION['export']= $export; -?> ---- - -The basic starter for your plugin is ready now. We're missing the plugin itself currently. To create it, -you need to create a file starting with class_ and ending with .inc. These files get sourced automatically. - -Here's the class_dummy.inc: - ---- -config= $config; - } - - /* Execute is the function all plugins need. It fills the plugin with life and produces the output. */ - function execute() - { - /* Use the smarty templating engine here... */ - $smarty= get_smarty(); - - /* Normally you would react to user input here. */ - - /* Let smarty fetch and process the page. Always seperate PHP and HTML as much as - you can. */ - return ($smarty->fetch (get_template_path('contents.tpl', TRUE))); - } - -} -?> ---- - -There are two things missing now. The template file and an entry in your gosa.conf. Lets finish the -work in the plugin directory, first. - -Here is the contents.tpl file: - ---- -

- {t}This is a dummy plugin. It really does nothing. The tags around this text do automatic translations to the desired language. Please don't include linefeeds here, or it will not work at all!{/t} -

- -

-   -

---- - -Now add the following entry to your Addons section in gosa.conf: --- - --- - -After logging into GOsa, you'll see your plugin in the addons section. - diff --git a/gosa-core/INSTALL b/gosa-core/INSTALL index be4ef51a2..352639930 100644 --- a/gosa-core/INSTALL +++ b/gosa-core/INSTALL @@ -1,7 +1,14 @@ -GOsa2.1 QUICK INSTALL -===================== +GOsa 2.6 QUICK INSTALL +====================== -* Installing GOsa +Prequisite: + +You have a system up and running. It has apache and PHP installed +and there is a blank (or prefilled) but working LDAP available. + +--- + +Installing GOsa from source: Unpack the GOsa tarball and move the main gosa directory to a place your webserver is configured to find it. The default @@ -27,45 +34,35 @@ config: # Set alias to gosa Alias /gosa /usr/share/gosa/html -Assumed you've installed PHP >= 4.1.0, restart your apache webserver +Assumed you've installed PHP >= 5.2.0, reload your apache webserver and do your first GOsa dry run without configuration: -http[s]://your-server/gosa/setup.php +http[s]://your-server/gosa + +GOsa setup will perform some basic system checks about general +prerequisites. The setup asks some questions and provides a +basic gosa.conf to save in /etc/gosa. Follow the instructions +until you're able to log in. + +You're done. Lets play with the GUI. + +--- + +* Installing from Packages + +If you install GOsa from packages, all the steps from above will +be done automatically. Go to the setup: + +http[s]://your-server/gosa GOsa setup will perform some basic system checks about general prerequisites. The setup asks some questions and provides a basic gosa.conf to save in /etc/gosa. Follow the instructions until you're able to log in. -As a final step - which is not done automatically yet, you've to -create a group which members will be GOsa administrators. Here's -an example ldif which creates a user named "admin" with the password -"tester" and a group where this user is in: - -dn: cn=admin,ou=people,dc=example,dc=net -objectClass: person -objectClass: organizationalPerson -objectClass: inetOrgPerson -objectClass: gosaAccount -uid: admin -cn: admin -givenName: admin -sn: GOsa main administrator -lmPassword: 10974C6EFC0AEE1917306D272A9441BB -ntPassword: 38F3951141D0F71A039CFA9D1EC06378 -userPassword:: dGVzdGVy - -dn: cn=administrators,ou=groups,dc=example,dc=net -objectClass: gosaObject -objectClass: posixGroup -gosaSubtreeACL: :all -cn: administrators -gidNumber: 999 -memberUid: admin - -After adding these entries, you should be able to use GOsa. Log in as -admin and try experiment with the GUI. +You're done. Lets play with the GUI. +--- * Migrating an existing tree @@ -86,24 +83,27 @@ plus some modifications: that have the objectClass gosaDepartment. You can hide subtrees from GOsa by not putting this objectClass inside. -- You need at least one group with objectClass gosaObject and attribute - gosaSubtreeACL set to :all in the base of your tree. All members of this - group are able to change everything in GOsa. Look at the cn=administrators - from above. +The GOsa setup may be used to do these migrations, but it is not meant +to work in every possible circumstance. For the first time: + +DO NOT WORK ON PRODUCTIVE DATA IF YOU DON'T KNOW WHAT YOU'RE DOING! That should be all. Entries should be visible in GOsa now. Be aware that if your naming policy of user cn's differs from the way GOsa handles it, the entries get rewritten to a GOsa style dn. +--- -* More informations +* Further information -To improve this piece of software, please report all kind of errors. -Looking for a mailing list? Go to +To improve this piece of software, please report all kind of errors, either +using the bug tracker on www.gosa-project.org or the button on the upper +right. -https://oss.gonicus.de/mailman/listinfo/gosa/ +Documentation: https://www.gosa-project.org +Mailinglist: https://oss.gonicus.de/mailman/listinfo/gosa/ -Thanks +Have fun! --- Cajus Pollmeier -- 2.30.2