# Installing the ODBC jEDI on Linux/Unix

Created At: 12/20/2019 4:47:27 PM
Updated At: 1/17/2020 12:45:31 AM
Original Doc: installing-the-odbc-jedi-on-linuxunix
Original ID: 509163
Internal: Yes

As previously stated, in order to properly perform the steps defined in this section, you will need a licensed system running jBASE 5.6 or greater, and the ODBC jEDItool-set installation package. If you do not yet have a valid licensed jBASE system, and/or the ODBC jEDItool-set installation package, please contact Zumasys licensing to obtain them.

The installation package is comprised of two components, the ODBCjEDI.jpkg and the jpkginstaller.zip; both can be removed from the target file system after successful installation. After receiving the ODBC jEDItool-set installation package, do the following to ensure successful installation:

  1. Save the installation package's components to a desired location on your file-system

# Note

For this example, **jBASEInstall/**will be the location our components are stored after initial download

  1. Navigate to where your ODBC jEDItool-set components are located on your file system
~$ cd /jBASEInstall
~/jBASEInstall$ ls
~/jBASEInstall$ ODBCjEDI.jpkg
~/jBASEInstall$ jpkginstaller.zip
1
2
3
4
  1. Create **bin/**and lib/ sub-directories in this location
~/jBASEInstall$ mkdir /bin
~/jBASEInstall$ mkdir /lib
1
2
  1. Unzip the jpkginstaller.zipcomponent into the **bin/**sub-directory
~/jBASEInstall$ unzip jpkginstaller.zip -d ./bin
1

# Note

You may need to install the unzip utility if it is not already installed on your OS

  1. Add the **bin/**sub-directory to your $PATH environment variable
~/jBASEInstall$ export PATH=/jBASEInstall/bin:$PATH
1
  1. Run the jpkginstallcommand from the same directory your ODBCjEDI.jpkgfile is located
~/jBASEInstall$ jpkginstall
1
  1. If you do not yet have the **config/**or CSV/ directories created within your $JBCDATADIRdirectory, you will be prompted and asked if you'd like to create them. Enter Yes to have the installer create the directories for you. If you already have these directories set up, the installer will skip to step 7.
Unpacking...

Installation cannot complete: $JBCDATADIR/config cannot be opened

Do you want to create it now? Yes

The default location for storing csv definitions ($JBCDATADIR/CSV) cannot be opened

Would you like to create it now? Yes
1
2
3
4
5
6
7
8
9
  1. You will be prompted and asked if you'd like to view the installer release notes. Enter No to continue with the installation.
Unpacking...    ODBC jEDI Installation

View release notes? No
1
2
3
  1. You will be prompted with the following DSN fields to fill out. The installer will use the data entered into these fields to attempt to connect to a valid data source.
CSV directory:
Table Separator:
VMC Separator:
Passwords Encrypted:
UID:
Database:
Password:
1
2
3
4
5
6
7

# Field Descriptions

DSN - Data Source Name

CSV directory - Directory where csv definitions will be held for generating stubs

Table Separator - Character used to join the primary table and the multi/sub-value table (where applicable)

VMC Separator - Character used to join the VMC column with the multi/sub-value group name (where applicable)

Passwords Encrypted - Controls whether or not the user password will be encrypted in the jEDIdrivers.ini file

UID - User ID for the DSN specified

Database - Database name for the DSN specified

Password - Password for the DSN specified

Below is an example of filled out DSN fields:

DSN:                    SQLServerDSN    SQL Server Native Client 11.0
CSV directory:          /jBASE/CSV  
Table Separator:        _
VMC Separator:          _  
Passwords Encrypted:    Yes
UID:                    sa
Database:               master 
Password:               ********** 
1
2
3
4
5
6
7
8
  1. You will be prompted one last time and asked if you want to continue with your installation. Enter Yes to test your DSN connection. If the connection is successful, you will be told the installation has succeeded. If not, you will need to verify your DSN and the DSNfields in step 8 were set up correctly.
Continue with installation? Yes

Verifying installation... Success.
1
2
3

Introduction to the ODBC jEDI

Installing the ODBC jEDI on Windows

Structure of ODBC jEDI Initialization Files

Structure of ODBC jEDI Mapping Files

Configuring the ODBC jEDI on Linux/Unix

Configuring the ODBC jEDI on Windows

Using the ODBC jEDI