OpenSSH on IBM i (AS400) – some hints


I was asked to repost this article from our old wiki. So here it is – with the content back from 2011. If I find some time I’ll post how to restrict ssh access to users with a predefined group profile. Or better let me know if you are interested in it ūüôā


Install Portable App Solutions Environment i5/OS PASE which is shipped as i5/OS option 33.


Install IBM Portable Utilities for i5/OS (*BASE) and OpenSSH, OpenSSL, zlib Libs (Opt 1) from your i5/OS Installation Media in Drive OPTxx.


For setup use CL (Command Language) commands or the build terminal to change configuration files

Config file location

After the first call of WRKLNK the DETAIL and DSPOPT parameter doesn’t have to be specified anymore. If you are more familiar with vi use this commands…

(Auto)start ssh daemon

From V6.1 and following, the start is done with an integrated CL command. System wide key files ar generated at first start!!! Autostart can be d

At V5.4 there is some more work, with QSECOFR or a user with following prerequisites, is to be done…

  • The userid that starts the daemon must have *ALLOBJ special authority
  • The userid that starts the daemon must be 8 or fewer characters long
  • Before starting sshd for the first time, you will need to generate host keys starting a PASE shell (STRQSH or CALL QP2TERM)

Start the sshd daemon within the same job…

or in a new job using PASE shell

or in a new job useing CL

For Autostart contact you AS400 SysAdmin to plan a Scheduler Entry (WRKJOBSCDE) with QSECOFR Profile in order to be sure that all thinks will run.

Stopping sshd

From V6.1 and following use…

In V5.4 you may find the running job and ‘kill’ it…

and stop the job using selection 4 ending for the Job with the function PGM-sshd. If more than one job is listed, then there are active connections to you system.

Enable public key authentication

Unmask the following lines in the sshd_config file.

Generate keys and exchange them on user basis as on any other linux/unix based system. Be aware that public key authentication will not work if public (write) authority is set to some directories or files … just read on.

Nice hints

Check this before connect to ssh on AS400

  • The userid that is connecting must be 8 or fewer characters long
  • For public key authentication verify the permissions on the userid’s directories and files
  • The userid’s home directory must not have public write authority ( chmod go-w /home/myuserid )
  • The userid’s /home/myuserid/.ssh directory and /home/myuserid/.ssh/authorized_keys file must not have any public authorities (chmod go-rwx /home/userid/.ssh and chmod go-rwx /home/myuserid/.ssh/authorized_keys )

Once connected, you will be at a PASE for i command line.

Restrictions on ssh, sftp or scp in PASE shell

The PASE shell (STRQSH or CALL QP2TERM) is not a true TTY device. This can cause problems when trying to use ssh, sftp or scp within one of these sessions. Try this as work-a-round:

  • For ssh: use the -T option to not allocate a tty when connecting
  • For sftp and scp: use the ssh-agent utility and public key authentication to avoid sftp and scp prompting for passwords or passphrases

References and Links

IBM Redbooks on this topic
Another straight forward guide
Using chroot to restrict jail access to specific directories
Some security considerations

ACS – Run SQL Scripts – Saving result data to .csv and other

In my last post about¬†ACS¬†I mentioned that it is the first real suitable version for developers. Now I want to share¬†another nice to know…

While IBM support tells us how to Save Result Data to .csv or .xls Files Using Run SQL Scripts in iSeries Navigator, in ACS the feature is grayed out.

Just add these two lines to file to enable save results:

ACS – First suitable version for developement and end-user

When ACS¬†(IBM i Access Client Solutions)¬†in version introduced additional support to restrict functions using Application Administration. (See also May Dawn’s post)¬†I felt happy to get a real tool to limit the usage of ACS functions for end-user.
We do¬†no longer scare ūüôā about end-user being able to find the file and enabling all components by commenting¬† (See GettingStarted Guide).

ACS Version and Applications Administration restiction message
ACS Version – restrict functions in Application Administration and new Database management features like Schema

But together with the new features like Schema РDatabase management interface Рand some improvements in Run SQL Scripts we were able to provide a real alternative to Windows 10  users which had to use slow IBM Navigator for i web tools so far (to be supported).

Hello IBM i (AS400) community

I will write what drives me (crazy) as IBM i SysAdmin. Transforming a grown AS400 system to a well managed, fully integrated and virtualized Power System running i5/OS remains exciting.

If you understand the following¬†IBM i abbreviations and tradmarkes – stay tuned! ACS, PowerVM, HMC, SVC, V5000, Navigator for i, Admin Server, ¬†PASE, PowerHA, BRMS, RDi, VIOS, LPAR, …