Installing FlexNet Code Insight Using the Linux Command Line

FlexNet Code Insight 6.13.2

This section provides the procedure for installing FlexNet Code Insight via a Linux command line.

To install FlexNet Code Insight via a Linux command line, do the following:

1. Ensure that you’ve met all the prerequisites in Prerequisites.
2. Place the following items in the same directory, such as /home/codeinsight/installer:

Type

File

Installer Jar File

codeinsight_6.x.jar 

Key

codeInsight.key

Database Driver

The JDBC driver that you downloaded based on your database type. See Installing the Database Driver for details.

3. Open the command prompt and enter the following to launch the installer:

java –jar codeinsight_6.13.x.jar

An Introduction message appears:

4. Press Enter when you are ready to continue.
To accept the default value at any time, press Enter.
To exit the installation at any time, press CTRL+C. The Choose Install Set screen appears:

5. Enter the number of one of the following options and press Enter.
1 Standalone—Both core and scanner on this computer.
2 Core—Configure this computer as the core server.
3 Scanner—Configure this computer as scan server.

The Core Server controls your Web UI and Detector Client. The Scan Server is where actual scanning is performed.

Note • This guide addresses the Standalone install but it is also common to have a single instance of the Core Server and multiple Scan Engine Servers.

The Choose Install Folder screen appears.

6. Enter the FlexNet Code Insight installation directory.
You can specify an existing directory or a new directory.
If you choose to create a new directory, it will be physically created after you have gone through all the prompts for setting up the product.

For Linux, the recommended location is /home/codeinsight/<version>/.This directory is referred to as <CODE_INSIGHT_ROOT_DIR> throughout this document.

7. Press Enter. The Total System Memory screen appears.

8. Select the total system memory (RAM) on this machine by entering a number between 1 and 4.

To find the RAM of your machine, type the following command in the command prompt: free –g. Then note the number in the Total column and round up or down to the nearest number.

Note • The heap space for the Java VM will automatically be set to 80% of the total RAM amount. This is the recommended amount for running FlexNet Code Insight.

9. Click Enter. The Choose Database screen appears.

10. Select your database vendor.

FlexNet Code Insight offers support for Oracle, MySQL and SQL Server. The input fields will be different depending on which database type you choose.

Note • You must have an empty schema and user account configured with the correct privileges before selecting the Database vendor. See Configuring a Database for details.

If you get an error, make sure that your database driver is in the same directory as the FlexNet Code Insight installer jar file before proceeding.

Note • The system will exit after this message. After you have placed the database driver in the directory, restart the installation.

11. Press Enter. A Configure Database panel specific to the selected database type appears.

MySQL Example

Oracle Example

SQL Server Example

12. On the Configure Database screens, enter your database IP address. By default, this field points to the IP address of the machine which you are currently using.

Note • The IP address defaults to the IP address of the server on which you are running the Installer. You may use localhost instead of IP if the database is on this machine.

Note • The Database password is encrypted after the first launch of the application.

13. Press Enter. The core.properties screen appears.

14. Enter an alias for your scan server in the Scan Server Alias field. This is the alias you will see in the FlexNet Code Insight Web UI when you configure and launch your scans.

Note • The Core/Scan Server IP address automatically defaults to the IP Address of the machine you are using. The HTTP and RMI port default to the recommended ports used by the FlexNet Code Insight application. If you have configured different ports, be sure to change the port numbers.

15. Press Enter. The Email Configuration screen appears.

16. To receive email notifications for events such as project creation and scan completion, enter 1 for Yes.

Note • Contact your network administrator to determine your SMTP settings.

17. Press Enter. The scan.properties screen appears.

18. In the Path to Compliance Library (CL) Directory field, enter the location of your Compliance Library.

Note • Your Compliance Library directory is the directory that contains a bdb folder and pattern files that end in .dat (such as C:\CodeInsight\PDL\CL\2.32).

19. Press Enter. The scanEngine.properties screen appears.

20. In the Path to Workspace Directory field, specify the location of your workspace directory, the directory in which your workspace data will be stored. The default and recommended location is one level above the <CODE_INSIGHT_ROOT_DIR>.

Tip • Keeping the workspace folder outside of your FlexNet Code Insight installation directory is recommended in order to simplify future workspace migration.

21. In the Path to Scan Root Directory field, enter the path to your scan root directory. The web application uses this property to limit the root of the server file system, making it easier to control which files and directories users have access to.

Multiple roots are supported, but they must be separated by a pipe character (|):

C:\Folder1\Folder2|D:\Folder3

Note • If you do not want to limit access of FlexNet Code Insight users to files and directories, leave this field blank.

22. Press Enter. The Pre-Installation Summary screen appears.

23. Review your FlexNet Code Insight installation name and location, and press Enter when you are ready to proceed with the Installation. The Installing screen appears.

Note • If you are installing into a non-empty directory, there may be files that need to be overwritten and a message box will be displayed. Select option 1 - Yes to All to overwrite the existing files.

24. The Installer executes a series of scripts and writes to your database schema. Wait while it completes the installation.
25. If a database error occurs during the installation process, a notification message is displayed:

26. Correct the error and run the installer again or manually run the database scripts after the installation completes.

Note • You may check the <CODE_INSIGHT_ROOT_DIR>/logs directory for more information about each script that was executed.

When the installation is complete, the Install Complete screen appears.

27. Press Enter to continue. You have completed the installation and are now ready to launch the application.

Proceed with the steps in Launching FlexNet Code Insight.