I need to install, upgrade, or uninstall VShell^® for UNIX on my FreeBSD system.

Required Libraries

The following libraries must reside on your system for the VShell for UNIX installer to complete successfully:

FreeBSD 4.8

• libz.so.2
• libpam.so.1
• libutil.so.3
• libstdc++.so.3
• libm.so.2
• libc.so.4

The following libraries are required if using PAM:

• pam_unix.so
• pam_permit.so

FreeBSD 5.3 and 5.4

• libz.so.2
• libpam.so.2
• libutil.so.4
• libstdc++.so.4
• libm.so.3
• libc.so.5

The following libraries are required if using PAM:

• pam_unix.so
• pam_permit.so

Install

To install VShell for UNIX, follow these steps:

Note: You must have root permissions to install VShell.

1. Download VShell from the VanDyke Software web site. Make a note of the MD5 checksum listed below the download link that you use. You can ensure that the downloaded file has not been corrupted by comparing that number to the number generated by running the following command on the downloaded file:
   

    md5 <vshell filename>

2. Clear port 22. By default, VShell uses port 22. Before installing VShell, stop all other services that run on port 22.
3. Go to the directory where you downloaded the VShell installer package.
4. Enter the following command:
   

    pkg_add vshell-<version number>-<build number>.bsd.i386.tgz

5. Answer any installer prompts. This will create the following files and install them to the indicated pathnames:
   
   /usr/local/sbin/vshelld
   /etc/init.d/vshelld
   /usr/local/bin/vsh
   /usr/local/bin/vsftp
   /usr/local/bin/vpka
   /usr/local/bin/vcp
   /usr/local/bin/vkeygen
   * /usr/local/etc/vshelld_config
   * /usr/local/etc/vshelld_primes.txt
   * /etc/pam.d/vshelld
   /usr/share/doc/vshell-<version>/history.txt
   /usr/share/doc/vshell-<version>/readme.txt
   /usr/local/vshell-<version>/VShell_EULA.pdf
   /usr/local/order.txt
   /usr/local/man/man1/vcp.1
   /usr/local/man/man1/vsh.1
   /usr/local/man/man1/vsftp.1
   /usr/local/man/man1/vpka.1
   /usr/local/man/man1/vkeygen.1
   /usr/local/man/man5/vshelld_config.5
   /usr/local/man/man8/vshelld.8
   /usr/local/etc/vshelld_config.default
   
   * These files will not be replaced if they already exist.

Upgrade

To upgrade VShell for UNIX enter the following command:

 pkg_update vshell-<version number>-<build number>.bsd.i386.tgz

In FreeBSD versions 5.3 and newer, the pkg_update command has been dropped so you will have to use pkg_add instead.

Note: You must have root permissions to upgrade VShell.

You should not remove the host keys when doing an upgrade unless you want them to be regenerated. If you do choose to regenerate the host keys, all users using the service must re-load the host key for the system.

Uninstall

To uninstall VShell for UNIX, enter the following command:

 pkg_delete vshell-<version number>-<build number> 

You can find the version and build numbers by running the pkg_info command and looking for vshell in the resulting list.

Note: You must have root permissions to uninstall VShell.

The uninstall program will not delete the following files:

/usr/local/etc/vshelld_config
/usr/local/etc/vshelld_eval.lic
/usr/local/etc/vshelld_hostkey
/usr/local/etc/vshelld_hostkey.pub

Known Issues

The following is a known issue with the VShell server:

• Client authentication using X.509 certificates is not supported on VShell for FreeBSD.

If this is an ongoing concern for you, please contact the VanDyke Customer Support Group at the following address:

http://www.vandyke.com/feedback.php