SFTP Feature Product Bulletin - Revision history

GMalcom: /* See Also */

2025-01-30T15:49:20Z

GMalcom: /* Installation Details */

2025-01-30T15:48:56Z

Installation Details

← Older revision		Revision as of 15:48, 30 January 2025
Line 28:		Line 28:
	<p><br></p>		<p><br></p>
	===== Installation Details =====		===== Installation Details =====
	<p>Installation involves two steps: uploading the update payload (the three files noted earlier) and rebooting the APU102 to complete installation. The following shows step-by-step instructions for each of the supported upload methods.~~</p><p><br>~~</p><p>Three files are sent to the APU102:</p><p style="margin-left: 25px;" >INSTSFTP.EXE<br>F.BAT<br>ZIP.PSP~~</p><p><br>~~</p>		<p>Installation involves two steps: uploading the update payload (the three files noted earlier) and rebooting the APU102 to complete installation. The following shows step-by-step instructions for each of the supported upload methods.</p><p>Three files are sent to the APU102:</p><p style="margin-left: 25px;" >INSTSFTP.EXE<br>F.BAT<br>ZIP.PSP</p>
	====== Telnet ======		====== Telnet ======
	<p>If Telnet connections are permitted, the ZREC command may be used to upload the update payload. (Note: ZMODEM over SSH is not reliable in the current software.)~~</p><p><br>~~</p>		<p>If Telnet connections are permitted, the ZREC command may be used to upload the update payload. (Note: ZMODEM over SSH is not reliable in the current software.)</p>
	#Connect to the APU102 using a Telnet client such as Tera Term.		#Connect to the APU102 using a Telnet client such as Tera Term.
	#Login to Session #1 and use the C command to enter Change mode.		#Login to Session #1 and use the C command to enter Change mode.
	#For each of the three files, use the ZREC command and then send the file using ZMODEM transfer		#For each of the three files, use the ZREC command and then send the file using ZMODEM transfer
	#Reboot the APU102 (R command).~~<br><br>~~		#Reboot the APU102 (R command).

	====== FTP ======		====== FTP ======
	<p>If the FTP server on the APU102 is enabled, an FTP client such as WinSCP or FileZilla may be used to send the update.~~</p><p><br>~~</p>		<p>If the FTP server on the APU102 is enabled, an FTP client such as WinSCP or FileZilla may be used to send the update.</p>
	#Open an FTP session using the IP address for the APU102 being updated.		#Open an FTP session using the IP address for the APU102 being updated.
	#Login using credentials provided by Comet.		#Login using credentials provided by Comet.
Line 46:		Line 45:
	#Login to Session #1 and use the C command to enter Change mode.		#Login to Session #1 and use the C command to enter Change mode.
	#Reboot the APU102 (R command).		#Reboot the APU102 (R command).
	~~<p><br></p>~~
	====== SCP ======		====== SCP ======
	<p>If SSH is enabled, an SCP client such as WinSCP may be used to upload the update payload.</p>		<p>If SSH is enabled, an SCP client such as WinSCP may be used to upload the update payload.</p>
Line 57:		Line 55:
	#Login to Session #1 and use the C command to enter Change mode.		#Login to Session #1 and use the C command to enter Change mode.
	#Reboot the APU102 (R command).		#Reboot the APU102 (R command).
	~~<p><br></p>~~
	= Configuration =		= Configuration =
	<p>Configuration is customer specific. Consult Comet for guidance.</p>		<p>Configuration is customer specific. Consult Comet for guidance.</p>

GMalcom: /* Using WinSCP */

2025-01-30T15:44:11Z

Using WinSCP

← Older revision		Revision as of 15:44, 30 January 2025
Line 75:		Line 75:
	= Using WinSCP =		= Using WinSCP =
	<p>WinSCP is available for download on the internet:</p>		<p>WinSCP is available for download on the internet:</p>
			:[https://winscp.net/eng/index.php https://winscp.net/eng/index.php]<p><br></p>

	~~:[https://winscp.net/eng/index.php https://winscp.net/eng/index.php]<p><br></p>~~
	{\| style="border-collapse: collapse; width: 821px; margin-left: auto; margin-right: auto;" border="1px" cellpadding="4px"		{\| style="border-collapse: collapse; width: 821px; margin-left: auto; margin-right: auto;" border="1px" cellpadding="4px"
	\|-		\|-
	\| style="width: 811.266px; background-color: rgb(241, 196, 15);" \| <p>'''Disclaimer'''</p>		\| style="width: 811.266px; background-color: rgb(241, 196, 15);" \| <p>'''Disclaimer'''</p>
	\|-		\|-
	\| style="width: 811.266px;" \| <p>Comet Electronics makes no guarantees whatsoever regarding the suitability or security of any third-party software such as WinSCP, PuTTY, or TeraTerm. '''Use at your own risk.'''</p><p>It is up to the user to establish that software is genuine, properly licensed, and compliant with any company Information Technology (IT) policies.</p><p>'''Contact your IT department for guidance.'''</p>		\| style="width: 811.266px;" \| <p>Comet Electronics makes no guarantees whatsoever regarding the suitability or security of any third-party software such as WinSCP, PuTTY, or TeraTerm. '''Use at your own risk.'''</p>
			<p>It is up to the user to establish that software is genuine, properly licensed, and compliant with any company Information Technology (IT) policies.</p>
			<p>'''Contact your IT department for guidance.'''</p>
	\|}		\|}
	<p><br></p><p>WinSCP provides a graphical interface showing files on your PC and files on the remote system. Refer to WinSCP website for documentation. When uploading files to the APU102, ensure that /d/aei is the current directory (see illustration).</p><p><br></p><p>To connect with an APU102, you will need to know which protocols are supported: SCP, FTP, or both. Note: is it possible for an APU102 to be configured such that neither transfer protocol is supported.</p>~~<p>~~[~~Image of WinSCP interface~~]~~</p>~~
			<p><br></p>
			<p>WinSCP provides a graphical interface showing files on your PC and files on the remote system. Refer to WinSCP website for documentation. When uploading files to the APU102, ensure that /d/aei is the current directory (see illustration).</p>
			<p><br></p>
			<p>To connect with an APU102, you will need to know which protocols are supported: SCP, FTP, or both. Note: is it possible for an APU102 to be configured such that neither transfer protocol is supported.</p>
			[[image:img1738315039976.png\|653px\|center\|frameless]]

	= Authentication =		= Authentication =
	<p>When connecting to an SFTP server, the APU102 (the client) is required to provide a username and either a password or private key.</p><p>If a key is to be used, the private key is installed on the APU102 and specified in the BAT file.</p><p>The corresponding public key is installed on the server in the “authorized_keys” file. This is server-specific (e.g. OpenSSH configuration may not be the same as other server software).</p>		<p>When connecting to an SFTP server, the APU102 (the client) is required to provide a username and either a password or private key.</p><p>If a key is to be used, the private key is installed on the APU102 and specified in the BAT file.</p><p>The corresponding public key is installed on the server in the “authorized_keys” file. This is server-specific (e.g. OpenSSH configuration may not be the same as other server software).</p>

GMalcom: /* Procedure Complete.Description of Changes */

2025-01-30T15:41:45Z

Procedure Complete.Description of Changes

← Older revision		Revision as of 15:41, 30 January 2025
Line 67:		Line 67:
	#Verify that the events are correctly reported to the railroad host system.<br><br>		#Verify that the events are correctly reported to the railroad host system.<br><br>

	= Procedure Complete.~~<br><br>~~Description of Changes =		Procedure Complete.
			= Description of Changes =
	<p>This update includes:</p>		<p>This update includes:</p>
	*- Updated “curl.exe” package		*- Updated “curl.exe” package

GMalcom: /* Procedure Complete.Description of Changes */

2025-01-30T15:41:01Z

Procedure Complete.Description of Changes

← Older revision		Revision as of 15:41, 30 January 2025
Line 71:		Line 71:
	*- Updated “curl.exe” package		*- Updated “curl.exe” package
	*- Updated report delivery scripts (ACC files). The names of these files are the same is in previous configurations. The new scripts refer to BAT files that contain the commands using curl.exe to send files using SFTP protocol.<br>		*- Updated report delivery scripts (ACC files). The names of these files are the same is in previous configurations. The new scripts refer to BAT files that contain the commands using curl.exe to send files using SFTP protocol.<br>
	~~<p>''' '''</p>~~
	= Using WinSCP =		= Using WinSCP =
	<p>WinSCP is available for download on the internet:</p>		<p>WinSCP is available for download on the internet:</p>

GMalcom: /* Authentication */

2025-01-30T15:40:53Z

Authentication

← Older revision		Revision as of 15:40, 30 January 2025
Line 86:		Line 86:
	<p>When connecting to an SFTP server, the APU102 (the client) is required to provide a username and either a password or private key.</p><p>If a key is to be used, the private key is installed on the APU102 and specified in the BAT file.</p><p>The corresponding public key is installed on the server in the “authorized_keys” file. This is server-specific (e.g. OpenSSH configuration may not be the same as other server software).</p>		<p>When connecting to an SFTP server, the APU102 (the client) is required to provide a username and either a password or private key.</p><p>If a key is to be used, the private key is installed on the APU102 and specified in the BAT file.</p><p>The corresponding public key is installed on the server in the “authorized_keys” file. This is server-specific (e.g. OpenSSH configuration may not be the same as other server software).</p>

	~~<br><p><br></p>~~
	= Sample BAT File =		= Sample BAT File =
	<p>A sample BAT file is shown:</p><p><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 1 - site index</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 2 - filename</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 3 - site name</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT=MYRR2CN.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT2=MYRR 2CN.2.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTLOG=MYRR 2CN.%1.LOG</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT2%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM be sure to keep the trailing '/' on the URL if specifying a directory!</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >curl -k -u someuser:somepassword -T %2 sftp://10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM check error level</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if NOT %ERRORLEVEL% == 0 goto Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM create log file</span></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Success</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:success > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo curl completed successfully >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:CurlFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if %ERRORLEVEL% == 1 goto UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2% >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Curl had unexpected failure, check log file >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:End</span></p><p><br></p><p>The name of the BAT file must agree with the name of the ACC file. In other words, if the ACC file is called AEICRR1.ACC, the corresponding BAT file must be called AEICRR1.BAT. By convention, the log files (specified in the three set statements at the top of the BAT file have the same base filename (e.g.  AEICRR1) as the ACC file.</p><p>If a key file is used in place of a password, the “curl” command should look like this:</p><p><br></p><p class="mwt-heading" style="margin-left: 25px;" ><span style="color: rgb(35, 111, 161);" >curl -k –key keyfilename.key -T %2 sftp://username@10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span><br></p>		<p>A sample BAT file is shown:</p><p><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 1 - site index</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 2 - filename</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 3 - site name</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT=MYRR2CN.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT2=MYRR 2CN.2.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTLOG=MYRR 2CN.%1.LOG</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT2%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM be sure to keep the trailing '/' on the URL if specifying a directory!</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >curl -k -u someuser:somepassword -T %2 sftp://10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM check error level</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if NOT %ERRORLEVEL% == 0 goto Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM create log file</span></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Success</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:success > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo curl completed successfully >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:CurlFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if %ERRORLEVEL% == 1 goto UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2% >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Curl had unexpected failure, check log file >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:End</span></p><p><br></p><p>The name of the BAT file must agree with the name of the ACC file. In other words, if the ACC file is called AEICRR1.ACC, the corresponding BAT file must be called AEICRR1.BAT. By convention, the log files (specified in the three set statements at the top of the BAT file have the same base filename (e.g.  AEICRR1) as the ACC file.</p><p>If a key file is used in place of a password, the “curl” command should look like this:</p><p><br></p><p class="mwt-heading" style="margin-left: 25px;" ><span style="color: rgb(35, 111, 161);" >curl -k –key keyfilename.key -T %2 sftp://username@10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span><br></p>

GMalcom: /* Sample BAT File */

2025-01-30T15:40:34Z

Sample BAT File

← Older revision		Revision as of 15:40, 30 January 2025
Line 88:		Line 88:
	<br><p><br></p>		<br><p><br></p>
	= Sample BAT File =		= Sample BAT File =
	<p>A sample BAT file is shown:</p><p><br></p><p style="margin-left: 25px;" >REM 1 - site index</p><p style="margin-left: 25px;" >REM 2 - filename</p><p style="margin-left: 25px;" >REM 3 - site name</p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~set OUTPUT~~=~~MYRR2CN.%~~1.TXT</p><p style="margin-left: 25px;" >~~set OUTPUT2~~=~~MYRR 2CN.~~2.%1.TXT</p><p style="margin-left: 25px;" >set OUTLOG=MYRR 2CN.%1.LOG</p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" ~~>del %OUTPUT%</p~~><p style="~~margin-left~~: ~~25px~~;" >del %~~OUTPUT2~~%</p><p style="margin-left: 25px;" >~~del %OUTLOG%</p><p~~ style="~~margin-left~~: ~~25px~~;" ><br></p><p style="margin-left: 25px;" >~~REM be sure to keep the trailing '/' on the URL if specifying a directory!</p><p style~~="~~margin-left~~: ~~25px~~;" >~~curl -k -u someuser:somepassword -T~~ %~~2 sftp:~~//~~10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</p>~~<p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" ~~>REM check error level</p~~><p style="~~margin-left~~: ~~25px~~;" >~~if NOT %ERRORLEVEL% == 0 goto Failure~~</p><p style="margin-left: 25px;" ><~~br></p><p style="margin-left~~: ~~25px~~;" >~~REM create log file</p><p style="margin~~-~~left~~: ~~25px;" >:Success<~~/p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~echo Status:success > %OUTLOG%~~<~~/p><p~~ style="~~margin-left~~: ~~25px~~;" >~~echo Supporting info: >> %OUTLOG%~~</p><p style="margin-left: 25px;" >~~echo curl completed successfully >&gt~~; %~~OUTLOG~~%</p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~goto End~~<~~/p><p style~~="~~margin-left~~: ~~25px~~;" ><br></p><p style="margin-left: 25px;" ~~>:Failure</p~~><p style="~~margin-left~~: ~~25px~~;" ><br></p><p style="margin-left: 25px;" >~~:CurlFailure~~</p><p style="margin-left: 25px;" ><~~br></p><p~~ style="~~margin-left: 25px~~;" >echo Status:~~failure~~ > %OUTLOG%</p><p style="margin-left: 25px;" >echo Supporting info: >> %OUTLOG%</p><p style="margin-left: 25px;" ><~~br></p><p~~ style="~~margin-left~~: ~~25px~~;" >~~strfunc -sf "~~curl:" %~~OUTPUT2~~%</p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~if %ERRORLEVEL% == 1 goto UnknownFailure~~<~~/p><p~~ style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~strfunc -sf~~ "~~curl~~:" ~~%OUTPUT2% >> %OUTLOG%~~</p><p style="margin-left: 25px;" ><br></p><p style="margin-left: 25px;" >~~goto End~~<~~/p><p style~~="~~margin-left~~: ~~25px~~;" ><br></p><p style="margin-left: 25px;" >~~:UnknownFailure~~</p><p style="margin-left: 25px;" ><~~br></p><p style=~~"~~margin-left~~: ~~25px~~;" >echo Status:failure > %OUTLOG%</p><p style="margin-left: 25px;" >~~echo Supporting info~~: >> %OUTLOG%</p><p style="margin-left: 25px;" >~~echo Curl had unexpected failure, check log file >> %OUTLOG%</p>~~<p style="margin-left: 25px;" ><~~br></p><p~~ style="~~margin-left~~: ~~25px~~;" >:~~End~~</p><p><br></p><p>~~The name of the BAT file must agree with the name of the ACC file. In other words,~~ if the ACC file is called AEICRR1.ACC, the corresponding BAT file must be called AEICRR1.BAT. By convention, the log files (specified in the three set statements at the top of the BAT file have the same base filename (~~e.g.&nbsp~~; ~~AEICRR1) as the ACC file.</p~~><p>~~If a key file is used~~ in ~~place of a password, the “curl” command should look like this:~~</~~p><p><br></p><p class="mwt-heading"~~ >~~curl -k –key keyfilename.key -T %2 sftp://username@10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%'''~~<br>~~'''~~</p>		<p>A sample BAT file is shown:</p><p><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 1 - site index</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 2 - filename</span></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM 3 - site name</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT=MYRR2CN.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTPUT2=MYRR 2CN.2.%1.TXT</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >set OUTLOG=MYRR 2CN.%1.LOG</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTPUT2%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >del %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM be sure to keep the trailing '/' on the URL if specifying a directory!</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >curl -k -u someuser:somepassword -T %2 sftp://10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM check error level</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if NOT %ERRORLEVEL% == 0 goto Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(22, 145, 121);" >REM create log file</span></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Success</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:success > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo curl completed successfully >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:Failure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:CurlFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >if %ERRORLEVEL% == 1 goto UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >strfunc -sf "curl:" %OUTPUT2% >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >goto End</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:UnknownFailure</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Status:failure > %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Supporting info: >> %OUTLOG%</span></p><p style="margin-left: 25px;"><span style="color: rgb(35, 111, 161);" >echo Curl had unexpected failure, check log file >> %OUTLOG%</span></p><p style="margin-left: 25px;"><br></p><p style="margin-left: 25px;"><span style="color: rgb(186, 55, 42);" >:End</span></p><p><br></p><p>The name of the BAT file must agree with the name of the ACC file. In other words, if the ACC file is called AEICRR1.ACC, the corresponding BAT file must be called AEICRR1.BAT. By convention, the log files (specified in the three set statements at the top of the BAT file have the same base filename (e.g.  AEICRR1) as the ACC file.</p><p>If a key file is used in place of a password, the “curl” command should look like this:</p><p><br></p><p class="mwt-heading" style="margin-left: 25px;" ><span style="color: rgb(35, 111, 161);" >curl -k –key keyfilename.key -T %2 sftp://username@10.1.3.200/MYRR_TO_CNRR/ 1> %OUTPUT% 2> %OUTPUT2%</span><br></p>

	= Converting PuTTY Key to OpenSSH =		= Converting PuTTY Key to OpenSSH =
	<p>If a public-private key pair is creating using PuTTY, the private key file must be converted to a format usable to OpenSSH before installing on the APU102.</p>		<p>If a public-private key pair is creating using PuTTY, the private key file must be converted to a format usable to OpenSSH before installing on the APU102.</p>

GMalcom: /* Converting PuTTY Key to OpenSSH */

2025-01-30T15:04:11Z

Converting PuTTY Key to OpenSSH

@@ Line 91: / Line 91: @@
 = Converting PuTTY Key to OpenSSH =
 <p>If a public-private key pair is creating using PuTTY, the private key file must be converted to a format usable to OpenSSH before installing on the APU102.</p>
-{|
+[[image:img1738340988024.png|250px|left|frameless|Figure 1]]
-|-
+<p>PuTTY includes a utility called PuTTYgen to perform this function. This utility may be found in the PuTTY folder in the Windows Start menu (Figure 1).</p>
-| <div><p>Figure 1</p></div>
+<p>The procedure may be used to convert a previously created private key file (.PPK).</p>
-|}
 <p>PuTTY includes a utility called PuTTYgen to perform this function. This utility may be found in the PuTTY folder in the Windows Start menu (Figure 1).</p><p>The procedure may be used to convert a previously created private key file (.PPK).</p>
 == Procedure ==
-<p>After starting the PuTTYgen utility, load the private key (.PPK) file by clicking the “Load” button (Figure 2).<br><br></p><p>Figure 2</p><p>Once the file is loaded, select “Export OpenSSH Key” from the Conversions menu (Figure 3):</p><p><br></p><p>Figure 3</p>
+[[image:img1738344171249.png|492px|left|frameless|Figure 2]]
-{|
+<p>After starting the PuTTYgen utility, load the private key (.PPK) file by clicking the “Load” button (Figure 2).</p>
-|-
-| <div><p>Figure 4</p></div>
-|}
-<p>If prompted to save the key without a passphrase, click “Yes” (Figure 4).</p><p>Once the file is saved, it is uploaded to the APU102. The BAT file on the APU102 used to send reports using SFTP need to be edited to specify the appropriate key file (see provided [[#Sample BAT File|Sample BAT File]]).</p><p><br></p><p><br></p><p>'''&nbsp;'''</p><p>'''&nbsp;'''</p>
 ====== Open Source Licenses ======
-<p><br></p><p>CURL.EXE</p><p>COPYRIGHT AND PERMISSION NOTICE</p><p><br></p><p>Copyright (c) 1996 - 2010, Daniel Stenberg, &lt;daniel@haxx.se&gt;.</p><p><br></p><p>All rights reserved.</p><p><br></p><p>Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.</p><p><br></p><p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p><p><br></p><p>Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.<br></p>
+<p><br></p>

GMalcom: /* See Also */

2025-01-29T21:43:22Z

GMalcom: /* Procedure */

2025-01-29T21:43:03Z

Procedure

← Older revision		Revision as of 21:43, 29 January 2025
Line 101:		Line 101:
	\| <div><p>Figure 4</p></div>		\| <div><p>Figure 4</p></div>
	\|}		\|}
	<p>If prompted to save the key without a passphrase, click “Yes” (Figure 4).</p><p>Once the file is saved, it is uploaded to the APU102. The BAT file on the APU102 used to send reports using SFTP need to be edited to specify the appropriate key file (see provided [[#Sample BAT File]]).</p><p><br></p><p><br></p><p>''' '''</p><p>''' '''</p>		<p>If prompted to save the key without a passphrase, click “Yes” (Figure 4).</p><p>Once the file is saved, it is uploaded to the APU102. The BAT file on the APU102 used to send reports using SFTP need to be edited to specify the appropriate key file (see provided [[#Sample BAT File\|Sample BAT File]]).</p><p><br></p><p><br></p><p>''' '''</p><p>''' '''</p>

	'''<br>'''<p>''' '''</p>		'''<br>'''<p>''' '''</p>
	====== Open Source Licenses ======		====== Open Source Licenses ======
	<p><br></p><p>CURL.EXE</p><p>COPYRIGHT AND PERMISSION NOTICE</p><p><br></p><p>Copyright (c) 1996 - 2010, Daniel Stenberg, <daniel@haxx.se>.</p><p><br></p><p>All rights reserved.</p><p><br></p><p>Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.</p><p><br></p><p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p><p><br></p><p>Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.<br></p>		<p><br></p><p>CURL.EXE</p><p>COPYRIGHT AND PERMISSION NOTICE</p><p><br></p><p>Copyright (c) 1996 - 2010, Daniel Stenberg, <daniel@haxx.se>.</p><p><br></p><p>All rights reserved.</p><p><br></p><p>Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.</p><p><br></p><p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p><p><br></p><p>Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.<br></p>

← Older revision		Revision as of 15:49, 30 January 2025
Line 9:		Line 9:
	<p>This document covers installation of the SFTP update and describes authentication (login) to an SFTP server.</p>		<p>This document covers installation of the SFTP update and describes authentication (login) to an SFTP server.</p>
	==== See Also ====		==== See Also ====
	<p>To use public-private key authentication, see provided [[#Sample BAT File\|Sample BAT File]].~~</p><p><br>~~</p>		<p>To use public-private key authentication, see provided [[#Sample BAT File\|Sample BAT File]].</p>

	= Installation =		= Installation =

← Older revision		Revision as of 21:43, 29 January 2025
Line 9:		Line 9:
	<p>This document covers installation of the SFTP update and describes authentication (login) to an SFTP server.</p>		<p>This document covers installation of the SFTP update and describes authentication (login) to an SFTP server.</p>
	==== See Also ====		==== See Also ====
	<p>To use public-private key authentication, see provided [[#Sample BAT File]].</p><p><br></p>		<p>To use public-private key authentication, see provided [[#Sample BAT File\|Sample BAT File]].</p><p><br></p>

	= Installation =		= Installation =
	<p>The update payload is large so a fast and reliable link is required for installation.<br><br></p>		<p>The update payload is large so a fast and reliable link is required for installation.<br><br></p>