Cashflow Analytics for Global Structured Finance

Unix Instructions

Installing autodnld

This page is designed to be a quick summary of a routine installation with no special issues. If you have more questions, contact Intex at autodnld_help@intex.com.

Before you install autodnld, you will need a user name and password for the Intex shipping system. You will also need some information about your mailserver if you are planning on using autodnld's email functionality. Please see the email section of the manual for more information.

Instructions for installing autodnld are below. The instructions were written for a computer running CentOS. CentOS is a Fedora based system, so notes are provided to help Debian based users where the distributions vary. You may need to tailor some of the commands to your specific distribution. Since each distribution is different, some of the commands used in these instructions may not be available on your distribution. These instructions may also include steps that you do not need to follow.

Install Programs

  1. Your system will need the basic packages required to build perl modules. Fedora users will need to determine what the requirements are for their distribution. Debian users should use the build-essential package.
  2. Install Perl:
    yum install perl
    More instructions are available at https://learn.perl.org/installing/unix_linux.html
  3. Install CPAN:
    yum install perl-CPAN
  4. One of the perl modules needs a C compiler:
    yum install gcc
    Dbstatus is compiled for 32 bit systems, so on 64 bit systems you will need to add 32 bit libraries.
    yum -y install glibc.i686
    Debian users will need to install gcc-multilib.
  5. One of the perl modules needs openssl:
    yum install openssl-devel
    Debian users should install libssl-dev.
  6. Autodnld needs gzip, unzip, and tar. Unzip isn't included in CentOS so install it using:
    yum install unzip
  7. Some program to download the compressed autodnld distrbition. These instructions uses wget:
    yum install wget

Connect using CURL

If you want to use CURL to connect to Intex, you will not need any further PERL modules. You will need to configure CURL during the installation - documentation here
Otherwise, you will need to install IO::Socket::SSL
IO::Socket::SSL is dependent on Net::SSLeay. Depending on your distribution, you may need to export your openssl include/library files. Some Linux/Unix users have run into this issue. By default the include/library files are stored in /usr/local/ssl/include and /usr/local/ssl/lib. You will need to
export OPENSSL_LIB=/usr/local/ssl/lib export OPENSSL_INCLUDE=/usr/local/ssl/include
before you install IO::Socket::SSL.

Run
cpan install IO::Socket::SSL
to install IO::Socket::SSL. This will also configure CPAN.

Install autodnld

  1. Create a directory to store autodnld, and then change into that directory.
    mkdir /home/autodnld cd /home/autodnld
  2. Download the compressed autodnld files:
    wget https://www.intex.com/autodnlddownload/unix/SOMEFILEPATH.tar.gz
    You can find the possible URLs on the Download page.
  3. Unzip:
    gzip -d autodnld_LINUX.tar.gz
  4. Untar:
    tar xvf autodnld_LINUX.tar
  5. Change into the new scripts directory. Autodnld needs to be run from the scripts directory, so you will need to change into this directory on scheduled runs.
    cd scripts
  6. Add symbolic links for gzip, unzip, tar, and perl. You can use the "which" command to find the right location to link. For example,
    which gzip
    Once you have the locations:
    ln -s /bin/gzip gzip ln -s /usr/bin/unzip unzip ln -s /bin/tar tar ln -s /usr/bin/perl perl
  7. Autodnld is designed to run using the root account. You may need to set the root password and switch into the account before running autodnld. To set the root password, run:
    sudo passwd root
    and then switch to the root account by running:
    su
  8. Configure autodnld by running:
    perl autodnld.pl -config
  9. Confirm that autodnld works:
    perl autodnld.pl -t
    If you run into issues here, you may need to add executable permission to autodnld files or add https=1 to scripts/autodnld.ini.
  10. Run
    perl autodnld.pl
    to download your first shipment.
  11. Schedule autodnld in crontab. Intex recommends running autodnld every day in the evening if you receive daily shipments.
Intex Home