SQL Developer: TimesTen Support

1. In the TimesTen Grid view node, right-click the TimesTen Grid folder and select Test Passwordless SSH.
   The Test Passwordless SSH configuration dialog displays. Locate the Instance Administrator Credentials region.
2. In the Instance Administrator text field, type the username of the instance administrator that will create and manage the grid.
3. By default, the Use Password option is selected. In the Use Password text field, type the password of the instance administrator.
   
   

   Note: Alternatively, you can select the Use SSH key file option and use the Browse button to specify an SSH key file. The Use SSH key file option enables you to avoid having to specify the password of the instance administrator. You can generate this SSH key file on any of the hosts of your grid as long as you have successfully setup passwordless SSH between these hosts.

   
   
   Locate the Add Hosts button in the Hosts region.
4. Click Add Hosts once for every host that you want to add to the grid topology.
5. In the Host Address column of the hosts table, type the host address for every host that will be part of the grid topology.
   
   

   Note: In case that you are using different internal and external addresses for a host, use the internal host address.

   
   
6. Click Test.
   The test can take several minutes depending on the number of hosts that you selected. In the Result column of the Details table and the Test Result column of the Hosts table, you should see the text "OK" for every host. If any host displays the text "Failed", ensure that the particular host is configured for passwordless SSH. Locate the Close button at the bottom of the dialog.
7. Click Close
   The Test Passwordless SSH configuration dialog closes.

1. In the Name text field, type a name for your grid. Select a name that is a meaningful identifier. The default value is grid1.
2. Select a K-safety level from the K-safety list. It is recommended that you select a K-safety level of 2.
3. In the Membership Configuration field, specify a ZooKeeper membership configuration file. You can specify the path of the file in the text field or you can use the Browse button to locate a file.
4. If you want to specify a host name for the management instance that is different from the host name that the operating system assigns, deselect the Use Default check box. In the Host Name field, type a name for your management instance host. Select a name that is a meaningful identifier.
5. In the Internal Address field, specify the internal address of the management instance.
6. In the External Address field, specify the external address of the management instance.
7. In the Instance Name field, type a name for your management instance. Select a name that is a meaningful identifier. The default value is instance1.
8. In the Instance Location field, specify the directory where you want TimesTen to create the instance. TimesTen creates a directory with the instance name inside of the directory you specify. For example, if you have an instance name of instance1 and an instance location of /TimesTen/instance/, TimesTen creates your instance in the /TimesTen/instance/instance1/ directory.
9. In the Daemon Port field, specify the port number for the TimesTen daemon. The default value is 6624.
10. In the Client/Server Port field, specify the port number for the TimesTen client/server. The default value is 6625.
11. In the Management Port field, specify the management port number. The default value is 3754.
    The management port is the value for the TCP/IP port number of the first management instance replication agent.
12. In the Software Location field, specify the location of the TimesTen installation file. You can specify the path in the text field or you can use the Browse button to locate the file.
13. In the Installation Location field, specify the directory where you want TimesTen to copy the install file. TimesTen copies the install file and then extracts the installation files. The installation files are extracted to a directory that is named based on the release number of TimesTen Scaleout. For example, if you are installing TimesTen Scaleout 18.1, the files are extracted to a tt18.1.1.1.0 directory inside of the installation location that you specified.
14. If you want to specify a user group that will own the TimesTen installation that is different from the primary user group of the instance administrator, deselect the Use Default check box. In the TimesTen Group field, specify the user group that will own the TimesTen installation. All the installations and instances in the grid will be owned by this user group.
15. In the Instance Administrator field, type the instance administrator of the management instance. Ensure that the instance administrator exists on all intended hosts with a common user ID and numeric UID.
16. By default, the Use Password option is selected. In the Use Password text field, type the password for the instance administrator.
    
    

    Note: Alternatively, you can select the Use SSH key file option and use the Browse button to specify an SSH key file. The Use SSH key file option enables you to avoid having to specify the password of the instance administrator. You can generate this SSH key file on any of the hosts of your grid as long as you have successfully setup passwordless SSH between these hosts.

    
    
17. To avoid SQL Developer prompts for the instance administrator password during future operations, select the Save Password check box.
    You are now ready to have SQL Developer validate your input values. Locate the Next button.
18. Click Next.

1. Right-click the Data Instances folder and select New.
   You are now ready to add the information for your data instance. Locate the Host Name text field.
2. If you want to specify a host name for the data instance that is different from the host name that the operating system assigns, deselect the Use Default check box. In the Host Name field, type a name for your data instance host. Select a name that is a meaningful identifier.
3. In the Internal Address field, specify the internal address of the data instance.
4. In the External Address field, specify the external address of the data instance.
5. In the Instance Name field, type a name for your management instance. Select a name that is a meaningful identifier. The default value is instance1.
6. In the Instance Location field, specify the directory where you want TimesTen to create the instance.
7. In the Daemon Port field, specify the port number for the TimesTen daemon. The default value is 6624.
8. In the Client/Server Port field, specify the port number for the TimesTen client/server. The default value is 6625.
9. In the Installation Location field, specify the directory where you want TimesTen to copy the install file. TimesTen copies the install file and then extracts the installation files. The installation files are extracted to a directory that is named based on the release number of TimesTen Scaleout. For example, if you are installing TimesTen Scaleout 18.1, the files are extracted to a tt18.1.1.1.0 directory inside of the installation location that you specified.
   Locate the Save button.
10. Click Save to save the configuration of your data instance.
    You have successfully added a data instance. When you add a data instance, SQL Developer actually adds a host, an installation, and then an instance. You are now ready to add additional data instances.

    You can add additional hosts with installations and data instances by:

    • Adding a new data instance.

      Right-click the Data Instances folder and select New. Then, follow the steps described in Add Data Instances.

    • Duplicating the configuration of another data instance.

      Right-click the data instance that you want to duplicate and select Duplicate. SQL Developer adds a new data instance with the same configuration values as the original data instance except for the host name, internal address, and external address. Ensure that you enter the values for the host name, internal address, and external address text fields.

    You can remove a data instance by right-clicking the data instance that you want to remove and select Delete.

11. Once you have added all of your intended data instances to your grid, click Next.
    SQL Developer validates your input values and displays a progress dialog. The validation can take a few minutes. If SQL Developer displays an error message, troubleshoot the error and click the Next button again to revalidate your input values.

    The progress dialog closes and the Simple Grid Wizard dialog refreshes. You are now ready to assign your hosts to data space groups.

Organize the hosts that contain one full copy of the data into a single data space group. Since there are k copies of the data, there are an equal number of data space groups, which are numbered from 1 to k. k is the value that you set for the K-safety configuration of your grid. The hosts in one data space group should be physically separate from the group of hosts in another data space group. Thus, hosts in one data space group are more likely to fail together; hosts in separate data space groups are less likely to fail simultaneously.

Once you have assigned a host to a data space group and you have applied that change to the grid model, you cannot change the data space group of that host.

To assign hosts to data space groups:

Right-click the host name that you want to assign to a data space group. Then, select the data space group where you want to assign the host.

Your host gets assigned to the data space group that you selected. Repeat this procedure to assign all of your hosts to data space groups. Ensure that you have the same amount of hosts in each data space group.

Once you have assigned all of your hosts to data space groups, click Next.

The Simple Grid Wizard refreshes and shows a summary table with the configuration for your grid.

Verify that the configuration settings for your grid are correct and click Finish.

The Simple Grid Wizard dialog closes and a Create Grid progress dialog displays. Creating a grid can take a few minutes depending on the number of hosts. If SQL Developer displays an error message, troubleshoot the error. In the case that an error file is generated, the Create Grid progress dialog displays the error file as a hyperlink. You can save the error file and troubleshoot any errors that are listed in the file.

1. In the TimesTen Grid view node, right-click the TimesTen Grid Folder and select New Grid.

   If you are using the new grid option for the first time, a Passwordless SSH dialog displays. Ensure that you have completed the prerequisites that the dialog specifies. If you do not want to see the Passwordless SSH dialog when you use the Simple Grid Wizard, select the Skip This Message Next Time check box. Then, click the Yes button.

   You are now ready to configure your initial management instance.

2. In the Name text field, type a name for your grid. Select a name that is a meaningful identifier. The default value is grid1.
3. Select a K-safety level from the K-safety list. It is recommended that you select a K-safety level of 2.
4. In the Membership Configuration field, specify a ZooKeeper membership configuration file. You can specify the path of the file in the text field or you can use the Browse button to locate a file.
5. If you want to specify a host name for the management instance that is different from the host name that the operating system assigns, deselect the Use Default check box. In the Host Name field, type a name for your management instance host. Select a name that is a meaningful identifier.
6. In the Internal Address field, specify the internal address of the management instance.
7. In the External Address field, specify the external address of the management instance.
8. In the Instance Name field, type a name for your management instance. Select a name that is a meaningful identifier. The default value is instance1.
9. In the Instance Location field, specify the directory where you want TimesTen to create the instance. TimesTen creates a directory with the instance name inside of the directory you specify. For example, if you have an instance name of instance1 and an instance location of /TimesTen/instance/, TimesTen creates your instance in the /TimesTen/instance/instance1/ directory.
10. In the Daemon Port field, specify the port number for the TimesTen daemon. The default value is 6624.
11. In the Client/Server Port field, specify the port number for the TimesTen client/server. The default value is 6625.
12. In the Management Port field, specify the management port number. The default value is 3754.
    The management port is the value for the TCP/IP port number of the first management instance replication agent.
13. In the Software Location field, specify the location of the TimesTen installation file. You can specify the path in the text field or you can use the Browse button to locate the file.
14. In the Installation Location field, specify the directory where you want TimesTen to copy the install file. TimesTen copies the install file and then extracts the installation files. The installation files are extracted to a directory that is named based on the release number of TimesTen Scaleout. For example, if you are installing TimesTen Scaleout 18.1, the files are extracted to a tt18.1.1.1.0 directory inside of the installation location that you specified.
15. If you want to specify a user group that will own the TimesTen installation that is different from the primary user group of the instance administrator, deselect the Use Default check box. In the TimesTen Group field, specify the user group that will own the TimesTen installation. All the installations and instances in the grid will be owned by this user group.
16. In the Instance Administrator field, type the instance administrator of the management instance. Ensure that the instance administrator exists on all intended hosts with a common user ID and numeric UID.
17. By default, the Use Password option is selected. In the Use Password text field, type the password for the instance administrator.
    
    

    Note: Alternatively, you can select the Use SSH key file option and use the Browse button to specify an SSH key file. The Use SSH key file option enables you to avoid having to specify the password of the instance administrator. You can generate this SSH key file on any of the hosts of your grid as long as you have successfully setup passwordless SSH between these hosts.

    
    
18. To avoid SQL Developer prompts for the instance administrator password during future operations, select the Save Password check box.
    You are now ready to have SQL Developer validate your input values. Locate the Create button.
19. Click Create.

    SQL Developer validates your input values and displays a progress dialog. The validation can take a few minutes. If SQL Developer displays an error message, troubleshoot the error and create your grid with the new grid option again.

    The New TimesTen Grid dialog closes and the a progress dialog displays. Creating a grid can take a few minutes. If SQL Developer displays an error message, troubleshoot the error. In the case that an error file is generated, the Create Grid progress dialog displays the error file as a hyperlink. You can save the error file and troubleshoot any errors that are listed in the file.

1. In the TimesTen Grid view node, right-click the TimesTen Grid Folder and select Manage an Existing Grid.
   The Manage an Existing Grid dialog displays. Locate the Host Address text field.
2. In the Host Address field, specify the external address of the active management instance of your grid.
3. In the Instance Home field, specify the instance home directory of your active management instance.
4. In the Instance Administrator field, type the instance administrator of the active management instance.
5. By default, the Use Password option is selected. In the Use Password text field, type the password for the instance administrator.
   
   

   Note: Alternatively, you can select the Use SSH key file option and use the Browse button to specify an SSH key file. The Use SSH key file option enables you to avoid having to specify the password of the instance administrator. You can generate this SSH key file on any of the hosts of your grid as long as you have successfully setup passwordless SSH between these hosts.

   
   
6. To avoid SQL Developer prompts for the instance administrator password during future operations, select the Save Password check box.
   You are now ready to have SQL Developer validate your input values. Locate the Test button.
7. Click Test.

   A progress dialog displays. The test process can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Once the test process completes, a Test Grid Existence dialog displays. Locate the OK button.

8. Click OK.
   The Test Grid Existence dialog closes. You are now ready to save the configuration of your existing grid.

   Locate the OK button.

9. Click OK.

   SQL Developer validates your input values and displays a progress dialog. The validation can take a few minutes. If SQL Developer displays an error message, troubleshoot the error and fix any invalid input values.

   Once SQL Developer completes validation, a Manage an Existing Grid confirmation dialog displays. Locate the OK button.

10. Click OK.
    The Manage an Existing Grid dialog closes.

1. Right-click the name of your grid, select Grid Control, then select Shutdown.

   The Shutdown Grid Wizard dialog and Updating databases information progress dialog display.

   The Updating databases information progress dialog closes. If a database has open connections, click the link in the Applications Connection column of the database table to view active connections to a specific database. Ensure that you close all applications that are connected to the database before shutting down a grid.

   Locate the Unload databases button.

2. Click Unload databases.
   The Updating databases information progress dialog displays. Unloading databases can take a few minutes depending on the number of databases. If SQL Developer displays an error message, troubleshoot the error.

   
   

   Note: For databases from a version prior to TimesTen Scaleout 18.1.2, if you are unable to disconnect an application from a database, SQL Developer may be unable to unload that database. If that is the case, you can cancel the unload databases process and go to step 3 to attempt to unload your data instances. For databases from TimesTen Scaleout 18.1.2 or higher, you may use the Force All User Connections to Disconnect check box. SQL Developer will attempt to abort all user connections if it fails to terminate them by using the transactional and immediate modes. Forcing all user connections to disconnect may result in data loss.

   
   

   The Updating databases information progress dialog closes. In the output text area, you should see the text "All databases are unloaded."

   Locate the Next button.

3. Click Next.

   The Shutdown Grid wizard dialog refreshes and the Updating instances information progress dialog displays. The Updating instances information progress dialog closes.

   Locate the Stop instances button.

4. Click Stop Instances.
   
   

   Note: Optionally, select the Force action check box of a specific instance to forcefully stop that instance. Forcefully stopping an instance may result in data loss. It is recommended to have a backup of your data before forcefully stopping an instance.

   
   

   The Updating instances information progress dialog displays. Stopping instances can take a few minutes depending on the number of instances. If SQL Developer displays an error message, troubleshoot the error.

   The Updating instances information progress dialog closes. In the output text area, you should see the text "All data instances are down."

   Locate the Next button.

5. Click Next.

   The Shutdown Grid wizard dialog refreshes and the Updating instances information progress dialog displays. The Updating instances information progress dialog closes.

   Locate the Stop instances button.

6. Click Stop instances.

   The Updating instances information progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   The Updating instances information progress dialog closes. In the output text area, you should see the text "All management instances are down."

   Locate the Finish button.

7. Click Finish.
   The Shutdown Grid Wizard dialog closes.

1. Right-click the name of your grid, select Grid Control, then select Start.
   The Start Grid Wizard dialog and Updating instances information progress dialog display. The Updating instances information progress dialog closes.

   Locate the Start instances button.

2. Click Start instances.

   The Updating instances information progress dialog displays. Starting instances can take a few minutes depending on the number of instances. If SQL Developer displays an error message, troubleshoot the error.

   The Updating instances information progress dialog closes. In the output text area, you should see the text "All management instances are up and running."

   Locate the Next button.

3. Click Next.

   The Start Grid Wizard dialog refreshes and the Updating instances information progress dialog displays. The Updating instances information progress dialog closes.

   Locate the Start instances button.

4. Click Start instances.

   The Updating instances information progress dialog displays. Starting instances can take a few minutes depending on the number of instances. If SQL Developer displays an error message, troubleshoot the error.

   The Updating instances information progress dialog closes. In the output text area, you should see the text "All data instances are up and running."

   Locate the Next button.

5. Click Next.

   The Updating databases information progress dialog displays. The Updating databases information progress dialog closes.

   The Start Grid wizard dialog refreshes.

   Locate the Load databases button.

6. Click Load databases.

   The Updating databases information progress dialog displays. Loading databases can take a few minutes depending on the number of databases. If SQL Developer displays an error message, troubleshoot the error.

   The Updating databases information progress dialog closes. In the output text area, you should see the text "All databases are loaded"

   Locate the Finish button.

7. Click Finish.
   The Start Grid Wizard dialog closes.

1. Right-click the name of your grid, select Grid Model, then select Apply Changes.

   The Comparing current and latest grid dialog model dialog displays. Comparing grid models can take a few minutes.

   If SQL Developer does not find any changes between the current and latest grid model, the Comparing current and latest grid dialog model dialog displays the text "Latest model is up to date with current model". Click Close to close the dialog.

   If SQL Developer finds any changes between the current and latest grid model, a Changes in current grid model dialog displays. Locate the changes table.

2. Review that the changes listed in the table are grid model changes that you want to apply to the grid.
3. Click Yes.
   The Changes in current grid model dialog closes and a Apply Changes dialog displays. Applying changes to the grid model can take a few minutes depending on the number of grid model changes. If SQL Developer displays an error message, troubleshoot the error.
4. Click Close.
   The Apply Changes dialog closes.

1. Right-click the name of your grid, select Grid Model, then select Export.
   The Export Grid Model dialog displays. Locate the Choose Version to Export region.
2. From the Choose Version to Export region, select a version of the configuration to export. These are the options:

   • Current - This is the current grid model that is applied to the grid.

   • Latest - This is the latest grid model that is not yet applied to the grid.

   • Version - This is the version of the configuration file that you can select. If you select this option, use the text field to the right of the Version radio button to select the version to export.

   Locate the Browse button.

3. Click Browse.
   The Export file dialog displays. Specify the location of where you want to export the grid model file.
4. In the File Name text field, specify a meaningful name for the grid model file and click Save.
   The Export file dialog closes. In the Export dialog, locate the Export button.
5. Click Export.

   The Verifying File Location progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   The Verifying File Location progress dialog and the Export Grid Model dialog close. The Export grid model progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

6. Click Close.
   The Export grid model progress dialog closes.

SQL Developer enables you to view the changes between your current and latest grid model. These changes are not yet applied to your grid model.

To view the changes to your grid model, ensure that you are on the main SQL Developer page, that you have enabled the TimesTen Grid view, and that your grid node is expanded.

Right-click your grid node, select Grid Model, then select Show Changes.

The Comparing current and latest grid model progress dialog displays.

If there are no changes between your current and latest grid model, you see the message "Latest model is up to date with current model". Click Close.

If there are changes between your current and latest grid model, the Comparing current and latest grid model progress dialog closes and the Changes in current grid model dialog displays. Review the changes to your grid mode and click Close.

You have successfully viewed the changes between your current and latest grid model.

1. Expand the Grid Model option, right-click the Physical Groups option, then select New Physical Group.
   The New Physical Group dialog displays. Locate the Physical Group Name text field. Select a name that is a meaningful identifier.
2. In the Physical Group name text field, specify the name of the physical group. Select a name that is a meaningful identifier.
   
   

   Note: Step 3 is only required if you want to assign an existing host to the physical group. If you do not want to assign an existing host to the physical group, skip to step 4. Once you add a new host to the grid model, you are able to assign that host to a specific physical group.

   
   
3. In the Excluded list, locate the row that contains the host name that you want to assign to your new physical group. Double click the host name. If you want to assign multiple hosts, double click the corresponding host name of any additional host.
4. Click OK.

   The New Physical Group dialog closes and a Creating Physical Group progress dialog displays. Creating a physical group can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   If you are adding or editing a grid model object for the first time, a Apply Changes dialog displays. This dialog shows you a reminder to apply your changes to the grid model. If you do not want to see this dialog when you add or edit a grid model object, select the Skip This Message Next Time check box. Then, click the OK button.

   Locate the Close button in the Creating Physical Group progress dialog.

5. Click Close.
   The Creating Physical Group progress dialog closes.

1. Expand the Grid Model option, expand the Physical Groups option, right-click the name of the physical group, then select Edit.
   The Add Hosts to Physical Group dialog displays. Locate the Excluded and Selected lists. Identify the hosts that you want to assign or remove from the physical group.
2. In the Excluded list, locate the row that contains the host name that you want to assign to your physical group. Double click the host name. If you want to assign multiple hosts, double click the corresponding host name of any additional host.
3. In the Selected list, locate the row that contains the host name that you want to remove from your physical group. Double click the host name. If you want to remove multiple hosts, double click the corresponding host name of any additional host.
   Review the Excluded list to ensure that the list contains the hosts that you want to remove from your physical group. Review the Selected list to ensure that the list contains the hosts that you want to assign to your physical group. Locate the OK button.
4. Click OK.

   The Add Hosts to Physical Group dialog closes and a Assigning Physical Group progress dialog displays. Assigning hosts to physical groups can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the Add Hosts to Physical Group progress dialog.

5. Click Close.
   You have successfully edited a physical group in the grid model. However, you need to apply your changes to the grid. Changes made to the grid model do not immediately impact a grid until you explicitly apply these changes. See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

1. Expand the Grid Model option, right-click the Hosts option, then select New Host.

   The New Host dialog displays. Locate the Host Name text field.

   In some cases, a Passwordless SSH dialog displays. Ensure that you have completed the prerequisites that the dialog specifies. If you do not want to see the Passwordless SSH dialog again, select the Skip This Message Next Time check box. Then, click the Yes button.

2. If you want to specify a host name for the host that is different from the host name that the operating system assigns, deselect the Use Default check box. In the Host Name field, type a name for your host. Select a name that is a meaningful identifier.
3. In the Internal Address field, specify the internal address of the host.
4. In the External Address field, specify the external address of the host.
5. From the Data Space Group drop-down list, select the data space group where you want to assign the host.
   
   

   Note: Steps 6-8 are only required if you are using physical groups. If you do not want to use physical groups, skip to step 9.

   
   
6. To select a physical group for this host, click the Select button to the right of the Physical Group(s) field.
   The Physical Group(s) dialog displays. Locate the Excluded list.
7. In the Excluded list, locate the row that contains the physical group to which you want to assign to your host. Double click the physical group name. If you want to assign your host to multiple physical groups, double click the corresponding physical group name of any additional physical group.
   Review the Selected list to ensure that the list contains the physical groups to which you want to assign your host. Locate the OK button.
8. Click OK.
   The Physical Group(s) dialog closes and the New Host dialog refreshes. Locate the OK button in the New Host dialog.
9. Click OK.

   The New Host dialog closes and a New Host progress dialog displays. Adding a new host can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the New Host progress dialog.

10. Click Close.
    You have successfully added a new host to the grid model. However, you need to apply your changes to the grid. Changes made to the grid model do not immediately impact a grid until you explicitly apply these changes. See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

1. Expand the Grid Model option, expand the Hosts options, right-click the host that you want to clone, then select Clone.

   In some cases, a Passwordless SSH dialog displays. Ensure that you have completed the prerequisites that the dialog specifies. If you do not want to see the Passwordless SSH dialog again, select the Skip This Message Next Time check box. Then, click the Yes button.

   If you are cloning a management instance for the first time, a Management Instance dialog displays. Ensure that you are sure that you want to clone a management instance. If you do not want to see the Management Instance dialog when you clone a management instance, select the Skip This Message Next Time check box. Then, click the Yes button.

   The Clone Host dialog displays.

2. If you want to specify a host name for the host that is different from the host name that the operating system assigns, deselect the Use Default check box. In the Host Name field, type a name for your host. Select a name that is a meaningful identifier.
3. In the Internal Address field, specify the internal address of the host.
4. In the External Address field, specify the external address of the host.
   You are now ready to clone the host. Locate the OK button.
5. Click OK.

   The Clone Host dialog closes and a Clone Host progress dialog displays. Cloning a host can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the Clone Host progress dialog.

6. Click Close.

1. Expand the Grid Model option, expand the Hosts options, right-click the host that you want to edit, then select Edit.
   The Edit Host dialog displays.
2. From the Data Space Group drop-down list, select the data space group where you want to assign the host.
   Once you have assigned a host to a data space group and you have applied that change to the grid model, you cannot change the data space group of that host.
3. To select a physical group for this host, click the Select button to the right of the Physical Group(s) field.
   The Physical Group(s) dialog displays. Locate the Excluded and Selected lists. Identify the physical group(s) to which you want to assign your host.
4. In the Excluded list, locate the row that contains the physical group to which you want to assign your host. Double click the host name. If you want to assign your host to multiple physical groups, double click the corresponding physical group name of any additional physical group.
5. In the Selected list, locate the row that contains the physical group from which you want to withdraw your host. Double click the host name. If you want to withdraw multiple physical groups, double click the corresponding physical group name of any additional physical group.
   Review the Excluded list to ensure that the list contains the physical groups from which you want to withdraw your host. Review the Selected list to ensure that the list contains the physical groups to which you want to assign your host. Locate the OK button.
6. Click OK.
   The Physical Group(s) dialog closes. Locate the OK button in the Edit Host dialog.
7. Click OK.

   The Edit Host dialog closes and the Edit Host progress dialog displays. Editing a host can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the Edit Host progress dialog.

8. Click Close.
   You have successfully edited a host. However, you need to apply your changes to the grid. Changes made to the grid model do not immediately impact a grid until you explicitly apply these changes. See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

1. Expand the Grid Model option, right-click the Hosts options, then select Assign to Data Space Groups.
   The Assign Hosts to Data Space Groups dialog displays. Locate the host that you want to assign to a data space group.
2. Right-click the host name that you want to assign to a data space group. Then, select the data space group where you want to assign the host.
   
   

   Note: If you have configured physical groups, you can click the Suggest Assignment button to have TimesTen Scaleout suggest data space groups for your hosts. Ensure that you have configured physical groups before using the Suggest Assignment button.

   
   

   Your host gets assigned to the data space group that you selected. Repeat this procedure to assign all of your hosts to data space groups. Ensure that you have the same amount of hosts in each data space group.

3. Once you have assigned all of your hosts to data space groups, click OK.

   The Assign Hosts to Data Space Groups progress dialog displays. Assigning hosts to a data space group can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   The Assign Hosts to Data Space Groups progress dialog and the Assign Hosts to Data Space Groups dialog close.

1. Expand the Grid Model option, expand the Hosts options, right-click the host on which you want to execute a command, then select Execute Command.
   The Execute Command dialog displays. Locate the Excluded folder in the right part of the Execute Command dialog.

   
   

   Note: If you want to see the data space group of each host, check the Show Data Space Group check box that is located at the bottom of the Execute Command dialog. This option separates the hosts in the Included and Excluded folders based on the data space group of each host.

   
   
2. In the Excluded folder, locate the host on which you want to execute a command. Right-click the host name and select Move. If you want to execute a command on additional hosts, right-click the corresponding host name and select Move for any additional hosts.
   Review the Included folder to ensure that the list contains the hosts on which you want to execute a command. Review the Excluded folder to ensure that the list contains the hosts on which you do not want to execute a command. Locate the Run Command text field.
3. In the Run command text field, type the command that you want to execute on the hosts that you selected.
   Locate the Execute button.
4. Click Execute.

   TimesTen Scaleout executes the command on all of the hosts that you selected. SQL Developer displays a tab with the output of every host. You can click on a host tab to view the output of the command for that specific host. You can save the output of a host by clicking the Save button. You can also save the output of every host by clicking the Save All button.

   You have successfully executed a command on a host from your grid. You can execute additional commands by typing the new command in the Execute command text field and then clicking the Execute button. Once you have finished executing commands on your hosts, locate the Close button.

5. Click Close.
   The Execute command dialog closes.

1. Expand the Grid Model option, expand the Hosts options, expand the host on which you want to create an installation, right-click the Installations option, then select New Installation.
   The New Installation dialog displays. Locate the Installation Name text field.
2. In the Installation Name field, type a name for your installation. Select a name that is a meaningful identifier. The default value is installationn, where n is the next sequential number based on your highest numbered installation name. For example, if you have an installation named installation1, the default value is installation2.
   Locate the Select Source region of the New Installation dialog.
3. In the Location field, specify the directory on your selected host where the TimesTen installation file can be copied.
4. Select an installation source from the Select Source radio buttons. These installation sources are available:

   • Use Existing Source

   • New Source

1. Right-click the name of your grid, select Grid Management, then select New Management Instance.
   The New Management Instance dialog displays. Locate the Select Host region.
2. From the Select Host drop-down list, select the host where you want to create the management instance.
   If you want to add a new host, click the New button next to the Select Host drop-down list.
3. From the Select Installation drop-down list, select the installation that you want to use for the management instance. If you selected a host without an existing TimesTen installation, you need to create an installation on your selected host.
   If you want to create a new installation, click the New button next to the Select Installation drop-down list. See Create a New Installation for more information on the New Installation dialog.
4. In the Instance Name field, type a name for your management instance. Select a name that is a meaningful identifier. The default value is instance1.
5. In the Instance Location field, specify the directory where you want TimesTen to create the instance. TimesTen creates a directory with the instance name inside of the directory you specify. For example, if you have an instance name of instance1 and an instance location of /TimesTen/instance/, TimesTen creates your instance in the /TimesTen/instance/instance1/ directory.
6. In the Daemon Port field, specify the port number for the TimesTen daemon.

   If you selected a host without a TimesTen instance, the default value for the TimesTen daemon port is 6624.

   If you selected a host with a TimesTen instance, the default value is the daemon port of your original instance plus 100. For example, if your original instance has a daemon port of 6624, the default value is 6724.

7. In the Client/Server Port field, specify the port number for the TimesTen client/server.

   If you selected a host without a TimesTen instance, the default value for the TimesTen client/server port is 6625.

   If you selected a host with a TimesTen instance, the default value is the client/server port of your original instance plus 100. For example, if your original instance has a client/server port of 6625, the default value is 6725.

8. In the Management Port field, specify the management port number.

   The management port is the value for the TCP/IP port number of the first management instance replication agent.

   If you selected a host without a TimesTen instance, the default value for the management port is 3754.

   If you selected a host with a TimesTen instance, the default value is the management port of your original instance plus 100. For example, if your original instance has a management port of 3754, the default value is 3854.

9. Click OK.

   The Creating grid object(s) progress dialog displays. If your selected instance directory does not exist, a confirmation dialog displays to ensure that you want to create the new directory. If this warning dialog displays, click Yes.

   Creating a management instance can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   The Management Instance dialog closes.

   Locate the Close button.

10. Click Close.
    You have successfully created a TimesTen management instance. However, you need to apply your changes to the grid. Changes made to the grid model do not immediately impact a grid until you explicitly apply these changes. See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

1. Expand the Management Instances option, right-click the management instance, then select Replace.
   The Replace Management Instance dialog displays.
2. From the Select Installation drop-down list, select the installation that you want to use for the management instance. If you selected a host without an existing TimesTen installation, you need to create an installation on your selected host.
   If you want to create a new installation, click the New button next to the Select Installation drop-down list. See Create a New Installation for more information on the New Installation dialog.
3. In the Instance Name field, type a name for your management instance. Select a name that is a meaningful identifier. The default value is instance1.
4. In the Instance Location field, specify the directory where you want TimesTen to create the instance. TimesTen creates a directory with the instance name inside of the directory you specify. For example, if you have an instance name of instance1 and an instance location of /TimesTen/instance/, TimesTen creates your instance in the /TimesTen/instance/instance1/ directory.
5. In the Daemon Port field, specify the port number for the TimesTen daemon.

   If you selected a host without a TimesTen instance, the default value for the TimesTen daemon port is 6624.

   If you selected a host with a TimesTen instance, the default value is the daemon port of your original instance plus 100. For example, if your original instance has a daemon port of 6624, the default value is 6724.

6. In the Client/Server Port field, specify the port number for the TimesTen client/server.

   If you selected a host without a TimesTen instance, the default value for the TimesTen client/server port is 6625.

   If you selected a host with a TimesTen instance, the default value is the client/server port of your original instance plus 100. For example, if your original instance has a client/server port of 6625, the default value is 6725.

7. In the Management Port field, specify the management port number.

   The management port is the value for the TCP/IP port number of the first management instance replication agent.

   If you selected a host without a TimesTen instance, the default value for the management port is 3754.

   If you selected a host with a TimesTen instance, the default value is the management port of your original instance plus 100. For example, if your original instance has a management port of 3754, the default value is 3854.

8. Click OK.

   The Replace Management Instance progress dialog displays. If your selected instance directory does not exist, a confirmation dialog displays to ensure that you want to create the new directory. If this warning dialog displays, click Yes.

   Replacing a management instance can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   The Replace Management Instance dialog closes.

   Locate the Close button.

9. Click Close.
   You have successfully created a new management instance, deleted an old management instance, and set the new management instance as your standby management instance. However, you need to apply your changes to the grid. Changes made to the grid model do not immediately impact a grid until you explicitly apply these changes. See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

SQL Developer enables you to create a new data instance with a data instance wizard or directly on a specific host.

Consider the following before creating a new data instance:

• Ensure that the hosts on which you create data instances for database distribution are assigned to a data space group. If you attempt to create a data instance on a host that is not assigned to a data space group, TimesTen Scaleout does not create that data instance. See Assign Hosts to Data Space Groups for more information on assigning a host to a data space group.

Use one of these options to create a data instance:

• New Data Instance Wizard  - This option enables you to specify the host on which the instance is created.

• New Data Instance on a Specific Host - This option enables you to select the host on which the instance is created before opening the dialog.

1. Expand the Grid Model option, expand the Hosts options, expand the host on which your instance is located, expand the Instances option, then right-click the instance and select one of these options:

   • Start - This option starts the TimesTen instance.

   • Start Server - This option starts the TimesTen server.

   • Stop - This option stops the TimesTen instance.

   • Stop Server - This option stops the TimesTen server.

   A confirmation dialog displays. Locate the OK button.

   
   

   Note: If you want to immediately start or stop a service and ignore warnings, select the Force Action check box.

   
   
2. Click OK.
   The confirmation dialog closes. Starting or stopping a TimesTen instance or TimesTen server can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

1. Expand the Grid Model option, expand the Hosts options, expand the host on which your instance is located, expand the Instances option, then right-click the instance and select Edit.
   The Edit Instance dialog displays.
2. From the Installation drop-down list, select the new installation that you want to use for your instance.
3. Click OK.

   The Edit Instance dialog closes and the Edit Instance progress dialog displays. Editing an instance can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the Edit Instance progress dialog.

4. Click Close.
   The Edit Instance progress dialog closes.

1. Expand the Grid Model option, then right-click the configuration file name and select Import.
   The Import dialog displays. Locate the Browse button.
2. Click Browse.
   The Import file dialog displays. Browse for your configuration file.
3. Select your configuration file and click Open.
   The Import file dialog closes. In the Import dialog, locate the Import button.
4. Click Import.

   The Verifying File Location progress dialog displays. SQL Developer verifies that the configuration file that you specified is a valid file. If SQL Developer displays an error message, troubleshoot the error.

   The Verifying File Location progress dialog and the Import Configuration dialog close. The Importing Configuration progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

5. Click Close.
   The Import Configuration progress dialog closes.

1. Expand the Grid Model option, then right-click the configuration file name and select Export.
   The Export dialog displays. Locate the Choose Version to Export region.
2. From the Choose Version to Export region, select a version of the configuration to export. These are the options:

   • Current - This is the current configuration file that is applied to the grid.

   • Latest - This is the latest configuration file that is not yet applied to the grid.

   • Version - This is the version of the configuration file that you can select. If you select this option, use the text field to the right of the Version radio button to select the version to export.

   Locate the Browse button.

3. Click Browse.
   The Export file dialog displays. Specify the location of where you want to export the configuration file.
4. In the File Name text field, specify a meaningful name for the configuration file and click Save.
   The Export file dialog closes. In the Export dialog, locate the Export button.
5. Click Export.

   The Verifying File Location progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   The Verifying File Location progress dialog and the Export Configuration dialog close. The Export Configuration progress dialog displays. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

6. Click Close.
   The Export Configuration progress dialog closes.

1. Right-click the Databases option and then select New Database.

   The TimesTen Grid Database Wizard dialog and Comparing current and latest grid model progress dialog displays.

   If you have made changes to your grid model and have not applied the model changes, the Comparing current and latest grid model progress dialog closes and a Changes in current grid model dialog displays. This dialog displays objects that have been added, changed, or removed from the grid model. Creating a database involves applying the grid model changes, so ensure that you want these grid model changes to be applied. Locate the OK button of the Changes in current grid model dialog.

   See Apply Grid Model Changes to the Grid for more information on applying model changes to a grid.

   If you have not made changed to your grid model, locate the Close button of the Comparing current and latest grid model progress dialog.

2. Depending on the dialog that displays, either click OK or Close.

   Depending on the dialog that displayed, the Changes in current grid model dialog or the Comparing current and latest grid model progress dialog closes. The TimesTen Grid Database Wizard displays.

   Locate the Database Name field.

3. In the Database Name text field, type a name for your database. Select a name that is a meaningful identifier. The default value is database1.
   
   

   Note: Optionally, you can import a database definition file to load attribute values for your database definition. The database definition file must use .dbdef as the file name extension. To import a database definition file, click the Import Definition button. Then, select your database definition file and click Open. If an attribute value was set in the wizard before you imported the database definition file, the attribute value changes to the value that is defined in the database definition file. Once you have imported the database definition file, you can still edit the database definition within the wizard. If you do not want to keep editing the database definition, skip to step 5.

   
   

   If your grid already contains a database, the default value of the database name of your original database plus 1. For example, if your original database name is database1, the default value is database2.

4. Set the connection attributes for your database. You can set these connection attributes:

   • Data Store Attribute - Attributes that are set at database creation time.

     
     

     Note: Ensure that you set a valid path for the DataStore attribute. This path must be valid on every host for every data instance. It is best practice to specify LogDir and have it be a different location from DataStore.

     
     

   • First Connection Attribute - Attributes that are set when a database is loaded into memory.

   • General Connection Attribute - Attributes that are set by each connection and persist for the duration of the connection. These attributes are added to a connectable and not are part of a database definition.

   To set any attribute that is part of the type of connection attributes listed above, select the relevant tab. Each tab of connection attributes contains a list of attributes with default values. You can edit the value of an attribute by double clicking the value from the value column of an attribute. Depending on the connection attribute, you can edit the value with a text field or a drop-down list of valid values.

   You can add additional connection attributes by selecting a connection attribute from the drop-down list located below the connection attribute tabs and then clicking Add. If a connection attribute is not listed in the drop-down list, you can select the New Attribute option and enter the connection attribute name in the Attribute column of the connection attribute table.

   You can remove a connection attribute by selecting a connection attribute from the connection attribute table and then clicking Delete.

5. Once you have set your connection attributes, click Next.

   SQL Developer validates your connection attribute values. If SQL Developer displays an error message, troubleshoot the error and click the Next button again to revalidate your input values.

   The Checking Directory Attributes dialog displays. Checking for a directory can take a few minutes. If your selected database directory does not exist on the host of a data instance, a confirmation dialog displays to ensure that you want to create the new directory on that host. If this warning dialog displays, click Yes.

   
   

   Note: SQL Developer creates the selected database directory on all hosts of available data instances.

   
   

   The Checking Directory Attributes dialog closes and the TimesTen Grid Database Wizard dialog refreshes. Locate the Database Distribution map.

6. By default, the default value is the maximum number of data instances based on their data space group without leaving a replica set incomplete. Review the SQL Developer suggestion for data instances and perform any necessary modifications.
   
   

   Note: If you do not want to configure the distribution map in this wizard, check the Skip database distribution check box and click Next. See Define the Distribution Map of a Database for more information on defining a distribution map for a database.

   
   

   
   

   Note: Ensure that each data space group contains the same number of data instances to create complete replica sets. If your data space groups do not contain the same number of data instances, an error dialog displays after you click the Apply button.

   
   

   If you want to remove a suggested data instance, right-click the instance name and select Remove.

   If you want to add a data instance from the Available column, right-click the instance name and select Add.

7. Once you have selected all of your data instances for data distribution, click Next.
   The TimesTen Grid Database Wizard refreshes and shows a summary table with the configuration for your database.
8. Verify that the configuration settings for your database are correct and click Finish.
   
   

   Note: Optionally, click the Export Definition button to save the database definition as a .dbdef file.

   
   

   The TimesTen Grid Database Wizard dialog closes and a Creating Database progress dialog displays. Creating a database can take a few minutes depending on the number of data instances included in the distribution map. If SQL Developer displays an error message, troubleshoot the error. In the case that an error file is generated, the Creating Database progress dialog displays the error file as a hyperlink. You can save the error file and troubleshoot any errors that are listed in the file.

   
   

   Note: If SQL Developer displays an error or if you cancel the database creation process, review the grid navigator to see if the database and definition file were created. In case that a database or database definition was created, delete the database and database definition. Then, create a new database. See Destroy a Database for more information on deleting a database.

   
   
9. Click Close.
   The Creating Database progress dialog closes.

1. Expand the Grid Model option, right-click the Database Definitions option, then select New Database Definition.
   The New Database Definition dialog displays. Locate the Database Name field.
2. In the Database Name text field, type a name for your database. Select a name that is a meaningful identifier. The default value is database1.
   
   

   Note: Optionally, you can import a database definition file to load attribute values for your database definition. The database definition file must use .dbdef as the file name extension. To import a database definition file, click the Import Definition button. Then, select your database definition file and click Open. If an attribute value was set in the wizard before you imported the database definition file, the attribute value changes to the value that is defined in the database definition file. Once you have imported the database definition file, you can still edit the database definition within the wizard. If you do not want to keep editing the database definition, skip to step 4.

   
   

   If your grid already contains a database, the default value is the database name of your original database plus 1. For example, if your original database name is database1, the default value is database2.

3. Set the connection attributes for your database definition. You can set these connection attributes:

   • Data Store Attribute - Attributes that are set at database creation time.

     
     

     Note: Ensure that you set a valid path for the DataStore attribute. This path must be valid on every host for every data instance.It is best practice to specify LogDir and have it be a different location from DataStore.

     
     

   • First Connection Attribute - Attributes that are set when a database is loaded into memory.

   • General Connection Attribute - Attributes that are set by each connection and persist for the duration of the connection.

   To set any attribute that is part of the type of connection attributes listed above, select the relevant tab. Each tab of connection attributes contains a list of attributes with default values. You can edit the value of an attribute by double clicking the value from the value column of an attribute. Depending on the connection attribute, you can edit the value with a text field or a drop-down list of valid values.

   You can add additional connection attributes by selecting a connection attribute from the drop-down list located below the connection attribute tabs and then clicking Add. If a connection attribute is not listed in the drop-down list, you can select the New Attribute option and enter the connection attribute name in the Attribute column of the connection attribute table.

   You can remove a connection attribute by selecting a connection attribute from the connection attribute table and then clicking Delete.

4. Once you have set your connection attributes, click OK.

   SQL Developer validates your connection attribute values. If SQL Developer displays an error message, troubleshoot the error and click the OK button again to revalidate your input values.

   The Checking Directory Attributes dialog displays. Checking for a directory can take a few minutes. If your selected database directory does not exist on the host of a data instance, a confirmation dialog displays to ensure that you want to create the new directory on that host. If this warning dialog displays, click Yes.

   
   

   Note: SQL Developer creates the selected database directory on all hosts of available data instances.

   
   

   The Checking Directory Attributes dialog closes and the Creating Database Definition progress dialog displays. Creating a database definition can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

5. Click Close.
   The Creating Database Definition progress dialog closes.

SQL Developer enables you to edit an existing database definition.

Before you edit an existing database definition:

• If you want to edit a database attribute and there is a database that was created from the database definition you are editing, you must stop the database, destroy it, and recreate it with the new database attributes. Since you are destroying the database, this causes you to lose all data in that database.

• If you want to edit a general connection attribute, edit the respective connectable because general connection attributes are associated with a connectable. See Edit a Connectable for more information.

• If you edit a first connection attribute of a database definition of an open database, these changes are not applied until you unload and reload the database. SQL Developer displays a warning message if your database is currently open when you edit the database definition.

To edit a database definition, ensure that you are on the main SQL Developer page, that you have enabled the TimesTen Grid view, and that your grid node is expanded.

Expand the Grid Model option, expand the Database Definitions option, right-click the name of your database definition, then select Edit.

The Edit Database Definition dialog and the Checking if database exists progress dialog display.

If there is an open database that was created from the database definition you are editing, the Checking if database exists progress dialog closes and a Editing open database warning dialog displays. If you do not want to see the Editing open database warning for future operations, select the Skip This Message Next Time check box. Then, click the OK button.

If there is no open database that was created from the database definition you are editing, the Checking if database exists progress dialog closes.

Follow the steps, starting on step 3, as described in Create a Database Definition.

1. Expand the Databases option, right-click the name of your database, then select Redistribute.
   The Distribution for database dialog displays. Locate the Database Distribution map.
2. If you want to add a data instance from the Available column, right-click the instance name and select Add.

   If you want to remove a suggested data instance, right-click the instance name and select Remove. If you want to replace the data instance that you are removing, select Remove and replace with and select the new data instance.

   If you want to evict a data instance, right-click the instance name and select Evict. Only evict a data instance if you are unable to fix that data instance and you have a backup of the data from that data instance. Evicting a data instance can result in data loss. If you want to replace the data instance that you are evicting, Select Evict and replace with and select the new data instance.

   
   

   Note: Ensure that each data space group contains the same number of data instances to create complete replica sets. If your data space groups do not contain the same number of data instances, an error dialog displays after you click the Apply button.

   
   
3. Once you have selected all of your data instances for data distribution, click Apply.

   The Performing operations progress dialog displays. Defining the distribution map of a new database can take a few minutes. If you are redistributing the data of an existing database, the redistribution can take up to a few hours. If SQL Developer displays an error message, troubleshoot the error.

   Once the distribution map of your database is applied, the Performing operations progress dialog closes and the Distribution for database dialog refreshes. The distribution map shows how your data instances are distributed in replica sets and data space group.

   Locate the Close button.

4. Click Close.
   The Distribution for database dialog closes.

SQL Developer enables you to start, load, open, stop, close, and unload the TimesTen database.

To start, load, open, stop, close, or unload the TimesTen database, ensure that you are on the main SQL Developer page, that you have enabled the TimesTen Grid view, and that your grid node is expanded.

Expand the Databases option, then right-click the name of your database and select one of these options:

• Start - Loads every element of the database into memory of their respective hosts and enables the database for user connections. This option does the same thing as if you perform a load and open operation of the database.
• Load - Loads every element of the database into memory of their respective hosts.
• Open - Enables the database for user connections.
• Stop - Disables new user connections to a database and unloads every element of the database from the memory of their respective hosts. This option does the same thing as if you perform a close and unload operation of the database.
• Close - Disables new user connections to a database.
• Unload - Unloads every element of the database from the memory of their respective hosts

SQL Developer performs the operation that you selected. The operation can take a few minutes.

A progress dialog displays in the lower right corner of the main SQL Developer window. If SQL Developer displays an error message, troubleshoot the error.

You can review the status of your database by double clicking the name of your database from the TimesTen Grid view region. If your database status is already open, you can click the refresh button that is located in the top left corner of the database status window to refresh your database status.

You have successfully performed an operation on the database.

1. Expand the Databases option, expand the name of your database, then either right-click the Client/Server Connectables or Direct Connectables option and select New Connectable.
   The New Connectable dialog displays. Locate the Connectable Name text field.
2. In the Connectable Name text field, type a name for your connectable. Select a name that is a meaningful identifier.
3. From the Connect to instance drop-down list, select a specific instance that applications connect to through the client/server DSN. The default value is Any Instance which lets your application connect to your database through any available data instance.
   
   

   Note: Optionally, you can import a connectable file to load connection attribute values for your connectable. The connectable file must use .connect as the file name extension. To import a connectable file, click the Import Definition button. Then, select your connectable file and click Open. If a connection attribute value was set in the wizard before you imported the connectable file, the connection attribute value changes to the value that is defined in the connectable file. Once you have imported the connectable file, you can still edit the connectable definition within the wizard. If you do not want to keep editing the connectable definition, skip to step 5.

   
   
4. Set the connection attributes for your connectable.

   You can add additional connection attributes by selecting a connection attribute from the drop-down list located below the Connect to instance drop-down list and then clicking Add. If a connection attribute is not listed in the drop-down list, you can select the New Attribute option and enter the connection attribute name in the Attribute column of the connection attribute table. Depending on the connection attribute, you can edit the value with a text field or a drop-down list of valid values.

   You can remove a connection attribute by selecting a connection attribute from the connection attribute table and then clicking Delete.

5. Once you have set your connection attributes, click OK.

   The New Connectable dialog closes and the Creating connectable progress dialog displays. Creating a connectable can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

6. Click Close.
   The Creating connectable progress dialog closes.

SQL Developer enables you to edit an existing connectable.

To edit a connectable, ensure that you are on the main SQL Developer page, that you have enabled the TimesTen Grid view, and that your grid node is expanded.

Expand the Grid Model option, expand the Database Definitions option, expand the name of your database, then either expand the Client/Server Connectables or Direct Connectables option, right-click the name of the connectable and select Edit.

The Edit Connectable dialog displays.

Follow the steps, starting on step 3, as described in Create a Connectable.

SQL Developer enables you to view all active connections to a database. This is useful to determine if it is safe to perform certain database operations like destroying a database or closing a database.

To view active connections to a database, ensure that you are on the main SQL Developer page, that you have enabled the TimesTen Grid view, and that your grid node is expanded.

Expand the Databases option and select the name of your database.

The database status displays or refreshes if it is already displayed. Locate the connections link that is next to the Number of applications connected to the database_name label.

Click the connections link that is next to the Number of applications connected to the database_name label.

The Updating information for database progress dialog displays. Once the database information has been loaded, the Updating information for database progress dialog closes and the Connection Details dialog displays.

The Connection Details dialog enables you to view all connections to your database data instances or specific data instances. Use the Instance drop-down list to select an instance for which you want to see its connection. In case that you want to see system connections, select the Include System Connections check box. You can also use the Connection Name text field to create a filter for all available connections to your selected instance.

Click the OK button to close the Connection Details dialog.

1. Expand the Databases option, then right-click the name of your database and select Destroy.

   The Destroy database dialog displays.

   Ensure that there are no active connections to your database before proceeding. Click the number hyperlink near the top of the dialog to view the connection details of your database. Ensure that there are no critical connections to your database or properly close any active connections.

   If there are 0 active connections to the database, you are ready to proceed.

2. In the text field, enter the instance administrator name.
3. If you want to delete the database definition of your database, click in the check box to the left of the text Delete database definition.
4. Click OK.

   The Destroying database dialog displays. Deleting a database can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   The Locate the Close button.

5. Click Close.
   The Destroying database progress and Destroy database dialogs close.

1. Expand the Grid Model option, right-click Repositories and select Create Repository.
   The Create Repository dialog displays. Locate the Repository Name field.
2. In the Repository Name field, specify the name for the repository.
3. In the Location field, specify a location that is mounted using NFS on each host or as a directory path that is accessible on each host with SSH or SCP.
4. From the Method drop-down list, select a mounting option:

   • Mount - Creates a repository as a directory path mounted using NFS on each host of your grid.

   • SCP - Creates a repository as a directory path that is not directly mounted on each host of your grid.

5. If you selected the SCP method, specify the fully qualified domain name of the host on which the repository exists in the Address field.
6. Click OK.

   The Create Repository dialog closes and the Create Repository progress dialog displays. Creating the repository can take a few minutes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button in the Create Repository progress dialog.

7. Click Close.
   The Create Repository progress dialog closes.

1. Right-click your grid node, select Inspect Logs, then select Support Log or User Error Log.
   Depending on the option that you select, the Inspect Support Log or Inspect User Error log dialog displays.
2. In the Available instance folder, locate the instance for which you want to view a log. Right-click the instance name and select Load/Unload. If you want to view a log of additional instances, right-click the corresponding instance name and select Load/Unload for any additional instances.
   
   

   Note: In case the log panel expands and hides the instance panel of the dialog, place your cursor at the left edge of the log panel and use the resize arrow to resize the log panel.

   
   

   If you want to close a log of an instance, locate the instance in the Showing Logs folder for which you want to close a log. Then, right-click the instance name and select Load/Unload.

   If you want to create filters, save the filtered logs, refresh logs, or perform various other operations with the logs, click the Logs menu button. The Logs menu button is located in the top left corner of the Inspect Support Log or Inspect User Error log dialog.

3. After you finish reviewing the log, click Cancel.
   Depending on the option that you select, the Inspect Support Log or Inspect User Error log dialog closes.

1. Right-click the Tables option and select New Table.
   The Create Table dialog displays. Locate the Schema drop-down list.
2. From the Schema drop-down list, select the owner of the table.
3. In the Name text field, type a name for the table.
   You are now ready to define the columns for your table. Locate the Columns region.

To define an index for your table, you need to have defined a primary key for your table. To define an index on your table:

Select an index type from the Index Type options.

If you selected a hash index, type a RowPages parameter in the Page size(Rows) text field.

Compute this value by dividing the number of expected rows in your table by 256. For example, if your table has 256,000 rows, specify 1000 for the value of RowPages (256000/256=1000)

You have successfully defined an index on your table. You are now ready to define constraints for your table.

1. Right-click the Sequences option and select New Sequence.
   The Create Sequence dialog displays. Locate the Schema drop-down list.
2. From the Schema drop-down list, select the owner of the sequence.
3. In the Name text field, type a name for the sequence.
4. In the Start With text field, specify the first sequence number to be generated.
   Use this field to start an ascending sequence at a value that is greater than the minimum value or to start a descending sequence at a value less than the maximum.
5. In the Increment text field, specify the incremental value between consecutive numbers.
   This value can be either a positive or negative integer. It cannot be 0. If the value is positive, it is an ascending sequence. If the value is negative, it is descending. The default value is 1.
6. In the Min Value text field, specify the minimum value for an ascending sequence, or the final value for a descending sequence.
   This value must be less than or equal to the value that you specified in the Start With field. The default minimum value is 1.
7. In the Max Value text field, specify the largest possible value for an ascending sequence, or the starting value for a descending sequence.
   This value must be greater than or equal to the value that you specified in the Start With field. The default maximum value is (2⁶³) -1, which is the maximum value of the BIGINT data type.
8. If you want to cache the numbers from this sequence, select the Cache option from the Cache drop-down list. If not, select the No Cache option.
9. If you selected the Cache option from the Cache drop-down list, in the Cache Value text field, specify the range of numbers that are cached.
   When a restart occurs, unused cached numbers are lost. If you specify a cache value of 1, then each use of the sequence results in an update to the database. Larger cache values result in fewer changes to the database and less overhead. The default value is 20.
10. From the Cycle drop-down list, select one of these options:

    • Cycle - The sequence number generator continues to generate numbers after it reaches the maximum or minimum value.

    • No Cycle - The sequence number generator stops generating numbers when the maximum or minimum value is reached.

    By default, sequences do not cycle. Once the number reaches the maximum value in the ascending sequence, the sequence wraps around and generates numbers from its minimum value. For a descending sequence, when the minimum value is reached, the sequence number wraps around, beginning from the maximum value.
11. In the Batch value text field, define the range of unique sequence values that are stored at each element of the grid. The default value is 10 million. This option is only available for TimesTen Scaleout databases.
    Locate the OK button.

    
    

    Note: If you want to review the DDL statement that TimesTen or TimesTen Scaleout uses to create your sequence, click the DDL tab.

    
    
12. Click OK.
    The Create Sequence dialog closes and TimesTen or TimesTen Scaleout creates your sequence.

1. Right-click the Packages option and select Compile All.
   The Compile All dialog displays. Locate the Apply button.
2. Click Apply.
   TimesTen compiles all of your saved PL/SQL packages. A confirmation dialog displays with the compilation results and any errors that TimesTen encountered.
3. Click OK.
   Review the Messages - Log area to see the compilation results. If you see any compilation errors, troubleshoot and fix the compilation errors. Then, recompile and save your PL/SQL packages.

1. Right-click the Packages option and select Compile Invalid.
   The Compile Invalid dialog displays. Locate the Apply button.
2. Click Apply.
   TimesTen compiles all of your invalid PL/SQL packages. A confirmation dialog displays with the compilation results and any errors that TimesTen encountered.
3. Click OK.
   Review the Messages - Log area to see the compilation results. If you see any compilation errors, troubleshoot and fix the compilation errors. Then, recompile and save your PL/SQL packages.

1. Right-click the Tables option and select Load from Oracle Database Tables.
   The Load from Oracle Database Tables dialog displays. Locate your Oracle database schema name from the navigation tree on the left of the Load from Oracle Database Tables dialog.
2. Select a mode:

   • Simple - This option enables you to load data from an Oracle database.

   • Advanced - This option enables you to load data from an Oracle database and specify the mapping of Oracle database data types to TimesTen database data types. You can also specify additional load options.

3. Once you have selected a mode, click Next>.
   Depending on the mode that you selected, follow the instructions from Advanced or Simple.

1. Right-click the Table option and select the Resume Loads from Oracle Database Tablesoption.
   The Resume Loads from Oracle Database Tables dialog displays. Locate the Browse button.
2. Click Browse.
   The Open dialog displays. Locate your load profile file.
3. Once you have located your load profile file, click Open.
   The Open dialog closes.

   
   

   Note: SQL Developer displays a warning message if you are using a different database connection than the one that was used when the load profile was saved.

   
   
4. Review the information that is loaded in the Resume Loads and Load Options tabs.

   The Resume Loads tab displays information related to which tables can be loaded from the Oracle database tables into TimesTen tables.

   The Load Options tab displays information related to the load options that will be used to load the Oracle database tables into TimesTen tables. These options cannot be edited.

5. Once you have reviewed the load information, click Resume Loads.

   A progress dialog displays. Once all tables have been loaded, the progress dialog closes. If SQL Developer displays an error message, troubleshoot the error.

   Locate the Close button.

6. Click Close.
   The Resume Loads from Oracle Database Tables dialog closes.