Repair a K2 Installation

To repair a K2 component, re-running the K2 Setup Manager and select repair. All the currently installed components on the server will be repaired.

Repairing any K2 installation will NOT preserve any custom files or changes to configuration. The Installer will reset and force the system back to a working state, as it would have been after doing a clean installation. If you want to make subtle configuration changes, like changing URLs, ports, users, SMTP Servers, you must choose the Configure option on the Maintenance panel when re-running the K2 Setup Manager.

After installing a Cumulative Update (CU) or Fix Pack (FP), any time you repair, reconfigure, or modify your installation, you must reinstall the same or latest CU and FP.

The repair process is essentially a re-installation of all of the previously installed components. Therefore, you should back up the K2 databases and additional configuration files if you made any changes, as no customizations will be kept.

Repairing a K2 blackpearl installation should be done only when absolutely necessary and only when components have been damaged by external circumstances.

All currently installed components on the server will be repaired.

Steps

  1. Be sure to save all your work and close the designers before continuing.
  2. Ensure that all K2 related processes, such as K2 Designer for Visual Studio, K2 Designer for SharePoint, K2 Web Designer (Legacy), and the K2 blackpearl Server service, are shut down.
  3. Run the K2 blackpearl Setup Manager (Setup.exe or browse to Start > All Programs > K2 blackpearl > K2 blackpearl Setup Manager) and select the Repair K2 blackpearl option.
  4. Click Next.
  5. Click Yes.
  6. You will be prompted to stop any running programs and services that use K2 components. The Setup Manager can stop the K2 Service for you, but you will need to close other programs manually.
  7. Follow the on-screen prompts to edit any Configurations. The following configuration settings are available:
    • K2 Database
    • K2 Pass-Trhough Authentication
    • K2 workspace Web Site Configuration
    • Resolve IIS Bindings
    • K2 Workspace Application Pool Configuration
    • SQL Reporting Services Configuration
    • Service Accounts Configuration
    • Exchange Server Configuration
    • Exchange Integration
    • SmartActions Configuration
  8. Review the Configuration Summary screen.
  9. Click Next.
  10. Any Additional Actions are listed. Click Next to start the Repair process.

    11. Please be patient, this process can run for a while.

  11. Click Next.
  12. Click Finish.
  13. After the components are repaired, you will not need to reconfigure the components. All of the configuration data is kept. You should validate your environment, however, after a repair, to ensure that your system is functioning properly.
  • When performing a repair, all custom values in configurations and the database will be overwritten as the installer will return the environment to a default working state.
  • You cannot repair a single component. Selecting the Repair option will reinstall all K2 components that are currently installed on that Server.
  • You will not be able to repair components when the K2 Designer for Visual Studio is running. Be sure to save all your work and close the designer before continuing.
  • Running the Repair option will reset the K2 environment to default settings. Any changes to these settings will be lost.

The repair process is essentially a re-installation of all of the previously installed components. Therefore, you should back up the K2 databases and additional configuration files if you made any changes.

Repairing a K2 smartforms installation should be done only when absolutely necessary and only when components have been damaged by external circumstances.

Selecting the Repair option will reinstall all K2 smartforms components that are currently installed on that server.

Steps

  1. Be sure to save all your work and close the designers before continuing.
  2. Ensure that all K2 related processes, such as K2 Designer for Visual Studio, K2 Designer for SharePoint, K2 Web Designer (Legacy), and the K2 blackpearl Server service, are shut down.
  3. Run the K2 smartforms Setup Manager (Setup.exe or browse to Start > All Programs > K2 blackpearl >K2 smartforms > K2 smartforms Setup Manager) and select the Repair K2 smartforms option.
  4. Click Next.
  5. Click Yes.
  6. The Setup Manager will prompt you to stop any running programs and services that use K2 components. It can stop the K2 Service for you, but you must close other programs manually.
  7. Follow the on-screen prompts to edit any Configurations. The following configuration settings are available:
    • K2 Server Database
    • K2 Designer Web Site
    • Resolve IIS Bindings
    • K2 Designer Site Application Pool
    • SmartForms Runtime Site
    • SmartForms Runtime Site Application Pool
  8. Review the Configuration Summary screen.
  9. Click Next.
  10. Any Additional Actions are listed. Click Next to start the Repair process.

    11. Please be patient, this process can run for a while.

  11. Click Next.
  12. Click Finish.
  13. After the components are repaired, you will not need to reconfigure the components. All of the configuration data is kept. You should validate your environment, however, after a repair, to ensure that your system is functioning properly.
  • When performing a repair, all custom values in configurations and the database will be overwritten as the installer will return the environment to a default working state.
  • You cannot repair a single component. Selecting the Repair option will reinstall all K2 components that are currently installed on that Server.
  • You will not be able to repair components when the K2 Designer for Visual Studio is running. Be sure to save all your work and close the designer before continuing.
  • Repairing a K2 smartforms installation should be done only when absolutely necessary and only when components have been damaged by external circumstances.
  • Repairing any K2 installation will NOT preserve any custom files or changes to configuration.