Installing Embarcadero Connect

From Connect
Jump to: navigation, search

Go Up to Getting Started with Embarcadero Connect

Please ensure that you have read the Installation Notes before proceeding.

To install Embarcadero Connect on a machine that meets the minimum system requirements, you need to run the Embarcadero Connect installation wizard and follow the steps. In this page you can find detailed information about the different steps of the installation wizard, as well as suggestions on what to do after the installation.

Notepad blue icon 2.pngNote: The ER/Studio Repository server and the database server to be used for the Embarcadero Connect Reporting repository must be running before installing Embarcadero Connect. You may also have to create a blank database prior to starting the installation, please check the Prerequisites

Download the Embarcadero Connect installer, run it and follow these steps to install Embarcadero Connect:

Notepad blue icon 2.pngNote: You need a user with administrative privileges to run the Embarcadero Connect installation wizard.

  1. Installer.png
    On the Welcome page, click Next.
    Note: Do not install Embarcadero Connect on a system where ER/Studio Portal or a previous version of Embarcadero Connect is installed, if the Embarcadero Connect installation wizard detects an installation of any of these applications it will ask to automatically uninstall these. If ER/Studio Data Architect or ER/Studio Business Architect are installed you must exit the wizard and uninstall these applications. Then, restart the installation wizard.
  2. InstallerPage2.png
    On the Software License and Support Agreement page:
    1. Check I accept the terms of the license agreement if you do accept them. Otherwise, click Cancel to abort the installation.
    2. Click Next to continue.
  3. InstallerPage3.png
    On the Installation Directory and Email page:
    1. Right under the Directory Name field, click Browse to choose the directory where you want to install Embarcadero Connect. The selected directory must be empty.
      Note: If the selected directory is not empty, an error dialog appears. Click OK to close the error dialog, and make sure that the selected directory is empty.
    2. Optionally, you can check "Enable Sending of Email" to be able to allow users to send search results and reports by email directly from Embarcadero Connect. When you check this option, additional fields appear:
      Note: You can enable or disable this feature later, after the installation, using the Embarcadero Connect Configuration Manager.
      1. In the Host field, enter the host name of the email server (for example: ETMAIL01), the fully qualified network name (for example: ETMAIL01.embarcadero.com), or the IP address (for example: 10.10.23.250).
      2. In the Port field, enter the port number where the email server is listening. The default port is 25.
      3. In the From Address field, enter the email address that you want to use as the sender of the emails sent from Embarcadero Connect. You may want to prepare a special email address on your email server for this purpose.
      4. Optionally, check "Use Authenticated SMTP" if your email server requires authentication. When you check this option, additional fields appear. Fill User Name and Password with the required values to authenticate Embarcadero Connect against your STMP server.
  4. InstallerPage4a.png
    On the Embarcadero Connect Tomcat Server page:
    1. In the Host Name field, enter the host name to run the Embarcadero Connect server (for example: DEWKBROW01), the fully qualified network name (for example: DEWKBROW01.embarcadero.com), or the IP address (for example: 10.10.23.250).
    2. In the Port field, enter the port number where the Embarcadero Connect server must listen for connections. The default port is 80. If another application on your system is already using the default port (for example, another web-based application), enter an unused port number (a commonly-used alternative is 8).
      Tip: Network ports may be a number between 0 and 65535. The ports in use depend on the platform and the services installed on your system. For example, you cannot use 0 or 139 on Windows as they are used for the NetBios Session Service. Higher numbers are less likely to be already in use.
    3. In the Shutdown Port field, enter the port number where the Embarcadero Connect server must listen for the shutdown command. The default port is 8006. If another application on your system is already using the default port, enter an unused port number.
      Note: You can change the shutdown port later, after the installation, using the Embarcadero Connect Configuration Manager.
    4. If you are using a Windows version newer than Windows XP, such as Windows Vista, Windows 7, and Windows 2008, you must also specify the following to enable Embarcadero Connect to synchronize with the ER/Studio Repository:
      1. In the Windows User field, enter the name of a Windows user that Embarcadero Connect can use to log in to the system. The user account must have local administrative privileges. The name should be in the format "machine_name\username".
        InstallerSSLPage.png
      2. In the User Password field, enter the password of the Windows user.
    5. Click Next to continue.
  5. On the Secure Communications page you can optionally choose to enable SSL and HTTPS. It is recommended that you enable secure communications as this will keep your password transmissions secure.
    1. If you do not have SSL set up on your server, you can click the Self-Signed button to take you through the short wizard which will create a Keystore file allowing you to use encryption.
    2. Fill out the fields of the Self-Signed wizard and click Next. The Keystore file will be created in the location of your choosing.
      InstallerKeystorePage.png
    3. Click Next.
  6. On the Enable LDAP Authentication page, optionally, check "Enable LDAP Authentication" to use the Lightweight Directory Access Protocol (LDAP) to enable users to log in to Embarcadero Connect using their domain username and password. You can also enable LDAP authentication after the installation):
    1. In the LDAP URL field, enter the URL of the server running LDAP. For example, ldap://10.40.40.94:389 for normal connections, or if you wish to use ldaps://10.40.40.94:636 for secure connections then you can enable this after installation with the Embarcadero Connect Configuration Manager.
    2. In the Manager DN field, enter the distinguished name for the user that is used to authenticate users. Embarcadero Connect uses this to connect to the LDAP server and validate user credentials. For example, CN=administrator,CN=Users,DC=mydomain,DC=com.
      InstallerLDAPPage.png
      • Note: In this example, administrator has been used. In which case, Users is defined as a container rather than an organizational unit as is the Microsoft Active Directory default. Your user accounts may be in an organizational unit, in this case you would specify it differently, for example, CN=user1,OU=sales,DC=mydomain,DC=com.
    3. In the Manager Password field, enter the password for the administrative user.
    4. In the Search Base DN field, enter the name of the root node in LDAP from which to search for users. For example, CN=Users,DC=mydomain,DC=com.
    5. In the Search Attribute field, enter the attribute in LDAP holding the user's login name. For example, sAMAccountName (for ActiveDirectory).
    6. On the Test User/Password field, enter the username and password of a sample user to attempt to authenticate against the LDAP server. The installer uses this information to validate the given LDAP information before moving to the next page.
      InstallerPage5.png
  7. On the Repository Information page you can specify the target instance of ER/Studio Repository that is the information source for Embarcadero Connect:
    1. Complete the information about the ER/Studio Repository server:
      1. On the Version field, select the corresponding version of the ER/Studio Repository.
      2. On the Repo Server Name field, enter the name of the machine where the ER/Studio Repository is installed.
      3. On the Super User Login field, enter the username for a user with the Super User role in the ER/Studio Repository.
      4. On the Password field, enter the password for the specified user.
        Tip: The default user and password for a Repository build are User 'Admin' and Password 'Admin' (case-sensitive), without the quotes.
    2. Complete the information about the ER/Studio Repository database:
      1. On the DBMS Server Type field, select a supported database platform from the list.
      2. On the DBMS Host/Port field, enter the hostname of the machine that contains the ER/Studio Repository database.
        Note: For Microsoft SQL Server only, if ER/Studio Repository runs on a Microsoft SQL Server database that is a named instance, specify the host name in the format HostName\NamedInstanceName. For example, DEWKBOW01.embarcadero.com\RepositoryServer.
      3. On the DataBase Name field, enter the name of the ER/Studio Repository database.
      4. Optionally, for Microsoft SQL Server only, you can check "Enable Encryption" to enable the Secure Sockets Layer (SSL) communication protocol, which encrypts messages between Embarcadero Connect users and the ER/Studio Repository. When SSL is enabled, Embarcadero Connect uses ports 80 and 443 for secure communications.
      5. On the User Name field, enter the username to access the ER/Studio Repository database.
      6. On the Password field, enter the password for the user specified above.
        Note: The password fields are preserved when navigating back and forth during the installation process.
    3. After you have entered the required information, click Connect to test the JDBC connection. The Next button, to continue the installation, is disabled until the installer successfully establishes a connection to the ER/Studio Repository and validates the specified username and password.
    4. Click Next to continue.
  8. InstallerPage6.png
    On the Reporting Repository page you can specify the details for the Reporting Repository:
    Notes:
    • You should have an empty database for the Reporting Repository on your database server. If you do not have one, create one now. In the screenshot example here we have created a new blank database on our DBMS using the SQL Management Studio, called ERSRepoRpt
    • If ER/Studio Repository and the Reporting Repository are installed on the same database server, you must use different schema owners for each database. There might be naming conflicts between ER/Studio Repository and the Reporting Repository otherwise.
    1. On the DBMS Server Type field, select a supported database platform from the list.
      Note: The DBMS server type must match that of the ER/Studio Repository.
    2. On the DBMS Service Host: Port field, enter the hostname and port number of the DBMS Service.
      Note: For Microsoft SQL Server only, if the Reporting Repository runs on a Microsoft SQL Server database that is a named instance, specify the host name in the format HostName\NamedInstanceName. For example, DEWKBOW01.embarcadero.com\ReportingRepository.
    3. Depending on the database platform that you selected above, complete the following fields:
      • If you selected Oracle:
        1. On the SID field, enter your database identifier.
        2. On the Tablespace field, enter your database tablespace.
      • If you selected IBM DB2 Universal Database:
        1. On the DBName field, enter your database name.
        2. On the Tablespace field, enter your database tablespace.
      • If you selected Microsoft SQL Server:
        1. On the Database Name field, enter your database name.
        2. Optionally, you can check "Enable Encryption" to enable the Secure Sockets Layer (SSL) communication protocol, which encrypts messages between Embarcadero Connect users and the Reporting Repository.
    4. On the Database Admin User field, enter the username of an Admin User that has the privilege to create reporting database tables, etc.
    5. On the Database Admin Password field, enter the password for the user specified above.
    6. For Microsoft SQL Server only:
      1. Optionally, check "Same as Admin" so that the User Name and Password fields below disappear, and the installer uses the admin username and password specified above instead.
      2. On the User Name field, enter the username of a user with read and write access to the Reporting Repository database.
      3. On the Password field, enter the password for the user specified above.
    7. Select one of the following options for connecting to the Reporting Repository:
      • Select "Initialize an existing, empty database" if the Reporting Repository database exists and it is empty with no tables. The installation wizard creates the Reporting Repository database schema, so the "Admin" user must have that privilege.
        InstallSolutionDBPage.png
      • If you are upgrading Embarcadero Connect, select "Connect to an existing Repository database".
      • Select "Reinitialize current Repository database" if the Reporting Repository database exists. The installation wizard drops all the Reporting Repository database tables and creates a new database schema, so the “Admin” must have that privilege.
        Warning: This is a destructive action.
    8. Click Connect to establish a connection to the Reporting Repository database. After a connection is established, the Next button is enabled.
    9. Click Next to continue.
  9. On the Solution Database page you can specify the details for the Solution Database.
    1. Click Connect to establish a connection to the previously installed Solution Database. After the connection is established, the Next button is enabled. This page will only appear on a reinitialization or connection to an existing installation.
  10. InstallerPage7.png
    On the Summary Information page review all the summary information. Click Back if you want to make any changes; otherwise, click Install to start the installation process. A panel appears showing the progress of the installation. When the installation wizard finishes, the final page appears.
    Note: You may see a message indicating that start up of the Apache Tomcat service is in progress. However this occurs only if the service is still in the process of starting when the installation is complete.
  11. InstallerPage8.png
    Click Finish to exit the installation wizard.

Embarcadero Connect is now installed on your system.

Notes:
  • You can use the Embarcadero Connect Configuration Manager to prevent Apache Tomcat from interacting with the desktop, so that next time that you start up Embarcadero Connect, the Apache Tomcat service window does not appear. For more information, see Embarcadero Connect Configuration Manager.
  • If any errors occur during the installation, an error page opens, which directs you to the log file located in the directory where you were installing Embarcadero Connect. For example: C:\Program Files\Embarcadero\ConnectX.X\log.txt.

Next Steps

After you install Embarcadero Connect, you should:

  1. Start Embarcadero Connect.
  2. Manage your Embarcadero Connect licenses.
  3. Synchronize with ER/Studio Repository.

See Also

Personal tools
Next Version
Product Family Wiki