Install TNSadmin Web Manager GUI on Windows

This will guide you through installation of TNSadmin Web Manager GUI on your windows server.

For 64bit installation, make sure you have Windows x64 and 64bit Java.
1. (Optional) Download and install Oracle JAVA 7

If you don't already have Java 7 on your server, download Java SE 7 JRE from and install.

2. Install TNSadmin Web Manager GUI

Extract tnsadmin-web-x.y.z-win32/ into a target directory. Try to avoid directory names with spaces.
E.g. C:\tnsadmin-web

3. Modify configuration

There are several configuration files in tnsadmin-web\conf folder.

copy tnsadmin.conf.sample to tnsadmin.conf

  • set to domains in your LDAP server, separate multiple domains with comma
  • set oracle.ldap.* to LDAP server with TNS records
  • by default, authentication is set to fixed local account - tnsadmin/mypassword
modify listening ports, if ports 8080 and 8005 are already taken
  • open file server.xml and set Server and Connector ports

This is the basic configuration you need to do to start application correctly. For more configuration options, check TNSadmin Web Manager configuration options

4. (Optional) Install license file

If you have an Enteprise License file, put it into tnsadmin-web\conf\tnsadmin.licence.
Without license file, you will be limited to manage only 10 database records.

5. Setup windows service

Create a windows service, so TNSadmin Web Manager GUI runs in the background

As Administrator run
service.bat install tnsadmin-web
In Services list (services.msc), you will see this service as: Apache Tomcat tnsadmin-web, you can set Startup mode (Automatic, Manual, Disabled) there.
6. Start application
Start the service with
net start tnsadmin-web
Check log files for possible errors, log files are located in tnsadmin-web\logs Your application will run on or another port if you changed it in server.xml