Transfer Sessions - hakakou/optiperl GitHub Wiki

OptiPerl uploads files two ways: Either by saving the file to a remote location from menu File, or when publishing a project. Both methods send files via FTP or Secure FTP, and the setup is done from the Remote transfer session dialog in menu "Tools".

A transfer session describes the server and parameter for uploading files, plus parameters when running a remote file.

Remote server fields

Session Name

Name of the session. This is used to identify the session in the project or opening/saving a remote file.

Type

Type of transfer session.

Server

Address of the server, for example ftp.mysite.com

Username

Username used to login

Password

Password to login.

Account

If your server needs an ACCT command, enter the account here. Usually not used.

Port

Port of the server, usually 21

Firewall settings

If you connect via a firewall, enter here the settings of it.

Remote running

The fields here affect running a remote file. Read more in running remote files.

Document Root

The path of the server that links to a URL address. This is usually just / (the root) or /htdocs.

Links to URL

The URL for calling files in the above path. For example http://www.mysite.com/

As an example, if you enter /htdocs as the document root and http://www.mysite.com/ as the URL, and you open the file in the path /htdocs/news/index.html , when pressing Run, optiperl will call http://www.mysite.com/news/index.html

Aliases

For many servers, entering the 2 above fields will be enough for the entire internet site. However your server might have additional paths that link to URL via aliases it has. For example apache with mod_perl does the following:

/perl/ Links to http://www.mysite.com/perl/

/cgi-bin/ Links to http://www.mysite.com/cgi-bin/

/htdocs/ Links to http://www.mysite.com/

This would need two additional aliases entered:

/perl/=http://www.mysite.com/perl/;/cgi-bin/=http://www.mysite.com/cgi-bin/

If you did not setup the above, then a file in /cgi-bin/ would no be able to be called from OptiPerl, since it is not a folder under /htdocs/

Shebang line

How the shebang line should look. This depends on the path to perl of your server. For example, enter here something like:

#!/bin/perl

Note that the shebang gets changed only the original has a shebang; It is never added.

Change when uploading

Whether to do the change to the shebang when uploading / downloading. This option is here so it can be easy to temporarily disable it.

Automatically convert version

Whether the version converter should convert your version to "SERVER" if you are uploading or publishing, and to version "LOCAL" when downloading from menu File / Open remote file.

Notes

To keep notes about the server.

Save passwords

If selected, the passwords for the server and firewall will be saved in OptiPerl's Application data folder. If this is deselected you will be prompted on each session of OptiPerl.

Under the database, there is a navigator for all the sessions in the database:

"+" Adds a new record

"-" Deletes a record

"Up" edits the selected record

"v" Saves changes from a previous edit

"x" Cancels changes from a previous edit