In this post, I am going to show you, how to setup openCMIS
Inmemory repository and cmis work bench provided by Apache Chemistry.
What is openCMIS
inmemory repository?
It is an implementation of CMIS repository. it holds the
content and metadata in memory. So once you restart the machine (or)
application, the data will be lost.
Why do we require
Inmemory repository?
First of all, for new comers, it is easy to experiment
with CMIS APIs, if they had repository in their computer.
What is CMIS workbench?
CMIS workbench is a swing based CMIS client, used to
connect to the repositories. By using CMIS work bench, you can
a.
Access the repository
b.
Perform CRUD operations against repository
c.
Get the information about the repository
d.
It provides TCK (Test Compatibility kit), to
verify whether given repository is CMIS compliance or not.
e.
Provide interactive Groovy Console.
Setting up OpenCMIS
in memory repository
Make sure you installed and setup Java on your machine.
Following post explains how to setup Java on your machine.
Go to following
location and download ‘OpenCMIS Server Webapps’.
Extract the download zip file, you can able to see two
war files.
chemistry-opencmis-server-fileshare-1.1.0.war
chemistry-opencmis-server-inmemory-1.1.0.war
War file
|
Description
|
chemistry-opencmis-server-fileshare-1.1.0.war
|
It is an implementation of CMIS repository. The
FileShare repository uses the file system as its back-end store and provides
read/write access to content and metadata. In other words, it puts a CMIS
interface on top of your file system.
|
chemistry-opencmis-server-inmemory-1.1.0.war
|
It is an implementation of CMIS repository. The
OpenCMIS In-Memory Repository is an implementation of a CMIS repository that
holds content and metadata in memory. Therefore, all data stored in the
repository is lost after each restart.
|
Since the in memory repository is a web application, we
need to deploy this in an application server like tomcat. Next steps shows you
how to install and deploy the war file
‘chemistry-opencmis-server-inmemory-1.1.0.war’.
Downloading and setting up tomcat
Go to following location and download the latest version
of tomcat server.
Extract the downloaded tomcat distribution.
Go to the bin directory of tomcat distribution and run
‘startup.bat’ file.
If everything goes fine, server will start on the port
8080.
Open web browser and hit the url
‘http://localhost:8080/’, you can able to see following output.
By using ‘Manager App’ button, we can deploy war files.
To use ‘manager App’, we should configure a user.
How to configure a
user in tomcat?
First stop the tomcat server by running ‘shutdown.bat’
file.
Tomcat users are defined in the file –
$TOMCAT_HOME/conf/tomcat-users.xml, by default, no user is configured. To
access the tomcat manager page, we should configure user in tomcat-users.xml
file.
Add following lines to the <tomcat-users>
<role rolename="manager-gui"/>
<user username="admin"
password="admin" roles="manager-gui"/>
Before updating
<tomcat-users xmlns="http://tomcat.apache.org/xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd" version="1.0"> <!-- <role rolename="tomcat"/> <role rolename="role1"/> <user username="tomcat" password="<must-be-changed>" roles="tomcat"/> <user username="both" password="<must-be-changed>" roles="tomcat,role1"/> <user username="role1" password="<must-be-changed>" roles="role1"/> --> </tomcat-users>
After updating
<tomcat-users xmlns="http://tomcat.apache.org/xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd" version="1.0"> <!-- <role rolename="tomcat"/> <role rolename="role1"/> <user username="tomcat" password="<must-be-changed>" roles="tomcat"/> <user username="both" password="<must-be-changed>" roles="tomcat,role1"/> <user username="role1" password="<must-be-changed>" roles="role1"/> --> <role rolename="manager-gui"/> <user username="admin" password="admin" roles="manager-gui"/> </tomcat-users>
Now run startup.bat file.
Open the browser and hit the url ‘http://localhost:8080/’
Click on the button ‘Manager App’. It prompts for user
name and password. Enter admin as username and password and press Login.
After successful login, you can able to see following
screen.
Choose the war file and deploy the war file ‘chemistry-opencmis-server-inmemory-1.1.0.war’.
After successful deployment of war file, the in memory
application ‘chemistry-opencmis-server-inmemory-1.1.0’ is added to Applications
table.
Click on the link
‘chemistry-opencmis-server-inmemory-1.1.0’, you can able to see the following
page.
In the above page, you can get access information of the
in memory server. Following access information is copied from above page.
CMIS 1.1
WS (SOAP) Binding: http://localhost:8080/chemistry-opencmis-server-inmemory-1.1.0/services11/cmis?wsdl
AtomPub Binding:
http://localhost:8080/chemistry-opencmis-server-inmemory-1.1.0/atom11
Browser Binding:
http://localhost:8080/chemistry-opencmis-server-inmemory-1.1.0/browser
CMIS 1.0
WS (SOAP) Binding:
http://localhost:8080/chemistry-opencmis-server-inmemory-1.1.0/services/cmis?wsdl
AtomPub Binding: http://localhost:8080/chemistry-opencmis-server-inmemory-1.1.0/atom
Remember above binding urls, they are required to connect
to the repository.
Setting up CMIS
workbench
CMIS Workbench is an independent swing based application
(You can assume like CMIS desktop client), used to connect to a cmis
repository.
Go to following location and download CMIS workbench.
Extract the downloaded workbench and run ‘workbench.bat’
file. You can able to see following swing user interface.
By default 'Binding' will be selected as 'AtomPub'. You
can give following AtomPub url and connect.
Click on the button 'Load Repositories'. You can able to
see list of repositories available. Since we configured only one inmemory
repository, you can able to see one.
Select the in memory repository and press Login. You can
able to see following kind of screen.
That’s it, you are done. Now you can experiment with the
CMIS work bench.
No comments:
Post a Comment