Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
services:trac [2011/10/05 14:39]
giunta [User preferences]
— (current)
Line 1: Line 1:
-====== SISSA Trac Server ====== 
-===== User preferences ===== 
  
-Go to the web address: ​ 
- 
-  http://​trac.sissa.it/​svn/​name_of_the_repository 
- 
-In our example //​name_of_the_repository//​ will be //repos// thus the address becomes ''​%%http://​trac.sissa.it/​svn/​repos%%''​ 
- 
-Click the ''​Login''​ button on the right 
- 
-{{ :​services:​trac:​border-login_button.png?​nolink&​ |}} 
- 
-Insert ''​Username''​ and ''​Password''​ 
- 
-{{ :​services:​trac:​border-login_user.png?​nolink&​ |}} 
- 
-You are now logged-in. Clicking on ''​Preferences''​ you can modify your personal data: 
- 
-{{ :​services:​trac:​border-preferences_menu.png?​nolink&​ |}} 
- 
-In section ''​General''​ you can see and change your name and the corresponding e-mail address 
- 
-{{ :​services:​trac:​border-preferences_general.png?​nolink&​ |}} 
- 
-In section ''​Account''​ you can modify your password in ''​Change Password''​ form or you can delete your account 
- 
-{{ :​services:​trac:​border-preferences_account.png?​nolink&​ |}} 
-===== How to manage an SVN repository ===== 
- 
-  * Go to the web address 
- 
-  http://​trac.sissa.it/​svn/​name_of_the_repository 
- 
-where //​name_of_the_repository//​ is the name of repository that you manage (in our example, the name of the repository will be //repos// thus the address becomes ''​%%http://​trac.sissa.it/​svn/​repos%%''​) 
- 
-  * Click ''​Login''​ button on the right 
- 
-{{ :​services:​trac:​border-login_button.png?​nolink&​ |}} 
- 
-  * Insert ''​Username''​ and ''​Password''​ 
- 
-{{ :​services:​trac:​border-login_form.png?​nolink&​ |}} 
- 
-  * You are now logged-in. Since you are the administrator of the repository you can now see the ''​Admin''​ button on the right 
- 
-{{ :​services:​trac:​border-admin_button.png?​nolink&​ |}} 
- 
-  * Click on ''​Admin''​ button to modify users and/or rules of your repository 
- 
-{{ :​services:​trac:​border-admin_page.png?​direct&​1000 |}} 
- 
- 
-==== User management ==== 
- 
-To add/remove a user or modify a user's password: ​ 
- 
-Click on ''​Users''​ button on the right menu 
- 
-{{:​services:​trac:​border-admin_menu_users.png?​nolink&​|}} 
- 
-The list of all users will appear (in our case there is only the user //Mario Rossi// who is the owner of the repository) 
- 
-{{ :​services:​trac:​border-admin_users_list.png?​nolink&​ |}} 
- 
-To create a new account, fill in ''​Add account''​ form, on the right: 
- 
-  * ''​username''​ 
-  * ''​password''​ (that **MUST** be different from the SISSA password if you are a SISSA user!) 
-  * ''​name''​ 
-  * ''​email address''​ (not necessarily a SISSA address) 
- 
-and click ''​Add''​ button: 
- 
-{{ :​services:​trac:​border-admin_add_account.png?​nolink&​ |}} 
- 
-You can now see the new account and the corresponding details on the list: 
- 
-{{ :​services:​trac:​border-admin_newusers_list.png?​nolink&​ |}} 
- 
-In this page you can also change the password of a user by filling the ''​Change Password''​ form (on the right). This can be useful e.g. if a user forgets his password. 
- 
-{{ :​services:​trac:​border-admin_password.png?​nolink&​ |}} 
- 
-To remove an account tick the corresponding name and the press the ''​Remove selected accounts''​ button. 
- 
-{{ :​services:​trac:​border-admin_remove_users.png?​nolink&​ |}} 
- 
- 
-==== Permission ==== 
-To manage users' permissions click on ''​Access Rights''​ on the left: 
- 
-{{:​services:​trac:​border-admin_menu_access.png?​nolink&​|}} 
- 
-Clicking on the root path: 
- 
-{{ :​services:​trac:​border-root_path.png?​direct&​1000 |}} 
- 
-you can now see only the owner of the repository that has permissions to read and write in all the repository, while all the others (*) can't do anything. ​ 
-Notice that the permissions on a folder are automatically extended to all the corresponding subfolder (so if a user has permission on the root they are automatically extended to all the repository). 
- 
-{{ :​services:​trac:​border-path_owner.png?​direct&​1000 |}} 
- 
-If you want a new user (eg. //​Giuseppe//​) to be able to read/write in one of the subfolder: 
- 
-  * Go to ''​Add path''​ form, select the desired folder from ''​Path''​ drop-down list and click ''​Add''​ button 
- 
-{{ :​services:​trac:​border-add_path.png?​nolink&​ |}} 
- 
-The selected folder is now present in the ''​Subversion Paths''​ table  
- 
-{{ :​services:​trac:​border-new_add_path.png?​direct&​1000 |}} 
- 
-  * Click on the name of the folder, then go to ''​Add path members''​ form, select the user you want to modify the permits of (what he is allowed to do) in ''​Subject''​ drop-down list and click ''​Add''​ 
- 
-{{ :​services:​trac:​border-modify_permits.png?​direct&​1000 |}} 
- 
-The added member will now appear in the ''​Path member''​ table 
- 
-{{ :​services:​trac:​border-modify_permits_new_user.png?​nolink&​ |}} 
- 
-  * If you want further modify only some permits you can tick/untick the corresponding checkbox and then ''​Change path members''​ 
- 
-  * To delete all the defined permits of a user tick ''​Remove''​ checkbox (on the left of the table) and ''​Change path members''​. ​ 
- 
- 
-If you define a user without adding any permission that user won't have any permission on that folder, even those defined for the root folder. 
- 
-==== Hook Scripts ==== 
- 
-Clicking on ''​Hooks Files''​ on the left menu you can modify what the system does when something changes. 
- 
-{{:​services:​trac:​border-admin_menu_hooks.png?​nolink&​|}} 
- 
-A typical example can be sending an e-mail to a people when the data in a folder are modified. 
- 
-In ''​Add email modification''​ form on the right 
- 
-{{ :​services:​trac:​border-add_email.png?​direct&​800 |}} 
- 
-you can choose the prefix of the subject of the email that will be sent in ''​Subject''​ field, in ''​Path filter''​ drop-down list you can select the folder for which you want to send an email in case it is modified. 
- 
-You can then select users in ''​Users''​ drop-down list and click ''​Add Email'',​ or write directly the email address in the ''​Email''​ field: 
- 
-{{ :​services:​trac:​border-insert_email.png?​nolink&​ |}} 
- 
-Clicking on ''​Add''​ button, the defined changes will appear in the central field 
- 
-{{ :​services:​trac:​border-hook_final.png?​nolink&​ |}} 
- 
-clicking on ''​Apply changes''​ you can save the newly defined email notification,​ otherwise selecting ''​Reset''​ you can cancel it.