Auto FTP – Installation Guide

Installation

Requirements

  • Java JDK 1.6 installed (www.java.com)
  • A predefined VPN connection with BGC. Contact your bank for further information
  • Active Bank agreement FTP-via-Internet. Contact your bank for further information
  • Pre configured FTP Server

Supported OS and versions

  • Unix
  • Linux
  • Windows

The Installation package contains different files depending on the OS. Please control OS and version before installation.

Unix/Linux

  1. Open a command line (Bash)
  2. Unpack the installation package in a TMP directory.
  3. Choose installation directory, example: /opt/autoftp
  4. Make all .sh files runable: chmod +x *.sh
  5. Make sure that have the environment variable JAVA_HOME set to where the Java JDK is installed. E.g. JAVA_HOME=/opt/jdk1.6
  6. Run staging script: ./stage_autoftp.sh – Directory where the autoftp will be installed. – The tagret operating system. Use sunos for Solaris and linux for Linux. Example: ./stage_autoftp.sh /opt/autoftp linux
  7. Accept the license agreement
  8. After installation control the log to make sure the installation doesn’t contain errors.
  9. In the installation directory a service script, glassfish.sh, will be installed. This can be linked to from /etc/init.d/glassfish. (ln -s /opt/autoftp/glassfish.sh /etc/init.d/glassfish). Then it is possible to add it to the correct rc.x directories. Recommended use the OS’s tool to do this.

Windows

  1. Unpack the installation package in a temporary directory.
  2. Open a command line (cmd.exe) and change to the temporary directory.
  3. Choose a installation directory. Recommended without space in the path.
  4. Make sure that have the environment variable JAVA_HOME set to where the Java JDK is installed. E.g. JAVA_HOME=”c:\Program Files\Java\jdk1.6”
  5. Run the installation script: stage_autoftp.bat c:\pagero_autoftp
  6. Accept the license agreement.
  7. After installation control the log to make sure the installation doesn’t contain errors.

To register the AutoFTP as a service you use the following command:
java -jar GlassfishSvc.jar -i -n AutoFTP -d “C:\\pagero_autoftp\\glassfish”
Update the path to match the installation path entered to the installation script.

Recommended structure of Directory

  • One directory for every active Service (KI/LB/AG)
  • One Sent directory in which every successfully sent file is transferred to.

Examples:

  • /bgc/lb/tmp
  • /bgc/lb
  • /bgc/lb/sent
  • /bgc/ag/tmp
  • /bgc/ag
  • /bgc/ag/sent

All LB files are to be put into the right directory from the customers ERP. It is recommended that the files are written to a temporary directory and then moved to the directory that is configured to be scanned. Pagero automatically scan the directory for new files and further processing. Pagero will handle all files in the directory independent of their name or format, Pagero will change the name after BGCs requirement.

File access rights

Make sure the directory has the correct rights in order to handle files. Also verify that both the user that write the files and the user that runs the AutoFTP has sufficient rights.
NOTE: Incoming files from BGC is not fetched by Pagero or the customers FTP, but sent from BGC and therefore not handled by Pagero. To receive incoming files a separate FTP-server must be setup and configured. The incoming files directory should be decided between BGC and internal IT personnel and configured in the VPN settings.

Configuration

Open browser to configure the settings needed: http://localhost:8080/autoftp-web/p/customerDetails.iface

Enabled – If checkbox is enabled, all services will be automated checked for files every minute and processed.
Send Now – If checkbox not enabled, the button is used for manually process files in directory.

Add bank connection

  1. Enter BGC customer number: 123456 (Provided by BGC)
  2. Enter USERID: BF123456 (Provided by BGC)
  3. Enter PWD: xxxxxx (Provided by BGC, The password must be manually changed before the automated solution is started, min 6, max 8)
  4. Enter HMAC Key
  5. Production key = Provided by BGC
  6. Test Key = 1234567890ABCDEF1234567890ABCDEF
  7. Save

Add service

  • Services: One specific required for each separate service provided by BGC
  • Name: Only for internal use. Recommended same as service i.e. LB, KI or AG and if multiple companies “LB-CompanyA”)
  • Enabled: If checked, local directory is checked every minute.
  • Test mode: If checked, file is named with ZZ, BGCs code for test status.
  • Service Code: BGCs control (LB for LB, AG for AG, KI for KI), depending on file-type.
  • Local Directory: Directory to read for files (see Recommended Structure)
  • Input File Encoding: Pagero converts file encoding format to ISO-8859-1 for BGC Standard
  • Save

Log information

All logs are written to a log file server.log which is available in /glassfish/domains/domain1/logs.
To view the log via a web browser open the following URL: http://localhost:4848/

Login:

User: admin
Password: adminadmin

Click the button: Search log files (on the right)

Testing the flow

In order to test the flow, create a file according to the right service. For file specifications please visit BGC at www.bgc.se and control your files.

Example LB:
Place a correct LB file in the LB directory.

  • If enabled (settings) within a minute the file will be sent and transferred into the Sent directory – Control logs for confirmation.
  • If not enabled, press the Send button in the configuration site – Control logs for confirmation.