ShadowStream ReadMe

This ReadMe contains information to help you understand and use the new StorageCraft ShadowStream product. The readme supplements and leverages information in the user guide.  Take a few minutes to understand the issues before you start the installation.

StorageCraft ShadowStream 6.1.2

Last Updated: August 9, 2016


Table of Contents

1. Update Information by Product Version

 
2. System Requirements (applicable for the current version)

3. Installation Instructions (applicable for the current version)


1. Information by Product Version


ShadowStream 6.1.2 (July 2016)

Enhancements

  •  The ShadowStream Server will now use multiple threads to handle multiple replication streams more efficiently.

Fixed Issues

  • Fixed an issue where the server-side throttling would not be adjusted when throttling changes were made by the sending ImageManager instance.
  • Fixed an issue where ShadowStream would not properly close UDT connections, leaving the ShadowStream process in an unstable state.

 


ShadowStream 6.0.12 (December 2015)

Enhancements

  • Added more logging to more easily troubleshoot future problems. 

  • Added auto restart to ShadowStream service. 

Fixed Issues

  • Fixed an issue to prevent dropping connections between ImageManager and the ShadowStream server. 
     
  • Fixed an issue so that ShadowStream server no longer goes into a state where it ignores incoming connections from ImageManager.

Known Issues
  • In some situations the uninstall does not close the Admin Console. If you have the ShadowStream 6.x User Admin open when you try to uninstall the product, the user interface may not always close automatically. If this occurs you can manually close the open user interface. This does not affect the uninstall at all.
     
  • This release significantly reduces the chance of a rare ShadowStream crash. However, under extreme conditions there is a chance that the ShadowStream Service may still crash. If this occurs the service will automatically resart.
 

ShadowStream 6.0.8 (July 2015) 

 

Enhancements

  • ShadowStream now checks for invalid command codes. The ShadowStream Service has been updated to improve handling of malformed packages that contain invalid command codes.
  • The ShadowStream service now has additional logging. You can enable this option by editing the ShadowStream configuration XML file and changing the logging level. 

  • You can increase the size of the log file, together with the number of log files retained. 

    <param name="maxFileSize" value="20MB"/>

    The XML configuration file is located in the "StorageCraft\ImageManager\Logs" folder.

  • There is also Improved ShadowStream Logging on the ImageManager Client side. The ShadowStream.xml file has been updated to include an additional logging entry near the end of the file:

    <logger name="QtpClient">
    <level value="all"/>
    <!-- <appender-ref ref="console" /> -->
    <appender-ref ref="logfile" />
    </logger>

    This additional option is not important for the ShadowStream Service side, but it is useful on the ImageManager ShadowStream Client side. On the ImageManager (Client side) the XML file is located in the "StorageCraft\ImageManager\Logs" folder. Previous versions of ShadowStream will support this additional entry, so it is backwards compatible.

Fixed Issues

  • Fixed an issue where If the share folder is deleted or missing, it failed to re-create the share directory when creating a new replication folder. If you tried to create a ShadowStream Replication Job in ImageManager, but the remote ShadowStream Service had no Shared Folders defined, the Replication Job creation would fail with an error. This has been fixed in this release. If a Replication Job is created and no Shared Folder exists, the ShadowStream Service will now create a shared folder.
     
  • Fixed an issue where the SST Server 6.0.8.2 was unable to parse directory contents of a share on a network location. In some rare situations, the ShadowStream Service had problems accessing sub-folders within a Shared Folder that the user defined in ShadowStream. This resulted in the following error: “Sync error: No files found in target”. The user also sometimes had problems accessing the sub-folders when using the ShadowStream Admin tool. This issue is fixed in this release.

    It is worth noting that these kinds of failures can be caused by a firewall which is blocking the UDP traffic used by ShadowStream.
     

  • Fixed an issue where nested subfolders were being created at the wrong level. When attempting to create a folder under an existing sub-folder, the new folder was created as a sibling of the existing sub-folder instead of as a child of that folder. This is fixed in this release.
     
  • Fixed an issue where ShadowStream Server "Enable" option wasn't working on shares or users. In some situations, the User or Share "Enable" option was ignored. This is fixed in this release. Now share changes take effect immediately (on the next action requested). User changes will not take effect until the user logs out and tries to login again. 
     
  • Fixed an issue where ShadowStream service crashes unexpectedly, which halts replication. In some rare situations when there are a number of ShadowStream Replication jobs, there is a chance that the ShadowStream Service will crash. This is fixed in this release.
     
  • Fixed a Runtime Error when configuring a share in ShadowStream. In some rare situations, it was possible to corrupt the install of ShadowStream if the permissions for a Shared Folder were changed. Normally a runtime error was shown when the problem occured. Simply restarting the ShadowStream Service did not fix the issue. The user needed to run a repair install instead. This is fixed in this release.
Known Issues
  • In some situations the uninstall does not close the Admin Console. If you have the ShadowStream 6.x User Admin open when you try to uninstall the product, the user interface may not always close automatically. If this occurs you can manually close the open user interface. This does not affect the uninstall at all.

  • This release significantly reduces the chance of a rare ShadowStream crash. However, under extreme conditions there is a chance that the ShadowStream Service may still crash. If this occurs, please contact StorageCraft support.

 


ShadowStream 6.0.4 (March 2015)

 

Enhancements

  • ShadowStream now uses UDP ports 4366 (data connection) and 4367 (admin connection). These ShadowStream ports are Registered with IANA. Legacy ShadowStream (for reference) used TCP ports: 4363, 4364 and 4365. 

Fixed Issues

  • ShadowStream now allows you to provide credentials for remote shares or shares on a NAS box if they require specific user credentials. See Create and Configure Shares in the ShadowStream user guide.
  • The ShadowStream installer now automatically creates the "DefaultShare" folder referred to in the ShadowStream Shares window. The folder path is:
    C:\ProgramData\StorageCraft\ShadowStream\DefaultShare
  • You can now refresh the ShadowStream Browse Share screen with the Refresh button. The F5 key was normally used in the past.

Known Issues

  • Under some rare conditions (which seem to be caused by network issues) you may see a "Failed To Create Directory" error when creating a new ShadowStream Replication Job. The error will include information similar to the message below:
     -SST-Error(19): Failed To Create Directory
     -Add(): Cannot create directory
  • Under some rare conditions ImageManager may temporarily display a replication error for new ShadowStream jobs. The message will disappear after 10 minutes. This may happen when there are network issues or when the destination device takes longer than normal to write the sent file.
  • When you upgrade from Legacy ShadowStream to the new ShadowStream you should enter your ShadowStream Legacy console password when the install prompts you
  • If you uninstall ShadowStream while the User Admin is open, the user interface may not always close automatically. If this happens you can manually close the user interface without affecting the uninstall.

ShadowStream 6.0 (December 2014)

 

Enhancements

  •  ShadowStream 6.0 is a completely rewritten, and greatly improved continuation of the older legacy version of ShadowStream.
Note: When you upgrade to ShadowStream 6.0, it doesn't install over (or update) your existing (legacy) version of ShadowStream. The new ShadowStream is a new (parallel) installation that allows you to run both versions side by side. This makes it easier to migrate your settings from the legacy version to the new version.

Fixed Issues

  • The new version of ShadowStream server is a 64-bit application. This new functionality allows the processor to access more memory which allows more connections.
  • New ShadowStream also provides backward database compatibility. This means is possible for you to "upgrade" from an existing set of legacy ShadowStream replication jobs to new ShadowStream 6.0.0 replication Jobs.
  • Fixed an issue where flags were ignored for Sending files. Now, compression and encryption options are honored, but StorageCraft recommends that you don't use these settings in most cases.  If the files are already compressed and encrypted (as normal), it just adds overhead to your network and servers to perform additional (unneccessary) compression or encryption.

  • Fixed ShadowStream install error so that legacy databases will upgrade from legacy ShadowStream servers to new ShadowStream servers.

    Note: Upgrading so your legacy database works with the new ShadowStream is a manual process. See How do I upgrade from the original (legacy) ShadowStream to the new ShadowStream? in the user guide.

Known Issues

  • The new ShadowStream Admin (in some rare situations) can get disconnected from the ShadowStream service when running on Windows Server 2012 R2.
  • See the Frequently Asked Questions (FAQ) page in the ShadowStream user guide for additional known issues and work-around information.


2. System Requirements


3. Installation Instructions

Terms and Conditions of Use - Privacy Policy - Cookies