How to install

PDFgetX2 takes about 17 MB hard disk space including this manual, while a typical installation of IDL may take up to 200 MB disk space for either the licensed distribution or the virtual machine.

Linux/UNIX system

The file you should download is pdfgetx2-xxxx-yymmdd-linux.sh. After a complete download, go to the saved directory, and run command sh pdfgetx2-xx-yymmdd-linux.sh to initialize the installation. You will be asked where to put the source and the executable, just be sure that you have the right permission. For example, with my computer running Red Hat Linux 9.0, I got the following when installing the PDFgetX2 into a local directory.

[xiangyun@kneesave ~/tmp]$ sh ./pdfgetx2-beta-040416-linux.sh
Verifying archive integrity... All good.
Uncompressing pdfgetx2-beta-040416...................................................................
Current directory: /tmp/selfgz31649
Source directory : .
Welcome to installation of PDFgetX2 beta
The liscense statement will be show first, use SPACE to scroll!
Press ENTER to continue ...
PDFgetX2
Software License Agreement


By downloading and installing a copy of the PDFgetX2 Software and
Documentation, you agree to the following terms.

Notification of Copyright: PDFgetX2 is a proprietary product of
Michigan State University ("MSU") and is protected by copyright laws
and international treaty.  You (as "End User") must treat PDFgetX2
like any other copyrighted materials.  Copyright laws prohibit making
copies of the Software for any reason.  You may make copies of the
Documentation for use with a licensed version of the Software;
however, MSU notifications of copyright must be left intact.  If you
have any questions concerning this agreement, please contact the
Copyright Licensing Office, MSU, East Lansing, Michigan 48824
U.S.A. (517) 355-2186.

License: MSU grants End User the royalty-free, non-exclusive,
non-transferable right to use PDFgetX2 software for research or
educational purposes.  You may not redistribute, transfer, rent,
lease, sell, lend, sub-license, prepare derivative works, decompile,
or reverse-engineer the PDFgetX2 Software without prior express
written consent of MSU at the above address.

MSU retains title to PDFgetX2, including without limitation the
Software and Documentation.  End User agrees to use reasonable efforts
to protect the Software and Documentation from unauthorized use,
reproduction, distribution, or publication.  All rights not
specifically granted in this Agreement are reserved by MSU.

Warranty: PDFgetX2 Software and Documentation are provided "as is."
MSU MAKES NO WARRANTY, EXPRESS OR IMPLIED, TO END USER OR TO ANY OTHER
PERSON OR ENTITY.  SPECIFICALLY, MSU MAKES NO WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OF PDFGETX2
SOFTWARE OR DOCUMENTATION.  MSU WILL NOT BE LIABLE FOR SPECIAL,
INCIDENTAL, CONSEQUENTIAL, INDIRECT OR OTHER SIMILAR DAMAGES, EVEN IF
MSU OR ITS EMPLOYEES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.  IN NO EVENT WILL MSU LIABILITY FOR ANY DAMAGES TO END USER
OR ANY PERSON EVER EXCEED THE FEE PAID FOR THE LICENSE TO USE THE
SOFTWARE, REGARDLESS OF THE FORM OF THE CLAIM.

General: If any provision of this Agreement is unlawful, void, or for
any reason unenforceable, it shall be deemed severable from, and shall
in no way affect the validity or enforceability of the remaining
provisions of this Agreement. This Agreement shall be governed by
Michigan law.

Do you ACCEPT the above statement? (Y/N)y
Default installation directory: /usr/local
Default location for executeable: /usr/local/bin
Use different directories? (Y/N)y
NO space is allowed in the path!!!
New installation directory:/u24/xiangyun/softsrc
New executeable directory:/u24/xiangyun/bin
Start installation ...
      installation directory: /u24/xiangyun/softsrc
      location for executeable: /u24/xiangyun/bin
coping files ...
making link ...
installation successfully completed, thanks!
please type: pdfgetx2 to run the program

Windows

The file you should download is pdfgetx2-xxxx-yymmdd-win.exe. Double click on the file will start the self-installation. An example of this starting step is shown in Fig. A.2.2. Following the GUI instructions should complete the installation. A shortcut will be created on the desktop. The file extension .xhst will be associated with program PDFgetX2. The PDFgetX2 group is also inserted to your programs menu.

Figure A.1: The windows self-installer GUI

Others

If the above two methods do not apply for your system, the last resort is to manually install the program PDFgetX2, which is in fact also rather straightforward. In this case, you can either download the pdfgetx2-xxxx-yymmdd.tar.gz or pdfgetx2-xxxx-yymmdd.zip. Once the file downloading is done, unzip and/or untar all file into a directory where you want to install the program. The file pdfgetx2.sav should be able to run now, provided IDL is already installed.