1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP/Vista, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

Create New Data Source


3. On the System DSN tab, click the Add… button.
   

Choose Driver

4. From the list of drivers that appears, choose Merant 3.60 32-bit Progress SQL92 (v9.1; or v10) ODBC Driver (or similar).
5. If you cannot find a suitable Progress Driver you may need to install one. For Skyward users: These drivers should be included with your Skyward installation, but their availability and installation is outside the scope of this document. Please contact Skyward for help in obtaining or installing these drivers.
6. Click Finish. The ODBC Progress SQL92 Driver Setup will appear.

ODBC Progress SQL92 Driver Setup


7. For Data Source Name, enter a name for the data source. Remember the name you choose, it is the same name you should enter in the ODBC DSN box in the Extractor. This can be almost anything, typically the name of your SIS will work.
8. Description This can be left blank, but is best used for reference so others will know what this ODBC is used for.
9. Host Name Enter the name of the system or the IP address, where the database is located.
10. Port Number The service number setup for the database listener process. (may be 12501)
11. Database Name Skyward.
12. User ID This is the default user name that you want to appear when connecting to the data source. It is only required if the database has the security options enabled.

Click the Advanced Tab


13. Default Isolation Level Make sure that the Default Isolation Level is set to READ_UNCOMMITTED.

Troubleshooting:
If after examining the errors below you still cannot find your issue, please email our support department with your issue.

If your extraction fails and you see this error in Acorn or in the log file, it generally indicates that the isolation level was not set.

[DataDirect-Technologies][ODBC PROGRESS driver]Error in row.

Solution:

1. Open the ODBC Data Source Administrator, as above, and ensure the isolation level is set to READ_UNCOMMITTED

Skyward Workstation ODBC Configuration Setup

1. The connection should be made to the Student Database
2. The Student ODBC IP is the IP address of the progress server with the student database.
3. The Student ODBC Port is most likely 12501, but could be anything based on setup of the Database.

Once finished follow the steps in Setting up a Data (ODBC) Connection to ensure the data source has been set up, and to retrieve the DSN name.


Troubleshooting:
There are no specific solutions for problems with this utility.

• IP address of the Pentamation Host
• DNS Hostname of the Pentamation Host
• DBPATH of the Host’s Pentamation student database
• Informix Server Name on the Host
• the Pentamation student database name
• a valid Pentamation access ID and password

Next we will install the Informix client and set up the ODBC DSN. This portion of the setup is fairly technical, so if you are unsure of anything please contact your IT department:

1. 1.Install the Informix client. This is a licensed product from Informix that should have been provided as part of your Informix installation. Generally it is available on CD, or as a file distributed on your network.
2. Place the CD in your CD drive, and explore the CD.
3. Find the setup.exe program: [CD Drive] \ICONNECT\WIN_NT95\Setup.exe (or similar)
4. Run this program (double click on it). Follow the steps on screen:
   

   Welcome

   
5. Click Next.
   

   Enter Serial # and Key

   
6. Click Next.
   

   User Information

   
7. Click Next.
   

   Choose Destination Location

   
8. Click Next.
   

   Setup Type

   
9. Click Next.
   

   Select Program Folder

   
10. Click Next.
    

    Start Copying Files

    
11. Click Next.
    

    Setup Complete

    
12. Once the Intaller has Finished, Click Finish.
13. The Informix Connect Drivers should now be installed

Next we need to do some setup on your computer.

1. Locate the Hosts file in c:\windows\system32\drivers\etc or c:\winnt\system32\drivers\etc and add this line:
   xxx.xxx.xxx.xxx DNSHostName
   Where xxx.xxx.xxx.xxx is the IP Address of your Pentamation Host, and DNSHostName is the DNS name of your Pentamation Host machine.
2. Locate the Services file in c:\windows\system32\drivers\etc or c:\winnt\system32\drivers\etc and add this line:
   sqlexec 1525/tcp
3. The Informix Connect install places a SETNET32 utility in the Start/Programs menu. Click the shortcut to run SETNET32 and ensure these parameters are set:
4. On the Environment tab:
   • INFORMIXDIR=/c:\Informix/
     This is the installation folder of the Informix client.
   • INFORMIXSERVER=/xsrvr/
     This is the name of the Informix server on the host (this may be different if you have a different server name enter it here) DBPATH=//stubase/schdata/
     This is the DBPATH of the Host’s Pentamation student database (again this may be different, if you are having trouble finding this value log on to the server and display the DBPATH this should be the same)
5. On the Server Information tab:
   • Informix Server: /xsrvr/
     Same as INFORMIXSERVER above.
   • Host name: /DNSHostName/
     Same as DNSHostName that was set in the Hosts file in step 2.
   • Protocol: sesoctcp
   • ServiceName: sqlexec
6. Now Click Make Default Server
7. On the Host Information tab:
   • User name: Set with a valid Pentamation ID that has access rights to extract data.
   • Password: Ask Password at runtime.
8. Close the SETNET32 utility.

1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

Create New Data Source


3. On the System DSN tab, click the Add… button.
   

Choose Driver


4. From the list of drivers that appears, choose INFORMIX [version] 32 BIT, and click Finish.
   
5. Informix ODBC Driver Setup screen will appear.
   

Informix ODBC Driver Setup


6. On the General tab: Enter the Data Source Name, enter a name for the data source. Remember the name you choose, it is the same name you should enter in the Pentamation Open Series and Student Plus DSN box in the Extractor.
7. Click on the Connection tab:

   Connection Settings

   
   • Server Name: /xsrvr/ Same as INFORMIXSERVER in step 4. (should be populated already)
   • Host name: DNSHostName Same as DNSHostName in step 2.
   • Service: sqlexec (should be populated already)
   • Protocol: sesoctcp (should be populated already)
   • Database: /studentDBName/ Name of the Pentamation student database.
   • User Id: Valid Pentamation ID
   • Password: password for the above ID
8. Click Apply & Test Connection
9. Click OK.
   

1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

Create New Data Source


3. On the System DSN tab, click the Add… button.
   

Choose Driver


4. From the list of drivers that appears, choose SQL Server, and click Finish.
   

Name Data Source


5. Create a New Data Source to SQL Server screen will appear.
   
6. For Data Source Name, enter a name for the data source. Remember the name you choose, it is the same name you should enter in the ODBC DSN box in the Extractor.
7. Click Next.

Enter Login Information


8. Select the With SQL Server authentication using a login ID and password entered by the user radio button.
   

Select Database


9. Enter the credentials into the Login ID and Password fields. Then click Next.
   Note: You may need to modify Client Configuration. If you have trouble with this step, please talk with your local IT administrator.
   
10. If your Database is not setup as the default database, click on the Change the default database checkbox and select the database from the drop down list.
    Note: You are not required to enter data in the remaining fields.

Finished


11. Click Next.
    
12. Click Finish again to exit the ODBC Data Source Administrator.

1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP/Vista, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

Create New Data Source


3. On the System DSN tab, click the Add… button.
   

Choose Driver


4. From the list of drivers that appears, choose Oracle ODBC Driver (this may be named Oracle in [Oracle Home Name] if you have multiple Oracle installations on your computer – in this case it is important to choose the installation that is used for your SIS).
5. If you cannot find a suitable Oracle Driver you may need to install one: Oracle Driver Install
6. Click Finish. The Oracle ODBC Driver Configuration will appear.

Oracle ODBC Drive Configuration


7. For Data Source Name, enter a name for the data source. Remember the name you choose, it is the same name you should enter in the ODBC DSN box in the Extractor. This can be almost anything, typically the name of your SIS will work.
8. Description This can be left blank, but is best used for reference so others will know what this ODBC is used for.
9. TNS Service Name This is the name of the listener for the Oracle server. This information is dependent on server set up and may have typical values based on the SIS you are using:

Generally in this format: [server address]:[port]/[Listener]

PowerSchool:
The [server address] is the ipaddress of your PowerSchool server.
The [port] should be: 1521.
The [Listener] is the name of the Oracle Listener: most likely PSProdDB

SASIxp:
The listener for SASIxp could be anything, the default listener is Listener, please contact your Oracle DBA for more information.

SchoolMAX:
Generally you will only need the service name for connecting to SchoolMAX. Consult your SchoolMAX documentation, or your Oracle DBA for more information.


10. UserID This is the user name used to log onto the Oracle server.
11. Enable Query Timeout: On the Application tab there is a setting with this label, we suggest unchecking this option when setting up if this ODBC DSN. If checked, long queries (ie section information) may cause the extraction to fail. You may see an error window with this text: [Ora]ORA-01013: user requested cancel of current operation
    
12. Once all of this information is entered click the Test Connection button, you will be prompted for the password for the account, click OK
13. If the entries are correct a Connection successful message will appear, your set is finished, click OK numerous times to exit the Administrator.
14. Once set up you are ready to move on to the next stage of Set Up
    

Troubleshooting:
If after examining the error codes below you still cannot find your issue, please email our support department with your issue, and then try this website: Oracle Error Codes. Please be aware that this site is external to the discovery website.

[Oracle][ODBC][Ora]ORA-01013: user requested cancel of current operation

Solution:

1. Open the ODBC Data Source Administrator.
2. Select the appropriate DSN. Click Configure
3. Ensure that “Enable Query Timeout” is unchecked
4. Click OK.
5. Re-rerun the extraction, this error should not appear now.

This error occurs because the query for the requested information is taking a inordinate amount of time to return, so Oracle cancels the query.

[Oracle][ODBC][Ora]ORA-12170: TNS: Connect timeout occurred

Possible solutions:

• IP address of the TNS Listener may be incorrect
• Ensure local machine is connected to the network
• Ensure server machine is powered on and connected to the network

[Oracle][ODBC][Ora]ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

Possible solutions:

• IP address is correct (if any) but the Listener name is probably incorrect
• Ensure Listener is spelled correctly
• Ensure server machine has a listener set up

[Oracle][ODBC][Ora]ORA-12541: TNS:no listener

Possible solutions:

• Oracle administrator will need to ensure that the TNS Listener is running on the server
• This website has some good advice: http://www.dba-oracle.com/t_ora_12541_tns_no_listener.htm

1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

Create New Data Source


3. On the System DSN tab, click the Add… button.
   

Create New Data Source


4. From the list of drivers that appears, choose Sybase ASE ODBC Driver
5. If you cannot find a suitable Sybase Driver you may need to install one: Sybase Driver Install
6. Click Finish. The Sybase ODBC Driver Configuration will appear.

ODBC Sybase Wire Protocol Driver Setup


7. For Data Source Name, Provide a descriptive name for your data source. This name displays on any list of data sources. ex PowerSchool
8. Description Enter a description for this data source (optional).
9. Network Library Name Select Winsock from the drop-down menu.
10. Network Access Enter your server address followed by the port number. The port numbers are:
    
    5000 if the database resides on a Windows server
    11222 if the database resides on a Mac server
    
    Separate the server address and the port number with a comma (no spaces). ex: district.yourschool.com,11222
11. Note: You are not required to enter data in the remaining fields.
12. Click OK.
13. Click OK again to exit the ODBC Data Source Administrator.

Your Data Source is now set up and ready to be used by the Data Extractor.


Troubleshooting:

1. Click on: Instant Client for Microsoft Windows (32-bit) (Windows XP, Vista 32 bit)
   1. If you are using Vista (64 bit) or Server 2008 (64 bit) you will still need to choose the 32-bit client.
   2. You may need to log on to the Oracle site at this point.
   3. Accept the user license agreement.
2. Under Version 10.2.0.4:
3. Download Instant Client Package – (Basic or Basic Lite)
4. Download Instant Client Package – ODBC
5. These two files are zip archives. You will need to extract them to your computer.
6. Extract them into the same folder: eg. C:\Oracle\InstantClient\
   1. There is a help document in this folder in case you need more help: ODBC_IC_Readme_Win.html.
7. Add this location to your PATH environment variable:
8. Start->Settings->Control Panel->System
   1. Advanced Tab.
   2. Environment Variables
   3. Under System Variables find a variable called PATH or Path.
   4. Select it, and click Edit.
   5. In the Variable value add the path of the Instant Client Package to the current value, separated by semi-colons. eg. You may add this string if this was your saved location from step 6 above:
   
   ;C:\Oracle\InstantClient\instantclient_10_2
   
9. Double click on the odbc_install.exe file in the Instant Client folder.
10. Your Oracle Drivers should be installed.

If you have trouble with this installation, please consult your Pearson Documentation or Oracle’s website for more information.

1. Place the CD in your CD drive, and explore the CD.
2. Find the setup.exe program: [CD Drive]\sybase\installer\setup.exe
3. Run this program (double click on it).
   

   Installer

   
4. Click Next.
5. Choose your Location and Agree to the Terms of the Agreement (after reading them of course). Click Next.

   EULA

   
6. Choose your destination directory.
7. Choose Custom Setup.
8. On the Features page, unselect every option except for ASE Data Providers and the sub group ODBC.

   Installer Features

   
   
   Please note if you have already installed Sybase on this computer, just add the ODBC selection, do not uncheck the already installed items as they may be removed.
9. Click Next.
10. Once you have confirmed everything, click Next.
11. Once the Intaller has Finished, Click Finish.
12. You should now be able to continue with Setting up an PowerSchool ODBC DSN.

1. Open the Windows Data Sources (ODBC) control panel:
   1. From the Start menu, choose Control Panel.
   2. On Windows 2000/XP, open the Administrative Tools folder.
   3. Double-click the Data Sources (ODBC) icon.
2. This will open the ODBC Data Source Administrator:

   Create New Data Source

   
3. On the System DSN tab, click the Add… button.
   
4. From the list of drivers that appears, choose SoftVelocity Topspeed Driver Read-Only (*.tps).
5. Click Finish. The Topspeed Data Source Name Configuration screen will appear.

   Topspeed Data Source Name Configuration

   
6. For Name, enter a name for the data source. Remember the name you choose, it is the same name you should enter in the STI DSN box in the Extractor.
7. Select the Database location, use the Directory button to browse to the location of the STI.tps files.
8. The default for the Topspeed driver is for Treat Empty Strings as NULL to be checked. Make sure that this check box is unchecked as per the picture above.
9. Click OK to create the DSN.

Your Data Source is now set up and ready to be used by the Data Extractor.


Troubleshooting: