Send files with HULFT Transfer Application (via VPN)

Let's take a look at how to connect to an on-premises HULFT system and send files (via VPN) with HULFT Transfer Application of HULFT Square.

Note

Description

Key points of sending

When you send with HULFT Transfer Application, you need to configure the transfer settings on HULFT Square to correspond with the settings of the receiving-side host. Similarly, the settings for HULFT Square must be configured on the receiving-side host.

Procedures

(1) Preparation

Before you use a HULFT system in an on-premises environment to receive files that are sent from HULFT Transfer Application, make sure these steps are complete:

Prep on HULFT Square (sending-side host)
  • Check the directory on the HULFT Square storage where the file to be sent is stored

  • Install HULFT Transfer Application from App Square

  • Configure the HULFT Transfer Application policy

    Assign AppTransferServiceFullAccess to the HULFT Transfer App service administrator.

  • Configure the policies for the management information of HULFT Transfer Application

    Assign the following permissions to the administrator of the HULFT Transfer Application management information:

    • AppTransferSendConfigFullAccess

    • AppTransferHostInfoFullAccess

    • AppTransferHostGroupInfoFullAccess

  • Install VPN Service from App Square

  • Configure the VPN policy

    Assign VPNServiceFullAccess to the VPN service administrator.

  • Check the IP addresses of the users who are to be permitted access

Prep on the on-premises HULFT system (receiving-side host)
  • Configure the system management information

    In the HULFT system in the on-premises environment, configure the settings for the system management information for receiving.

    At this point, for Host Name (host name of remote host) in the Host Information, specify the hostname alias that is used in File Transfer in the HULFT Transfer App service.

    Set U (UNIX) for Host Type.

 

Settings

(2) Start up a VPN service

  1. After applying a policy for VPN Service to a user, press the F5 key to reload the screen.

    = Remarks =

    When the screen is reloaded, VPN appears in the navigation menu.

  2. Select > SERVICES > VPN.

  3. On the VPN page, select Add.

  4. In step General, set the fields as shown below, and then select Next.

    Field name

    Setting content (example)

    Name

    VPN_1

    Description

    (Optional)

    CPU

    1

    Memory

    2 GB

    Scalability

    1

    Assigned group

    Select the group with operation permissions.

  5. In step Parameters, set the fields as shown below, and then select Next.

    Field name

    Setting content (example)

    IP allowlist

    Enter an IP address (such as your own IP address) that is to be permitted access.

    Name

    Enter the name.

    Common name

    Enter the common name (server name).

    Organizational unit

    Enter the department name in the organization.

    Organization

    Enter the organization name.

    Locality

    Enter the address (name of the municipality) of the organization.

    State or province

    Enter the address (name of the state or province) of the organization.

    Country

    Enter the country name.

    Validity (in days)

    Enter the validity period of the VPN service.

  6. In step Service events, set the fields as shown below, and then select Next.

    Field name

    Setting content (example)

    Workspace to save

    Select a workspace for storing logs.

    Author

    Select a user who will be the author of log files.

  7. In step Summary, confirm that the settings are correct, and then select Finish.

  8. On the page displayed from > SERVICES > VPN, wait a few minutes for the VPN service to start and then confirm that appears for the status.

    Note

    If you configured the VPN service settings, it may take some time to apply the settings to the service.

(3) Add an external user who can connect to the VPN service

  1. On the page displayed from > SERVICES > VPN, select Information from the action menu for the VPN service that was started.

  2. Select the link beside External VPN user that indicates the number of users.

  3. On the VPN > VPN service name > External Users page that is displayed, select Add.

  4. In step General, set the fields as shown below, and then select Next.

    Field name

    Setting content (example)

    Name

    Enter the user name.

    Authentication

    Password

    Password

    Enter the password.

  5. In step Summary, confirm that the settings are correct, and then select Finish.

    Note

    After you add an external user, it may take some time until it's ready for use.

(4) Start up the HULFT Transfer App service

  1. Select > SERVICES > HULFT Transfer App.

  2. On the HULFT Transfer App page, select Add.

    Note

    If you have created a HULFT Transfer App service in Receive files with HULFT Transfer Application (via VPN), you can use the existing service.

    The setting for Hostname alias is important when a file is sent. Refer to step 3 and subsequent steps to set the field.

  3. In step General on the HULFT Transfer App > Add New page, specify the information for the HULFT Transfer App service that you want to create.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Name

    HULFT_App_01

    Description

    (Optional)

    CPU

    1

    Memory

    2 GB

    Scalability

    1

    Assigned group

    Select the group with operation permissions.

    Select Next.

  4. From step Network to step Service events, specify the following values:

    Field name

    Setting content (example)

    Network

    Receive Port No.

    Specify the receive port number.

    Observe daemon Port No.

    Specify the observe daemon port number.

    Inbound

    Secure connection type

    VPN

    Secure connection

    VPN_1

    Outbound

    Secure connection type

    VPN

    Secure connection

    VPN_1

    Transfer general

    MUX

    10

    DEMUX

    0

    Code Conversion

    Code encoding

    EUC-JP

    Japanese character set

    JIS83

    Key mapping for Tab

    Space

    Key mapping to KEIS Em-size space

    0x4040

    File Transfer

    Multi receiving threads for a file

    Wait

    Verify Host group Info

    Don't verify any

    Retry when the other peer exceeds DEMUX limit

    Off

    Policy in failing to clear/delete sending file

    Treated as failure in sending

    Dequeuing policy in resending queue

    Dequeue in case the record has the same transfer name and host info

    Maximum file size in receiving

    0

    Hostname alias

    HULFTSQUARE01

    Connection layer

    Retry count for establishing connection

    5

    Retry Interval

    20

    Retry count for auto resending

    0

    Socket timeout for sending/receiving

    3600

    Socket buffer size for sending

    0

    Socket buffer size for receiving

    0

    Socket timeout for observe daemon

    86400

    Transferring strategy

    Send/Receive: Speed

    Security

    Mandate longer encryption key length

    Off

    Advanced

    Timeout on transmit request

    60

    Timeout on job execution

    999999

    Threshold of recording lines to delete logs

    0

    Reporting

    Trace log format

    ver.8

    Reduce log size

    Off

    Trace log level

    Info

    Service events

    Workspace to save

    Team A

    Author

    Select a workspace owner.

  5. In step Summary, confirm the settings and select Finish.

  6. On the page displayed from > SERVICES > HULFT Transfer App, wait a few minutes for the HULFT Transfer App service (HULFT_App_01) to start and then confirm that appears for the status.

    Note

    If you configured the HULFT Transfer App service settings, it may take some time to apply the settings to the service.

(5) Register the Host configuration

Register the Host configuration in HULFT Square.

You can also output the on-premise environment settings using the Management Information Parameter File Generation command and then import them using HULFT Transfer Migration.

Note

You need to specify the IP address of the VPN client as the name.

For details on the steps, refer to Import the settings of the HULFT management information for HULFT Transfer Application.

 

This section describes the steps for registering HULFT management information in HULFT Square.

  1. Select > HULFT TRANSFER APP > Host Info.

  2. On the Host Info page, select Add.

  3. In step General on the Host Info > Add New page, set the HULFT Transfer Application Host configuration (remote host information).

    This example specifies values in the case when the on-premises HULFT system is Windows. In cases other than Windows, change the values according to the type of use.

    Field name

    Setting content (example)

    Name

    Enter the IP address of the VPN client.

    Description

    (Optional)

    Select Next.

  4. In step Profile, set the information for the profile.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Profile

    Choose a profile.

    Select Next.

  5. In step Configuration, set the information for the remote host.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Host name

    Enter the IP address of the VPN client.

    Description

    (Optional)

    Host type

    Win/NT

    Code encoding

    UTF-8

    Japanese character set

    JIS83

    Receive port

    Specify the receive port number.

    Protocol version 7 as Primary use

    Don't select.

    MUX

    0

    Accept send requests

    Select.

    Select Next.

  6. In step Summary, confirm the settings and select Finish.

  7. In the list on the Host Info page, check that the host that you set has been added.

= Remarks =

(6) Register the Host group information

Register the Host group information in HULFT Square.

You can also output the on-premise environment settings using the Management Information Parameter File Generation command and then import them using HULFT Transfer Migration.

For details on the steps, refer to Import the settings of the HULFT management information for HULFT Transfer Application.

  1. Select > HULFT TRANSFER APP > Host Group Info.

  2. On the Host Group Info page, select Add.

  3. In step General on the Host Group Info > Add New page, set the HULFT Transfer Application Host group information.

    Field name

    Setting content (example)

    Name

    AppTransfer_group_01

    Description

    (Optional)

    Select Next.

  4. In step Profile, set the information for the profile.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Profile

    Choose a profile.

    Select Next.

  5. In step Configuration, set the Host group information.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Host group info

    GROUP02

    Description

    (Optional)

    Host name

    Enter the IP address of the VPN client.

    Select Next.

  6. In step Summary, confirm the settings and select Finish.

  7. In the list on the Host Group Info page, check that the Host group information that you set has been added.

= Remarks =

(7) Register the Send configuration

Register the Send configuration in HULFT Square.

You can also output the on-premise environment settings using the Management Information Parameter File Generation command and then import them using HULFT Transfer Migration.

For details on the steps, refer to Import the settings of the HULFT management information for HULFT Transfer Application.

 

This section describes the steps for registering HULFT management information in HULFT Square.

  1. Select > HULFT TRANSFER APP > Send Configs.

  2. On the Send Configs page, select Add.

  3. In step General on the Send Configs > Add New page, set the HULFT Transfer Application Send configuration.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Name

    AppSndConf

    Description

    (Optional)

    Select Next.

  4. In step Profile, set the information for the profile.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Profile

    Choose a profile.

    Select Next.

  5. In step Configuration, set the information for sending a file.

    The following values are specified in this example:

    Field name

    Setting content (example)

    Transfer name

    SNDFILE01

    Description

    (Optional)

    File to send

    /Ateam/data/sndfile.txt

    File type

    Text

    Compression type

    DEFLATE

    Compression block size

    0

    DEFLATE compressing strategy

    Standard

    Code Conversion

    None

    EBCDIC encoding

    Auto

    Send File Mode

    Keep

    Receivers

    GROUP02

    Transmitting time interval

    0

    Transfer task priority

    50

    Add shift code in code conversion for MF-IBMi

    On

    Encryption key

    (Optional)

    Select Next.

  6. In step Summary, confirm the settings and select Finish.

  7. In the list on the Send Configs page, check that the HULFT Transfer Application Send configuration that you set has been added.

= Remarks =

(8) Create a script for executing a send

Create the script necessary to execute a send.

For details about how to create projects and scripts, refer to Create a script that processes a CSV file.

  1. Select > APPLICATIONS > Installed > HULFT Transfer Application.

  2. Select Clone & Edit from the action menu.

  3. Enter HULFT Transfer Application Snd for New application name and select OK.

  4. Select Edit Script from the action menu in Contained scripts and depended resources.

  5. Launch Designer, and from the Tool palette, drag HULFT > HULFT Transfer App > Send File onto the script canvas.

  6. Select AppSndConf in Send config. Set script variables as needed.

  7. Select Tools > Option and specify HULFT_App_01 for Specify HULFT Transfer service for execution.

  8. Select OK.

  9. Select Save project.

(9) Set the application

  1. Select > APPLICATIONS > All > HULFT Transfer Application Snd.

  2. On the HULFT Transfer Application Snd page, select the profile in which you have set the HULFT Transfer Application Send configuration.

  3. Select Configure.

    The following values are specified in this example:

    Field name

    Setting content (example)

    HULFT Transfer app Service

    HULFT_App_01

    Integrate service

    Select an Integrate service.

    Receive configs

    Select 0 configs selected, and then select AppRcvConf from the list of displayed Receive configurations.

    Transfer name

    (Appropriate value)

    Host info

    (Appropriate value)

    Status code

    (Appropriate value)

    Detail code

    (Appropriate value)

    File name

    (Appropriate value)

    File size

    (Appropriate value)

    Start time

    (Appropriate value)

    End time

    (Appropriate value)

    msg0

    (Appropriate value)

    msg1

    (Appropriate value)

    Script

    Selecting a script will also select one or more Send configurations in Transfer Configs.

    Select Next.

  4. Select Test.

  5. Confirm that "Test completed successfully" is displayed, and then select Apply.

 

Transfer

(10) VPN connection

  1. Select > SERVICES > VPN to open the VPN_1 page.

  2. Copy the value of Endpoint.

  3. Configure VPN communication from the client you intend to use.

  4. Start Manage computer certificates from the Control Panel.

  5. Select Trusted Publisher > All Tasks > Import, and then import the CA certificate downloaded in step 3.

    Note

    The extension of the downloaded CA certificate is .pem. If a .pem file is not displayed, change the settings so that all files are displayed.

  6. Start the VPN settings from Settings.

  7. On the Add a VPN connection page, set the fields as shown below.

    Field name

    Setting content (example)

    VPN provider

    Windows (built-in)

    Server name or address

    Specify the host name copied in step 2.

    VPN type

    IKEv2

    User name

    Specify the user name of the VPN connection user who is set in HULFT Square.

    Password

    Specify the password of the VPN connection user who is set in HULFT Square.

  8. Connect to the VPN.

(11) Deploy the application

  1. On the page displayed from > APPLICATIONS > Installed > HULFT Transfer App, confirm the settings that have been configured.

  2. Specify the combination of settings that you created in (5) , (6) , and (7) in the profile, and select Deploy.

(12) Execute a send

If you have set an application trigger, a send is executed when the trigger condition is met.

If you want to try out transferring, you can also execute a send by directly executing the script created in step (8) .

 

Confirmation

(13) Check the execution results

  1. Select > SERVICE EVENTS > HULFT Transfer App.

  2. On the Receive tab of the HULFT Transfer App page, select the transfer log with the file ID SNDFILE01.

  3. Select an event to check the details of the send results and script execution results.

  4. Check the script execution results if you need to.

(14) Check the receive file

  1. In the on-premises HULFT, check that the file has been received.

  2. Check the Receive Log if you need to.