ArchiveTeam/CommonCrawl_URL_Processor
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation Update

Browse Source
This commit is contained in:
datechnoman 2023-12-18 04:34:20 +00:00
parent 727d2c3187
commit 1036de64a7
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -12,6 +12,7 @@ The script can be run without the second part but the server will quickly fill i
<li>Gzip</li> <li>Gzip</li>
<li>Axel</li> <li>Axel</li>
<li>Parallel</li> <li>Parallel</li>
<li>Rsync or WinSCP</li>
</ul> </ul>
<b>Pre-Setup Steps:</b> <b>Pre-Setup Steps:</b>
@ -27,8 +28,18 @@ Run "prerequisites.sh" to setup the stack.
1. Run url_extractor.py against the directory of txt.gz files you are wanting to process. The script will ask for you to enter the location of the files, where you want to store the output and the concurrency to run the script at. 1. Run url_extractor.py against the directory of txt.gz files you are wanting to process. The script will ask for you to enter the location of the files, where you want to store the output and the concurrency to run the script at.
2. Once the script has completed running, verify the output of the file. 2. Once the script has completed running, verify the output of the file.
<b>Data Transfer:</b>
There are two methods of transferring data from the server running the scripts back to a local machine being rsync or FTP.
From testing I have found that while rsync is robust and reliable it is quite slow and can only move a single file at a time. When running multiple instances at a time it seems that no additional bandwidth is consumed and instead the files fight each other for bandwidth.
I have developed a powershell script that uses WinSCP and the FTP protocol. Running multiple instances of the script significantly speeds up the data transfer rate. I strongly recommend using this method to download files from the server.
<b>Notes:</b> <b>Notes:</b>
<ul> <ul>
<li>A text file with all of the CommonCrawl links named "urls_to_download.txt" is required to be located in /opt/CommonCrawl_URL_Processor.</li> <li>A text file with all of the CommonCrawl links named "urls_to_download.txt" is required to be located in /opt/CommonCrawl_URL_Processor.</li>
<li>I took the lazy way of setting up FTP on the server by allowing the root account SSH access to the server without a private key.</li>
<li>WinSCP Automation is required to be downloaded and copied over the top of the installed WinSCP installation directory for the script to work.</li>
</ul> </ul>