Installing interactively from the Linux and UNIX system console

On Linux and UNIX systems, use Installation Manager console mode to install VersionVault interactively using a character-based version of the Installation Manager interface.

Before you begin

Make sure that Installation Manager is installed on the system where you are installing VersionVault product package from. See Installation Manager tasks.

About this task

On Linux and UNIX systems that do not support a graphical user interface or to minimize delays that are caused by network latency when interactively installing VersionVault from a remote system, you can use the character-based interface in Installation Manager console mode to install VersionVault. Use this feature to manage packages from a remote system and for server-side deployments. In console mode, you can complete the following tasks:
  • Install
  • Upgrade
  • Modify
  • Roll back
  • Uninstall

To start Installation Manager console mode, use the imcl utility in the Installation Manager tools directory.

These installation steps cover a typical installation scenario by using console mode. During the installation session, console mode prompts are displayed specific to the package you are installing. For information about specifying values or selecting options during the installation, see the product-specific instructions for planning and deploying the product.

The Installation Manager console mode interface uses these conventions:
  • [X] indicates a selected option.
  • [ ] indicates an option that is not selected.
  • Default commands are enclosed in brackets[ ]. [N] indicates that the default command is N: Next.

    To accept the default entry, press Enter. To change the command, type the option code, then press Enter.

Note: More information about Installation Manager and console mode is available in the Installation Manager documentation, see the Installation Manager documentation.


To install a package in console mode:
  1. Start Installation Manager in console mode by using imcl.
    1. Open a command line.
    2. Go to the Installation Managertools directory /opt/HCL/InstallationManager/eclipse/tools/user_home_directory/HCL/InstallationManager/eclipse/tools.
    3. Run the command ./imcl -c.
  2. To add the repository for the VersionVault package files, enter P > 1 > D. Then, follow the prompts to specify the repository location.
    Installation Manager verifies the validity of that repository and add it to the list of repositories.
  3. Enter A > R to apply the changes and return to the main menu.
  4. From the main menu, enter I: Install - Install software packages.
    If you have repositories that require credentials, and you did not save the credentials, you are prompted to provide these credentials. You can also save the credentials when prompted. See Saving credentials in console mode in the Installation Manager documentation.
  5. Enter 1: [ ] package_name.
    To select a package, enter the number to the left of the package. This example selects the first package listed. If the selected package requires a later version of Installation Manager, you are prompted to install the later version.
  6. On the Select screen, enter one of the options:
    • 1: Choose version package_version for installation. This option shows when you chose a package that is not selected for installation.

      You see the option 1: Do NOT install version package_version when you chose a package that is selected for installation.

    • 2: Show all available versions of the package.
    1. Enter the number to the left of the package that you want to install
  7. Enter O: Check for Other Versions, Fixes, and Extensions. Installation Manager searches available repositories for other versions, fixes, or extensions of the selected package.
    • For Installation Manager to search the default repository for the installed packages, the preference Search service repositories during installation and updates must be selected. This preference is selected by default. To access this preference, go to the Repositories preference page.
    • Typically, Internet access is required.
    1. Enter O: OK.
      The Check for Other Versions, Fixes, and Extensions option indicates the number of other versions, fixes, or extensions that are found. However, it does not list the found items. To see available versions, enter the number to the left of the package then enter 2: Show all available versions of the package.
  8. Enter N.
  9. Options for the Licenses screen:
    • 1: product_name - License Agreement. To view a license agreement, type the number to the left of the product name. This example selects the first license agreement listed.
    • A: [ ] I accept the terms in the license agreement.
    • D: [ ] I do not accept the terms in the license agreement. If you decline the license agreement, the installation is stopped. To continue the installation, you must accept the license agreement.
    1. Enter A to accept the license agreement.
    2. Enter N.
  10. To enter a different value for the Shared Resources Directory, type M: Shared Resources Directory.
    Attention: You can specify the shared resources directory only the first time that you install a package. Select the drive with enough available space to ensure adequate space for the shared resources of future packages. You cannot change the location of the shared resources directory unless you uninstall all packages.
    1. To accept the default value for Shared Resources Directory or to continue after you enter a different value, type N.
  11. To enter a different value for the package group location, type M: Change Location.

    The architecture of the package shows when you install on a 64-bit operating system. For new package groups, you can change the bit mode by entering T: Change to bit architecture. For existing package groups, the option for 32-bit or 64-bit is disabled. You cannot change the architecture of an existing package group.

    Restriction: You cannot install a 32-bit package into a 64-bit package group.
    1. To accept the default values or to continue after you enter a different value, type N.
  12. Enter the number to the left of the language to add or remove the language from the list of languages that are installed. You can select only one language at a time.
    English is selected by default. You cannot clear the selection for the English language. Your language choices apply to all packages installed in the package group.
    1. Enter N.
  13. Enter the number to the left of the feature to add or remove the feature from the list of features that are installed.
    1. Enter N.
  14. On the Summary screen, review your selections before you install the package.
    • To generate a response file, enter G: Generate an installation response file. Enter the name of the response file and use .xml as the file extension. Response files are XML files. You can include a directory location when you enter the response file name to save the file to a different location.
    1. Enter I: Install.
  15. When the installation completes, enter F: Finish.

What to do next

After completing the installation, see Configuring your environment after deploying.