INSTALLATION

PRIVATE CLOUD

Visit us on the Web

www.docstar.com
Table of Contents
Introduction .................................................................................................................................................. 2
Welcome .................................................................................................................................................. 2
Lessons ..................................................................................................................................................... 2
Lesson 1 : Obtaining your eclipse Provision Code .................................................................................... 3
Using the Licensing Portal ...................................................................................................................... 3
Logging in .............................................................................................................................................. 3
License Code Details ............................................................................................................................. 4
Claimed License Sets ............................................................................................................................. 5
Unclaimed License Sets ......................................................................................................................... 5
Lesson 2 : Installing eclipse........................................................................................................................ 6
Starting the Installation .......................................................................................................................... 6
Eclipse Server Configuration................................................................................................................... 7
Licensing ................................................................................................................................................ 7
Server Configuration ............................................................................................................................. 8
SQL Server Configuration ...................................................................................................................... 8
Index Configuration .............................................................................................................................. 9
Application Settings .............................................................................................................................. 9
Completing the Installation .................................................................................................................. 10
Testing the installation.......................................................................................................................... 11
Site Configuration .................................................................................................................................. 11
Lesson 3 : Activating eclipse License Provision Code Post-Installation ............................................... 12
Activating license provision code ......................................................................................................... 12

1
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Introduction
Welcome
In this tutorial, I will guide you through installing Eclipse.

By the end of this tutorial, your Eclipse site will be installed and ready for configuration.

Lessons
This tutorial is divided into the following lessons:

Lesson 1. Obtaining your eclipse licensing Provision Code

Lesson 2. Installing eclipse
Lesson 3. Activating licensing post-installation

2
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Lesson 1 : Obtaining your eclipse Provision Code
In this lesson, we will discuss how to use the licensing portal to track and manage your eclipse site licenses.

Using the Licensing Portal

Every eclipse site must be licensed to be operational. Though it is possible to install eclipse first and then
license it later, you may forget about it to only be reminded when you try to use it. You may find that it is
best to have the license code ready before the installation and to apply the license as soon as possible.

The licensing portal is a webpage that you can use to view

and track all of your claimed and unclaimed site licenses.

Logging in
Follow the steps below to log into the licensing portal:
1. Open your web browser.

2. In the address bar, type the following URL:

licensing.docstar.com

3. After the page has loaded, enter your username and password into the text boxes provided.

The licensing portal login in the same username and

password for the Support Center website
(support.docSTAR.com)

Create a Support Center login by going to

support.docstar.com and clicking on the registration link at
the bottom of the page.

4. Next, click the login button to log into the site.

5. When login is successful, your site is displayed.

3
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

License Code Details
When you select either a claimed or unclaimed provision code (highlighted in yellow), the License
Details area will display what licenses are contained within the code.

For example, as seen in the screenshot below, Provision Code HDTLN6 contains 10 current user
licenses and 1 1D barcode license. These licenses are subscription based as well expiring May
30 2013.

4
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Claimed License Sets
The bottom portion of the webpage provides a list of provision codes that have already been
“used” and what Company is using them for their eclipse site.

Unclaimed License Sets

The middle portion of the webpage provides a list of unclaimed provision codes and which
company the code is intended for. Select the appropriate provision code from this group and
make note of the Provision Code value. We will use this code during the installation.

In this tutorial, we will use the unclaimed provision code QHEEQZ

5
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Lesson 2 : Installing eclipse
Now that we have obtained an unclaimed provision code, we are now ready to begin the eclipse Private
Cloud installation.

Starting the Installation

Follow the steps below to install eclipse:

1. Double-click EclipseServerSetup.exe to begin the installation. Check the box to agree to the
license terms and conditions, then click Install.

2. Click Close. Next, you will see the Eclipse Server Configuration
6
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Eclipse Server Configuration
You’re probably thinking “That was easy” and it certainly was – but you’ve only just begun. Next, we
must configure the settings, which are broken down into the following categories:

 Licensing
 Server Configuration
 SQL Server Configuration
 Index Configuration
 Application Settings

Licensing
1. Enter your provision code

2. If you have internet access on the server, enter your provision code then click Activate. Otherwise,
click Skip.

Licensing provision code must be activated to use the

software.

7
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Server Configuration
3. Modify the Server Configuration settings only as needed, then click Next

The help section on the right contains more detail on each

of the settings.

SQL Server Configuration

4. Select your preferred SQL Server settings, then click Next

If you already have an instance of SQL Server installed that

you’d like to use, be sure to change the server settings and
uncheck the “Install SQL Express” box.

Otherwise eclipse will install and use SQL Express.

8
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Index Configuration
5. Modify the Index Configuration settings only as needed, then click Next

The default settings are acceptable for most installations. If

you are unsure what to select, contact your docSTAR
support team.

Application Settings
6. Select your preferred application settings, then click Finish

Application Configuration settings is the area that you are

most likely to want to modify.

Most commonly changed settings are:

Alerts Base URL
Server Email from Address
Support Email Address
New Content Path

9
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Completing the Installation
7. Now sit back and relax as the installation completes.

Installation time can vary greatly. If IIS and SQL Server

are not already installed, you can expect additional time
as these components are installed by eclipse.

The progress bar at the bottom of the window will

indicate when the installation is complete.

10
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Testing the installation
Last, to verify that your installation is complete, open your web browser and enter the URL for the
eclipse site. (This was determined during Server Configuration Settings.) The URL may look something
like this:

http://yourservernamehere/EclipseWeb

When logging in for the first time, use the following

credentials:
Username: admin@docstar.com
Password: EclipseWelcome123!

Site Configuration
Now that the installation is complete, you are ready to configure the eclipse site, creating users, groups,
security, and content types.

See Site Configuration tutorial for more.

11
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

Lesson 3 : Activating eclipse License Provision Code Post-Installation
Until the license provision code has been activated, eclipse features and functionality will not be accessible.
You may even see system messages like the one shown below:

If you were unable to activate your eclipse license provision code during the installation process, you can
follow the steps in this lesson to activate the license post-installation.

Activating license provision code

Follow the steps below:

1. Log into your eclipse site, then click the Admin tab.

2. Click the License link

3. Enter your Provisioning Code in the Licensing Code textbox. If you have internet access, click Submit,
otherwise continue on.

If you do not have internet access, do the following:

4. Click Request button

12
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC

5. A license request file (RequestFile.txt) will be generated by eclipse. Save the generated file, or if you
are not prompted to save the file, search your downloads folder as it may have been saved
automatically.

Email the RequestFile.txt to your docSTAR support group. You will then receive an answering license
file. Save the license answer file to the eclipse application server.

6. Click Choose File to select your license answer file

7. Click Upload

Licensing is now complete!

13
eclipse
Private Cloud
Installation Series Tutorials

docSTAR  A Division of Astria Solutions Group LLC