Cleanscape *NIX command-line installation instructions 9-May-2024 ---------------------------------------------------------------------- If you are downloading Fortran-lint, note that the distrubution unpacks the DEMO version of the product. If you have acquired Fortran-lint, you will need to convert from the demo version to the full version; see Appendix D. These are the installation instructions for UNIX command-line versions of Cleanscape products - Fortran-Lint (hereinafter referred to as Flint), C++Lint, and Lint-Plus (Lplus). ---------------------------------------------------------------------- 0. If you are upgrading, it is STRONGLY recommended you back up your existing installation, either by tar tzvf or simply renaming your installation directory (e.g., mv flint flint.bak). 1. Download the appropriate tarball. Click on the link on this page to initiate download of the tarball. NOTE: The GUI version of the product also contains the command line version. This installation is recommended since it provdes the flexibility of using the GUI in addition to the command line. If this approach is more suitable, resume reading the install notes linked on this page for the GUI (uinstall.txt). After downloading the appropriate tarball, move it to the "/tmp" directory on the target system. 2. Log-in as "root" on the target system. Note: "root" privileges are recommended, but are not required. 3. Create a directory to hold Flint. For example: mkdir -p /usr/local/cleanscape/flint # For most systems or mkdir -p /opt/cleanscape/flint # For Solaris For the other products, substitute "flint" with "cpplint" for C++lint or "lplus" for Lplus. 4. Go to the new directory. Unpack the tarball using a command similar to the following: For Linux systems: tar zxvf /tmp/_.taz.taz For other UNIX systems: gunzip /tmp/_.taz.taz tar xvf /tmp/_.taz.tar 5. Set environment variables. Edit your "login" scripts (and the "login" scripts for any other users who will be running Flint). Add commands similar to the following: For "sh" users Flint: export FLINTHOME=/usr/local/cleanscape/flint export FLINTHOST=localhost # license server or export FLINTHOST= # client machines export PATH=$FLINTHOME:$PATH C++lint: export IPTLINT=/usr/local/cleanscape/cpplint export CSIHOST=localhost # license server or export CSIHOST= # client machines export PATH=$IPTLINT:$PATH Lplus: export CSIHOME=/usr/local/cleanscape/lplus export CSIHOST=localhost # license server or export CSIHOST= # client machines export PATH=$CSIHOME:$PATH For "csh" users (use env. vars. for products as shown above) setenv FLINTHOME /usr/local/cleanscape/flint setenv FLINTHOST localhost set path = ( $FLINTHOME $path ) rehash Note: "FLINTHOME" should specify the program directory created in step 3. Modify the setting shown here as necessary. After making the changes, log out, then log-in again. 6a.Install license keys. NOTE: There is a separate demo version of Flint as of version 6.02. NO registration is required; you may simply being using the demo. As of the date of this writing, Linux and Mac are at v. 6.02. If you are on these hosts, no other steps are necessary until you acquire the product; then see Appendix D for conversion from Demo to Full version of Flint. 6b.Execute the following command: Flint: flint activate C++lint: cpplint -license=activate Lplus: lplus -license=activate This should print a server code. Copy the code, then press CTRL-C to abort the process. Call Cleanscape at (800) 944-5468 and ask for an activation for the product you have purchased. Alternatively, mail the server code to support@cleanscape.net along with your name, company name, and telephone number. Mention the product name in your message. Cleanscape will generate an activation key for you at no cost. When you receive the activation key, run the activation again and enter the key. This should create a script named "startup" in the product's executables directory (FLINTHOME, IPTLINT, or CSIHOME). Note: You may receive two activation keys. If so, run the activation twice, once with each key. 7. Install license manager daemon The "startup" script starts a license manager daemon. To install the daemon: (a) Make the "startup" script executable. For example: chmod a+x /usr/local/cleanscape/flint/startup (b) If you have "root" access, edit the appropriate system startup script, add a line similar to the following, and reboot the system: /usr/local/cleanscape/flint/startup & (c) If you don't have "root" access, execute the script man- ually. 8. Set up XLINT (optional for Flint). NOTE: The Cleanscape GUI provides more features than the Xlint browser. Xlint is still provided for legacy users. Flint comes with a database browser named XLINT. If you plan to use XLINT, set two additional environment variables "XAPPLRESDIR" and "XLINTHOME" as follows: "sh" example "csh" example ---------------------- ----------------------------- XAPPLRESDIR=$FLINTHOME setenv XAPPLRESDIR $FLINTHOME XLINTHOME=$FLINTHOME setenv XLINTHOME $FLINTHOME export XAPPLRESDIR export XLINTHOME You may also need to set the standard UNIX "DISPLAY" variable. You may also need to copy $XLINTHOME/XLint $HOME for each user. Note case of "XLint". For more information on XLINT, see chapters 11 through 16 of the main flintman.pdf manual (located in the "Doc" subdirectory of the main program directory). Note: Presently, XLINT assumes that the display is set to a resolution of at least 1024x768. 9. Install "man" page (optional): To install the UNIX "man" page, when available, use commands similar to the following: cd $FLINTHOME mkdir -p /usr/local/man/man1 cp -p flint.1 /usr/local/man/man1 Modify the directory path shown here as necessary. The command-line version of Flint should now be installed and ready ready for use. For more information, see flintmain.pdf, located in "Doc" subdirectory of the main program directory (created in step 3). ---------------------------------------------------------------------- APPENDIX D - CONVERTING FROM DEMO TO FULL VERSION OF FLINT Once you have decided to acquire Flint (thanks!), you need to convert the program from demo mode to full operation. To do so, as root run the script ConvertToFull located in your installation directory. This will copy the correct Flint binary, and remind you to read the license agreement. You can then proceed with key installation process starting at Step 6b above. Until this step, Flint does not have the ability to register the product. After running ConvertToFull, you can proceed with the registration process outlined in Step 6b above.