This section explains how to install, license and remove the Easysoft ODBC-Sybase Driver on supported Unix platforms.
The installation assumes you are, or have available for consultation, a system administrator.
There are three ways to obtain the Easysoft ODBC-Sybase Driver:
Select Download from the Easysoft ODBC-Sybase Driver section of the website and then choose the platform release that you require.
First time visitors must complete the new user form and click Register. Note that your personal Internet options may require you to login and click Continue if you have previously registered.
Change to the pub/sybase directory and then choose the platform release that you require.
The name of the Easysoft ODBC-Sybase Driver install file varies from platform to platform, but is of the form:
where "x" is the major version number, "y" is the minor version number and "z" is the build index, which is incremented when minor changes are made.
"platform" will vary depending on the operating system distribution you require and you may come across files of the form:
within specific Unix platforms, where "platform-variation" refers to alternative versions available for a single platform.
| Select the highest release available for your platform within your licensed major version number (installing software of a different major version number requires a new Easysoft license). |
Unix filenames may also be suffixed with .gz for a "gzipped" archive, .bz2 for a "bzip2ed" archive, or .Z for a "compressed" archive.
You can now download a file and begin the installation process.
Although this section covers a range of platforms and the precise output may vary from system to system, the installation process is essentially the same.
The Unix installation routine has the following requirements:
If any of these commands are missing they can be obtained from the Free Software Foundation (http://www.fsf.org).
1. Log on to your Unix machine as the root user.
2. Download the Easysoft ODBC-Sybase Driver (see Obtaining the Easysoft ODBC-Sybase Driver).
3. Place the distribution file in a temporary directory on your Unix machine.
4. Change to the directory in which the distribution file resides.
5. Extract the installation files from the distribution file:
If the distribution file has been gzipped (i.e. the filename ends in .gz), then use:
gunzip odbc-sybase-x.y.z-platform.tar.gz
If the distribution file has been bzip2ed (i.e. the filename ends in .bz2), then use:
bunzip2 odbc-sybase-x.y.z-platform.tar.bz2
If the distribution file has been compressed (i.e. the filename ends in .Z), then use:
uncompress odbc-sybase-x.y.z-platform.tar.Z
6. If the distribution file has not been compacted at all (i.e. the filename ends in .tar), then it is ready for extraction:
tar -xvf odbc-sybase-x.y.z-platform.tar
The tar program creates a directory with the same name as the tar file (without the final .tar) containing further archives, checksum files, a script called install and a text file called INSTALL.
It also contains a versioned directory to ensure that any shared components already installed by other Easysoft products are only overwritten if those included in this distribution are newer.
| If you do not wish to keep the original downloaded distribution file you can now delete it safely. |
7. Change into the newly-created odbc-sybase-x.y.z-platform directory.
9. If you have read and agree to the Easysoft License Agreement, type yes and then press <Enter> to continue.
10. The script pauses to allow you to read its output so far. Up to this point it has checked the following:
11. Press <Enter> to continue.
The script checks the archive package.
12. Press <Enter> to continue.
13. Specify the directory into which the Easysoft ODBC-Sybase Driver is to be installed.
If you accept the default base directory, the files are installed into a subdirectory called easysoft within the specified path.
For example, if you accept the default path of /usr/local, the files are installed into /usr/local/easysoft.
If you specify an alternative directory, the files are installed into that directory but a symbolic link is created from /usr/local/easysoft pointing to the install directory. This link is necessary for licensing to work.
14. If an existing version of the Easysoft ODBC-Sybase Driver has already been installed on this machine then Easysoft recommend that this be removed and you will be prompted to do so at this point.
15. Press y to continue or n to stop the installation.
The Easysoft ODBC-Sybase Driver requires unixODBC to be installed and if unixODBC is not already present, the script offers to install the copy of the unixODBC driver manager contained in the Easysoft ODBC-Sybase Driver distribution.
| The entire unixODBC source distribution may also be downloaded from ftp://ftp.easysoft.com/pub/unixODBC and installed independently. |
The unixODBC driver manager enables an ODBC application to load whichever driver is required to access the data source at runtime.
| unixODBC is an open source project sponsored by Easysoft and other industry members. It is rapidly becoming the standard driver manager across the Unix data access community. Comprehensive documentation can be found at http://www.unixodbc.org. |
If unixODBC is already installed, the installation script can use your existing unixODBC, but you should bare in mind the following possible complications of doing this:
Easysoft ODBC-Sybase Driver distributions contain matched builds of unixODBC and the Easysoft ODBC-Sybase Driver, so installing the incorporated unixODBC build is often the safest policy.
16. Press <Enter> to continue and then choose whether to install unixODBC.
17. If you do not wish to install the version of unixODBC included with this distribution, enter y.
If you wish to install unixODBC, enter n at the prompt.
18. The script pauses at this point. Press <Enter> to continue.
The script extracts the unixODBC files.
| Depending on your platform this installation of the unixODBC driver manager may not contain the GUI components of unixODBC. |
19. The Easysoft product database now needs resetting.
All Easysoft products that are currently running should be closed down or they may terminate unexpectedly and any applications using them will need to be restarted.
20. You are now asked if you want to obtain a license. Accept the default [y] to start the licensing procedure.
A menu of options is displayed.
21. Choose the option to license the Easysoft ODBC-Sybase Driver.
You will then be asked to provide some contact information.
24. Enter at least one of Email, Phone and Fax (preferably all three).
25. At the Ref prompt, do either of the following:
26. The License Manager displays a menu of licensing options.
If you have an internet connection you should select 1, Automatic (this is the quickest and easiest method unless your firewall or other network obstacles prevent the message from getting through).
If you do not have an internet connection, or the Automatic option fails, select option 2 to write the required information to a text file in the current working directory called license_request.txt, which you will then need to view to obtain a license.
27. The License Manager displays the menu again. Select 0 to exit.
If you chose the automatic licensing method and licenses are retrieved, the licensing script outputs them to a file called licenses.out.
If the install script detects possible new licenses in the file licenses.out it asks whether you want to add them to the license database.
28. If you obtained licenses and you want to add them now, enter y.
If you did not obtain licenses, enter n.
If you do not see this message, then read on. You will need to complete the offline licensing procedure as explained in Completing the offline licensing procedure.
A message informs you that the Easysoft ODBC-Sybase Driver has been installed and you are asked to the enter the details needed to create a data source for the Easysoft ODBC-Sybase Driver.
29. Enter a Sybase database name.
30. Enter a user name and password.
31. Enter the server name into the SERVER_HOST field.
32. Enter the server port number into the SERVER_PORT field.
The Easysoft ODBC-Sybase Driver installation is complete.
If at step 26 you chose to write the licensing information to a file, you still need to complete the licensing procedure before the Easysoft ODBC-Sybase Driver can be used.
The licensing information is written to the license_request.txtfile, which contains information including a site number (a number unique to your machine) that Easysoft require before you can be issued with a license key.
1. Do any one of the following:
2. When you receive your license key(s), append them to the file /usr/local/easysoft/license/licenses, removing any LIC: prefixes.
The Easysoft ODBC-Sybase Driver is now licensed and you can begin using it.
If you need further information about licensing, please refer to the Licensing Guide.
To uninstall the Easysoft ODBC-Sybase Driver under Unix:
2. Check whether the Easysoft ODBC-Sybase Driver is configured under unixODBC by typing:
3. If "SYBASE" is returned in the output then remove the Easysoft ODBC-Sybase Driver entry by typing:
If a message is displayed about a reduced usage count, repeat this step until odbcinst states that the Easysoft ODBC-Sybase Driver has been removed.
| If unixODBC is no longer required then the odbcinst.iniand odbc.ini files can be removed. |
Notify the dynamic linker that the shared objects are no longer available.
| This information only applies to systems with the ld.so dynamic linker (normally only Linux). |
4. If the file /etc/ld.so.conf file exists, make a backup copy and open it.
5. Remove the path to the Easysoft ODBC-Sybase Driver shared objects:
6. If no other Easysoft software is in use then remove the path to the common Easysoft shared objects:
7. If unixODBC is no longer required then remove the reference:
<InstallDir>/easysoft/unixODBC
8. Run /sbin/ldconfig so that the dynamic linker re-reads the file and will no longer search the removed paths.
Finally, remove the software from the system hard drive.
The system displays the current directory.
Double-check that this is the directory under which you installed the Easysoft ODBC-Sybase Driver.
10. Remove the Easysoft ODBC-Sybase Driver installation directory:
Check that you are in the right directory.
The system may ask you to confirm deletion for some files. You can confirm these as long as you are sure you are in the correct directory.
11. If you have no other Easysoft products on your system and you are not using any copy of unixODBC that may be in this directory, then you can delete the easysoft directory too.
If there are other files in the directory tree (i.e. you have other Easysoft products installed) then you must not remove the easysoft directory, because it will contain your license keys and other important files.
12. If you left the Easysoft ODBC-Sybase Driver distribution file on your system then you may wish to remove it at this point.
The uninstall process is complete.
Any licenses you obtain for the Easysoft ODBC-Sybase Driver and other Easysoft products are stored in the <InstallDir>/easysoft/license/licenses file.
After uninstalling the Easysoft ODBC-Sybase Driver, unless you have deleted this file, you will not need to relicense the product when you reinstall or upgrade.
However, for security purposes you may want to make a copy of <InstallDir>/easysoft/license/licenses before uninstalling.
© 1993 - 2024 Easysoft Limited. All rights reserved. Oracle® is a registered trademark of Oracle® Corporation and/or its affiliates. Other trademarks and registered trademarks appearing on easysoft.com are the property of their respective owners.
