Installing 3d com Search on Windows

1. Check your machine's operating system against the following table to verify that it will indeed support 3d com MetaSearch.

• Launch the 3d com Installation.
• In the Select Software dialog box of the installation, you should choose the N3G configuration.

Note the following points during the installation of the 3d com Navigator configuration:

• Choose an installation directory without any white space (i.e.: don't keep the default WindowsInstallPathx86 directory, but choose rather something 
  like C:\metasearch). This limitation will be fixed in a later release.  
• Ignore the port number configuration dialog box for the backbone  
• Don't choose to automatically start the Portal after the installation. The created icon 
  and menus are reserved for future use,  but are ineffective at this moment.

// --------- Example ---------
example = [.
Name = "example",
RealName = "Example",
Checked = false,
Internal = false,
Technical = false,
Program = "http://search.example.com/search.gw",
ProgramURL = "http://search.example.com/search.gw?search=",
Home = "http://www.example.com/",
Parameters = fun(Request)
[. search = Request .]
end,
Init = fun(Results)
return Seq(Results, "a # br small");
end,
Extract = fun(Answer)
var Result = [. .];
var Item = Elem(Answer, "a")[0];
Result.Title := Text(Item);
Result.URL := Str_Split(Item.href, ";")[1];
Result.Abstract := Text(Answer);
return Result;
end
.],

 

1. Copy / paste the definition of one of the pre-defined drivers in order to have a model for the creation of your driver definition.
2. Modify the object name example to correspond to the identifier of your driver. 
3. Modify the Name variable to be the object name surrounded by quotes.
4. Modify the RealName variable to be the driver name as you wish it to appear on the screen in your MetaSearch menus.
5. Modify the Checked variable to be:

• true:  if you wish the entry in the MetaSearch menu to be pre-checked
• false:  if you wish the entry in the MetaSearch menu not to be pre-checked

6. Modify the Internal variable to be:

• true:  if you wish the entry in the MetaSearch menu to appear in the list of Internal drivers 
• false:  if you wish the entry in the MetaSearch menu not to appear in the list of Internal drivers (it will appear in the list of General drivers by default)

7. Modify the Technical variable to be:

• true:  if you wish the entry in the MetaSearch menu to appear in the list of Technical drivers 
• false:  if you wish the entry in the MetaSearch menu not to appear in the list of Technical drivers (it will appear in the list of General drivers by default)

8. Modify the Program variable to be the URL of the called program cgi.
9. Modify the ProgramURL variable to be a concatenation of the above Program variable + the minimum argument required, e.g.: 

• connect to the browser from your desktop
• make a search
• copy / paste the search string from the browser's URL field into your ProgramURL variable

10. Modify the Home variable to be the URL home of your driver.

For the following three variables, you can consult the topic Markup Algebra  in the Compaq webl documentation which you'll find at the following location of your installation:

%install_path%\docs\metasearch\CompaqWEBLanguage.pdf

11. Modify the Parameters variable to contain the search arguments of the ProgramURL in webl syntax.  
12. Modify the Init variable to define the initialization function in webl syntax.
13. Modify the Extract variable to define the extraction in webl syntax. 

For further information, consult the Compaq webl documentation:

%install_path%\docs\metasearch\CompaqWEBLanguage.pdf

1. In the MetaSearch settings file
      %install_path%\startup\metasearch\metasearch.properties
customize the Proxy Preferences variables:

# Proxy preferences (use | to separate hosts)
http.proxySet=true
http.proxyHost=128.1.2.3
http.proxyPort=80
http.nonProxyHosts=lyon|pepita

2. In the %install_path%\code\bin  directory of your installation, run the command

MetasearchServer  password  "login_name:login_password" 

where  login_name  is the 3d com proxy login name and 
            login_password is the 3d com proxy password.

1. Customize the MetaSearch settings file
         $install_path\startup\metasearch\metasearch.properties
to define the mail server:

• define the mail server machine name in the variable  metasearch.mailServer 
• define the Simple Mail Transport Protocol (SMTP) in the variable 
metasearch.mailPort 

 

# Name of your mail server
metasearch.mailServer=soleil
# Port of your mail server
metasearch.mailPort=25

1. Customize the variable  metasearch.language  in the MetaSearch settings file  %install_path%\startup\metasearch\metasearch.properties  to conform to the language used in your company, i.e.

for English: metasearch.language=en
for French: metasearch.language=fr
for German: metasearch.language=de
for Japanese: metasearch.language=ja
for Chinese: metasearch.language=zh

1. Customize the optional settings in the MetaSearch settings file
         %install_path%\startup\metasearch\metasearch.properties
   to conform to your company's needs.
   
   The following is a list of some of the settings you can customize:

• MetaSearch language variable : metasearch.language
• trace variables : metasearch.traces,  metasearch.stdOut
• timeout variables : metasearch.timeout, metasearch.longTimeout, metasearch.shortTimeout, metasearch.time
• proxy server variables : http.proxySet, http.proxyHost, http.proxyPort, http.nonProxyHosts

1. Modify the file $install_path/startup/metasearch/searchserver.properties by setting the following value:

searchserver.doc=path_of_installed_online_documentation

e.g. C:/Program Files/Dassault Systemes/EnvNameSuffixdoc/English/online

Note: All directory separators in the defined path should be slashes "/" (not backslashes "\").

1. Choose a filesystem which can grow to meet the storage requirements for all persistent search subscriptions and archives. For example, choose C:\metasearch
2. Edit the CATEnv environment  file ENOVIA3dcomEnvironmentName.txt located in the directory 
       C:\Winnt\Profiles\All Users\Application Data\
     Dassault Systemes\CATEnv\
   
   by setting the CATMetaSearchPath environment variable to:
       CATMetaSearchPath =C:\metasearch
   

1. To start the Search server, you must run the following command:

• %install_path%\code\bin\SearchServer

2. To start the MetaSearch server, you must run the following command:

• %install_path%\code\bin\MetasearchServer

Example:

MetaSearchServer.exe -env ENOVIA3dcomEnvironmentName.txt -direnv "C:\Documents and Settings\All Users\Application Data\
\DassaultSystemes\CATEnv"
 

Example:

• %install_path%\code\bin\SearchServer servername  
  etole.dassault-systemes.fr
• %install_path%\code\bin\MetaSearchServer servername  
  etole.dassault-systemes.fr

%install_path%\startup\metasearch\metasearch.properties
%install_path%\startup\metasearch\searchserver.properties
%install_path%\startup\metasearch\driver.webl

or modification of the proxy username and password using 
          %install_path%\code\bin\MetasearchServer.exe 

will not be taken into account until the MetaSearch and Search server processes are  re-launched. See Launch the Search server and the MetaSearch server above.