Easysoft ODBC-Sybase Driver User Guide - Installation
Installing the Easysoft ODBC-Sybase Driver
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.
Obtaining the Easysoft ODBC-Sybase Driver
There are three ways to obtain the Easysoft ODBC-Sybase Driver:
- The Easysoft web site is available 24 hours a day at http://www.easysoft.com for downloads of definitive releases and documentation.
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.
- The Easysoft FTP server is available 24 hours a day at ftp://ftp.easysoft.com, containing free patches, upgrades, documentation and beta releases of Easysoft products, as well as definitive releases.
Change to the pub/sybase directory and then choose the platform release that you require.
- You can order Easysoft software on CD by email, telephone or post (see Contact Details).
What to install
The name of the Easysoft ODBC-Sybase Driver install file varies from platform to platform, but is of the form:
- odbc-sybase-x.y.z-platform.tar.gz (Unix)
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.
If you download a Unix file using Windows, the browser may corrupt the filename. For example, if you download a .gz file and Windows corrupts the filename, it may not be obvious that the file is "gzipped". Use "filefilename" to find out the file type of the downloaded file.
You can now download a file and begin the installation process.
As long as you stop all running applications (under Windows), or any software either from Easysoft or using Easysoft drivers (under Unix), it is safe to reinstall or upgrade the Easysoft ODBC-Sybase Driver without uninstalling.
If you do uninstall, you should first back up any configuration data that you still need, as uninstalling some Easysoft products will result in this information being deleted (license details remain in place).
Installing the Easysoft ODBC-Sybase Driver
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:
- The Bourne shell (or BASH) must either be named (or linked to) /bin/sh or the first line of the install file updated to the correct location.
- Various common Unix commands such as grep, awk, cut, ps, sed, cat, wc, uname, tr and find.
If any of these commands are missing they can be obtained from the Free Software Foundation (http://www.fsf.org).
- Depending on the platform, you will need up to 10Mb of free disk space for the installed programs and up to 10Mb temporary space for the installation files themselves.
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.
Extracting the installation files
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:
¯ OR ¯
If the distribution file has been bzip2ed (i.e. the filename ends in .bz2), then use:
¯ OR ¯
If the distribution file has been compressed (i.e. the filename ends in .Z), then use:
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.
Check through the INSTALL file before continuing. It gives full installation instructions for the Unix-literate, and if you are confident in the use and administration of your system, you can follow the instructions in the INSTALL file instead of working through the remainder of this section.
Beginning the Installation
During the installation, you are asked to answer some questions. The default reponse is displayed in square brackets , which you can press <Enter> to accept or you can choose any of the alternative responses shown in round brackets () by typing the required response and then pressing <Enter>.
Occasionally, the install program pauses to give you time to read the information displayed on screen. Press <Enter> to continue when you have read the current screen of information.
9. If you have read and agree to the Easysoft License Agreement, type yes and then press <Enter> to continue.
You must type yes, not y, to continue.
10. The script pauses to allow you to read its output so far. Up to this point it has checked the following:
- that you have the minimum set of Unix programs it requires
- the platform you are running
- any platform-specific components, such as the version of the C runtime library
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 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:
- If there are multiple copies of unixODBC on your system already you will have to choose one of them. If you pick the wrong one (i.e. not the one your applications are linked with, or not the one your run-time linker uses) the Easysoft ODBC-Sybase Driver will not be visible to your applications until this is corrected.
- If you have built unixODBC yourself from sources you must make sure it has been configured correctly for use with your applications.
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.
¯ OR ¯
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.
Licensing the Easysoft ODBC-Sybase Driver
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.
22. Enter your Name.
23. Enter your Company Name.
24. Enter at least one of Email, Phone and Fax (preferably all three).
25. At the Ref prompt, do either of the following:
- If you want a trial license, leave it blank and press <Enter>.
- If you want to install a purchased license, enter your authorization code and press <Enter>.
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).
¯ OR ¯
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.
The View Existing Licenses option will not display any license you obtained during this License Manager session. You must quit the License Manager and allow the install script to finish applying the license.
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.
¯ OR ¯
If you did not obtain licenses, enter n.
¯ OR ¯
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.
Completing the offline licensing procedure
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:
- Display the license_request.txt file (e.g. using
cat license_request.txt) and note the site number. Now run a web browser and go to http://www.easysoft.com/sales/autolicense.phtml. Log in to Easysoft's web site. On the License Generator screen, choose the type of license you want, then enter your site number and click Continue. You can now close the web browser. You will shortly receive your license key(s) via email.
- Email the file license_request.txt to firstname.lastname@example.org. Your license key(s) will be emailed to you automatically.
- Email the file license_request.txt to email@example.com. A member of the Licensing Department will email the license keys(s) to you.
2. When you receive your license key(s), append them to the file /usr/local/easysoft/license/licenses, removing any LIC: prefixes.
The Easysoft license responder puts an attachment in its outgoing emails that allows Windows users to activate their licenses with a double-click. If you read your email in Windows, this attachment will be visible but it will not work for licensing Unix versions of the software.
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.
Uninstalling the Easysoft ODBC-Sybase Driver
To uninstall the Easysoft ODBC-Sybase Driver under Unix:
- If unixODBC is installed, the Easysoft ODBC-Sybase Driver driver must be removed from its database.
- If the system has a dynamic linker (such as ld.so on Linux), the Easysoft ODBC-Sybase Driver directories must be removed from the dynamic linker search path (this may require root access, depending on the mechanism used by the platform).
- The Easysoft ODBC-Sybase Driver install directory tree must be removed (this requires the same privileges as the user who performed the installation, which is normally root).
A step-by-step guide follows:
1. Log in as root.
Removing from unixODBC
2. Check whether the Easysoft ODBC-Sybase Driver is configured under unixODBC by typing:
odbcinst -q -d
3. If "SYBASE" is returned in the output then remove the Easysoft ODBC-Sybase Driver entry by typing:
odbcinst -u -d -n SYBASE
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.
Removing from the dynamic linker
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:
8. Run /sbin/ldconfig so that the dynamic linker re-reads the file and will no longer search the removed paths.
Deleting the Software
Finally, remove the software from the system hard drive.
9. Change directory to:
The system displays the current directory.
Double-check that this is the directory under which you installed the Easysoft ODBC-Sybase Driver.
Be very careful issuing the rm -r command as root. Normally rmdir will not remove directories that contain files, but rm -r will remove all subdirectories along with their contents. It is possible to effectively destroy your system and/or lose all user files by removing the wrong directory.
10. Remove the Easysoft ODBC-Sybase Driver installation directory:
Check that you are in the right directory.
rm -r sybase
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.
rm -r easysoft
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.