Before installing a network crawler, SearchBlox has to be installed and set up successfully. Then create a Custom Collection.
Contact email@example.com to get the download link for SearchBlox-network-crawler.
Download the latest version of SearchBlox-network-crawler. Extract the downloaded zip to /opt/searchblox-network in Linux, and C: /searchblox-network in windows machine.
The extracted folder will contain a folder named /conf, which contains all the configurations needed for the crawler.
This is the configuration file that is used to map the SearchBlox to the network crawler. Edit the file in your favorite editor.
apikey: This is the API Key of your SearchBlox Instance. You can find it in the Admin tab of the SearchBlox instance.
colname: Name of the collection which you created.
colid: The Collection ID of the collection you created. It can be found in the Collections tab near the collection name from the SearchBlox instance.
url: The URL of SearchBlox instance.
apikey: 267BACD0F31A74F557426DD2A552ECDD colname: custom colid: 2 url: http://localhost:8080/searchblox/
Enter the details of the domain server, authentication domain, username, password, folder path, disallow path, allowed format and recrawl interval in C:/searchblox-network/conf/Windowsshare.yml. You can also enter details of more than one server, or more than one path in same server, in Windowsshare.yml file.
You can find the details in the content of the file as shown below.
//The recrawl interval in days. recrawl : 12 servers: //The IP or domain of the Server. - server: 18.104.22.168 //The authentication domain if available it can be optional authentication-domain: //The Administrator Username username: administrator //The Administrator password password: may@2016 //The Folder path where the data need to be indexed. shared-folder-path: [/test/jason/pencil/] //The disallow path inside the path that needed to be indexer. disallow-path: [/admin/,/js/] //The file formats that need to be allowed for indexing allowed-format: [ txt,doc,docx,xls,xlsx,xltm,ppt,pptx,html,htm,pdf,odt,ods,rtf,vsd,xlsm,mpp,pps,one,potx,pub,pptm,odp,dotx,csv,docm,pot ] //Details of another server or another AD path to crawl - server: 22.214.171.124 authentication-domain: username: administrator password: may@2016 shared-folder-path: [/test/jason/newone/] disallow-path: [/admin/,/js/] allowed-format: [ txt,doc,docx,xls,xlsx,xltm,ppt,pptx,html,htm,pdf,odt,ods,rtf,vsd,xlsm,mpp,pps,one,potx,pub,pptm,odp,dotx,csv,docm,pot ]
The Crawler can be started with start.sh in Linux and start.bat in Windows. The crawler starts in the background but you can see the logs in the logs folder.
You can only run one network crawler at a time. If you need to run the crawler for different paths or different servers, enter the details in the same network crawler in Windowsshare.yml file.
To re-run the crawler in another collection, delete sb_network index using a tool that can communicate with Elasticsearch.
If plain passwords are not allowed in your server, enable the plain password using the line below in start.bat of the network connector:
Enable Active Directory secure search under Search → Security settings as shown below.
Secure Search can be used based on Active Directory configuration by enabling the checkbox for Secured Search and entering the required settings.
- Select Enable Secured Search
- Enter the Active Directory details
LDAP URL that specifies base search for the entries
Search Base for the active directory
Password for the username
Filter type could be default or document
Enable document filter
enable this option to filter search results based on users
- Test the connection.
- Log in using AD credentials here:
Perform secure search.
These instructions are applicable for versions 8.5 and later.
For versions prior to 8.5, go to ../webapps/searchblox/WEB-INF/secured.yml and enter your credentials as shown below.
url: ldap://126.96.36.199:389 search-base : "DC=ad,DC=searchBlox,DC=com" username: Administrator@searchblox.com password: Domain@2016 #There are two types 1. Default 2. document type: document #Filter search result with SSID, document-filter: true
If you need to filter search results based on users, then enter true for document-filter.
Restart the server once changes are made.
For help with configuration details, contact the system administrator.
Navigate to the below URL and log in with username and password. Then search the accessible files. http://localhost:8080/searchblox/search/login_securesearch.jsp
If the SMB file share is available on another server on the same network and requires permission, run the SearchBlox server service with Admin access and enter your credentials. Running as Admin account or account with access to files only will help successfully index files from the share.
Make sure to run the network crawler service as Admin in a similar manner.
and allocate more RAM by making changes in the following line
rem set JAVA_OPTS=%JAVA_OPTS% -Xms1G -Xmx1G
instead of 1G please give 2 or 3G
uncomment the following line and allocate more memory
JAVA_OPTS="$JAVA_OPTS -Xms1G -Xmx1G"
To rerun the network crawler in another collection, delete the sb_network index using a tool that can communicate with Elasticsearch.
Go to http://localhost:9200/_cat/indices and check whether you can view the sb_network index.
Kibana can also be used with Elasticsearch. Click here to learn how to start and run Kibana.
Start Kibana and access Dev Tools from the lefthand menu.
To delete an index, use the DELETE command as shown below:
Look for the "acknowledged": "true" message.
Check http://localhost:9200/_cat/indices; sb_network index should not be available among the indices.
Rerun the crawler after making necessary changes to your config.yml.