Check out the WSO2 Registry source from https://wso2.org/repos/wso2/trunk/registry. Then build the project by using the command "mvn clean install". It will create a zip archive containing the binaries and the documentation.
Deploy the <registry-home>/modules/webapps/target/wso2-registry.war in a servlet container. In Apache Tomcat, this can be done by copying the wso2-registry.war to the <tomcat-home>/webapps directory.
WSO2 Registry will use an in-memory database if a data source is not configured in the servlet container. If it is required to use some other database than the in-memory database, configure a data source named jdbc/WSO2RegistryDB in the servlet container.
Now we are done with the installation.
WSO2 Registry provides a Web UI to browse the resources in the registry. First sign in as admin user either using the edit UI or the human view UI. Open a web browser and point it to the URL http://localhost:8080/wso2registry/view (We assume that your servlet container runs on port 8080. If it runs on some other port, please replace the 8080 with the port used by your servlet container). You will get the browse view of the registry. Initially this will be empty as there are no resources in the registry at start up. Once you add resources and meta data to the registry using the edit UI described in the Adding and editing resource section , you can use this UI to view those resources.
Resources in the root collection of the registry will be displayed in the home page. Name, average rating, last updated time, author and the description will be displayed for each resource. You can view the tags associated with resources by clicking on the "tags" link located in the right side of each resource row. Similarly the comments can be viewed by clicking on the "comments" link located next to the "tags" link. You can browse inside the collections by clicking on the name of the collection. Clicking on the name of other resources will display the resource content or prompt you to download the content depending on the media type.
WSO2 Registry provides a sophisticated UI for browing and editing resources and for managing other aspects of the Registry in a human friendly way. Open a web browser and point it the URL http://localhost:8080/wso2registry/admin. You will be prompted for sign in. Sign in with the user name "admin" and password "admin". You will be taken into the root collection of the Registry. There will be no resources at the start up. Now you can use the "Add Resource" and "Add Collection" sections located at the right side of the page to add new resources and collections to the root collection.
In the "Add Resource" section, type the name of the new resource and an optional description. Then click the Browse button to select a file to add as the resource content. Click Add button to add the new resource. Now you can see the newly cerated resource listed in the left side of the page with some details. Click details... link to view more details about the new resource. Now you can see a list of details about the resource. Note the "/" symbol appearing on the top left hand corner of the page. It provides a link to the parent collection of this resource. In this case, parent is the root of the Registry.
Under the "Rate this resource" section type a rating for the resource and click Rate button. You can see that the resource's rating value will be updated with average rating.
Type the tag string in the text box under the Tags heading. Click Tag button. New tag appears under the Tags heading.
Enter the comment text in the text area under the Comments section. Click Post comment button. You will see that the new comment will apear along with the author and the commented time.
Go to the root collection by clicking the "/" symbol on the top left hand corner. Type the name of the new collection under the "Add Collection" section. Optionally provide a description for the collection. Click Add button to create the collection. You will see the newly created collection appearing in the left side of the page. You can view and change the collection details by clicking on the details... link. You can browse the new collection by clicking on the name of the collection.
Click on the "User Management" link on the top righ hand corner of the page. You can see the two built in users named "admin" and "anonymous". To add a new user, fill the "Add User" section in the right side of the page and click Add button. New user name will appear in the user list. Click on the cross sign next to the user name to remove that user.
After you created a new user, click on the details.. link of a resource to give permissions for that resource. Under the Assign Permissions section select the newly created user. Then click on the permissions checkboxes to assign permissions. For example, give Get permission to the collection created in the previous step. We have to give the Get permissions for the root of the Registry as well. Otherwise, new user will not be able to browse the root and therefore will not have access to any resource. When you are browsing the root collection, you will see the text "You are browsin the root of the Registry. view details..." on the top of the page. Click the view details link and assign Get permission for the new user.
Now sign out by clicking the "Sign Out" link of the top right hand corner and sign in as the new user. You will see the resource and the collection added in previous steps. But details of the resource will be hidden and it will be marked as locked.
WSO2 Registry provides a simple UI for adding and editing resources, comments, tags, etc. This is intended to use only for the testing of the registry which will be eventually removed, once an advanced admin UI is created. Open a Web browser and point it to the URL http://localhost:8080/wso2registry/edit. This will bring up the edit UI.
Sign in as the admin user by typing the user name "admin" and password "admin" in the "Sign in" box and click on "Sign in" button. A message "Signed in successfully as admin" will be displayed on the top of the page. If you want to sign in as a different user, click on the "Sign out" link and sign-in with the required user name.
Type the path of the new resource in the Path field of the "Add resource" section. Collections (i.e. directories) in the path may or may not exist in the registry. If collections in the typed path does not exist, they will be created automatically. Optionally you can give a description for the new resource in the Description field. Then select the file to be uploaded as the content of the new resource using the Browse button. Click the "Add" button to add the new resource. You will get a message "Resource <path> is successfully added to the registry" on the top of the page. Now you can view the resource using the view UI.
Type the path of the new collection in the Path field of the "Create collection" section. Optionally add a description in the Description field. Then click the Create Collection button to create the new collection. Similar to the add resource operation, all non-existing collections of the given path will also be created automatically.
Type the path of the resource or a collection to be tagged in the Path field of the "Add tag" section. Type the tag in the Tag field. Click Add button to apply the tag to the given resource. Note that same user cannot tag the same resource with the same tag more than once. If it is attempted, an error message will be displayed on the top of the page.
Type the path of a resource in the Path field of the "Post comment" section. Type the comment text in the Comment field. Press the Post comment button.
Type a path of a resource in the Path field of the"Rate" section. Type the rating value in the Rating field. Hit the Rate button to rate the resource. Note that a one user can have only one rating for a resource. If a user rated the same resource more than once, previous ratings will be overwritten by the last rating.
