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

Required Libraries

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

Solaris 8

• libpam.so.1
• libsocket.so.1
• libnsl.so.1
• libdl.so.1
• libbsm.so.1
• libstdc++.so.5
• libm.so.1
• libgcc_s.so.1
• libc.so.1
• libmp.so.2
• libc_psr.so.1

Solaris 10

• libz.so.1
• libpam.so.1
• libsocket.so.1
• libnsl.so.1
• libdl.so.1
• libbsm.so.1
• libstdc++.so.6
• libm.so.2
• libgcc_s.so.1
• libc.so.1
• libcmd.so.1
• libmp.so.2
• libmd5.so.1
• libscf.so.1
• libsecdb.so.1
• libdoor.so.1
• libuutil.so.1
• libc_psr.so.1
• libmd5_psr.so.1

The following library is required if using PAM:

• pam_unix.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 commands:
   

    gunzip vshell-<version number>.<build number>.solaris.pkg.tar.gz
    tar xf vshell-<version number>.<build number>.solaris.pkg.tar

   This will create a "vshell" directory under the current directory.
5. To add the new package, enter the following command:
   

    pkgadd -d . vshell

6. Answer the pkgadd prompts. When asked to select the package that you want to process, enter the number displayed in the prompt message for the vshell package. When you are notified that the package you are adding contains scripts and asked if you want to allow their execution, you must answer "y" to complete the installation of the package.
   
   The installer will create the following files and install them to the indicated pathnames:
   
   
   /etc/init.d/vshelld
   /opt/vshell/bin/vcp
   /opt/vshell/bin/vkeygen
   /opt/vshell/bin/vsh
   /opt/vshell/bin/vsftp
   /opt/vshell/bin/vpka
   /opt/vshell/doc/history.txt
   /opt/vshell/doc/readme.txt
   /opt/vshell/doc/order.txt
   /opt/vshell/doc/VShell_EULA.pdf
   /opt/vshell/etc/vshelld_config.default
   /opt/vshell/etc/vshelld_primes.txt
   /opt/vshell/lib/libgcc_s.so <symbolic link>
   /opt/vshell/lib/libgcc_s.so.1
   /opt/vshell/lib/libstdc++.so <symbolic link>
   /opt/vshell/lib/libstdc++.so.5 <symbolic link>
   /opt/vshell/lib/libstdc++.so.5.0.0
   /opt/vshell/man/man1/vcp.1
   /opt/vshell/man/man1/vkeygen.1
   /opt/vshell/man/man1/vsh.1
   /opt/vshell/man/man1/vsftp.1
   /opt/vshell/man/man1/vpka.1
   /opt/vshell/man/man5/vshelld_config.5
   /opt/vshell/man/man8/vshelld.8
   /opt/vshell/sbin/vshelld
   
   
7. Once the package has been installed successfully, you can quit the installer. You can also now remove the tar file and the "vshell" directory created when you untar'ed the tar file.

Upgrade

At this time, to upgrade VShell for UNIX on Solaris, you must first uninstall the existing VShell and then install the new version.

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, follow these steps:

Note: You must have root permissions to uninstall VShell.

1. Enter the following command:
   

    pkgrm vshell

2. Answer the pkgrm prompts. When you are notified that the package you are removing contains scripts and asked if you want to allow their execution, you must answer "y" to complete the removal of the package.
3. The program should notify you when the package has been successfully removed.
   
   The uninstall script should run whether or not vshelld is running. If the uninstall scripts do not work properly, you can manually remove VShell by deleting the /var/sadm/pkg/vshell directory.

The uninstall program will not delete the following files:

/opt/vshell/etc/vshelld_config
/opt/vshell/etc/vshelld_eval.lic
/opt/vshell/etc/vshelld_hostkey
/opt/vshell/etc/vshelld_hostkey.pub