TenFold Enterprise
Installation Guide
Content
1Abstract (2)
2Initial server machine (2)
2.1Install IIS to support Tenfold BrowserClient (2)
3Setup SQL server 2005 for Tenfold (2)
3.1Installed SQL server 2005 Enterprise Edition (2)
3.2Create 2 databases VMDICT_DEV and VMAPPL_DEV in SQL server. (2)
3.3Create 2 Users For Tenfold Database (3)
3.4Execute following SQL Query For Tenfold databases (4)
4Setup ProductAreas (4)
4.1Download Installation Package (4)
4.2Create the directory structure for your server/client ProductArea (5)
4.3Install TenFold Distribution Tools on server and client computers (5)
5Create OptionFile and Install Package (6)
5.1Install Server Part (6)
5.2Install Client Part (7)
5.3Check the execution result of tfdeliver (8)
6Setup BrowserClient (9)
7Installing TenFold using existing database (9)
8Port configuration at TenFold ServerManagers (11)
9iClient configuration (12)
1Abstract
This user guide describes how to install and configure TenFold Enterprise. In the following section, we will introduce you on initialing server machine, installing and setup TenFold database, setup TenFold ProductArea, installing TenFold package.
2Initial server machine
2.1Install IIS to support Tenfold BrowserClient
2.1.1Go to Control Panel -> Add or Remove programs -> Add/Remove Windows
Components
2.1.2Select Application server in Components list, click on ‘Details’ button
2.1.3Check the checkbox of ‘Internet Information Services (IIS)’ in Subcomponents of
Application server list, click on OK button
2.1.4Click on Next button in Window Components Wizard dialog to install IIS
2.1.5
3Setup SQL server 2005 for Tenfold
3.1Installed SQL server 2005 Enterprise Edition
3.2Create 2 databases VMDICT_DEV and VMAPPL_DEV in
SQL server.
And set ‘Auto Shrink’ value in Database properties to True.
3.3Create 2 Users For Tenfold Database
Create 2 users VMDICT_DEV (with password VMDICT_DEV) and VMAPPL_DEV (with password VMAPPL_DEV) in SQL server. And set proper User Mapping.
3.4Execute following SQL Query For Tenfold databases
alter database
alter database
Notes:
-For other database types (e.g. Oracle) you have to follow the same steps. You can use database vendor documentation to find similar information how to create a database schema and new user with corresponding privileges.
4Setup ProductAreas
4.1Download Installation Package
Download the installation package, which will have the name similar to this:
WinAll1.Enterprise.2012May15.rar. This archive contains all that you need for the installation of TenFold Enterprise.
Here we put downloaded package file WinAll1.Enterprise.2012May15.rar in C:\temp\
WinAll1.Enterprise.2012May15.rar.
4.2Create the directory structure for your server/client
ProductArea
Suppose we are going to install TenFold in C:\TenFold, then our %TENFOLD_ROOT% is C:\TenFold.
●Create /server folder in %TENFOLD_ROOT%
●Create /pkg folder under %TENFOLD_ROOT%\server
●Create /client folder in %TENFOLD_ROOT%
●Create /pkg folder under %TENFOLD_ROOT%\client
See the directory structure sample below:
4.3Install TenFold Distribution Tools on server and client
computers
a)Create Tools folder and copy TenFold Distribution Tools bootstrap package
i.Create a folder named disttools under %TENFOLD_ROOT%
ii.Copy the TenFold Distribution Tools bootstrap client package
bpkg+
copy bpkg+intel_win2003_db2_entdb_mssql_mysql_ora+C20080104.tar to
C:\TenFold\disttools.)
b)Extract files from TenFold Distribution Tools bootstrap package
Unzip bpkg+
Note: This creates and populates bin, doc, log, and opt folders under C:\TenFold\disttools See the directory structure sample below:
5Create OptionFile and Install Package
5.1Install Server Part
5.1.1Create Server OptionsFile
a)Copy the sample “tools\opt\tfdist_server.i ni” file to “tfdist_server.ini”
b)In the “(Deliver)” subsection and “(Obtain)” subsection, replace text between “###”
symbols
(Deliver)
TenFoldRoot=c:\TenFold\server
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=claw3:VMDICT_DEV
DatabaseServer=claw3
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
FastConnectDefaultServer=claw3:20671
ProductArea=VMServer
RemoveClientPackage=Yes
(Obtain)
TenFoldRoot=c:\TenFold\server
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=claw3:VMDICT_DEV
DatabaseServer=claw3
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
EndUserName=installtest
EndUserPassword=installtest
Responsibility=TenFold Dictionary distributor
ObtainClientComponent=No
ObtainServerComponent=Yes
ObtainSourceCode=Yes
5.1.2Create Server Setup Script
a)Copy the sample “tools\opt\SetupToolsSample.bat” file to SetupToolsServer.bat
b)Modify the script using instructions in the script.
SET TENFOLD_ROOT= c:\TenFold\disttools
SET TENFOLD_OPTIONS= tfdist_server.ini
5.1.3Install Server Packages
a)Run the script SetupToolsServer.bat.
b)Using the correct SequenceRange for your product area, run this commands:
tfdeliver Product=UA Label=C20120515 SequenceRange=2067000000
outputtype=screen Outputfile=UA.C20120515.C20120528.1545.LOG
Notes:
SequenceRange - The numeric sequence range for your dictionary that you received from TenFold. It is customer-specific, so you have to make sure that you use the correct
sequence range value.
The SequenceRange is start value for records IDs in database and the datatype for that is an unsigned 32-bit integer. Please ensure that it does not exceed the maximum value for an unsigned 32-bit integer
5.2Install Client Part
5.2.1Create Client OptionsFile
a)Copy the sample “tools\opt\tfdist.ini” file to “tfdist_client.ini”
b)In the “(Deliver)” subsection and “(Obtain)” subsection, replace text between “###”
symbols
(Deliver)
TenFoldRoot=c:\Tenfold\client
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=claw3:VMDICT_DEV
DatabaseServer=claw3
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
FastConnectDefaultServer=claw3:20671
ProductArea=VMClient
RemoveClientPackage=No
(Obtain)
TenFoldRoot=c:\TenFold\client
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=claw3:VMDICT_DEV
DatabaseServer=claw3
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
EndUserName=installtest
EndUserPassword=installtest
Responsibility=TenFold Dictionary distributor
ObtainClientComponent=Yes
ObtainServerComponent=No
ObtainSourceCode=Yes
5.2.2Create Client Setup Script
a)Copy the sample “tools\opt\SetupToolsSample.bat” file to SetupToolsClient.bat.
b)Modify the script using instructions in the script.
SET TENFOLD_ROOT=c:\TenFold\disttools
SET TENFOLD_OPTIONS=tfdist_client.ini
5.2.3Install Client Packages
a)Setup client environment variables by executing the Setup script created in “Create
Client Setup Script” in the command shell.
b)Using the correct SequenceRange for your product area (contact TenFold Support if
you have questions), run this commands:
tfdeliver Product=UAClient Label=C20120515 SequenceRange=2067000000
outputtype=screen Outputfile=UAClient.C20120515.20120528.0930.LOG
5.3Check the execution result of tfdeliver
When tfdeliver finished we should see a message like: **** tfdeliver completed at Mon May 28 09:30:07 2012
To run TenFold Enterprise go to C:\Tenfold\server\opt, run the created SetupToolsServer.bat script(we specified this also in the configuration file), it will set up TenFold Enterprise environment, all we had to is to run tfcli command and TenFold Enterprise starts:
\
6Setup BrowserClient
Copy WCInstall-
Navigate to C:\Tenfold\webconnect\bin folder.
Run tfinstall AppName=Tenfold ServerManager=localhost:20671 URL=http://localhost/Tenfold WebServer=Apache
Connect to http://localhost/Tenfold/signon.htm
7Installing TenFold using existing database
It is possible to upgrade to the current TenFold Enterprise version using the old TenFold application databases and registry file from the previous TenFold installation.
TenFold uses Registry file to track the versions of the installed components. When you install TenFold the first time, it creates Registry file (see /reg/site.reg) and when you upgrade TenFold installation next time, it compares component versions in Registry file and if it finds that some components have a newer version –it runs upgrade procedure for this component (including updating database schema).
In case you want to install TenFold on existing product database without having previous TenFold installation on your machine (without ProductArea), you have to copy the old site.reg file into %TENFOLD_ROOT%/reg folder and run installation process from scratch. In this case your database schema will be updated correctly.
Installation steps:
1)Download TenFold Distribution Tools bootstrap client package:
bpkg+intel_win2003_db2_entdb_mssql_mysql_ora+C20080104.tar
Unpack it into c:/TenFold/disttools
2)Create c:/TenFold/server folder. Also create /reg and /pkg subfolders in it;
3)Copy site.reg from old TenFold installation into %TENFOLD_ROOT%/reg folder;
4)Copy the sample "disttools\opt\tfdist_nt.ini" file to "tfdist_server.ini" in the same folder
location. In the "(Deliver)" subsection and "(Obtain)" subsection, replace text between "###"
symbols:
(Deliver)
TenFoldRoot=c:\TenFold\server
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=localhost:VMDICT_DEV
DatabaseServer=localhost
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
FastConnectDefaultServer=localhost:20671
ProductArea=UA
RemoveClientPackage=No
(Obtain)
TenFoldRoot=c:\TenFold\server
TenFoldOptions=tenfold.ini
Database=VMDICT_DEV
DatabaseImplementation=localhost:VMDICT_DEV
DatabaseServer=localhost
DatabaseUser=VMDICT_DEV
DatabasePassword=VMDICT_DEV
DatabaseType=MSSQL
DatabaseClientVersion=7.0
EndUserName=installtest
EndUserPassword=installtest
Responsibility=Applications Prototyper
ObtainClientComponent=No
ObtainServerComponent=Yes
ObtainSourceCode=No
5)Copy the sample "disttools\opt\SetupToolsSample.bat" file to "disttools\SetupServer.bat".
Modify the script using instructions in the script:
SET TENFOLD_ROOT= C:\TenFold\disttools
SET TENFOLD_OPTIONS= tfdist_server.ini
SET MSSQL_HOME=c:\Program Files\Microsoft SQL Server\90
SET PATH=%TENFOLD_ROOT%\bin;%TENFOLD_ROOT%\sbin;%MSSQL_HOME%\binn
6)Copy pkg+UA+
7)Open command line and run the script SetupServer.bat.
8)In the same command line window run the next command:
tfdeliver Product=UA Label=C20120515 SequenceRange=2067000000 outputtype=screen Outputfile=UA.C20120515.C20120526.1245.LOG
9)Make sure that the installation process is finished successfully.
8Port configuration at TenFold ServerManagers
Firstly you have to make sure that tfdaemon process is started. Usually it's started with OS startup (located in Startup menu). If it's not running yet, you have to run it
manually:
c:\TenFold\disttools\bin\runtfd.bat
When tfdaemon is started, you have to start up ServerManager instance. Start StandardClient and login as Application Expert;
Select Classic->Servers->ServerManagers menu item;
Click "Run Query" to select all ServerManager instances;
Now you can go through each instance, check assigned ports and if you need - to start
the selected ServerManager instance by clicking on "Start" button:
9iClient configuration
You need to configure the following option in iClient options file:
[FastConnect]
DefaultServer=
where machine and port are the configuration information of ServerManager. The default value of port is 20671
Also please verify that you have the following options configured in iClient options file: [UniversalApplication]
ClientConfiguration=iClient
[TenFoldClient]
Distributed=Yes
[Error]
UseDictionary=No
Word文档免费下载：