Updating your SUNSHARE software ensures you’re leveraging the latest features, security patches, and performance improvements. Whether you’re using photovoltaic monitoring tools, energy management modules, or system optimization plugins, here’s a granular, step-by-step guide to execute the update flawlessly across different operating systems.
**Step 1: Verify Your Current Version**
Open the SUNSHARE application and navigate to **Help > About** (Windows/Linux) or **SUNSHARE > About SUNSHARE** (macOS). Note the version number (e.g., v4.2.1) and build date. Cross-reference this with the latest release notes on the SUNSHARE website. If your version is older than the one listed under “Current Releases,” proceed with the update.
**Step 2: Download the Update Package**
Never source installers from third-party sites. Log in to your SUNSHARE account portal and locate the “Software Downloads” section. Select the correct installer for your OS:
– **Windows**: Choose between EXE (standard) or MSI (enterprise deployment) formats.
– **macOS**: Opt for the DMG file if using Apple Silicon (M1/M2) or Intel processors.
– **Linux**: Use the DEB/RPM package or TAR.GZ archive depending on your distribution.
Enable checksum verification by comparing the SHA-256 hash displayed on the download page with the file’s actual hash (use `Get-FileHash` in PowerShell or `shasum -a 256` in Terminal).
**Step 3: Prepare Your System**
Close all SUNSHARE-related processes. For Windows, terminate background services via Task Manager > Details tab > end “SunshareService.exe.” On macOS, force-quit any lingering processes in Activity Monitor. For Linux, run `sudo systemctl stop sunshare-core` if using a systemd-based distribution.
Temporarily disable firewalls or antivirus software that might interfere with the installation. Ensure your system meets the updated software’s requirements (e.g., .NET Framework 6.0 for Windows, OpenSSL 3.0 for Linux).
**Step 4: Install the Update**
**Windows**: Right-click the installer and select “Run as Administrator.” During installation, select “Repair” if upgrading from a recent version (e.g., v4.1.x to v4.2.x) or “Complete Install” for major version jumps (e.g., v3.x to v4.x). Enable the “Preserve Historical Data” checkbox to retain your existing configurations.
**macOS**: Mount the DMG file, drag the SUNSHARE icon to the Applications folder, and authenticate with your OS password. If upgrading from a pre-4.0 version, manually migrate custom scripts from `/Library/Application Support/Sunshare/Legacy/` to the new `Modules` directory.
**Linux**: For DEB/RPM packages, use `sudo apt install ./sunshare-latest.deb` or `sudo rpm -Uvh sunshare-latest.rpm`. TAR.GZ users should extract the archive to `/opt/sunshare/`, then run `sudo ./install.sh –migrate-config` to preserve settings.
**Step 5: Post-Installation Validation**
Restart the application and check the version number again. Test critical workflows:
– Generate a real-time energy production report.
– Trigger an automated grid export (if enabled).
– Validate API connections to inverters or battery systems.
Review the log files located in `C:\ProgramData\Sunshare\Logs` (Windows), `/var/log/sunshare` (Linux), or `~/Library/Logs/Sunshare` (macOS) for errors. Look for entries containing “WARN” or “ERROR” and cross-check them with the known issues in the release notes.
**Troubleshooting Common Update Issues**
– **Download Failures**: Clear your browser’s cache or use a VPN if regional restrictions block access.
– **Installation Rollbacks**: Occurs when prerequisite libraries are missing. Use the `sunshare-diagnostic-tool` (included in the installer) to identify missing dependencies.
– **Data Discrepancies**: If historical metrics appear inconsistent, reimport data backups using `File > Restore > Select Backup File`.
For mission-critical systems, schedule updates during low-activity periods and perform a full system backup using SUNSHARE’s built-in snapshot tool (**Tools > System Backup > Create Snapshot**). Always test non-production environments first if you’re managing large-scale deployments.
Remember: Updates don’t automatically reset custom configurations, but always document your settings before proceeding. If you encounter unresolved issues, the SUNSHARE support team provides live assistance during business hours through the portal’s chat interface.