Completing Installation (Windows)


Completing the installation and starting JDesignerPro

The BulletProof Enterprise Management Server (JAGGServer) must always be running first to run JDesignerPro. The Enterprise Server needs only to be running on the machine on which JDesignerPro is installed. If you are building remotely through a browser, you do not need JAGGServer on your machine, just on the server. Wait for the Enterprise Server to display the message "Enterprise Server Running on port: 4899"

Now launch JDesignerPro one of these ways:

  1. From the Windows Start menu find the JDesignerPro pogram group and select JDesignerPro (JDPRO icon) or double click the icon in the JDesignerPro program group. In this case, JDesignerPro is running as a local application using the JDK Java virtual machine.
  2. Start a Java-compatible browser and go to http://localhost/JDesignerPro/default.htm or http://localhost/JDesignerPro/index.htm. Where "localhost" is your server machine’s domain or IP address. (Note: for Windows users, if you click on the JDesignerPro HTML file, it will try to launch JDesignerPro from a local file, which will not work properly. You must type in the http:// path as above into your browser.)

The first time you run JDesignerPro you will go through a system setup, described below.

  1. The first thing you’ll see is the license agreement. Read the agreement and press the Accept button if you are willing to accept the terms.
  2. Next you will see a screen which will tell you how to check if you have ODBC correctly installed on your machine. Follow the instruction carefully.
  3. Next you will see the setup window with Username and Password fields and two buttons, Standard Installation and Custom Installation.

Here you set the Developer’s account name and password that you will use to access your JDesignerPro system. Use ‘Admin’ or any name of your choice.

Standard Installation

The Standard Installation will install the JDesignerPro system tables into ODBC compatible tables using FoxPro drivers. The JDesignerPro system tables store information about application delivery, menu structure, user accounts and authorization, etc. You do not need FoxPro installed on your machine.

We recommend doing the tutorials so that you can quickly become proficient with JDesignerPro.

The next time you start JDesignerPro you will be prompted with the login window. Enter your Admin username and password or login as Guest with no password. Remember, in all JDesignerPro systems, the Guest account is a default user which never requires a password.

Custom Installation

The Custom Install is used if you want the JDesignerPro system tables installed on your own JDBC or ODBC database.

If you wish to install JDP into an ODBC datasource you will first need to set up an ODBC datasource in the ODBC Control Panel. See below for directions.

  1. Press the New button.
  2. Enter the name you would like to use within JDesignerPro to refer to the database where the JDesignerPro system tables will reside.
  3. Choose the JDBC driver for your database from the pulldown. If your driver does not exist then enter it.
  4. Choose the JDBC prefix for your database from the pulldown. If your prefix does not exist then enter it.
  5. Enter the suffix string to be used to connect to the database. If you are using the jdbc:odbc: prefix then this will be a pulldown containing a list of all the ODBC datasources on your machine. Choose the one you require. If you're not using jdbc:odbc: you would typically enter an @ if the database resides on the same machine as JDesignerPro. If is on a different machine you would enter the machine name and port in the format database.mydomain.com:8000.
  6. Enter the username and password to access the database. Typically this user will require the ability to create tables in the database.
  7. Press the Install JDP button.
  8. JDesignerPro will then create the system tables and allow you to log in with your new Admin username and password.

If you don’t have a database already set up, click the JDesignerPro DB data source and press Connect.

If you encounter errors and you have successfully made a JDBC connection to your database using the sample code provided by the JDBC vendor please contact BulletProof Support.

We recommend doing the tutorials so that you can quickly become proficient with JDesignerPro.

The next time you start JDesignerPro you will be prompted with the login window. Enter your Admin username and password or login as Guest with no password. Remember, in all JDesignerPro systems, the Guest account is a default user which never requires a password.

Creating an ODBC datasource

  1. Open the ODBC32 control panel from the Windows control panels.
  2. Click on the System DSN tab.
  3. Press the Add button.
  4. Choose the driver for the database that you are using and press finish.
  5. Enter the name you would like to call this datasource.
  6. Enter the other settings that this type of datasource requires.
  7. Press OK to complete the setup.
  8. The datasource is now setup in ODBC and will now be visible in the JDBC Suffix pulldown on the Select database panel of JDesignerPro. See above for creating a JDesignerPro database to point to this datasource.