...
- Check out the ole-docstore directory from the following SVN Repository:
ole-docstore -- Refer to it as DOCSTORE_PROJ
2.Building the Code
- Open command prompt and go to the ole-docstore folderRun the following command folder: %DOCSTORE_PROJ%
Run "mvn clean install".
oledocstore.war file will be created in %DOCSTORE_PROJ%ole-docstore-webapp*{*}target folder.
3.Deployment
3.1 Setting up properties
Create the following directories in the same drive as %TOMCAT_HOME% directory.
...
properties
...
Go to %TOMCAT_HOME%\bin directory.
...
Define the following variables in setenv.bat file
...
Set JAVA_OPTS as below.
set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx1g -XX:MaxPermSize=256m |
Save the file setenv.bat
- Copy the contents of DOCSTORE_SOLR_CONFIG_PROJ to OLE_ DISCOVERY_CONFIG_HOME.
- Copy ole-discovery.properties from DOCSTORE_WEBAPP_PROJ/src/main/resources to OLE_ DISCOVERY_PROP_HOME.
Modify the port in the following property in the above file to match the Tomcat port. (Default is 8080)
...
3.2 Deploying the War file to Tomcat
- Copy oledocstore.war file from %DOCSTORE_PROJ%ole-docstore-webapp*target to %*TOMCAT_HOME%\webapps folder
4.Running Docstore and Discovery
Start the Tomcat Server.
Open a browser.
Navigate to the following URLs.
- http://localhost:8080/oledocstore
- Copy log4j.properties from DOCSTORE_WEBAPP_PROJ/src/main/resources to OLE_DOCSTORE_PROP_HOME
- Copy DOCSTORE_WEBAPP_PROJ /repository-derby.xml to OLE_DOCSTORE_PROP_HOME.and rename it as repository.xml
- Copy DOCSTORE_ENGINE_PROJ/src/main/resources/org/kuali/ole/utility/documentstore.properties to OLE_DOCSTORE_PROP_HOME
...
...
The following directory structure is created for DocumentStore and Discovery related configuration after the application is started.
...
DocumentStore
- \opt\docstore\properties
Discovery
- \opt\docstore\discovery\properties
- \opt\docstore\discovery\solr-config
If the application is not accessible, the following properties may need to be edited and Tomcat restarted.
- Open documentstore.properties file under \opt\docstore\properties and modify the port in the following property
...
- to match the Tomcat port. (Default is 8080)
local.docSearchURL=http://localhost:8080/oledocstore/
3.2 Deploying the War file to Tomcat
- Copy oledocstore.war file from %DOCSTORE_WEBAPP_PROJ%target to %TOMCAT_HOME%\webapps folder
4.Running Docstore and Discovery
Start the Tomcat Server.
Open a browser.
Navigate to the following URLs.
- http://localhost:8080/oledocstore
- http://localhost:8080/oledocstore/discovery.do
- Open ole-discovery.properties file under \opt\docstore\discovery\properties and modify the port in the following property to match the Tomcat port. (Default is 8080)
docSearchURL=http://localhost:8080/oledocstore/
...
5.String Ingest
Open a browser.
Go to URL http://localhost:8080/oledocstore/discovery and and click on "Ingest String Content" tab.
...
The response xml in the browser gives the result of the stream ingest process.
The The data can also be verified using the URLs given in the previous section.
...
Copy the following sample data files to the folder specified by the property local.batch.upload.dir (only this property) in the file %OLE_DISCOVERY_PROP_HOME% \opt\docstore\propertiesdocumentstore.properties. This property should be changed to a directory suitable to the local user's system. (e.g. /ole-test-data/bulkingest). Create this folder if it does not exist.
Please note: There may be issues with file/folder permissions with this directory. Make sure this directory is fully accessible by all users.
- %DOCSTORE_ENGINE_PROJ%% DOCSTORE_PROJ%ole-docstore-engine*{*}src\test\resources\org\kuali\ole\bulkIngest\files\bulkIngest-Work-Bib-Marc-20.xml --- This is a sample test data file
- %DOCSTORE_ENGINE_PROJ%% DOCSTORE_PROJ%ole-docstore-engine*{*}src\test\resources\org\kuali\ole\bulkIngest\files\bulkIngest-Work-Inst-OleML-20.xml --- This is a sample test data file
...
To verify that the data is stored in DocStoreDocumentStore, go to URL
http://localhost:8080/oledocstore
...
Open log4j.properties file under OLE_DOCSTORE_PROP_HOME \opt\docstore\properties
Now check the following properties to find the location of log files:
...
Before building OLE make sure the following properties are correctly set in local-build.properties file in %OLE_HOME% directotydirectory.
- ole.docstoreapp.url=http://localhost:8080/oledocstore/document
- ole.discovery.app.url=http://localhost:8080/oledocstore/discovery/
...
Click on 'Search' button.
Open documentstore.properties file under \opt\docstore\properties and modify the port in the following property to match the Tomcat port. (Default is 8080)
local.docSearchURL=http://localhost:8080/oledocstore/