Installing GlobalSight on Windows

From Globalsight
Revision as of 04:40, 14 October 2014 by Globalwiki (talk | contribs) (1 revision)
Jump to navigation Jump to search
Developers
Go to: Getting Started Guide
Footer-logo.gif
System requirements

Installing GlobalSight
3rd party comps: Windows | Ubuntu
GlobalSight: Windows | Ubuntu
Desktop Icon

Setting up GlobalSight
Running GlobalSight Behind an Apache Reverse Proxy

Developing GlobalSight
GlobalSight Architecture
Getting the Code
Building and Deploying GlobalSight
GlobalSight Developer’s Guide
Setting up the Development Environment
Debugging GlobalSight
Designing the GlobalSight Adapters
GlobalSight Web Services API
Using the GlobalSight Web Services API Test Tool
Using the GlobalSight CVS Connector
Connecting to a CVS with the GlobalSight Desktop Icon

Upgrading GlobalSight
Comparing GlobalSight with WorldServer

Prerequisites

Note that Internet Explorer (IE) is the only browser fully supported at the moment.

Installing the GlobalSight files

To install the GlobalSight files:

  1. Ensure that Java is in your PATH. To verify, type:
    echo %PATH%
  2. Ensure that <MySQL_ROOT>/bin is in your PATH and that you can access the GlobalSight MySQL Server from the MySQL command line
  3. Unzip the GlobalSight.zip file to the GlobalSight Application home directory
  4. Using the command line, go to the GlobalSight Application home directory
  5. CD to the install directory and run the GlobalSight install script install.bat
  6. Click Next when the GlobalSight GUI Installation interface
    Installgs.jpg

Entering the server settings

In Server Settings, enter the installation parameters and click Next. Use the table below as a guide.

Installgs1.jpg


Parameter Description
Java home The JAVA_HOME to run the application server.

Default: c:/jdk1.6.0_07

J2EE App Server Hostname or IP Address Name of the server on which you installed the App Server. Enter the fully qualified name of the host, e.g. machine.domain.com

Default: localhost

J2EE App Server HTTP port The web server HTTP port for the App Server.

Default: 80

Use Public Address Flag (true or false) to use a public address for the App Server to login.

Default: false

Public Login URL The public login url for the App Server.
Enable HTTPS Flag (true or false) to enable HTTPS for the App Server.

Default: false

J2EE App Server HTTPS port The web server HTTPS port for the App Server.

Default: 443

Keystore File for HTTPS(leave empty to use default) The keystore file for HTTPS authentication.

Default: empty. Default self-signed certificate

Keystore Password The keystore file’s password for HTTPS authentication.

Default: empty. Default self-signed certificate’s password: changeit

Allow concurrent logins of the same user Flag (true or false) to allow concurrent logins of the same user. If set to false, you will not be able to login twice (concurrently) with the same username. If you want to login as the second user, the first user must logout or you must wait for their session to time out.

Default: true

Entering the application settings

In Application Settings, enter the installation parameters and click Next. Use the table below as a guide.

Installgs3.jpg


Parameter Description
GlobalSight Administrator username The user you will use to first log in to GlobalSight and to create all the other users initially. This user will be created in OpenLDAP when you import the globalsight.ldif file below.

Use the default value. Default: superAdmin

GlobalSight Administrator password The password of GlobalSight Administrator username

Default: password

GlobalSight Super Company Name The name of the super company of GlobalSight.

Default: Welocalize

GlobalSight file storage directory This is a permanent directory GlobalSight will use to store temporary files.

Default: d:\FileStorage

Logging level Debugging level.

Default: INFO

Write debug files Flag (true or false) to enable writing to the debug directory.

Default: false

Enable Job Costing Flag (true or false) to enable the Job Costing feature.

Default: true

Enable job revenue details If this module has been purchase then answer “true”, otherwise answer “false.”

Default: true

Comment Sort Order Default: default
Enable Local Content Management Flag (true or false) to enable the Local Content Management feature.

Default: true

Enable reporting Flag (true or false) to enable the Reporting feature of GlobalSight.

Default: true

Entering the database settings

In MySQL Database, enter the installation parameters and click Next. Use the table below as a guide.


Parameter Description
Database server The server name where the MySQL is installed, for example, machine.domain.com or localhost

Default: localhost

Database port The MySQL port

Default: 3306

Database name The MySQL database name that you want to connect to.

Default: globalsight

Database username The username of the MySQL database, for example, globalsight

Default: globalsight

Database password The password for the database user above

Default: password

Database logging Flag (true or false) to enable logging of SQL statements of hibernate and other database related information.

Default: false

Entering the email settings

In Email settings, enter the installation parameters and click Next. Use the table below as a guide.

Installgs5.jpg


Parameter Description
Enable notification service Flag (true or false) to enable the Email Notification feature of GlobalSight

Default: false

Mail server The mail server, for example, smtp.gmail.com

Default: mail.domain.com

SMTP port(default: 25 for non-ssl, 465 for secure) The SMTP port for the mail server

Default: 25

GlobalSight Administrator email The email address of the GlobalSight Administrator. When something goes wrong in the system, this person gets an email

Default: WelocalizeAdmin@domain.com

Enable secure connection(TLS/SSL) Flag (true or false) to enable secure connection

Default: false

Enable Email Authentication Flag (true or false) to enable the Email Authentication feature of GlobalSight. This feature should be enabled only when the mail server used by GlobalSight requires authentication

Default: false

Email authentication username The mail server user that authenticates all email sent from GlobalSight. This is a special mail server user created just for GlobalSight email authentication purposes. You must add this user to the mail server that you specified above.

Note: The username is not the username of the sender of GlobalSight email, since GlobalSight emails can be sent from multiple users This parameter is ignored if the Enable Email Authentication parameter above is disabled Default: nobody

Email authentication password The password for the Email authentication user above

This parameter is ignored if the Enable Email Authentication parameter above is disabled Default: nobody

Enable warning thresholds This enables thresholds for Job Acceptance/Completion/ warnings

Default: false

Acceptance/Completion time warning threshold The time when the Acceptance or Completion Warning email isbe sent. This value is the time elapsed in percent between:
  1. Job Creation and Acceptance
  2. Job Acceptance and Job Completion

This parameter is ignored if the Warning Thresholds parameter above is disabled

Default: .75

Entering the optional package settings

In Optional Packages, enter the installation parameters and click Next. Use the table below as a guide.

Installgs6.jpg


Parameter Description
Web Service This enables the Web Service capability of GlobalSight. Web Service and Desktop Icon do not work if they are not checked-.

Default: true

Alchemy Catalyst Integration This enables the Alchemy Catalyst Integration capability of GlobalSight. This capability does not work if this is not checked

Default: false

Path to Alchemy Catalyst Server Default: c:\Catalyst 5
Paragraph Editor This enables the Paragraph Editor feature of GlobalSight. This feature doesl not work if this is not checked.

Default: true

Corpus TM This enables the Corpus TM capability of GlobalSight. This capability does not work if this is not checked

Default: true

Corpus Aligner This enables the Corpus Aligner capability of GlobalSight. This capability does not work if this is not checked

Default: true

Calendar component This enables the Calendar capability of GlobalSight. This capability does not work if this is not checked.

Default: false

System’s default time zone in GMT format (i.e. GMT-8:00 for US) This sets the time zone used by GlobalSight for all time and date calculations. This value is expressed in hours from Greenwich Mean Time. The default is set to GMT-8, which is Pacific Standard Time for the West Coast of the US and Canada.

Default: GMT-8:00

FrameMaker Adapter This enables GlobalSight to work with FrameMaker 9. The adapter does not work if this is not checked. Default: false

If this is set to true, you need to set up the converter for it. For instructions, see the Installing the FrameMaker 9 Converter section of this document.

FrameMaker 9 Adapter Conversion Directory The directory that the GlobalSight FrameMaker 9 Converter uses for import and export. This parameter is ignored if the FrameMaker Adapter above is disabled.

Default: d:\winfiles

Microsoft Office Word Adapter This enables GlobalSight to work with Microsoft Word. This adapter does not work if this is not checked

Default: false If this is set to true, you need to set up the converter for it. For instructions, see the Installing the MS Office Converters section of this document

Microsoft Office Excel Adapter This enables GlobalSight to work with Microsoft Excel. This adapter does l not work if this is not checked.

Default: false If this is set to true, you need to set up the converter for it. For instructions, see the Installing the MS Office Converters section of this document

Microsoft Office PowerPoint Adapter This enables GlobalSight to work with Microsoft PowerPoint. This adapter does not work if this is not checked.

Default: false If this is set to true, you need to set up the converter for it. For instructions, see the Installing the MS Office Converters section of this document

MS Office 2007 Adapter Conversion Directory The directory that the GlobalSight MS Office 2007 Adapter feature l uses for internal processing. This parameter is ignored if the Enable Microsoft Office integration parameter above is disabled

Default: d:\winfiles

MS Office 2003 Adapter Conversion Directory The directory that the GlobalSight MS Office 2003 Adapter feature uses for internal processing. This parameter is ignored if the Enable Microsoft Office integration parameter above is disabled

Default: d:\winfiles_2003

Adobe INDD Adapter This enables GlobalSight to work with Adobe InDesign. The adapter does not work if this is not checked

Default: false If this is set to true, you need to set up the converter for it. For instructions, see the Installing the ADOBE InDESIGN & ILLUSTRATOR Converters section of this document

Adobe Illustrator Adapter This enables GlobalSight to work with Adobe Illustrator. This adapter does not work if this is not checked

Default: false If this is set to true, you need to set up the converter for it. For instructions, see the Installing the ADOBE InDESIGN & ILLUSTRATOR Converters section of this document

Adobe(CS2) Adapter Conversion Directory The directory that the GlobalSight Adobe InDesign CS2 and Illustrator Adapter feature uses for internal processing. This parameter is ignored if the nable Adobe integration parameter above is disabled

Default: d:\winfiles

Adobe(CS3) Adapter Conversion Directory The directory that the GlobalSight Adobe InDesign CS3 and Illustrator Adapter feature uses for internal processing. This parameter is ignored if the Enable Adobe integration parameter above is disabled

Default: d:\winfiles

Adobe(CS4) Adapter Conversion Directory The directory that the GlobalSight Adobe InDesign CS4 and Illustrator Adapter feature uses for internal processing. This parameter is ignored if the Enable Adobe integration parameter above is disabled

Default: d:\winfiles

Adobe(CS5) Adapter Conversion Directory The directory that the GlobalSight Adobe InDesign CS5 and Illustrator Adapter feature uses for internal processing. This parameter is ignored if the Enable Adobe integration parameter above is disabled

Default: d:\winfiles

SQL Database Adapter This enables the Database Integration feature of GlobalSight. The adapter does not work if this is not checked

Default: false

TeamSite Adapter This enables the TeamSite integration feature of GlobalSight. This feature does not work if this is not checked

Default: false

Vignette Adapter This enables the Vignette integration feature of GlobalSight. The adapter does not work if this is not checked

Default: false

Vendor Management This enables the Vendor Management capability of GlobalSight. Vendor Management does not work if this is not checked

Default: false

ServiceWare Adapter This enables the ServiceWare integration feature of GlobalSight. This feature does not work if this is not checked

Default: false

Documentum Adapter This enables the Documentum integration feature of GlobalSight. This feature does not work if this not checked

Default: false

Finishing the installation

  1. In Install Options, check all boxes except the second
    Installgs8.jpg


    Note: Create Database should be checked for a brand new GlobalSight installation. This creates the database tables needed for GlobalSight.
  2. Click Install. This starts the installation process for GlobalSight
  3. If Create database is checked, click Yes on the warning that pops up. Do this on the first installation of GlobalSight, or if you want to re-create the GlobalSight tables
    Installgs9.jpg

  4. Click Close once Installation Successful appears
    Installgs10.jpg

    Installgs11.jpg

GlobalSight has now been installed.

Check the wizard console for any errors that may have been arisen during the database creation.

Note: When creating the database, the installer also copies the necessary LDAP files to OpenLDAP and configures OpenLDAP. You can then skip the configuring OpenLDAP Directory Server section.

Configuring GlobalSight Web Services (optional)

The Web services API allows any client - regardless of implementation technology or operating system - to connect and exchange data with GlobalSight.

To configure the Web Services:

  1. Log in to GlobalSight as a superadmin
  2. Click Remote IP Filter for Webservices
  3. Click New to add the remote IP address information. For example:
    Installgs12.jpg

  4. Click Save

You can use an asterisk (”*”) as a wildcard in place of the last IP address parameter. For example, the IP address "192.168.30.*" allows all network IP addresses that begin with 192.168.30 to use GlobalSight Web services.

Installing the Aligner (optional)

Alignment is the process by which segments in previously-translated files are matched with one another to create translation memory.

The process is partially automated, and the language resource is responsible for confirming the alignment between the source and target segments. This process allows translation memory to be created rapidly from content previously translated.

To install the GlobalSight Aligner (Galigner):

  1. Unzip the galign-installer.zip to a temporary location
    For example: c:\Galigner
  2. Open that location
    • For Windows: Click setup.exe
    • For Mac: Double-click galign-installer.jar
    • For UNIX: Run java –jar galign-installer.jar

Installing the MS Office Converters

Installing .NET Framework 3.5

  1. Open the Microsoft .NET Compact Framework 3.5, which is included in the GlobalSight package. You can also download it
  2. Double-click NETCFSetupv35.msi
  3. Accept all defaults and follow though the installation
  4. Re-start the computer after the installation finishes (default)

Installing the MS Office 2003 or 2007 converters

The version of the MS Office converter should correspond to the Office version on the machine. Different versions cannot be installed on the same machine.

  1. Create a shared directory (<ConversionDir> for the purposes of this document), which contains your source files. This should match the directory that you set in the Install Wizard – Optional Packages – MS Office 2003/2007 Adapter Conversion Directory
    For example: d:\WINFILES
  2. Under the <ConversionDir>, create a directory for the MS Office format you want to import. For example, “excel”, “word” or “PowerPoint”. Word is used for the purposes of this document
  3. Enable the Microsoft Word Adapter during the installation of GlobalSight by setting the following installation parameters:
    • Microsoft Word Adapter Conversion Directory [D:\WINFILES], as in D:\<ConversionDir>. Do not use a trailing slash in the name. If the conversion directory is n a different computer and is being accessed over the network, do not use a mapped drive. Use the UNC path instead. For example: \\server\WINFILES. Mapped drives do not work if the server has been set to start up automatically on reboot
  4. Extract GlobalSight_MSOffice2003_Converter.zip or GlobalSight_MSOffice2007_Converter.zip
  5. Double-click setup.exe to start the installation

Both MS Office 2003 and 2007 converters need .NET framework v3.5.

To start the converters:

  1. Click Start->Programs->GlobalSight->Office 2007 Converters
  2. Specify the Conversion Directory
  3. Click Start All

Uninstalling the converters:

  1. Stop the Office 2007 Converters
  2. Click Control Panel->Add or Remove Programs to remove the Office 2007 Converters

Installing the FrameMaker 9 Converter

The GlobalSight FrameMaker 9 Converter requires the Adobe FrameMaker 9 software to be installed.

To install the GlobalSight FrameMaker 9 Converter

  1. Extract GlobalSight_FrameMaker9_Converter.zip
  2. Double-click setup.exe to start the installation

To add the plugin to Adobe FrameMaker 9

  1. Stop FrameMaker 9 application
  2. Copy <FrameMaker 9 Converter>\fmconv.dll to <Adobe FrameMaker9 Installation Path>\fminit\Plugins folder
  3. Add the following line to <FrameMaker9 Installation Path>\maker.ini [APIClients] section.
    fmconv=Standard, GlobalSight FMConvert, fminit\Plugins\fmconv.dll, all

To start the converter:

  1. Click Start->Programs->GlobalSight->FrameMaker 9 Converter
  2. Specify the FrameMaker 9 Path
  3. Specify the Conversion Directory
    This should match the directory that you set in the Install Wizard – Optional Packages – FrameMaker 9 Adapter Conversion Directory. For example: d:\WINFILES
  4. Click Start

To uninstall the converter:

  1. Stop the FrameMaker 9 Converter
  2. Click Control Panel->Add or Remove Programs to remove the FrameMaker 9 Converter

Installing the InDesign and Illustrator Converter

The version of the converter for InDesign CS2/CS3/CS4/CS5 and Illustrator CS2 should correspond to the version on the machine. Different versions cannot be installed on the same machine.

To install the InDesign and Illustrator Converter:

  1. Extract Adobe_CSx_Converter.zip (Adobe_CS4_Converter.zip for InDesign CS4)
  2. Double-click AdobeConverter.exe to run the converter
  3. Select InDesign Converter CS2/CS3/CS4/CS5 and Enter or Browse to the directory that is used in the GlobalSight – Optional Packages – Adobe (CS2)/(CS3)/(CS4)/(CS5) Adapter Conversion Directory
  4. Select Illustrator Converter CS2 and Enter or Browse to the directory that is used in GlobalSight – Optional Packages – Adobe (CS2) Adapter Conversion Directory
  5. Click Start

Error logs:

Any errors related to the Adobe InDesign & Illustrator converter are logged in the EventLog. Any other errors in normal processing are logged in a file called AdobeConverter.log under the selected directory location.

Uninstalling the converter:

  1. Click Stop
  2. Remove the Adobe Converter directory

Configuring GlobalSight for Auto-Import (optional)

This feature allows you to import files automatically into the system.

Prerequisites

Set up GlobalSight with at least one Localization Profile and one File Profile so that the settings you enter below can accurately reference GlobalSight objects for processing and routing.

Setting Auto-Import parameters

  1. Edit the file <application_home>/autoFileImport.properties
  2. Use the table below to enter the correct parameters for your GlobalSight installation
    Changes to this file require a GlobalSight restart
Parameter Description
disableAutoImport Flag (true or false) to enable the entire Auto-Import feature. If it is false, then no directories are watched for auto-import.

Default: false

pollingFrequency The polling frequency in seconds. This is how often the GlobalSight polls the directories for changes.

Default: 60

BatchSize This determines the number of files to import in a batch when changes have been detected. This only matters if the associated Localization Profile uses Batch instead of WordCount to determine the job size.

For example, if, it has been determined that three files have changed when polling, either three batches containing one file each can be sent, or one batch containing three files The values allowed are “one” or “all” Default: one

AssumeUnencounteredFilesAreNew Flag (true or false) to tell GlobalSight whether or not files in a previously un-scanned directory are new. For example, if the directory en_US\pressReleases exists and has five files before the first time GlobalSight is run, then all five files are identified as new, files and imported if the property is set to true.

If the property is set to false, then the five files are not be imported unless are modified later. A sixth file added to the directory is b identified as new and imported regardless of the setting Default: true

Specifying the directories to watch

  1. Edit the file <application_home>/autoFileImport.map
  2. Enter one line for each directory that you want to watch. Enter each line in the format:
    <directory> | <jobNamePrefix> | <FileProfileName>
    • <directory> is the directory that you want to watch. Watching is recursive, so sub-directories will also be watched
    • <FileProfileName> is the File Profile in GlobalSight that corresponds to the files in this directory

For example, the entry:
en_US\pressReleases | PressReleases | My_en_US_HTML_Files specifies that the directory <globalsight_docs>\en_US\pressReleases is watched by GlobalSight for new and changed files. The files imported from this directory will be processed as specified in the GlobalSight File Profile “My_en_US_HTML_Files”.

Preparing documents for import

  1. Create the document directory that you entered during the installation of the GlobalSight files
    • For example: d:\welocalize\docs
  2. Create a sub-directory where you store your source files
    • For example: d:\welocalize\docs\en_US
  3. Put the documents you want to import in this directory
  4. If your source language is different, replace en_US with your source language locale. For example: es_MX.

Starting and stopping GlobalSight

You can start and stop GlobalSight using the options below.

The procedure starts and stops JBoss only. All other GlobalSight components run as automatic services and are therefore already running when the machine is started.

  • To start GlobalSight from the Start Menu, click Start -> All Programs -> GlobalSight -> Start GlobalSight
  • To stop GlobalSight from the Start Menu, click Start -> All Programs -> GlobalSight -> Stop GlobalSight

To start GlobalSight in Service Mode:

  1. Click Start -> Run
  2. Type services.msc and submit
  3. In the Service Window, find the GlobalSight Service
  4. Right-click it and select Start

To stop GlobalSight in Service Mode:

  1. Click Start -> Run
  2. Type services.msc and submit
  3. In the Service Window, find the GlobalSight Service
  4. Right-click it and select Stop

To start GlobalSight in Console Mode

  1. Run <GlobalSight Server Directory>/jboss/startJboss.cmd
  2. Wait for the following sentence:
    -----------JBOSS -- GlobalSight started ------------

To stop GlobalSight in Console Mode, press Ctrl+C in the JBoss Console or close the JBoss Console directly.

Logging in to GlobalSight

  1. Open Internet Explorer and go to http://server.domain.com:port/globalsight/
    "server.domain.com" is the value entered for " J2EE App Server Hostname or IP Address"
    "port" is the value entered for " J2EE App Server HTTP port"
  2. Username: superAdmin, GlobalSight Administrator user.
  3. Password: password, the password for GlobalSight Administrator user.

Uninstalling GlobalSight

To uninstall the GlobalSight components, follow the steps below in the order listed.

All of these procedures assume that GlobalSight is NOT running.

Uninstalling the Application Service

Execute UninstallApp-NT.cmd in folder <GlobalSight_home>\install\JavaServiceWrapper\bin.

Uninstalling JDK

To uninstall JDK:

  1. Open Control Panel-> Add/Remove Programs
  2. Remove the following components:
    • Java DB
    • Java(TM)
    • Java(TM) SE Development Kit

Uninstalling MySQL

To uninstall MySQL:

  1. OpenControl Panel > Add/Remove Programs
  2. Remove MySQL Server

Cleaning up the Start menu

To clean up the Start menu:

  1. Open the <GlobalSight_home>\install\JavaServiceWrapper\bin folder
  2. Double-click RemoveStartMenu.cmd

Cleaning up the system PATH variable

To clean up the system PATH variable:

  1. Open Control Panel->System->Advanced->Environment
  2. Remove the entries for the products that you have uninstalled

You can now remove the <GlobalSight_home> folder.