Getting Started : Upgrading solidDB® to a new release level
  
Upgrading solidDB® to a new release level
solidDB® supports upgrades from at least the two previous release levels. Upgrades to solidDB® 100 are supported from the 7.0 and 6.5 release levels; conversion of the database files is however needed. If you need to upgrade from older versions, contact UNICOM Systems, Inc.
Before you begin
Familiarize yourself with the new and changed features that are described in the solidDB® Release Notes.
About this task
The steps below describe the procedure for upgrading a single solidDB® server to a new release level. If you are using solidDB® in High Availability mode, see section Upgrading HotStandby servers in the solidDB® High Availability User Guide.
The previous release level solidDB® JDBC and ODBC drivers are compatible with the 100 release level solidDB® server. However, the 100 versions of the drivers cannot be used with earlier versions of the server. Thus, the server must be upgraded before the drivers.
You must upgrade the drivers only if you plan to take into use the new features that are introduced at release level 100.
Note If you want to convert a partial-Unicode database to support the full Unicode mode, see “Converting partial-Unicode databases to Unicode” in the solidDB® Programmer Guide.
Procedure
1 Make a backup copy of your database files and solid.ini configuration files.
For instructions, see “Performing backup and recovery” in the solidDB® Administrator Guide.
2 Shut down solidDB®.
3 Install the new version of solidDB®.
solidDB® is delivered as a single installation file. If you do not want to run the installer on your production environment node, install solidDB® on a separate node and copy the executables, libraries, and drivers manually to your production node, as applicable for your setup.
For a description of the solidDB® server package contents, see solidDB® server package.
For instructions on how to run the solidDB® installer, see Installing solidDB®.
4 Update the license file.
Copy the new license file (solid.lic) from the License Certificate image to the solidDB® working directory.
If your previous installation used the soliduc.lic license file, you must remove the soliduc.lic file and replace it with the solid.lic license file provided in the solidDB® 100 License Certificate.
5 Check the changes in parameter factory values and update the solid.ini configuration files if necessary.
Changes in the parameter values are described in the Release Notes.
6 Check and update the solidDB® JDBC and ODBC driver-related settings as applicable to your environment.
solidDB® JDBC Driver
If you installed the new solidDB® JDBC Driver (SolidDriver2.0.jar) into a different location than the previous one, add the new driver location to the CLASSPATH system environmental variable. By default, the solidDB® JDBC driver is installed to the jdbc directory in the solidDB® installation directory.
solidDB® ODBC Driver
– In Windows and Linux operating systems, define the new ODBC data sources. To use the new driver, you must either modify the existing data sources or create new ones.
– If the application links to the solidDB® ODBC driver directly, you must recompile your application.
7 Convert the existing database files by starting solidDB® with the -x autoconvert or -x convert command-line option.
In the solidDB® working directory, issue the following command:
solid -x autoconvert
or
solid -x convert
The -x autoconvert option converts the database and starts solidDB®.
The -x convert option converts the database and exits solidDB®.
After the conversion, you cannot use the database with an older server version. To downgrade a database, you must export and import the data using the solidDB® tools.
Related concepts
System tools and utilities