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
.
Enter the password to open this PDF file:
File name:
-
File size:
-
Title:
-
Author:
-
Subject:
-
Keywords:
-
Creation Date:
-
Modification Date:
-
Creator:
-
PDF Producer:
-
PDF Version:
-
Page Count:
-
Preparing document for printing…
0%
Σχόλια 0
Συνδεθείτε για να κοινοποιήσετε σχόλιο