Inspire Designer 8.1. Installation Guide Linux on x86-64. GMC Software AG. 2011 GMC Software AG. All rights reserved.

Inspire Designer 8.1 Installation Guide Linux on x86-64 GMC Software AG 2011 GMC Software AG. All rights reserved.

Inspire Designer 8.1 Installation Guide Linux on x86-64 Release date: October 2011 Document version: 8.1.0.1 GMC Software AG www.gmc.net Should you have any queries, suggestions or comments concerning these materials, please do not hesitate to contact us at documentation@gmc.net. This document contains information classified as Public. The GMC Software Group of companies are ISO 9001:2008 certified. Copyright Information contained within this document may contain technical inaccuracies or typographical errors. Changes will be added periodically and modifications will be made thereto without prior notification. GMC Software AG does not enter into any obligations or responsibilities regarding the content of this document and does not assume any legal liability neither expressed or implied for its accuracy, completeness and/or usefulness. Copying of the software or manual on to any data storage medium or in any other way, except for explicit company internal use, is strictly forbidden without the prior written authorization of GMC Software AG. Failure to comply with these restrictions is liable to prosecution. Trademarks GMC Software Technology and its logo are trademarks and service marks of GMC Software AG registered in Switzerland, the US and numerous other countries. Adobe and Adobe PDF Library are trademarks or registered trademarks of Adobe Systems Inc. in the US and other countries. The names of other companies, products and services are the property of their respective owners. 2011 GMC Software AG. All rights reserved.

Table of Contents Table of Contents 1 Requirements 4 1.1 Installation Sequence Scheme.......................... 4 1.2 Hardware Requirements............................. 4 1.3 Software Requirements............................. 4 1.4 Access Rights................................... 5 2 Licensing 5 2.1 Net Licensing................................... 6 2.2 Software Licensing................................ 7 2.3 Demo Licensing................................. 7 2.4 Hardware Licensing............................... 7 2.5 Installation of HASP Hardlock Daemon for Linux x86-64............ 8 2.6 GetLicID & GetHostnameID Tools........................ 8 3 Temp Files 9 4 Installing Inspire Designer for Linux 64 9 5 Installing Inspire Production Server and ICM to Run after Startup 10 6 Uninstalling Inspire Designer for Linux 64 11 7 Troubleshooting 12 7.1 Licensing Issues................................. 12 3

1 Requirements 1 Requirements 1.1 Installation Sequence Scheme This is the sequence in which you should perform the installation and post-installation steps: 1. Install the operating system on a new computer, or check if your current operating system is supported. See the Software Requirements chapter for supported platforms. 2. Find out which licensing method you will use for the installation and check the respective information about the method in this guide. 3. Check the access rights of the user account that you will be performing the installation under. 4. Now you can install Inspire Designer for Linux. 5. Optionally install Inspire Production Server and Inspire Content Manager to run after the system start-up using the two init scripts available in the installation directory. 6. Check the section Troubleshooting for additional information. 1.2 Hardware Requirements Minimum Configuration An x86-64 processor 1 GB RAM memory 1 GB of free system disk space Note Even though the technical data and information as mentioned before have been prepared with the utmost care and GMC believes to the best of its knowledge that the information supplied is correct, GMC does neither expressly nor implicitly assume any legal liability or responsibility for its accuracy, completeness and/or usefulness. 1.3 Software Requirements In its current version, Inspire Designer for Linux is supported and has been tested in the following environment for which the performance and results are guaranteed: Operating Systems Suse Linux Server 11 for Intel x86_64 processors Red Hat Linux ES Server 6 for Intel x86_64 processors 4

2 Licensing ODBC Support Drivers and Packages MySQL: mysql-connector-odbc-3.51.27-0 Oracle: oracle-instantclient-basic-10.2.0.3-1 glibc ver.: glibc-2.4-31.74.1 Note To be able to use ODBC correctly, ODBC 64-bit drivers have to be installed. Databases MySQL: 5.0.51 Oracle: 10.1.0 Note Using different configurations might cause unexpected problems. Working with other databases (MSSQL, PostgreSQL, etc.) depends on ODBC drivers. As there is no 64-bit driver for HASP dongles, 32-bit HASP drivers were tested and they are also included in the installer. 1.4 Access Rights To install Inspire Designer, switch the user to root (administrator) using the command su. To run Inspire Designer it is sufficient to use a standard user account. Note It is strongly recommended that the user is a member of "gmc" group. 2 Licensing Inspire Designer application can be licensed using any of the following license types: Net license SW license Demo license HW (dongle) license Basic information on how to set up each licensing method are provided. For more information about the characteristics, advantages and limitations of each type and troubleshooting please see the Public Licensing Guide document. 5

2 Licensing 2.1 Net Licensing Net licensing is the preferred licensing method. It should be used instead of HW licensing for all network licensing purposes. When Net licensing is employed, Inspire Content Manager must be used as a license manager, i.e. GMC License Manager. Before you start installing Inspire Designer and licensing it by the Net licensing method, you should know the following: The License ID of the server (according to the HW and SW requirements) where GMC License Manager will be running. Use the GetLicID tool to find out the License ID. Have a HASP HL Dongle, if it will be used together with Net license (e.g in case of volume limitation). Ask the Support team to generate an ls.lic license file for the License ID and optionally the dongle ID. Have the License-Manager-Linux-[version]-Beta.tar.sh distribution package (distributed together with the Inspire Designer) and optionally also the installation guide for it. To set up Net license for a new installation on the server with GMC License Manager, do the following: 1. If dongle is used, install HASP Device Driver. The dongle must be connected to the licensing server, on which the GMC License Manager will be running. (The HASP License Manager cannot work together with Net licenses.) 2. Install the GMC License Manager. See the GMC_License_Manager-Installation_Guide- LINUX-[version].pdf for more information. 3. Copy the ls.lic license file to the License Manager installation directory (as is advised at the end of the GMC License Manager installation). To set up Net license for a new installation on the other computers, specify the licensing method and the server on which the GMC License Manager is running. This can be done by using either environment variables or CONFIG files: Environment variables have the advantage that they only have to be set once for all applications, but it is necessary to set them on each workstation using Net licensing. It is necessary to set the following environment variables: CX_LICENSE=LS This environment variable specifies the licensing method used (LS stands for Net licensing). CX_LIC_SERVER=SERVERNAME This environment variable specifies the server s name/ip address. CONFIG files need to be created for each installed product but when shared network installations are used, this only has to be done once as the settings made in these files are applied for any workstation running the product(s) from the shared server directory. 6

2 Licensing The content of the file must be entered in the following way: <Config> <CX_LICENSE>LS</CX_LICENSE> <CX_LIC_SERVER>SERVERNAME</CX_LIC_SERVER> </Config> Then the file must be saved under an appropriate name according to the product for which it is to be used (PNetTC.config, PNetTVCS.config, PNetTNetServer.config) and placed into the same directory with it. 2.2 Software Licensing Software licensing is performed using a PNetT.lic file. It is always created for a specific License ID (or more License IDs). Before you start installing Inspire Designer and licensing it by the SW licensing method, you should know the following: The License IDs of all computers (according to the HW and SW requirements) on which you will perform the installation. Use the GetLicID tool to find out the License IDs of the computers. Ask the Support team to generate a PNetT.lic license file for the License IDs. There can be created just one PNetT.lic file for all License IDs. To set up SW license for a new installation (any computer as there is no licensing server), Install Inspire Designer for Linux and then copy the PNetT.lic license file to the installation directory. 2.3 Demo Licensing Demo licensing is performed using a demo PNetT.lic file usually for a trial period only and is intended to be replaced later by another licensing type. Install Inspire Designer for Linux and then copy the PNetT.lic demo license file to the installation directory. 2.4 Hardware Licensing Note For new installations, the Hardware licensing is not preferred as the licensing method and should be replaced by Net licensing. 7

2 Licensing 2.5 Installation of HASP Hardlock Daemon for Linux x86-64 If parallel key access is required, install the aksparlnx kernel mode driver. If you run the install.sh installer, this process is done automatically. However, you can do it manually, in the following way: 1. The driver is part of the distribution package: aksusbd-suse-1.14-3.i386.rpm. 2. Depending on the operating system (Red Hat Linux or SUSE Linux), use the command rpm -ivh aksusbd-redhat-1.14-3.i386.rpm or aksus bd-suse-1.14-3.i386.rpm to install the driver. Note There are no 64-bit drivers available, 32-bit drivers have to be used. 3. Then restart the system or launch the driver manually using the command /etc/init.d/aksusbd start If the error message Starting AKSUSB daemon/usr/sbin/aksusbd: no parallel key driver and no usbdevfs found: aborting appears, use the command mount -t usbdevfs none /proc/bus/usb to add the necessary usbdevfs file system. The daemon runs in the background. 2.6 GetLicID & GetHostnameID Tools GetLicID and GetHostnameID are standalone tools that are distributed separately and provide the IDs necessary for SW and Net licensing. The GetLicID tool retrieves a License ID based on the computer where it is installed (and the GMC applications will be installed). This is the preferred type of License ID. The GetHostnameID tool retrieves a License ID based on the hostname of the computer. It is intended to be used in cases where virtual machine software (e.g. VMware) is employed as the environment where applications are installed. It can also be used in other cases where the hardware is required to change, e.g. for failover solutions. To use either of these tools: 1. Download the installation file, e.g. GetLicID-<platform>.tar.gz 2. Unzip the file, e.g. run the command: gunzip GetLicID-<platform>.tar.gz 3. Install the application, e.g. run the command: tar -xvf GetLicID-<platform>.tar 4. Execute the application, e.g. run./getlicid.sh The License ID of the computer will be displayed. 8

3 Temp Files 3 Temp Files GMC software applications create temp files and licensing information. In rare cases, a security policy may have dictated that user permissions were enhanced to forbid writing to the directory used for this and the application will fail. The location used by GMC applications is /etc/chimenix and all users must have write permissions to this directory. 4 Installing Inspire Designer for Linux 64 The distribution package consists of one file: Inspire-Designer-Linux64-8.1.27.0-Beta.tar.sh (exact name might be different as it depends on current build). Note For 64-bit version the names contain Linux64 instead of Linux whereever this appears in the file name in the installation description below. 1. Run the command chmod a+x Inspire-Design er-linux-8.1.27.0-beta.tar.sh to make it an executable file. 2. Run the command./inspire-designer-linux-8.1.27.0-beta.tar.sh. The End User License Agreement is displayed. Hit <Q> when you finish reading. 3. After confirming the license agreement the archive is unzipped. It contains the following files: aksusbd-redhat-1.14-3.i386.rpm aksusbd-suse-1.14-3.i386.rpm install.sh 9

5 Installing Inspire Production Server and ICM to Run after Start-up Inspire-Designer-Linux-8.1.27.0-Beta.rpm Inspire-Designer-SW-Lic-1.0-0.noarch.rpm 4. To install Inspire Designer use the following commands: a. Switch the user to root (administrator) using the command su. b. Inspire Designer can be installed in two ways: Run the./install.sh which will guide you through the installation. It installs Inspire Designer executables, Redist and the HASP driver. Alternatively, you can use the rpm package to install the files manually: i. Perform the HASP driver installation, if dongle will be used as a part of licensing. ii. Use the command rpm ivh Inspire-Design er-linux-8.1.27.0-beta.rpm to install the package. The installation will install the Inspire Designer executables, Redist (without PDF Library and Normalizer) and two init scripts (for Inspire Production Server and Inspire Content Manager) to the directory /usr/loc al/gmc/inspire-designer-64bit-8.1.27.0-beta/. iii. The application can be installed to a different directory using the parameter --prefix. E.g.: rpm ivh --prefix=/opt/gmc Inspire-De signer-8.1.27.0-beta.rpm The runtime environment setting is ensured by wrapper scripts. 5 Installing Inspire Production Server and ICM to Run after Start-up If you want to have Inspire Production Server (formerly known as NetServer) and/or Inspire Content Manager (formerly known as VCS) running directly after the system start-up, without starting them manually, you can make use of the two init scripts available in the installation directory after Inspire Designer for Linux has been installed. 10

6 Uninstalling Inspire Designer for Linux 64 To install Inspire Production Server and/or Inspire Content Manager to run always after startup, do the following: 1. Go to the installation directory, i.e. /usr/local/gmc/inspire-design er-64bit-8.1.27.0-beta/ or the one you specified during installation. 2. Customize the init script: To specify the user under whom Inspire Production Server and/or Inspire Content Manager will run, modify the line user='default'. Change it to your account or create a special user for running these applications. For security reasons it is recommended not to use the 'root' account. If you want to use Net licensing for these applications, delete the '#' mark at the beginning of the licensing options and enter the name of the server in the CX_LIC_SERVER=hostname line. 3. Change directory using the command cd /etc/init.d. 4. Create link using the command ln -s /usr/local/gmc/inspire-designer-64bit-8.1.27.0-beta/pnettnet Server-init.sh or ln -s /usr/local/gmc/inspire-design er-64bit-8.1.27.0-beta/pnettvcs-init.sh 5. Perform registration in the system using the command chkconfig --add PNetTNetServer-init.sh or chkconfig --add PNetTVCS-init.sh. 6 Uninstalling Inspire Designer for Linux 64 To uninstall Inspire Designer use the following commands: Switch the user to root (administrator) using the command su Use the command rpm e Inspire-Designer-64bit-8.1.27.0-Beta Note The uninstall procedure will remove the default content of the /usr/local/gmc (or the alternative installation directory). Files added by the user will be preserved. 11

7 Troubleshooting 7 Troubleshooting 7.1 Licensing Issues On SuSE 9.0 systems unplugging and reconnecting a USB device can cause the hotplug daemon (a program responsible for un/plugging devices) to freeze. 12