Axional DBStudio is a JAVA-based database management tool that allows you to manage databases, using a rich client user inrerface. Its main features include the ability to browse and edit databases, create and execute SQL scripts, export and import data and perform ER diagrams. Its also includes a large set of procedures for database server monitoring and administration.

1 Installation

The product is available Linux, Mac OS and Windows (64 bits) platforms.

1.1 Prerequisites

Axional DBStudio requires Java JDK 1.8 available in your computer. If you don't have it already installed, you can download and install Java from https://www.java.com/download/.

1.2 Install DBStudio

Axional DBStudio product is distributed in a multi platform JAR (artifact) named:

axional-server-dbstudio-[VERSION]-all.jar

To install, simply copy the jar file to your system into an appropriate directory.

2 Startup

From operating system console run java command:

  • MacOS:
    Copy
    $ java -XstartOnFirstThread -jar axional-server-dbstudio-[VERSION]-all.jar [--server] [--port num] [--swt] [--api]
  • Linux:
    Copy
    $ java -jar axional-server-dbstudio-[VERSION]-all.jar  [--server] [--port num]  [--swt] [--api]
  • Windows:
    Copy
    C: java -jar axional-server-dbstudio-[VERSION]-all.jar [--server] [--port num]  [--swt] [--api]

By default, with no arguments, the SWT application is started and the http server is disabled.

The following options are available:

  • --server: Starts only the web server. The SWT app is not started.
  • --port num : Specify a port number to be used by the web server.
  • --swt: Forces SWT app to be started. This option only makes sense when used in conjuction with --server
  • --api: Enables REST api web service (requires --server mode).

3 License

Contact with your provider to obtain a PGP license token.

4 Setup

4.1 Servers setup

Axional DBStudio includes a left pane with connection groups and instances and a right pane with related information.

Under the left pane you can setup the tree of groups and it's database servers. A sample structure can be as follows.

Loading...

In first run, you'll get a blank "unnamed" root node without any connection group or server connection. To create a new connection group, click right mouse button over root "unnamed" node and choose "Create new group" option:

Enter connection group name and press OK to create a new connection group. You can create as many connection groups as you require, to identify or categorize your instances. E.g. Production servers, Development servers, etc.

To create an instance connection definition in a connection group, right click over a group and choose "Create server" option on the popup menu.

You'll get a server form definition to enter data for your server connection:

Name Name to identify your server connection on tree menu
Description This is a free text field to enter information about instance
Hostname Hostname or IP of the database server
Protocol Protocol to connect. This field defines instance database brand and JDBC used to connect. By default: jdbc:informix-sqli (Informix)
Port TCP/IP Port to connect
Service Service name
User User name used to open connection
Password Password used to connect

When pressing OK button, server will be added to the servers group and if all data is properlly entered you'll get a server node to access to instance management.

4.1.1 Refreshing the catalog metadata for a database connection

You can refresh the catalog metadata if a connection is defined and you are connected. If other users have modified the metadata, you can see the latest changes.

Procedure

To refresh the catalog metadata for a database connection:

  • In the Data Source Explorer, right-click on the database connection that you want to refresh.
  • Select Refresh Objects Tree.

4.2 Configure security

You can protect access to Axional DBStudio by requesting a user and password to run application

Select the root node (by default "unnamed") and click right button to open popup menu. Choose properties option and you'll get the root node configuration form.

This form allows to change the root node name and to introduce a user and password to protect application access. Leave user and password blank if you don't require pasword access protection.

5 Troubleshooting

5.1 Connecting to a local Windows instance gives -908 Error

It usually comes down to the issue that the Informix server is listening on a different network interface. In many cases the host name can route to an IP which is not the interface on which Informix is running as well, so when testing it’s best to use IP addresses when you are doing the local machine so you know what you are trying to connect to.

If you have the external IP for the windows machine and have not tried it I recommend trying that (even if it is local). You can also run `netstat -aon` and match it with the oninit process to see what IP/port combo it is listening on. It might be something surprising or different from the other Windows machine you said was connecting fine.

Dbaccess never helps you resolve connectivity problems unless you manually connect with ip + port as dbaccess defaults to shared memory connections.

Currently there is no debugging mechanism for showing the interface that JDBC is trying to connect to. This is an interesting case that really only shows up on Windows and typically once one knows which IP to connect to or change the server to listen on all adaptors with *HOSTNAME in the sqlhosts (adding the asterisk) then the problem goes away.

Adding * in SQLHOSTS file should solve the connection issue