Linux Installation Details

These instructions apply to installing the application. If you have ordered a floating license using the Flexlm license manager you should first install it, verify it is working and know the name and port that the license manager is listening on. Instructions for this can be found on Artwork's support page.

If you have node locked licenses then you should have them handy so that you can cut and paste them in near the end of the installation.


1. Download and copy the tarball to the directory where you want it installed. In this example the install directory is: /home/cad/clipextract.


2. untar the release

$ tar xf clipextract.e4_64+.linux.v100.tar

Your directory should look like this:

-rw-r--r-- 1 stevedb stevedb 7649280 2016-08-29 14:02 clipextract.e4_64+.linux.v100.tar
-rwxr-xr-x 1 stevedb stevedb    1934 2016-08-26 18:50 INSTALL
drwxr-xr-x 2 stevedb stevedb    4096 2016-08-29 14:15 tools
drwxr-xr-x 2 stevedb stevedb    4096 2016-08-29 14:15 zipimage

3. Now run the INSTALL script (from your install directory - not from your home directory or anywhere else)

$ ./INSTALL [enter]

You'll see on the terminal

------------------------------------------------------------------
Artwork Conversion Software - clipextract Installation
www.artwork.com  info@artwork.com  (831)426-6263
------------------------------------------------------------------

Install clipextract version 1.00 in /home/cad/clipextract? (y/n) y [enter]

4. You will then be prompted to enter the unzipping password. We recommend that you copy/paste as opposed to typing it in.

Archive:  ../zipimage/clipextract.e4_64+.linux.v100.zip
[../zipimage/clipextract.e4_64+.linux.v100.zip] checkver password: ********** [enter]

Assuming you have correctly entered the password the INSTALL script will unzip the files, create a number of subdirectories and customize a couple of scripts to reflect the location of the binaries.

Unzipping program files into the bin directory...

  inflating: checkver                
  inflating: clipextract64.exe       
  inflating: clipextract-command-line.pdf  
  inflating: clipextract.htm
  inflating: colfill.pat
  inflating: demo5.gds
  inflating: extract-gdsii-demo
  inflating: extract-tiff-demo
  inflating: gdsfont.shx
  inflating: hostinfo                
  inflating: liseater
  inflating: readgds
  inflating: version.txt
  inflating: xhostinfo


Customizing the installation...

creating examples

creating documentation

5. You will then be asked if you want to install keycodes to enable program execution. If you are upgrading over an existing installation you can answer no and the previously installed keycodes will be used. But let's assume here that this is a first time installation.

For a new install, you need to install keycodes to activate clipextract.
For an upgrade, you do not need to reinstall keycodes.


Install keycodes? (y/n)y [enter]


LICENSING MODE SELECTION

This product can be licensed using either network or node locked
licensing schemes.  Each scheme uses a different keycode format:

a) You should obtain and install a FLEXlm license on your license 
   server before performing this step.

b) FLEXlm node lock license strings are in the form of:

# Qckvu3 GDS
FEATURE ACS58IO artwork 1.0 01-jul-2012 uncounted HOSTID=f46d04cdea47 \
SIGN="0076 1DC3 6A3B 1070 7C70 BF10 997A BB00 A616 9F61 9ED8 \
F5AE 9A46 D637 6CEE"

   It is highly recommended that you be able to PASTE your license
   strings when prompted.


Finally the tools folder has binaries potentially needed for licensing
in flexlm.tar.gz. These include the artwork daemon and other FLEXLM
utilities.


6. Network or Node Lock. At this point we have to choose the type of licensing. The script will "branch" off and so will our documentation. We will start with Node Locked. If you have floating licenses, click here to jump past the node locked documentation.

If you have node locked key codes

Install for (a) network or (b) node lock licensing? (a/b) b [enter]

=====================  Keycodes installed  =====================
|
| -- none --
|
================================================================

PRODUCT ACTIVATION : 'clipextract'

-----------------------------------------------------
Paste in keystrings one line at a time or as a group. flexlm.lic

Type DONE when finished entering keystrings.
-----------------------------------------------------

# ClipExtract v1.00 for Linux 1c6f6593b8d6
FEATURE ACS3I2O9 artwork 1.0 30-dec-2039 uncounted \
HOSTID=1c6f6593b8d6 SIGN="00CD ADDE B902 FA03 E2AD E929 D58F \
F100 85D8 377C 8067 4C0B E62C A66C 2376"
DONE[enter]

Again, assuming your codes were entered correctly and that they were generated for this machine you should see:

Licensing Report
----------------

* License Availability:
  1 hextract licenses available.

clipextract Installation Finished
-------------------------------------
clipextract Install - [PASSED] clipextract v1.00
Keycodes Install - [PASSED] 1 products activated
  1 hextract licenses available.



*
* Clipextract extracts small clips from a GDSII file to GDSII, OASIS, TIFF, BMP or RAW formats
* using multiple threads whenever possible
*
* The 'artwork' directory contains the clipextract64.exe program.
* Run clipextract64.exe from a writable working directory.
* To get usage information, use the '-h' or '-help' command-line argument.
*
*
 

Floating License KeyCodes

If you have a license server installed and configured and you have an environment variable that correctly points to the license server (i.e. if your license server was installed on a machine called asmsc75 and it is listening on port 1701 then you would have an environment variable ARTWORK_LICENSE_FILE set to 1701@asmsc75.) then enter a at the prompt.

Install for (a) network or (b) node lock licensing? (a/b) a [enter]

If all is OK, the INSTALL script will let you know. However if something is wrong you'll get this message:

Licensing Report
----------------



* You have chosen to use the FLEXlm license manager.
  You should have already installed a valid FLEXlm
  network license for this product before performing 
  this step.

* License Availability:
  No hextract licenses available.
No licenses available for all products.

clipextract Installation Finished
-------------------------------------
clipextract Install - [PASSED] clipextract v1.00
Keycodes Install - [FAILED] clipextract is not activated

The message may vary. In this particular example, I had a license manager correctly installed and configured on asmsc75 for port 1701 and I had the environment variable correctly set. I know this because when I echo the variable ARTWORK_LICENSE_FILE I get back the port and server name.

stevedb@asmsc45:/home/cad/clipextract$ echo $ARTWORK_LICENSE_FILE
1701@asmsc75

What I had failed to do is to force the license server to do a re-read after editing the license file to add the codes for clipextract.

When things are not working the message is unfortunately not always very specific as to what is broken; anymore than when your (older) car won't start in the morning, the car doesn't tell you the source of the problem.








Documentation Download Rev History Price




ARTWORK CONVERSION SOFTWARE, INC.                  Company Profile
417 Ingalls St.,     Santa Cruz, CA 95060         Tel (831) 426-6163     Fax 426-2824               email: info@artwork.com