|
Home > |
HSM Access Provider Installation Guide > Linux Installation for PCI Mode
|
|---|
This chapter provides instructions for Linux operating systems only. For Windows operating systems, see Windows Installation for PCIe Mode.
The simplest way to install or uninstall an access provider package on any of the Linux/Unix platforms is to use the Unix Installation Utility. The utility ensures that the correct commands for your platform are automatically executed.
If you wish to enter Linux commands manually, see Manual Linux Installation Commands.
Before adding or removing any packages, you must become the super-user on the host system.
The Linux driver is distributed as source code and must be compiled for the running kernel before loading as a dynamic module. In most cases, the installation script will do this automatically, provided the following conditions are met:
•The same version of the C compiler (gcc) used to compile the kernel must be available.
•The rpmbuild package is installed.
•The appropriate kernel source package for the running system is installed. The kernel source is usually installed in /usr/src/linux-<VER> with a symbolic link from either:
–/lib/modules/<VER>/build or
–/lib/modules/<VER>/source
where <VER> is the kernel version as reported by uname –r
1.Mount the installation CD-ROM and navigate to its directory. For example:
# cd /cdrom/cdrom0/
2.Use the Unix Installation Utility.
Select the PCI HSM Access Provider device driver package from the Install Menu. This will install the PCIe HSM Access Provider package, including the device driver and test utilities, as well as the manual pages for these programs to the default directory (/opt/safenet).
See Using the Unix Installation Utility for more information.
Note: A reboot may be required to successfully load the driver.
The access provider is installed by executing the following as 'root' (super-user):
# cd /cdrom/cdrom0/Linux/pci_hsm_access_provider
rpm -i PTKpcihsm2-X.X-X.i386.rpm
If the compile fails, or the driver does not come up automatically (hsmstate fails), you will need to correct the problem and then cd /opt/ETpcihsm/src and invoke make(1) as root. The Makefile in that directory has some notes to help you get the driver compiled correctly.
To remove the software from your host system, simply use the rpm(8) command with the appropriate package name as a parameter.
For example:
# rpm -e PTKpcihsm2
Finally, make any necessary configuration changes. Currently, the only configurable setting in PCIe mode is the ET_HSM_PCICLIENT_READ_TIMEOUT_SECS variable. This setting determines the time in seconds the PCIe driver will wait before timing out on a read operation. It should be set long enough to avoid an unintentional timeout, which causes the driver to shut down the HSM. See Configuration Items for instructions on how to change this setting, and PCI Mode Client Configuration Items for a description of the variable.