Migrating from AIJ v5.x to v6.x

[karenacollins]

AstroImageJ has migrated to a new platform as of version 6.x. The new platform consists of several underlying changes that will somewhat change the user experience.

First, the AstroImageJ website is migrating away from the University of Louisville website that has hosted AIJ for over a decade (thank you to Professor John Kielkopf for maintaining the hosting at UofL!). The new website at https://astroimagej.com is hosted on GitHub for longevity and sustainability. You should plan to migrate as soon as it is practical since the UofL website will eventually not be supported. If you find that your version 5 updates are no long working, it is likely that the UofL website might be no longer supported at that time. In that case, you will need to uninstall AIJ version 5, and download a new install package for v6 from https://astroimagej.com/#download.

However, we recommend that you use the AIJ update capability now to move to version 6 because it will preserve your memory setting and any custom observatories that you have set up (as well as preferences). If you are updating from version 5.x, you will need to first update to version 5.6.0. This uses the old update process. Once you restart AIJ after the update to v5.6.0, you will be immediately notified that you should run another update. Version 5.6.0 uses the new update process to update to version of 6.x. Once you update to v6.x, you will not be able to downgrade to versions 5.x. However, for now the version 5.6 new installation packages are still available on the UofL website if you run into a problem.

A second change to the new platform enhances the capability and security of new install packages and the update capability. The new packages use multiple levels of cryptographic signing. To support the new capabilities and signing, the new update process effectively implements a full installation, but avoids the user having to access the website and go through the process manually. The new update process will require a few more clicks on some platforms, and even a password entry on Mac computers, but we believe the additional steps are justified to support the increase in capabilities and security.

If you encounter a problem updating to v6, please post us a message here giving as much detail about where you were in the process, and what went wrong at the step where it broke (and of course the OS you are running).

If you for some reason find that you are unable to use AIJ after an update, version 6 new install packages  are available at https://astroimagej.com/#download. If you find that you have to install version 6 for the first time using a new install package (rather than through the update facility), after previously running v5, preferences will be maintained, but you may need to re-set-up any custom observatory entries that you have, as well as any custom memory set up that you have entered.

Karen

[cduston]

I think my update is hanging on Linux:

$ lsb_release -a
No LSB modules are available.
Distributor ID:	Pop
Description:	Pop!_OS 22.04 LTS
Release:	22.04
Codename:	jammy

 I got the message about updating to 6.X, and then got this in my terminal:

$ Attempt 1 of 5...
Computed SHA256: 871bb1e4461058b43f6043b291167c74816d18fc9e60e8057a92e9d0474c7244
Expected SHA256: 871bb1e4461058b43f6043b291167c74816d18fc9e60e8057a92e9d0474c7244
SHA256 matches expected.
Attempt 1 of 5...
Computed SHA256: 0acd6842711a870f419fe4569a557647e01d6d7ef2abc05b2b623f45c82e6a29
Expected SHA256: 0acd6842711a870f419fe4569a557647e01d6d7ef2abc05b2b623f45c82e6a29
SHA256 matches expected.
Saving installer: /tmp/aij-updater/installer.tgz
Beginning linux update
Working folder: /tmp/aij-updater

But now nothing is happening. That folder was written:

$ ls -lat aij-updater/
total 106284
drwxrwxrwt 18 root    root        28672 Feb 19 12:43 ..
-rw-rw-r--  1 cduston cduston 108786205 Feb 19 12:43 installer.tgz
drwx------  2 cduston cduston      4096 Feb 19 12:43 .
-rwxrwxr-x  1 cduston cduston      1142 Feb 19 12:42 updateScript.sh

But it's now 1:02 and nothing else has happened. Nothing in top that screams astroimagej or Java.

Should I just try to remove it and download a fresh version 6 installer? Or maybe dpkg -i that .tgz?

[keastrid]

Hi cduston,

I don't believe we require LSB.

As the migration script first deletes the existing AIJ installation, and I assume you still have yours, it probably got stuck waiting for AIJ to shutdown or otherwise failed to delete the existing installation.

The migration script writes a log file to either $XDG_STATE_HOME/astroimagej/logs/elevator.log or ~/.local/state/astroimagej/logs/elevator.log. It is probably in the latter location for you. If you could share that with us, we might be able to tell you what is wrong.

If you want to do the installation manually, this is what the migration script does:
- Deletes the existing AIJ installation
- Unpacks the tar file where the previous installation was with tar --strip-components=1 -xzf "$TGZ" -C "$DEST"
- Creates a symlink for $installation_folder/AstroImageJ to $installation_folder/bin/AstroImageJ
  - This step is optional and done to keep other user links to the AIJ executable working
- Relaunches AIJ

The downloaded /tmp/aij-updater/installer.tgz is the same file you would have gotten from the website, so you can use that if you don't want to redownload. Only the migration scripts differ.

See our linux installation instructions.

Let us know if you have any questions or encounter any other problems.

[cduston]

Hi Karen,
    Thanks for responding so fast - I refreshed the pages a few times and didn't see your reply, apologies. I've been using the old version since then fine.

Let's try to debug the migration. I'll start the update again and see if those logs are created.

So this time I watched top - I saw a java entry there while the AIJ window was open, checking and downloading things. When AIJ closed, the java entry vanished and nothing appeared there related to the process. At some point the terminal process appears to hang again:

$ Attempt 1 of 5...
Computed SHA256: 871bb1e4461058b43f6043b291167c74816d18fc9e60e8057a92e9d0474c7244
Expected SHA256: 871bb1e4461058b43f6043b291167c74816d18fc9e60e8057a92e9d0474c7244
SHA256 matches expected.
Attempt 1 of 5...
Computed SHA256: 0acd6842711a870f419fe4569a557647e01d6d7ef2abc05b2b623f45c82e6a29
Expected SHA256: 0acd6842711a870f419fe4569a557647e01d6d7ef2abc05b2b623f45c82e6a29
SHA256 matches expected.
Saving installer: /tmp/aij-updater/installer.tgz
Beginning linux update
Working folder: /tmp/aij-updater

i.e. it looks like it's hanging. If I look for those two log locations (different terminal)

$ echo $XDG_STATE_HOME

cduston@CygnusX1:/etc/systemd/sleep.config.d$ ls ~/.local/state/astroimagej
ls: cannot access '/home/cduston/.local/state/astroimagej': No such file or directory

it doesn't appear they are being created. If I hit enter (back in the original terminal) I get

Working folder: /tmp/aij-updater

[2]+  Done                    astroimagej
cduston@CygnusX1:/etc/systemd/sleep.config.d$ 

If I try to run astroimagej again, I get back to 5.6 and it asks to update.

What do you think, any thoughts or should I do a manual install?

[karenacollins]

Hi cduston,

If we are holding you up, you could go ahead with the manual installation of version 6.

If you have time to help us do some debugging, we'd be glad to take advantage of your generosity, which may in turn help other AIJ users that run into the same migration issues. We unfortunately have not been able to duplicate this on our machines.

If you want to continue, please create a script with the content between the dashed lines below and name it updateScript.sh, and then run the following command after replacing "/path/to/aij/installation" with the correct path for your machine:

updateScript.sh 0 /tmp/aij-updater/installer.tgz /path/to/aij/installation

Then send us your console output from the script, and check the log file locations again and send us any content if a file is found.

Thank you,
Karen

script contents (between dashed lines):
-------------------------
 #!/usr/bin/env bash

echo "Setting up elevator"

# Get log file
# Use XDG_STATE_HOME if available, else ~/.local/state
xdg_state="${XDG_STATE_HOME:-}"
if [[ -n "$xdg_state" ]]; then
  state_base="$xdg_state"
else
  home="${HOME:-.}"
  state_base="$home/.local/state"
fi

# Convention: ~/.local/state/astroimagej/logs/elevator.log
elevator_log="$state_base/astroimagej/logs/elevator.log"
rm -f "$elevator_log"
exec >>"$elevator_log" 2>&1

echo "Starting AIJ elevator"

PID_TO_WAIT="$1"
TGZ="$2"
DEST="$3"

# Delete old version
echo "Removing old installation..."
rm -rf "$DEST"

echo "Creating install folder..."
mkdir -p "$DEST"
echo "Unpacking AIJ..."
tar --strip-components=1 -xzf "$TGZ" -C "$DEST"

if [[ ! -f "$DEST/AstroImageJ" ]]; then
  echo "Creating symlink..."
  ln -s "$DEST/bin/AstroImageJ" "$DEST"
fi

# Rerun AIJ
echo "Relaunching AIJ..."
$DEST/bin/AstroImageJ
------------------------------