BERG NEXT SUITE INSTALLATION (1.0.

3)

Next Suite
A1 INSTALLATION

1 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Welcome
Welcome to Berg NextSuite Installation manual. This document will help you to install NextSuite components on your system. If you are already familiar with installing components, this document may help you to quickly install NextSuite updates when they are available. If you are inexperienced with installing components in Delphi & C++ Builder, or you experience installation problems this document will help you to successfully install NextSuite. If you have any more questions, please contact us on support@bergsoft.net.

NextSuite Version
As every major component in Next Suite own version, NextSuite also own some kind of global Version number. This number is in following format and it may be found in archive file name in following format:

majorversion.month.year.release
Example: 4.4.08.2

Helpful links
1. BergSoft Support Board (Web Forum): www.bergsoft.net/forum 2. Members Section & New Versions of Components: bms.bergsoft.net 3. Articles & Tutorials: dn.bergsoft.net

2 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Installation steps
Follow these 3 steps in order to successfully install Berg Next Suite components in your Delphi/Borland C++ Builder. IMPORTANT NOTE: If you have previous version of Next Suite installed, please uninstall previous version first (!). 1. Download and extract components on local hard drive 2. Install packages in IDE 3. Uninstalling components If you have problems with installing components please read Common problems during installation section of this document.

3 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

1. Download and extract Components on local hard drive

Please download components from members section of site (http://bms.bergsoft.net/).

Components installer (setup) or zip archive distribution, which to use?

Berg Next Suite components are distributed in 2 formats: 1. Components Installer (exe) 2. Zip archive (zip) Component installer is better choice for novice users, and for users who dont update components too often. When installing new version, uninstaller will uninstall old version (delete all files), and then setup for new version need to be started. Zip archive is better choice for updating components after small changes (bug fixed, requested feature added). All is need to delete old Sources sub-folder and extract new files into it. Sometime only few files need to be replaced. If changes are minor and run-time only, packages even dont need to be recompiled.

4 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Components Installer (setup)

IMPORTANT NOTE: Make sure that Delphi/BCB/BDS IDE must be closed before installer is started. Components Installer (setup) will guide trough process of installing components: 1. Copy all files into specified folder on local disk. 2. Add Library Paths (optional). Setup file name indicate Next Suite version (nxcompsXX.exe, nxgridsXX.exe). Once setup is open, Component Wizard will appear:

5 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Zip archive
Zip archive require zip utility program to be installed first. MS Windows XP and MS Windows Vista operating systems already include support for zip archives.

Archive need to be extracted into desired folder with option keep folder structure is enabled inside your zip utility program (WinZip, WinRar, Total Commander). When files are extracted, packages need to be installed within Delphi/BCB IDE.

6 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

2. Installing packages in IDE

Sections:

1 2 3

Library path Components Installer includes option to add Library Path on installation complete. If components are installed from zip archive, paths need to be added manually. Compiling and installing packages Every package need to be compiled and installed. Common problems during installation
Problems may appear when installing packages, or when placing component on form.

7 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Library path
Adding components paths into Library Path is required in order tell Delphi/BCB IDE where to find components source files (.pas files). IMPORTANT NOTE: Components Installer may automatically add Library Paths into IDE. Library Path settings are located in: Delphi 6, 7, BCB 6: Tools Environment Options Library Library Path Delphi 2005, 2006, 2007: Tools Options Environment Options Delphi Options Library Win 32 Following Paths need to be added: Path <Next Suite>\Sources <Next Suite>\Sources\Next Grid <Next Suite>\Sources\Next DBGrid <Next Suite>\Sources\Next Inspector <Next Suite>\Sources\Next Collection <Next Suite>\Sources\Next Sheet <Next Suite>\Sources\Next Addons Components Required for all components NextGrid, NxFieldChooser, NxSlidesDesigner NextDBGrid NextInspector, NextDBInspector NxAlertWindow, NxButton, NxFlipPanel, NxHeaderPanel NextSheet NxAutoCompletion, NxBusy, NxPreview, NxProgress

8 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Compiling and installing packages

IMPORTANT NOTE: Make sure that path to Sources sub-folder is added in Library Path before compiling and installing packages. Components packages are located into Packages\<IDE Version> sub-folder in Next Suite folder:

Packages with suffix Run are run-time packages, packages with suffix Dsgn are design-time packages. Packages must be installed in following order (following table also indicate packages dependency). Package Name NxCommonRun.dpk1 NxCommonDsgn.dpk NxGridRun.dpk NxGridDsgn.dpk NxDBGridRun.dpk NxDBGridDsgn.dpk NxInspectorRun.dpk NxInspectorDsgn.dpk NxCollectionRun.dpk NxCollectionDsgn.dpk NxSheetRun.dpk NxAddonsRun.dpk Components Next Editors (NxEdit, NxSpinEdit, NxButtonEdit, NxDatePicker), NxColorSheme. NextGrid, NxFieldChooser, NxSlidesDesigner

NextDBGrid

NextInspector, NextDBInspector NxAlertWindow, NxButton, NxFlipPanel, NxHeaderPanel NextSheet, NxBorderPicker, NxLineStyleList

NxAutoCompletion, NxBusy, NxVirtualDataSet

Open package, click on Compile2 and then (after compiling is finished) on Install:
1

Extension for C++ Builder packages is .bpk

9 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3) Delphi 6, 7, BCB 6:

Delphi 2005, 2006, 2007: Right-click on package:

As indicated in table above, NxCommonXXX.dpk packages are required to be installed before all other packages because it contains some base classes used in other packages. When packages are installed, following pages (categories) inside Components (Tool) Palette will appear: Page (Category) Next Suite3 Next Editors4 Next Collection Next Shared Next Add-ons Version of particular components may be determined by reading Version property, or with right-clicking on component and choosing Version from components popup-menu: Components

2 3

Build in C++ Builder Component list depends from purchased license 4 Included in every package

10 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Common problems during installation

Problems may appear when installing packages, or when placing component on form.

What may cause installation problem?

Install problems usually appears when: A. Previous version is not completely uninstalled. Symptoms: 1. Message The procedure entry point @ popup. B. Package with same name installed in several IDEs are installed on system, and BPL files are build into same folder.

Solutions
Follow these steps in order to successfully clean system from previous or invalid installation of Next Suite components. 1. Remove components from IDE (Read bellow, Remove components from IDE) 2. Close IDE. 3. Delete every Nx*.bpl file from Delphi/BCB/BDS BPL sub-folder on your system: Version Delphi 6 Delphi 7 C++ Builder 6 Delphi 2005, Delphi 2006 Delphi 2007 Components <Next Suite>\Lib\Delphi 6 <Next Suite>\Lib\Delphi 7 C:\Program Files\Borland\CBuilder6\Projects\Bpl C:\Program Files\Borland\CBuilder6\Projects\Lib C:\Documents and Settings\<User>\My Documents\Borland Studio Projects\Bpl C:\Documents and Settings\<User>\My Documents\CodeGear Studio Projects\Bpl

4. Install packages again.

Direct support
If you still have problems installing components please contact us on support@bergsoft.net for direct support. 11 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

12 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

3. Uninstalling old version

Uninstalling old version of Next Suite components is good choice when: 1. New version is installed after long period of not updating. 2. New major version is released. 3. Problems while installing occurs.

When uninstall is not required?

When some smaller bug-fix or new feature is added, there is no need for uninstall. In this situations recompiling target package is only required. Example: If new run-time method is added, or bug is fixed in existing method in NextGrid component, only NextGrids run-time package need to be re-compiled.

Remove components from IDE

It is recommended that components are first removed (unregistered) from IDE: 1. Open Delphi/BCB IDE 2. Click on Components -> Install Packages 3. Remove every Berg package (Berg NextGrid, Berg NextGrid (Design), Berg Inspector) 1. Click on package 2. Click on Remove button. 3. Repeat these steps for each Berg package.

4. Click on OK button.

13 Copyright BergSoft 2008. All Rights Reserved.

BERG NEXT SUITE INSTALLATION (1.0.3)

Delete files from disk with using uninstaller

If previous version is installed with using Component Installer (setup), uninstall program need to be run to delete components from system. IMPORTANT NOTE: If components are installed from zip archive, uninstall program will not exist. 1. Close Delphi/ C++ Builder IDE 2. Run Uninstall.exe (located in Next Suite sub-folder, or inside Berg program group)

3. Follow on-screen instructions in order to uninstall components from system.

Delete files from disk with using file manager

If previous version is installed with from Zip archive, files need to be deleted from disk manually with using Windows Explorer, or other file manager. 1. Close Delphi/C++ Builder IDE 2. Delete all files from NextSuite folder with using Windows Explorer, or other file manager. If new version is going to be installed from zip file, it may be extracted into same folder after old files are deleted. This will save time for adding new Library Paths into IDE.

14 Copyright BergSoft 2008. All Rights Reserved.