Receive files with HULFT Transfer Application (via VPN)
Let's take a look at how to connect to an on-premises HULFT system and receive files (via VPN) with HULFT Transfer Application of HULFT Square.
-
This tutorial uses the transfer function of HULFT Transfer Application. When using the transfer function of HULFT Transfer services, refer to "Connect to on-premises HULFT and receive files with the HULFT Transfer service".
-
To use HULFT Transfer Application, a contract for the paid add-on HULFT Transfer Application is required.
Description
- Key points of receiving
-
When you receive with HULFT Transfer Application, you need to configure the transfer settings on HULFT Square to correspond with the settings of the sending-side host. Similarly, HULFT Square information must be set in the management information on the sending-side host.
Operation flow
Settings
(3) Add an external user who can connect to the VPN service
(4) Start up the HULFT Transfer App service
(5) Register the Host configuration
(6) Register the Host group information
(7) Register the Receive configuration
Transfer
Confirmation
Procedures
Before you use HULFT Transfer Application to receive files sent from a HULFT system in an on-premises environment, make sure these steps are complete:
- Prep on HULFT Square (receiving-side host)
-
-
Check the directory on the HULFT Square storage where you intend to upload a received file
-
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:
-
AppTransferReceiveConfigFullAccess
-
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 on-premises HULFT system (sending-side host)
-
-
Configure the system management information
In the HULFT system in the on-premises environment, prep the send files and configure the settings for the system management information for sending.
At this point, for the Host Name (host name of remote host) in the Host Information, set the DNS name of the VPC endpoint created with your environment.
Set U (UNIX) for Host Type.
-
Settings
-
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.
-
Select
> SERVICES > VPN.
-
On the VPN page, select Add.
-
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.
-
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.
-
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.
-
In step Summary, confirm that the settings are correct, and then select Finish.
-
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.
NoteIf 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
-
On the page displayed from
> SERVICES > VPN, select Information from the action menu for the VPN service that was started.
-
Select the link beside External VPN user that indicates the number of users.
-
On the VPN > VPN service name > External Users page that is displayed, select Add.
-
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.
-
In step Summary, confirm that the settings are correct, and then select Finish.
NoteAfter you add an external user, it may take some time until it's ready for use.
(4) Start up the HULFT Transfer App service
-
Select
> SERVICES > HULFT Transfer App.
-
On the HULFT Transfer App page, select Add.
-
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.
-
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
Specify a local host name.
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.
-
In step Summary, confirm the settings and select Finish.
-
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.
NoteIf 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.
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.
-
Select
> HULFT TRANSFER APP > Host Info.
-
On the Host Info page, select Add.
-
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
AppTransfer_host_01
Description
(Optional)
Select Next.
-
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.
-
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
WinServer
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.
-
In step Summary, confirm the settings and select Finish.
-
In the list on the Host Info page, check that the host that you set has been added.
-
For details of the screens displayed during the operation, refer to Host Info.
-
You can import the Host configuration (Host Information) settings.
For details, refer to Import the settings of the HULFT management information for HULFT Transfer Application.
(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.
-
Select
> HULFT TRANSFER APP > Host Group Info.
-
On the Host Group Info page, select Add.
-
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.
-
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.
-
In step Configuration, set the Host group information.
The following values are specified in this example:
Field name
Setting content (example)
Host group info
GROUP01
Description
(Optional)
Host name
WinServer
Select Next.
-
In step Summary, confirm the settings and select Finish.
-
In the list on the Host Group Info page, check that the Host group information that you set has been added.
-
For details of the screens displayed during the operation, refer to Host Group Info.
-
You can import the Host group information (Transfer Group Information) settings.
For details, refer to Import the settings of the HULFT management information for HULFT Transfer Application.
(7) Register the Receive configuration
Register the Receive 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.
-
Select
> HULFT TRANSFER APP > Receive Configs.
-
On the Receive Configs page, select Add.
-
In step General on the Receive Configs > Add New page, set the HULFT Transfer Application Receive configuration.
The following values are specified in this example:
Field name
Setting content (example)
Name
AppRcvConf
Description
(Optional)
Select Next.
-
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.
-
In step Configuration, set the information for receiving a file.
The following values are specified in this example:
Field name
Setting content (example)
Transfer name
RCVFILE01
Description
(Optional)
File to receive
/Ateam/data/rcvfile.txt
File receiving option
Replace
Error handling
Keep
EBCDIC encoding
Auto
Senders
GROUP01
Verify received file
Don't select.
Encryption key
(Optional)
Select Next.
-
In step Summary, confirm the settings and select Finish.
-
In the list on the Receive Configs page, check that the HULFT Transfer Application Receive configuration that you set has been added.
-
For details of the screens displayed during the operation, refer to Receive Configs.
-
You can import the Receive configuration (Receive Management Information) settings.
For details, refer to Import the settings of the HULFT management information for HULFT Transfer Application.
Create a script to be executed after receiving files.
For details about how to create projects and scripts, refer to Create a script that processes a CSV file.
-
Select
> APPLICATIONS > Installed > HULFT Transfer App.
-
On the HULFT Transfer App page, select the profile set with the Receive configuration.
-
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)
Select Next.
-
Select Test.
-
Confirm that "Test completed successfully" is displayed, and then select Apply.
Transfer
-
On the page displayed from
> SERVICES > VPN, select Information from the action menu for the VPN service that was started.
-
Copy the value of Endpoint.
-
Download the CA certificate from Certificate.
-
Configure VPN communication from the client you intend to use.
-
Start Manage computer certificates from the Control Panel.
-
Select Trusted Publisher > All Tasks > Import, and then import the CA certificate downloaded in step 3.
NoteThe extension of the downloaded CA certificate is .pem. If a .pem file is not displayed, change the settings so that all files are displayed.
-
Start the VPN settings from Settings.
-
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.
-
Connect to the VPN.
Perform a send from the on-premises side HULFT.
For the host name in the Host configuration, specify the endpoint, which you can obtain using the following steps:
-
After you start the HULFT Transfer App service, select Information from the action menu and open
> SERVICES > HULFT Transfer App > HULFT_App_01.
-
Copy the Endpoint displayed on the Network page from
> SERVICE EVENTS > HULFT Transfer App > HULFT_App_01.
Confirmation
(13) Check the execution results
-
Select
> SERVICE EVENTS > HULFT Transfer App.
-
On the Receive tab of the HULFT Transfer App page, select the transfer log with the file ID RCVFILE01.
-
Select Information from the action menu, and check the details of the receive results.
-
Select
> SERVICES > Storage.
-
Open the directory where the receive files are stored and check for the file you specified in the HULFT Transfer Application Receive configuration.
-
Check the execution results for the script executed after receiving in
> SERVICE EVENTS > HULFT Integrate if you need to.