Differences

This shows you the differences between two versions of the page.

--- merging_drives [2022/07/17 11:53] – johnsanc
+++ merging_drives [2022/07/22 17:39] – johnsanc
@@ Line 8: / Line 8: @@
 First, you will need to download and install WinFsp which is used for mounting virtual filesystems.
-  - Go to the [[https://winfsp.dev/rel/|WinFsp]] site
+  - Go to the [[https://winfsp.dev/rel/|WinFsp]] site.
   - Download the latest version for your operating system. For this example we will use the standard WinFsp Installer.
   - Open the WinFsp installer by double clicking on the ``.msi`` file that was downloaded. If prompted with a security warning, choose the "Run" option.
   - Install the application by following the prompts. The default settings should be sufficient.
 \\
 ===== Setup rclone =====
-Work in progress
+Next, you will need to download and setup rclone which is used for mounting various remote sources so they can be accessed through Windows Explorer. This may not seem intuitive at first if your drives are all connected locally with different drive letters. In this example we will be using rclone just for its merging capabilities, however it can also be used to connect to remote sources such as WebDAV, Google Drives, etc.
+  - Go to the [[https://rclone.org/downloads/|rclone]] site.
+  - Download the latest version for your operating system. For this example we will use the "Intel/AMD - 64 Bit" version for Windows.
+  - Extract the contents of the ``.zip`` file to a location of your choosing. Note that rclone is like RomVault and does not have an installer. For this example we will extract the contents to ``C:\rclone``
+\\
+===== Configure an rclone Union remote =====
+Next, you need to configure rclone using a special type of remote called a "Union". The Union remote allows you to virtually merge the contents of multiple sources into a single mount point. This does not impact the filesystems of the source drives and does not require you do to do any reformatting or drive preparation.
+  - Open a command prompt by typing ``cmd`` into the Windows search bar and select **Command Prompt**
+  - Navigate to the rclone directory, in this case: ``cd C:\rclone`` and press **Enter**. Note you can also type ``cd `` then drag and drop your rclone directory onto the command line to populate the correct path.
+  - Launch rclone by typing ``rclone config`` and press **Enter**. A configuration wizard will display.
+  - Choose the option for "New remote" by typing ``n`` then press **Enter**. A name prompt will display.
+  - Give your remote a friendly name so you know what it is. For this example we will be merging two drives that contain a PlayStation 2 collection, so we will call this remote "PS2". Press **Enter** and a long list of remote types will display.
+  - Choose the **union** option by typing the number or the word ``union`` and press **Enter**. The config wizard will ask for a list of upstreams, or paths to merge.
+  - Type or drag and drop the paths you want to include separated by a space, for example: ``"X:\PS2" "Y:\PS2"``. Press **Enter** to continue.
+  - The setup wizard will walk you through various settings for this remote:
+    * **action_policy**: use the default
+    * **create_policy**: use the default
+    * **search_policy**: use the default
+    * **cache_time**: use the default
+  - When prompted to edit the advanced config, choose **no**.
+  - When prompted to keep the remote, choose **yes**. You will be taken back to the main menu of the remote configuration wizard.
+  - Quit the configuration wizard by typing ``q`` and press **Enter**.
+\\
+===== Mount the Union remote =====
+Now that you have a union remote configured, the next step is to mount the remote to access the files. This will effectively be a shortcut to access your files through the unified view.
+  - From the command prompt in the rclone directory, launch rclone using the mount option and choose to mount the remote to a new location using the following syntax: ``rclone mount [remote_name]:[directory_in_remote] [mount_path] [options]``. For example: ``rclone mount PS2:\ "C:\ROMs\PS2\" --vfs-cache-mode writes`` and press **Enter**. Note that rclone for Windows not will not allow you to mount to a directory that already exists.
+  - If everything was successful, a message should display indicating that the rclone service has started.
+  - Check that the mount exists by navigating to your mount path using Windows Explorer. The mount point will appear with a shortcut icon.
+  - Check that the contents of your drives are accessible through the remote. You should see the contents of both of your drives merged.
+|**ⓘ NOTE:** \\ RomVault requires write access to the remote for fix operations. Use the ``--vfs-cache-mode writes`` option while mounting the remote to enable write access.|
+|**💡 TIP:** \\ rclone must be running for the virtual files to be populated in your mount point. You may want to create a simple batch file to launch rclone and mount your union remote so you do not need to use the command line every time. |
+\\
+===== Optional: Create a batch script to mount remotes and start RomVault =====
+If you would like to mount your remotes when you launch RomVault, you can create a simple batch script as follows:
+  - Navigate to the directory of your RomVault executable
+  - Right click in blank space in Windows Explorer and select **New > Text Document**
+  - Rename the file something friendly with a ``.bat`` extension, like ``MountStartRV.bat``
+  - Open your .bat file in Notepad by right clicking and choosing **Edit**
+  - Enter the contents of your batch script. You can use the following as an example:<file>start "C:\rclone\rclone.exe mount PS2:\ C:\ROMs\PS2\ --vfs-cache-mode writes"
+start "" "C:\ROMVault\ROMVault35.exe"</file>
+  - Make sure RomVault and rclone are both closed, then test your script by double clicking on your *.bat file.
+  - If everything was successful, rclone will launch and mount your remote and RomVault will also launch.
+Congratulations! You can now mount your remotes and launch RomVault by clicking your batch script file. Note that closing RomVault will not stop your rclone mount. If you would like to unmount your remote and shut down the rclone, then close the rclone command prompt window.
 \\
 ===== Configure directory rules =====
-Work in progress
+Finally, the last step is to update your directory rule in RomVault to use your new mount point as the directory for your ROMs. In this case we will just be updating the directory rule for our PlayStation 2 collection.