CryoStubbing Client Installation

Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
1

of
㈹









Cryo
Stubb
ing

Client

Installation




Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
2

of
㈹


Revision History


Document

Version

Date

S/W

Version

Description

Author

1.0

28/
DEC
/2009

5.0

Installation instructions

FCS Development Team

2.0

18
/FEB/2010

5.1.1

Installation instructi
ons
updated

FCS Product Management
Team

3.0

05/APR/2010

5.2.1

Terminal Server
installation instructions
added

FCS Development Team

4.0

05
/
AUG
/20
10

5.2.3

Cryo Stubbing Client
installation using GP over
the network and in the
standalone environment

FCS Dev
elopment Team

5.0

05
/
AUG
/20
10

5.2.3

Cryo Stubbing Client
installation using GP over
the network and in the
standalone environment

FCS Development Team

6.0

02
/
SEP
/20
10

6.0.0

Cryo Stubbing Client
installation using GP over
the network and in the
standalone

environment

FCS Development Team













Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
3

of
㈹



Contents


1.

Cryo Stubbing Client installation using GP

4

1.1

Pre requisites for stu
bbing installer

4

1.2

Installer components and their detail

4

1.3

Deploying Installer components

4

1.4

Steps for VBS Install Script editing

4

1.5

Deploying VBS script on Domain controller to Install Pre
-
Requisites.

4

1.6

Deploying Cryo Stubbing MSI on Domain controller to install Cryo Outlook Addin

8

1.7

Stubbing Client Installation

14

1.7.1

Fresh Installation

14

1.7.2

Up gradation

16

2.

Cryo Stubbing Client Installation in the Standalone Envir
onment

17

2.1

Pre requisites for stubbing installer

17

2.2

Installer components and their detail

18

2.3

Deploying Installer components

18

2.4

Stubbing client installation

18

2.4.1

Fresh Instal
lation

18

2.4.2

Upgrading

20

3.

Cryo Stubbing Client Installation in the Terminal Server Environment

21

3.1

Pre requisites for stubbing client installer

21

4.

Installer Verification

21

4.1

Ver
ification for Stubbing Client Installer v5.2.3

21

4.2

Verification for Stubbing Client Installer v6.0.0

24

5.

Trouble Shooting G
uide

28



Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
4

of
㈹


1.

Cryo Stubbing Client installation using GP


1.1

Pre requisites for stubbing installer

This section describes all the prerequisites for integrated
Cryoserver
stubbing client installer
.
These components must be installed

prior to
the stubbing installation proceeding.


a.

MS
O
utlook 2003/2007

b.

Microsoft
.NET
Framework 2.0

or above

1.2

Installer components and their detail

This section lists all the required componen
ts of stubbing client installer:

a.

Primary Interop Assemblies 2003 (
For Outlook 2003)

b.

Primary Interop Assemblies 2007 (For Outlook 2007)

c.

Visual Studio Tools for Office Runtime 2005

d.

NetworkSetup
.exe (this is to install pre
-
requisites
)

e.

CryoStubbing

Setup
.ms
i (this is to install Cry
o

Outlook Addin)

f.

PreReq
Install.vbs (VB scrip
t to install pre
-
requisites
and
Cryo Outlook Addin
MSI
using GP

over the network
)

g.

UserRegInstall.vbs (VB script to install Cryo Outlook Registry entry for the user)

1.3

Deploying Installer components

This section describes how to place/deploy all components of

stubbing client installer

a.

Unzip installation package ‘CryoStubbingClient.zip’ and p
lace in
to

a

shared folder
on
a deployment
server


1.4

Steps for VB
S

Install Script editing

How to make changes in VB script, deployed with stubbing clie
nt components
.

a.

Right cli
ck ‘
PreReq
Install.vbs’ and open in ‘Notepad’.

b.

Incorporate following information in the script according to

the

user environment

i.

CryoStubbing Client components directory path.

\
\
<Machine
-
IP>
\
<Installation
-
Dire
ctory
-
Path>
\
NetworkSetup.exe


c.

Save.

d.

Right click ‘UserRegInstall.vbs’ and open in ‘Notepad’.

e.

Incorporate following information in the script according to the user environment

i.

CryoStubbing Client components directory path.

\
\
<Machine
-
IP>
\
<Installation
-
Directory
-
Path>
\
UserReg.reg


f.

Save.



1.5

Deploying VB
S

script on Domain controller

to Install Pre
-
Requisites.



This section describes, h
ow to deploy
the
VB script on

the Domain C
ontroller to run stubbing

client pre
-
r
equisite components
on user log on

a.

Open ‘Active Directory Users and Computers’
. In the console tree, ‘Right Click’ on
appropriate Organizational Unit and click ‘Properties
’
.


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
5

of
㈹



















b.

Select ‘Group Policy’ tab
, and
click the
New

button to create po
licy for prerequisite
installation and registry information





Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
6

of
㈹


c.

Select the
newly created

group policy object PreReq_RegistryInstall that created
above, press the
Edit

button, and follow the following path:

User Configuration


W楮iow猠s整e楮i猠


S捲楰i猠⡌
ogon⽌/goff)












d.

Right Click
on
Logon

and take its properties. . Press the
Add

button to add the vbs script file
‘PreReqInstall.vbs’ from the shared location that will install the prerequisites of Cryo Stubbing
Client when the user logs on.

Ente
r the
Script Name

as per UNC standard
(
\
\
Server
\
SharedFolder
\
PreReqInstall.vbs
).

Enter

the ‘
Script Parameters
’
(/u:administrator
@domain.name /p:password
)
. Click

‘
OK
’
to exit dialogue
and press ‘
Ap
ply
’ to
save settings
.
































Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
7

of
㈹


e.

Again press
the
Add

button to add the vbs script file ‘UserRegInstall.vbs’ from the
shared location that will add the registry information about Cryo Stubbing Client when
the user logs

on.

Enter the
Scr
ipt Name

as per UNC standard
(
\
\
Server
\
SharedFolder
\
UserRegInstall.vbs
).

Script Parameters are not required.

Click

‘
OK
’
to
exit dialogue
and press ‘
Apply
’ to save settings
.


















































(
Note: This VB

script
is ready to install

prerequisites

and registry entry

for cryostubbingclient

at
users
-
end
.
)


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
8

of
㈹


1.6

Deploying
Cryo Stubbing MSI

on Domain controller to
install

Cryo Outlook Addin



This section
describes

how to de
ploy Cryo Stubbing MSI

on domain controller to run
Cryo
Stubbing Outlook Addin
at domain computers.

a.

Open ‘Active Directory Users and
Computers’. In the console tree,
‘Right Click’ on appropriate
Organizational Unit and click on
‘Properties.














b.

Select ‘Group Policy’ tab, and
click the
New

button to create the new group
policy object link. You may name it
StubbingClientInstall
.
















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
9

of
㈹


c.

Select
the group policy link that you created above and press the
Edit

button, and
follow the following pat
h:

Computer Configuration


Softw慲e

S整e楮i猠


Softw慲攠en獴慬s慴楯n











Right click on
Software Installation
, select
New



Package
.
The following

window will
appear that require the UNC path to the shared folder where
t
he MSI is located. Then clic
k
Open
.

(
Note: Don’t select file from browsing, make sure to type complete
UNC

path)



























Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㄰

of
㈹


d.

After adding MSI package, a dialog box
will appear that ask the Deployment
method. Select
Assigned

to make the Cryo Stubbing Client installation
auto
.
C
lick
‘OK’

button

to proceed further










e.

After successful addition of
CryoStubbing

package, right click on it and take its properties.
Click the
Advanced

button at the left bottom.

Make sure the option
‘Make this 32
-
bit X86
application availabl
e to Win64 machines’

is checked. Click OK. Then click OK

to proceed
further.






































Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄱ

of
㈹


f.

Give
the elevated privileges to the MSI installer.
Follow the location


Computer Configuration


Adm楮楳ir慴楶攠 T敭e污瑥猠


W楮iow猠 䍯浰on敮e
猠


W楮iow猠sn獴慬汥s


At the right hand side
select the option
‘Always install with elevated privileges’
and takes its
properties. Select the option
Enabled
. Click Apply. Click OK
.








f.











































Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄲ

of
㈹


g.

Close the Group
Policy Ob
ject Editor. OU properties windows will be at view,
select the policy object that just created (CryoStubbingInstall), click the
Properties

Button. Go to
Security

tab, and
Add

the Domain Computers that you want to give access
the group policy.
Check the
pro
perties

‘Read’

and
‘Apply Group Policy’.
Click Apply. Click
OK.






























h.

Move the desired machine from Computers object to the OU on which the above policy has
created. You may also create separate OU only for those computers on

which group policy
need to apply. Close Active Directory Users and Computers















(
Note: This will install cryostubbingclient.msi

at domain computers via

GPO
)


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄳ

of
㈹


i.

The
changes made or added in the group policy will be applied after updating the
group

policy objects.
Open
command prompt and write
gpupdate /force
.
Press
Y

to reboot the server machine, and press Enter





































Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄴ

of
㈹


1.7

Stubbing Client Installation


This will include client steps on first logging, once stubbing client in
stallation package deployed
using GP over the network.

1.7.1

Fresh Installation

a.

Installer will prompt user to ‘Accept’ VSTOR 2005 license




b.

Installer will detect Outlook version and prompt user to
install

relevant Primary Interop
Assemblies either 2003 or 2007
.







Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄵ

of
㈹




Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄶ

of
㈹



c.

Installer will prompt to ‘Run’ VSTOR 2005 setup.





1.7.2

Up gradation

Some blinking screens will be appearing on user screen and user does not
need to
click o
n any prompt.


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄷ

of
㈹


2.

Cryo Stubbing Client Installation in the Standalone Environment


2.1

Pre requ
isites for stubbing installer

This section describes all the prerequisites for integrated stubbing client installer

a.

MS outlook 2003/2007

If MS Outlook 2003/2007 is not installed, given below error generated by Installation
package.


b.

Microsoft Framework 2
.0

If MS Framework 2.0 is not installed then given below error will be generated by
Installation Package


If user trying to install VSTOR 2005 after getting above error then Installer will display
given below error for

missing MS Framework 2.0 is on clien
t machine
.


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄸ

of
㈹



c.

User must be logged with Administrative account

2.2

Installer components and their detail

This section lists all the components of stubbing client i
nstaller

a.

Primary Interop Assemblies 2003 (For Outlook 2003)

b.

Primary Interop Assemblies 2007 (For Ou
tlook 2007)

c.

Visual Studio Tools for Office Runtime 2005

(For both Outlook 2003/2007)

d.

CryoStubbing Setup.msi

(this is to inst
all CryoOutlook addin)

All the above setups are integrated in Setup.exe

e.

Setup
.exe (this is to install pre
-
requisites and Cryoserver
Outlook Addin)


2.3

Deploying Installer components

This section describes how to place/deploy all components of stubbing client installer

Cryo End user needs to u
nzip
‘
CryoStubbingClient.zip
’

file and place all the components in a
single folder.


2.4

Stubbing clie
nt installation

Stubbing client installation steps

2.4.1

Fresh Installation

a.

Cryo end user needs
to
execute
‘
Setup.exe
’

using Administrative account

from
Installation package (CryoStubbingClient.zip)
.


Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
ㄹ

of
㈹



b.

Installer will prompt user to ‘Accept’ VSTOR 2005 license


c.

Installer will detect Outlook version and prompt user to
install

relevant Primary
Interop Assemblies either 2003 or 2007.





Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈰

of
㈹


d.

Installer will prompt to ‘Run’ VSTOR 2005 setup.








2.4.2

Upgrading

a.

Cryo end user
just
needs to execute ‘CryoStubbing Setup.msi’
from Installation package
(CryoStubbingClient.zip)
. It will a
utomatically up
grade relevant files.

Some blinking screens will be appearing on user screen and user does not click on any
prompt.

Note: Command prompt screen will appear as a blink, when user ea
ch time logged.



Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈱

of
㈹


3.

Cryo Stubbing Client Installation in the Terminal Server Environment


3.1

Pre requisites for stubbing client installer


a.

Microsoft Outlook 2003/2007

b.

Microsoft .Net Framework 2.0 or above

c.

Primary Interop Assemblies

2003/2007

d.

Visual Studio Tools

for Office Runtime 2005

a.

Install all the pre
-
requisites mentioned in the above section on Terminal Server.

b.

Install ‘CryoStubbing Setup.msi’ on Terminal Server.

c.

Run registry file ‘AddinCompleteRegistries.reg’ on Terminal Server.

Note: The r
egistry file actu
ally will shad
ow copy stubbing Client add
-
in’s required
registry on the terminal server, and these registries are then copied by Terminal Server
for new user logon, which is need to run Stubbing Client Terminal Server’s users.


4.

Installer Verification

4.1

Ve
rification for Stubbing Client Installer v5.2.3


a.

After successful installation, Cryo Stubbing Client Installer should place all the relevant files
in the installation directory at following location
:

C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\


Given below
files should be present in the installation directory

i.

CASPolicyInstaller.dll

ii.

CryoStubbing.dll (Application Extension File)

iii.

CryoStubbing.dll (XML Configuration File)

iv.

CryoStubbing.dll.manifest

v.

Interop.Redemption.dll

vi.

Microsoft.Office.Interop.Outlook.dll

vii.

Micro
soft.Office.Interop.SmartTag.dll

viii.

Microsoft.Office.Tools.Common.dll

ix.

Microsoft.VisualStudio.Tools.Applications.Runtime.dll

x.

Office.dll

xi.

Redemption.dll

xii.

System.Data.SQLite.dll

xiii.

VSTOStorageWrapper.Interop.dll







Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈲

of
㈹


b.

Verify the CAS policies installation throu
gh .Net Framework 2.0 Configuration
Tools. Proceed to Control Panel

Administrative Tools

Microsoft .Net
Framework 2.0 Configuration.

Expand: My Computer

Runtime Security Policy

Machine

Code Groups

All_Code


Verify the following
CAS
policies:

i.

StubOutlookAdd
in
:

URL:
C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\
CryoStubbing.dll

Policy Level: Full Trust
















ii.

Redemption
:

URL:
C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\
Interop.Redemption.dll

Policy Level: Full Trust















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈳

of
㈹


iii.

SQLite
:

URL:
C:
\
Program F
iles
\
CryoOutlook
\
CryoStubbing
\
System.Data.SQLite.dll

Policy Level: Full Trust















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈴

of
㈹


4.2

Verification for Stubbing Client Installer v6.0.0


a.

After successful installation, Cryo Stubbing Client Installer should place all the relevant files
in the install
ation directory at following location:

C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\


Given below files should be present in the installation directory

























b.

Verify the CAS policies installation through .Net Framework 2.0 Configuration Tool
s. Proceed to
Control Panel

Administrative Tools

Microsoft .Net Framework 2.0 Configuration.






Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈵

of
㈹


Expand: My Computer

Runtime Security Policy

Machine

Code
Groups

All_Code

StubOutlookAddinPath

















Verify the following
CAS
policies:

i.

StubOutlookA
ddin
:

URL:
C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\
CryoStubbing.dll

Policy Level: Full Trust


















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈶

of
㈹


ii.

Redemption:

URL:
C:
\
Program
F
iles
\
CryoOutlook
\
CryoStubbing
\
Interop.Redemption
.dll

Policy Level: Full Trust














iii.

S
QLite
:

URL:
C:
\
Program
Files
\
CryoOutlook
\
CryoStubbing
\
System.Data.SQLite
.dll

Policy Level: Full Trust















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈷

of
㈹


iv.

FileStorage:

URL:
C:
\
Program Files
\
CryoOutlook
\
CryoStubbing
\
FileStorage
.dll

Policy Level: Full Trust














v.

DynamiteXML:

URL:
C:
\
Program Files
\
CryoO
utlook
\
CryoStubbing
\
DynamiteXML
.dll

Policy Level: Full Trust



Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈸

of
㈹


5.


Trouble Shooting Guide


a.

If
o
utlook
a
ddin
did not
load

in Addin list

Resolution:

check the following registry values

i.

HKEY_CURRENT_USER
\
Software
\
Classes
\
CryoStubbing

ii.

HKEY_CURRENT_USER
\
Software
\
Microsoft
\
Office
\
Outlook
\
Addins
\
CryoStubbing



b.

If outlook
a
ddin added in the Addin list but not loaded due to Runtime Error

Resolution:


i.

Register Redemption.dll

on local machine from CryoStubbing Client directory by using
command
“regsvr32 C:
\
Program File
s
\
CryoOutlook
\
CryoStubbing
\
Redemption.dll”

ii.

Verify the CAS policies as given in In
staller Verification
section 4


c.

If outlook addin is loaded successfully but ‘Cryo Settings’ option did not visible in menu

Outlook 2003:
Tools

Trust Center

Add
-
ins

Outlook 200
7:
Tools

Options

Others

COM Addins

CryoStubbing

Resolution:

Restart the outlook to properly load
cryo stubbing client
addin
. Also verify the
step
a

and
b
.


d.

If outlook addin installed and successfully loaded but stubbed messages body
appeared

blank or
did n
ot show
properly















Stubbing Client

Installation

Doc Version:4
.0 |

FCS

2013

Pag攠
㈹

of
㈹



Resolution:

Open ‘Cryo Settings’ and change the cyoserver

URL

with the
appropriate cryoserver
ip address

or name

at

which the stubbed mail resides, and
press the Test button.




e.

After successful installation of cryo out
look client if there is a problem in downloading
stubbed mail attachment,
the following error will be logged in log file:







Reason:

Above error
is

due to Outlook OLK folder absence. Outlook uses this folder as
temporary storage for attachments

downloa
ding
.

Resolution:

T
his folder
is
automatically created when
download the attachment f
rom

any
un
-
stubbed mail

once
.