Installation_Manual_W2000v2.x.doc - Resalys

towerdevelopmentΔιαχείριση Δεδομένων

16 Δεκ 2012 (πριν από 4 χρόνια και 7 μήνες)

242 εμφανίσεις



















Installation Manual for

Windows 2000
/2003

Agent






















Software Version
2.0


Manual version 1.0



StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0





TABLE OF CONTENT



Overview

................................
................................
................................
................................
....

1

Installation Requirements

................................
................................
................................
.......

1

Installation Worksheets

................................
................................
................................
..........

2

HostFlow Modules Installation

................................
................................
................................
..

3

HostFlow Agent Installation

................................
................................
................................
......

7

HostFlow Add
-
On Installation

................................
................................
................................
...

7

Maintenance

................................
................................
................................
.............................

17

Appendix

................................
................................
................................
................................
..

18

APPENDIX: Get Started with WINDOWS Agent

................................
..............................

19

IIS requirements

................................
................................
................................
...................

19

Access Rights

................................
................................
................................
.......................

19

Scheduled tasks

................................
................................
................................
....................

19

Express provisioning

................................
............................

Error! Bookmark not defined.

APPENDIX: POSTGRES Connection Configuation

................................
..........................

20


Page
1


Overview




This manual is your guide to installing
Windows 2000
/200
3

Web
agents

for

your Hostflow
2.x

infrastructure
.

To run HostFlow properly, you must install the HostFlow
Database and
Manager on
L
inux server
s

(refer to the Linux installation manual for
instructions) then install Linux
and/
or Windows agents on your ex
tra servers to
perform Linux

and/
or NT based hosting
.

Your Windows servers are exclusively dedicated to Web hosting. They cannot
be configured to act as a Manager box, a Mail or a DNS server.


The installation process involves 3 steps:



Installing HostFlow
Modules

(PERL libraries required
to run the agent)



Installing HostFlow Add
-
On (
third party
applications that run
with

HostFlow)



Installing
HostFlow

Agent




WARNING




HostFlow Windows agents run exclusively on Windows 2000
/2003

servers
and Advanced ser
vers


Every installation for Hostflow (Hostflow modules, Hostflow add
-
on, and Hostflow
agent) MUST be done with the LOCAL administrator of the server.

The local
administrator must not be renamed.


StarFlow Software voids customer support and does not guara
nty the
proper function of HostFlow Windows agents if the installation is made on
another OS version.



You can either install HostFlow software with the installation CD
-
Rom or with
a download from the
www.hostflow.c
om

Web site.


Each Windows

agent
installation procedure takes about 1
5

minutes
.



Installation Requirements


To suc
cessfully install a Windows 2003

Web agent, you will need all of the
following:



Basic Windows administration knowledge

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
2



An i386 CPU
-
based com
puter

configured as an Windows servers



IIS



IIS FTP



Active Perl

: you must use the 5.
8.X

version from
http://www.activeperl.com

install it under C:
\
usr (REQUIRED)



Install PHP if you want to provide it
(
under c:
\
ph
p
)



A CD
-
ROM drive*



Completed installation worksheet (located at the end of this manual)



If you are performing the installation from a download, make sure
you download both files
hostflow
-
windows2k
-
x.x.x.zip
and

hostflow
-
x.x
-
addons
-
x.x.zip

(x represents the

version number).

StarFlow Software strongly recommends that you burn these files
on a CD
-
ROM prior to installation.

* For CD
-
Rom installation only



Prior to the installation, make sure your server has the following ports open in
your firewall setting (y
ou need to specify the connection type
-

tcp or udp or
both):

20 FTP

21 FTP

22 SSH

53 DNS

80 HTTP

443 SSL

3306 MySQL


AWSTATS

installation r
equirement:

\
Program Files
\
AWStats





if you want to add an additional agent outside the Hostflow Database
Server

SubNetwork, you will have to manually allow this agent to be able to
connect to Hostflow Database. (See Appendix Postgres Connection
Configuration)


Installation Worksheets


If hostname, IP address and netmask are strange
words

for you then take the
worksheet

at the end of this
manual

and make your network administrator fill it
before continuing the installation process.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
3



HostFlow Modules Installation




Installing HostFlow Modules is the first step of the three necessary
to properly
install a Windows 200
3

HostFlow agent.

The HostFlow Modules script compiles the PERL libraries required for a
HostFlow agent.


To install HostFlow Modules complete the steps below:


1. From
the Win2k directory of the HostFlow CD or download
, d
ouble click
the
HostFlow
-
2.0
-
modules
-
x.xx
.exe

file

to launch the installation program.


2.

The following screen appears:




The installation program is currently
check
ing out your

computer.
W
ait
(it
may take few minutes)
and click the
Next >

button when it
b
ecomes

available
.


3.

The following screen appears:


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
4



Read the Licence Agreement
then click the
“I accept the terms in the
license agreement”
button. Then click on
N
ext

>

to continue.


By clicking the “I do not accept the terms in the license agreement”
button, you will cancel the installation process
.


4.

The following screen appears:




Verify

that

the

installer has found the
right

directory for ActivePerl or
select it using the

C
hange


button.

Then click on
N
ext

>

to continue
.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
5


At this time Active Pe
rl should really be installed in c:
\
usr and NOT in
c:
\
perl

(not like the picture). If you installed Perl in c:
\
perl please
cancel the installation and reinstall Perl in c:
\
usr



5.

The following screen appears:




Wait

for the program to finish the
installat
ion
.


During this process, your anti
-
virus should detect a marvellous
script
.

It’s a NORMAL script witch will setup ISS so you must let it
run.



6.

The following screen appears:


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
6



Y
ou have successfully install
ed

Hostflow
M
od
ules on your computer, you
can

n
ow install Hostflow

AddOn
.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
7



HostFlow
Add
-
On

Installation





Installing HostFlow Add
-
on is the third and last step of the Windows 2000
HostFlow agent installation process.

This step is required if you want to provide your customers with the third part
y
applications integrated into HostFlow.


To install HostFlow
Add
-
on

complete the steps below:


1.
From the Win2k directory of the HostFlow CD or download, d
ouble click the
Hostflow
-
2.x
-
Addons
-
x.x.exe

file to launch the installation program
.


2. The fol
lowing screen appears:





The installation program is currently checking out your computer.

Wait (it may take few minutes) and click the
Next >

button when it becomes
available.


3.

The following screen appears:


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
8


Read the Licence Agreement then click the

“I accept the terms in the
license agreement” button. Then click
the
Next >

button
to continue.


By clicking the “I do not accept the terms in the license agreement”
button, you will cancel the installation process.


4.

The following screen appears
:



StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
9

C
hoose
to perform:




a c
omplete installation, click the
Next >

button
(
and refer directly to
step

6
)



a customized

installation


5.

If you have selected the
Custom

option, t
he following screen appears
:




Click on the Add
-
ons you want to install (click again to

deselect them).
Then click
the
Next >

button.


6.

The following screen appears:


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
10



Click the
Install

button to launch the installation process
.


7.

The following screen appears:



Wait for the program to finish the installation.


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
11

6.

The following screen appears
:




You have successfully install
ed

Hostflow
Add
-
ons on your computer, you
can n
ow install
the
Hostflow

Agent.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
12



HostFlow
Agent

Installation




Installing HostFlow Agent is the second step of the three necessary to
properly install a Windows 2000 HostF
low agent.


To install HostFlow
Agent
complete the steps below:


1. From
the Win2k directory of the HostFlow CD or download
, d
ouble click
the
Hostflow2.0
.exe

file to launch the installation program.


Hostflow modules must be installed

prior to the HostF
low Agent
installation
.


2.
The following screen appears
:




The installation program is currently checking out your computer. Wait (it
may take few minutes) and click the
Next >

button when it becomes
available.


3.
The following screen appears:


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
13


Re
ad the Licence Agreement then click the “I accept the terms in the
license agreement” button. Then click on
Next >

to continue.


By clicking the “I do not accept the terms in the license agreement”
button, you will cancel the installation process.



4.

The following screen appears:

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
14






In the Hostname field, enter the network name of the computer on
witch you want to
install HostF
low.


Then click the

Next >

button
.
StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
15


5.
The following screen appears:




You must now configure your agent to interact
with your HostFlow
Database.




Type in the
IP address of the computer on witch

runs

the
Hostflow
database.




Enter the p
ort
that will allow c
ommunicat
ions

with the Database on
this computer.




Enter the database login name and password.



6. The following s
creen appears:

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
16



Wait for the program to finish the installation.



During i
nstallation a
DOS like
black window may appear
. Do not

close

this window or the installation will fail.


7.

The following screen appears:




You have successfully install
ed

Hostfl
ow
Agent on your computer
.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
17


Maintenance





You may

want to change parameter
s

of your
previous

installation
. To do so

launch again the install
ation

program:

Launch the
the same file

or

Select from the Start Menu of your computer the following options:
S
ettings

>
Control P
anel
>

A
dd/R
emove
P
rogram
s
> H
ostflow

>

M
odify)




Select your option
:



Modify
your previous

installation (
Refer to the installation process for
instructions)



Repair the installation if
some of your files are corrupted or missing.




Unins
tall Hostflow




If

you modify your installation,
your
database password
will show
as

empty
. Do not

fill
out
the
field
if you
do not

w
ish

to
modify

it

after your previous installation.

StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
18



Appendix




Windows 2003

HostFlow Agent Worksheet




Hostn
ame:
_
___________________________________
______________

(Example:
shared1.
enterprisename.com)


IP Address:
_______________________________________
__________

(Example: 10.1.1.19)



Database Server
IP
:
_________________________
_________________

(Example: 10.1
.1.19)


Database Server Port:
________________________________________

(Example: 5432)



StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
19


APPENDIX: Get Started with WINDOWS Agent


Global System requirements


The local administrator username MUST be one of the following (and not be renamed):

-

administr
ator

-

administrateur

-

administrator

The local administrator group and everyone group must not be renamed.

If your system uses an another administrator username, please contact Starflow support.


IIS requirements


1)
If you

are using IIS, make sure that it au
thorizes use of CGI and PHP.



2
)
CentralBinaryLoggingEnabled

option must not set to TRUE as Hostflow needs file
text logs in order to calculate usage, urchin and webalizer statistics…


Access Rights


3) Usergroup Clients and hfgrp must have read and exe
cute access to directory
X:/var (root path of domains directories)


4
) Local Administator must have full access to C:/var C:/usr C:/tmp C:/etc


Scheduled tasks


5) Every Hostflow scheduled tasks (Hostflow_hourly_agent and
Hostflow_daily_agent), must be e
xecuted as the LOCAL Administrator of the system.

You have to fill in Local Administrator password for
the tasks
.

Fixed IP provisioning


If you want Hostflow to configure your network interface for fixed IP hosting, you have
to specify in
\
var
\
www
\
html
\
hos
tflow
\
config
\
hostflow.conf file the Id of the network
interface that Hostflw should use using the variable:

network_interface = "1"


Default value is set to 0.


StarFlow Software


Windows 200
3

Agent
Installation Manual


for
Host
F
low

version
2.0




Page
20

APPENDIX: POSTGRES Connection
Configuration


The installation of Database Hostflow Server will

configure Postgres in order to allow
connections from any IP of the sub network from the Database server.

Due to security reason, if you want to add an external agent to Hostflow, you will
have to edit manually the file ~postgres/data/pg_hba.conf on the H
ostflow Database
Server (as root) and add the line (at the end of the file):



host all
NETWORK_IP_AGENT

NETMASK

PASSWORD





Then you will have to restart postgres on order to make changes applied:


/etc/init
.d/postgresql restart