Guide to Upgrade SolarSoft(SSW): Difference between revisions

From EOVSA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
This guide compiles all the (scattered) steps to upgrade SSW taken from different sources.
SSW upgrade using passive_ftp was stopped in August 2019. The current way to upgrade SSW is to use the WGET executable. If you have done an update on SSW since August 2019 and your system already has WGET, any further upgrade can be made by directly following the steps underlined [https://hesperia.gsfc.nasa.gov/rhessi3/docs/ssw_update_help.html here]. For Linux and MacOS you can check if you already have WGET by typing the command "which wget" in the bash shell.


SSW upgrade using passive_ftp was stopped in August 2019. The current way to upgrade SSW is to use the WGET executable. If you have done and update on SSW since August 2019 and your system already has WGET, any further upgrade can be made by directly following the steps underlined [https://hesperia.gsfc.nasa.gov/rhessi3/docs/ssw_update_help.html here]. For Linux and MacOS you can check if you already have WGET by typing the command "which wget" in the bash shell.


If your system was not updated since August 2019, follow the steps below:
If your system was not updated since August 2019, follow the steps below:
Line 9: Line 10:
'''USING HOMEBREW'''
'''USING HOMEBREW'''


To install homebrew, type the following command in the bash shell:
To install homebrew, type the following command in the terminal:
<pre style="background-color: #FCEBD9">
<pre style="background-color: #FCEBD9">
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Line 28: Line 29:
</pre>
</pre>


==== 2. Update SSW to use wget ====
==== 2. Prepare SSW to use wget for the first time ====
* Go to [http://www.lmsal.com/solarsoft/] and scroll all the way down to the SSW installation form.
* For "Installation Type", select "Upgrade Existing".
* For "Transfer Protocol", select "curl".
* Specify the existing path to SSW on your computer. (You can find it in your ~/.bashrc or ~/.cshrc)
* Click on "Generate Installation Script" and download it.
* If you are in the bash shell, please change to csh or tcsh,
<pre style="background-color: #FCEBD9">
% tcsh
Execute the script using the C-Shell
% csh -f scriptname
</pre>
 
==== 3. Upgrade SSW ====
* While in SSWIDL type:
<pre style="background-color: #FCEBD9">
ssw_upgrade, /loud , /spawn
</pre>
This will update all the SSW branches listed in the SSW_INSTR environment variable (as well as their dependencies, and always includes gen and packages/binaries). This most likely will not update every branch in your SSW tree since you probably run SSW with a subset of branches activated.
* To upgrade specific branches, type for example
<pre style="background-color: #FCEBD9">
ssw_upgrade, /lasco, /spawn
</pre>
 
===== Possible Errors =====
* '''Error: bash:wget command not found''': Indicates that wget was installed using bash and csh/tcsh is not able to locate it. To resolve, simply give the path to wget in the upgrade command
<pre style="background-color: #FCEBD9">
ssw_upgrade, /loud, /spawn, wget = 'path/to/wget'                         
</pre>
 
* '''RD_TFILE: No file: /usr/local/ssw/site/mirror/ssw_upgrade.mirror''': check if the "''/spawn''" keyword has been missed
 
* '''Other errors with WGET ''': Sometimes using an older version of wget gives errors during SSW_upgrade, in this case add the keyword "''/lmsal''" to the upgrade command. This allows use of older wget versions.

Revision as of 22:01, 5 April 2022

This guide compiles all the (scattered) steps to upgrade SSW taken from different sources. SSW upgrade using passive_ftp was stopped in August 2019. The current way to upgrade SSW is to use the WGET executable. If you have done an update on SSW since August 2019 and your system already has WGET, any further upgrade can be made by directly following the steps underlined here. For Linux and MacOS you can check if you already have WGET by typing the command "which wget" in the bash shell.


If your system was not updated since August 2019, follow the steps below:

MacOS

In order to perform the upgrade, you must be the owner of the SSW tree.

1. Installing wget

USING HOMEBREW

To install homebrew, type the following command in the terminal:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Once homebrew is installed, you can simply install wget by using the following command:

brew install wget

USING MacPorts

Alternatively, wget can also be installed using MacPorts. Directions to install MacPorts for specific OS versions are given here After installation, the following command will install wget:

sudo port install wget

2. Prepare SSW to use wget for the first time

  • Go to [1] and scroll all the way down to the SSW installation form.
  • For "Installation Type", select "Upgrade Existing".
  • For "Transfer Protocol", select "curl".
  • Specify the existing path to SSW on your computer. (You can find it in your ~/.bashrc or ~/.cshrc)
  • Click on "Generate Installation Script" and download it.
  • If you are in the bash shell, please change to csh or tcsh,
% tcsh
Execute the script using the C-Shell 
% csh -f scriptname

3. Upgrade SSW

  • While in SSWIDL type:
ssw_upgrade, /loud , /spawn

This will update all the SSW branches listed in the SSW_INSTR environment variable (as well as their dependencies, and always includes gen and packages/binaries). This most likely will not update every branch in your SSW tree since you probably run SSW with a subset of branches activated.

  • To upgrade specific branches, type for example
ssw_upgrade, /lasco, /spawn
Possible Errors
  • Error: bash:wget command not found: Indicates that wget was installed using bash and csh/tcsh is not able to locate it. To resolve, simply give the path to wget in the upgrade command
ssw_upgrade, /loud, /spawn, wget = 'path/to/wget'                          
  • RD_TFILE: No file: /usr/local/ssw/site/mirror/ssw_upgrade.mirror: check if the "/spawn" keyword has been missed
  • Other errors with WGET : Sometimes using an older version of wget gives errors during SSW_upgrade, in this case add the keyword "/lmsal" to the upgrade command. This allows use of older wget versions.