Inspire Designer 8.1Installation GuideLinux on x86-64

GMC Software AG

© 2011 GMC Software AG. All rights reserved.

Inspire Designer 8.1

Installation GuideLinux on x86-64

Release date: October 2011Document version: 8.1.0.1

GMC Software AGwww.gmc.net

Should you have any queries, suggestions or comments concerning these materials, please donot 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.

CopyrightInformation contained within this document may contain technical inaccuracies or typograph-ical errors. Changes will be added periodically and modifications will be made thereto withoutprior notification. GMC Software AG does not enter into any obligations or responsibilities re-garding the content of this document and does not assume any legal liability – neither expressedor 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, exceptfor explicit company internal use, is strictly forbidden without the prior written authorizationof GMC Software AG. Failure to comply with these restrictions is liable to prosecution.

Trademarks

GMC Software Technology and its logo are trademarks and servicemarks of GMC Software AG registered in Switzerland, the US andnumerous other countries.

Adobe and Adobe ® PDF Library™ are trademarks or registered trademarks of Adobe SystemsInc. in the US and other countries. The names of other companies, products and services arethe property of their respective owners.

© 2011 GMC Software AG. All rights reserved.

http://www.gmc.net/mailto:documentation@gmc.net

Table of Contents1 Requirements 4

1.1 Installation Sequence Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.3 Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.4 Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Licensing 5

2.1 Net Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.2 Software Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.3 Demo Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.4 Hardware Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.5 Installation of HASP Hardlock Daemon for Linux x86-64 . . . . . . . . . . . . 82.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 Start-up 10

6 Uninstalling Inspire Designer for Linux 64 11

7 Troubleshooting 12

7.1 Licensing Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3

Table of Contents

1 Requirements1.1 Installation Sequence SchemeThis 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 operatingsystem 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 respectiveinformation about the method in this guide.

3. Check the access rights of the user account that you will be performing the installationunder.

4. Now you can install Inspire Designer for Linux.

5. Optionally install Inspire Production Server and Inspire Content Manager to run afterthe 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 preparedwith the utmost care and GMC believes to the best of its knowledge that the informationsupplied is correct, GMC does neither expressly nor implicitly assume any legal liability or re-sponsibility for its accuracy, completeness and/or usefulness.

1.3 Software RequirementsIn its current version, Inspire Designer for Linux is supported and has been tested in the followingenvironment 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

1 Requirements

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 theyare also included in the installer.

1.4 Access RightsTo install Inspire Designer, switch the user to root (administrator) using the command su. Torun 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 LicensingInspire 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 informationabout the characteristics, advantages and limitations of each type and troubleshooting pleasesee the Public Licensing Guide document.

5

2 Licensing

2.1 Net LicensingNet licensing is the preferred licensing method. It should be used instead of HW licensing forall network licensing purposes. When Net licensing is employed, Inspire Content Manager mustbe used as a license manager, i.e. GMC License Manager.

Before you start installing Inspire Designer and licensing it by the Net licensing method, youshould know the following:

The License ID of the server (according to the HW and SW requirements) where GMCLicense 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 volumelimitation).

Ask the Support team to generate an ls.lic license file for the License ID and optionallythe dongle ID.

Have the License-Manager-Linux-[version]-Beta.tar.sh distribution package (distributedtogether 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 thefollowing:

1. If dongle is used, install HASP Device Driver. The dongle must be connected to the li-censing server, on which the GMC License Manager will be running. (The HASP LicenseManager 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 atthe end of the GMC License Manager installation).

To set up Net license for a new installation on the other computers, specify the licensingmethod and the server on which the GMC License Manager is running. This can be done byusing either environment variables or CONFIG files:

Environment variables have the advantage that they only have to be set once for allapplications, 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’sname/IP address.

CONFIG files need to be created for each installed product but when shared networkinstallations are used, this only has to be done once as the settings made in these filesare 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:

LSSERVERNAME

Then the file must be saved under an appropriate name according to the product forwhich it is to be used (PNetTC.config, PNetTVCS.config, PNetTNetServer.config) andplaced into the same directory with it.

2.2 Software LicensingSoftware licensing is performed using a PNetT.lic file. It is always created for a specific LicenseID (or more License IDs).

Before you start installing Inspire Designer and licensing it by the SW licensing method, youshould know the following:

The License IDs of all computers (according to the HW and SW requirements) on whichyou 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 canbe 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), InstallInspire Designer for Linux and then copy the PNetT.lic license file to the installation directory.

2.3 Demo LicensingDemo licensing is performed using a demo PNetT.lic file usually for a trial period only and isintended to be replaced later by another licensing type.

Install Inspire Designer for Linux and then copy the PNetT.lic demo license file to the installationdirectory.

2.4 Hardware LicensingNote For new installations, the Hardware licensing is not preferred as the licensing methodand should be replaced by Net licensing.

7

2 Licensing

2.5 Installation of HASP Hardlock Daemon forLinux x86-64

If parallel key access is required, install the aksparlnx kernel mode driver. If you run the install.shinstaller, this process is done automatically. However, you can do it manually, in the followingway:

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 commandrpm -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 nousbdevfs 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 ToolsGetLicID and GetHostnameID are standalone tools that are distributed separately and providethe IDs necessary for SW and Net licensing.

The GetLicID tool retrieves a License ID based on the computer where it is installed (and theGMC 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 isintended to be used in cases where virtual machine software (e.g. VMware) is employed as theenvironment where applications are installed. It can also be used in other cases where thehardware is required to change, e.g. for failover solutions.

To use either of these tools:

1. Download the installation file, e.g. GetLicID-.tar.gz

2. Unzip the file, e.g. run the command: gunzip GetLicID-.tar.gz

3. Install the application, e.g. run the command: tar -xvf GetLicID-.tar

4. Execute the application, e.g. run ./GetLicID.sh

The License ID of the computer will be displayed.

8

2 Licensing

3 Temp FilesGMC software applications create temp files and licensing information. In rare cases, a securitypolicy may have dictated that user permissions were enhanced to forbid writing to the directoryused for this and the application will fail.

The location used by GMC applications is /etc/Chimenix and all users must have write permissionsto this directory.

4 Installing Inspire Designer forLinux 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 Linuxwhereever this appearsin 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 when you finish reading.

3. After confirming the license agreement the archive is unzipped. It contains the followingfiles:

aksusbd-redhat-1.14-3.i386.rpm

aksusbd-suse-1.14-3.i386.rpm

install.sh

9

3 Temp Files

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 in-stalls 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 oflicensing.

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 (withoutPDF Library and Normalizer) and two init scripts (for Inspire ProductionServer 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 ProductionServer and ICM to Run afterStart-up

If you want to have Inspire Production Server (formerly known as NetServer) and/or InspireContent Manager (formerly known as VCS) running directly after the system start-up, withoutstarting them manually, you can make use of the two init scripts available in the installationdirectory after Inspire Designer for Linux has been installed.

10

5 Installing Inspire Production Server and ICM to Run after Start-up

To install Inspire Production Server and/or Inspire Content Manager to run always after start-up, 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 ContentManager will run, modify the line user='default'. Change it to your accountor create a special user for running these applications. For security reasons it is re-commended not to use the 'root' account.

If you want to use Net licensing for these applications, delete the '#' mark at thebeginning of the licensing options and enter the name of the server in theCX_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 forLinux 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 thealternative installation directory). Files added by the user will be preserved.

11

6 Uninstalling Inspire Designer for Linux 64

7 Troubleshooting7.1 Licensing IssuesOn 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

7 Troubleshooting

Inspire DesignerTable of Contents1 Requirements1.1 Installation Sequence Scheme1.2 Hardware Requirements1.3 Software Requirements1.4 Access Rights

2 Licensing2.1 Net Licensing2.2 Software Licensing2.3 Demo Licensing2.4 Hardware Licensing2.5 Installation of HASP Hardlock Daemon for Linux x86-642.6 GetLicID & GetHostnameID Tools

3 Temp Files4 Installing Inspire Designer for Linux 645 Installing Inspire Production Server and ICM to Run after Start-up6 Uninstalling Inspire Designer for Linux 647 Troubleshooting7.1 Licensing Issues