Simply visit Helioviewer.org
However, if you wish to install the Helioviewer Project on your own machine this document has been created to aid you in this process.
First you will need to install all required packages. This guide has been designed to work with Ubuntu 20.04
sudo apt update;
sudo apt upgrade;
sudo apt install apache2 php7.4 php7.4-mysql php7.4-curl php-pear php-imagick php-mbstring php-bcmath php-redis libapache2-mod-php mysql-server redis-server imagemagick python3-mysqldb python-tk python3-tk python3-pip ffmpeg git libpng-dev libgsf-1-114 git ant
pip3 install sunpy glymur zeep bs4 drms lxml numpy scipy datetime pandas bokeh==2.2.1 matplotlib pathlib joblib
Clone the api repository into webroot usually located in “/var/www”
git clone https://github.com/Helioviewer-Project/api.git api.helioviewer.org
Clone the front-end repository into webroot usually located in “/var/www”
git clone https://github.com/Helioviewer-Project/helioviewer.org.git
cd into the helioviewer.org folder and run the following command to pull in project dependencies
git submodule update --init
Setup the Database
The next step is to process your JPEG 2000 (JP2) images and enter their information into the database for efficient querying. If you don’t already have a JP2 dataset, you can download a sample dataset, e.g.:
tar zxvpf sample-data.tgz -C /var/www/jp2
If the MySQL daemon is not already running, start it:
sudo service mysql start
Change to the “api/install” directory and run the Helioviewer installation script:
Follow the steps shown on screen. Processing the JPEG 2000 archive may take anywhere from several minutes to many hours depending on the size of the archives, and the number of files to be processed. For a small dataset like the sample one provided above, processing should only be a matter of minutes.
Kakadu binaries and shared libraries for 32-bit and 64-bit linux can be found in the install/kakadu directory. Select the appropriate archive based on your architecture and extract the files:
tar zxvpf Kakadu_v6_4_1-00781N_Linux-64-bit-Compiled.tar.gz
Next, copy the Kakadu shared libraries and binaries to a known path, e.g.:
sudo cp lib/* /usr/local/lib/
sudo cp bin/* /usr/local/bin
Update dynamic linker cache:
sudo -s # enter root shell
exit # exit root shell
Now try running one of the Kakadu tools to make sure everything was set up properly:
Create Caching/Logging Directories
In order to function properly, Helioviewer requires write-access to several directories. Tiles, screenshots, and movies are stored in a “cache” directory and logs are stored in a “log” directory. Additionally, if you plan to use a JPIP server in conjunction with Helioviewer, a “movies” directory must be created within the JPEG 2000 archive so that generated JPX files may be accessed over JPIP.
mkdir -p log cache jp2/movies
Enable Apache to write to the directories:
chgrp www-data log cache jp2/movies
chmod 755 log cache jp2/movies
Modify Config File
Both the front-end and back-end of Helioviewer.org use a single configuration file named “Config.ini”, in addition to a separate database configuration file, “Private.php.” Both of these files are located in the api/settings directory. Example files, “Config.Example.ini” and “Private.Example.php,” are provided which are intended to be used as a basis for your own configuration.
Copy or rename these example files to “api/settings/Config.ini” and “api/settings/Private.php”, respectively.
Modify the “Config.ini” file so that the information (filepaths, etc) accurately reflect your server configuration.
Modify the database credentials in the “Private.php” file with the values you entered in the installation GUI.
It is recommended to use a virtual host configuration within apache to direct requets to the api under a subdomain.
To test the installation, open your web browser of choice and navigate to the location where Helioviewer is installed. If you installed Helioviewer to /var/www/helioviewer, you can view the website at http://localhost/helioviewer/.