Installing GlobalSight on Ubuntu

From Globalsight
Revision as of 03: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

Unzipping creates the following folders:

  • 3rd_party_software
  • Aligner
  • Converters
  • DesktopIcon
  • GlobalSight

Note that GlobalSight 8.5 support Internet Explorer, Firefox and Chrome at the moment. Some functions may only work in compatibility mode on Internet Explorer 10.

Installing the GlobalSight files

To install the GlobalSight files:

  1. Ensure that $JAVA_HOME is in your PATH
    • For example: echo $JAVA_HOME
    • /usr/local/java/jdk1.7.0_21
    • For example: echo $PATH
      • /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/local/java/jdk1.7.0_21/bin
  2. Ensure that <MySQL_ROOT>/bin is in your PATH and that you can access the GlobalSight MySQL Server from the MySQL command line. The GlobalSight installer uses this to connect to the MySQL database server to create tables for the GlobalSight application
    • For example: echo $PATH
      • /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/local/java/jdk1.7.0_21/bin:/usr/local/mysql/bin
  3. Create a user called “jboss” for the GlobalSight system as follows:
    • Type: sudo useradd jboss –m –s /bin/bash
    • Type: sudo passwd jboss
    • Type: sudo adduser jboss sudo
  4. Login as user jboss
  5. Copy and unzip GlobalSight.zip to /home/jboss directory
    • Type: sudo unzip GlobalSight.zip –d /home/jboss/GlobalSight
  6. Go to the installation directory (for example /home/jboss/GlobalSight/install) and add the executable attribute to the file Install.sh as follows:
    • Type: cd /home/jboss/GlobalSight/install
    • Type: sudo chmod u+x Install.sh
    • Run the Install.sh
      Type: sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh

The GlobalSight Installation interface starts.

Installubuntu1 update1.jpg


In the Install menu, type N to go to the next page.

Installubuntu2 update1.jpg


Entering the server settings

In Server Settings, enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu3 update1.jpg


Parameter Description
Java home The JAVA_HOME to run the application server
J2EE App Server Hostname or IP Address The name of the server on which you installed the Application Server. Enter the fully qualified name of the host, for example, machine.domain.com or localhost

Default: localhost

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

Default: 80 Note: Use a port number higher than 1024 On UNIX-type operating systems, only user root can bind to listen on port 80. All other users are considered non-privileged and they cannot bind to that port. In fact, all ports below port 1024 are considered privileged. This is a basic security measure.

Use Public Address Flag (true or false) to use a public address for the Application Server to log in

Default: false

Public Login URL The public login URL for the Application Server
Enable HTTPS Flag (true or false) to enable HTTPS for the Application 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 cannot login twice (concurrently) with the same username. If you want to login as the second user, the first user must log out or you must wait for their session to time out.

Default: true

Entering the application settings

In Application Settings, enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu4 update1.jpg


Parameter Description
GlobalSight Administrator username The user used for first login to GlobalSight and for creating all other users initially. This user is created in OpenLDAP when importing the globalsight.ldif file below

Default: gsAdmin

GlobalSight Administrator password The password of the 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 that GlobalSight uses to store temporary files.

Note: The jboss user must have the write privilege to the directory you choose

Document directory This is where the files are imported from and exported to

Note: The jboss user must have the write privilege to the directory you choose

Logging level This means the 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 purchased, 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 Default: Flag (true or false) to enable the Reporting feature of GlobalSight

Default: true

Entering the MySQL database settings

In MySQL Database, enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu6 update1.jpg


Parameter Description
Database server The server name or the IP where MySQL is installed

Default: localhost For example: db_server.domain.com or 192.168.29.29 or localhost

Database port The MySQL port

Default: 3306

Database name The name of the GlobalSight database that you want to connect to

Default: globalsight

Database username The GlobalSight database username, for example, GlobalSight

Default: globalsight

Database password The password for the database user above

Default: password

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

Default: false

Entering the email settings

In Email Settings, enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu7 update1.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 mail.domain.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 is used to authenticate 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 Job Acceptance/Completion/ warning thresholds.

Default: false

Acceptance/Completion time warning threshold The time when the Acceptance or Completion warning email should be sent. The 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 optional package settings

In Optional Packages, click D to go to the next page.

Installubuntu8 update1.jpg


Enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu9 update1.jpg


Parameter Description
Web Service This enables the Web Service capability of GlobalSight. Web Service does not work if it is false

Default: true

Alchemy Catalyst Integration This enables the Alchemy Catalyst Integration capability of GlobalSight. Alchemy Catalyst Integration does not work if it is false

Default: false

Path to Alchemy Catalyst Server The jboss user must have the write privilege to the directory you choose
Paragraph Editor This enables the Paragraph Editor feature of GlobalSight. The Paragraph Editor does not work if it is false

Default: true

Corpus TM This enables the Corpus TM capability of GlobalSight. Corpus does not work if it is false

Default: true

Corpus Aligner This enables the Corpus Aligner capability of GlobalSight. Corpus does not work if it is false.

Default: true

Calendar component This enables the Calendar capability of GlobalSight. Calendar does not work if it is false

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: /home/jboss/welocalize/winfiles

Microsoft Office Word Adapter This enables GlobalSight to work with Microsoft Word. The adapter does not work if it is false

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 for instructions

Microsoft Office Excel Adapter This enables GlobalSight to work with Microsoft Excel. The adapter does not work if it is false

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 in this document

Microsoft Office PowerPoint Adapter This enables GlobalSight to work with Microsoft PowerPoint. The adapter does not work if it is false

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 in this document

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

Note: The jboss user must have the write privilege to the directory you choose

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

Note: The jboss user must have the write privilege to the directory you choose

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

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. The adapter does not work if it is false

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 “Enable Adobe integration” parameter above is disabled

Note: The jboss user must have the write privilege to the directory you choose

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

Note: The jboss user must have the write privilege to the directory you choose

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

Note: The jboss user must have the write privilege to the directory you choose

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

Note: The jboss user must have the write privilege to the directory you choose

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

Note: The jboss user must have the write privilege to the directory you choose

Passolo Adapter This enables GlobalSight to work with SDL Passolo 2011. The adapter does not work if it is false

Default: false

Passolo 2011 Adapter Conversion Directory The directory that the GlobalSight Passolo 2011 Adapter feature uses for internal processing. This parameter is ignored if the “Pasolo Adapter” parameter above is disabled

Note: The jboss user must have the write privilege to the directory you choose

Windows Portable Executable Adapter This enables GlobalSight to work with .Net Fromework to handle Dynamic Link Library(.DLL) files and execuable(.EXE) files. The adapter does not work if it is false

Default: false

Windows Portable Executable Adapter Conversion Directory The directory that the GlobalSight Passolo 2011 Adapter feature uses for internal processing. This parameter is ignored if the “Windows Portable Executable Adapter” parameter above is disabled

Note: The jboss user must have the write privilege to the directory you choose

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

Default: false

TeamSite Adapter This enables the TeamSite integration feature of GlobalSight. The adapter does not work if it is false

Default: false

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

Default: false

Vendor Management This enables the Vendor Management capability of GlobalSight. Vendor Management does not work if it is false

Default: false

ServiceWare Adapter This enables the ServiceWare integration feature of GlobalSight. The adapter does not work if it is false

Default: false

Documentum Adapter This enables the Documentum integration feature of GlobalSight. The adapter does not work if it is false

Default: false

Entering the optional CMS settings

In Optional CMS settings, enter the installation parameters as required and then type N to go to the next page. Use the table below as a guide.

Installubuntu10 update1.jpg


Parameter Description
CMS Adapter This enables the CMS integration feature of GlobalSight. The adapter does not work if it is false

Default: false

CMS UI host The hostname of the machine where the CMS UI is running, for example “tempest”

Default: cms_host

CMS UI port The port that is used to display the CMS UI. For example, if the CMS module is deployed in Tomcat, then typically this is 8080 by default

Default: cms_port

Content server URL An IIOP or RMI URL that can be used to connect to the MAE (Mediasurface Application Engine). If the MAE is deployed on the machine ‘tempest’, then an example value is: iiop://tempest/Mediasurface

Default: iiop://host/Mediasurface

Content server name The name of a “Content Server” object configured within the CMS. For example “Staging Server”, “Live Server”, and so on. GlobalSight is set up to localize content from this content server

Default: Staging Server

Content server port The port of the specified Content Server. For example, “8080”. If JSP templates are being used, then this is typically the same as the CMS UI port

Default: 8080

Finishing the installation

To finish the installation:

  1. In Install Options, set options 1, 3 and 4 above to true (for a first GlobalSight install)
    Installubuntu11.jpg

    • Note: Option 4 creates database tables for the GlobalSight application. The installer drops exiting tables, if they exist from a prior install, and creates new tables for the GlobalSight application. If this is not your first GlobalSight install, setting option 4 to 'true' causes a loss of data.
  2. Type I to start the installation
  3. Press Enter after installation to continue

GlobalSight is now installed.

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

Post-installation procedures

To configure the jboss user:

  1. Make sure the owner of the GlobalSight system is set to jboss, if not change as below
    • Type: sudo chown -R jboss /home/jboss/GlobalSight
  2. Set the related file executable. For example:
    • Type: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/standalone.sh
    • Type: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/jboss-cli.sh

To check the docHome location:

  1. Make sure that File storage directory and Document directory specified in Entering the server settings have been written to web.xml file.
    • Type: vi /home/jboss/GlobalSight/jboss/server/standalone/deployments/globalsight.ear/globalsight-web.war/WEB-INF/web.xml

If you find any docHome is set to default value other than that you specified, i.e. /home/jboss/welocalize/docs and /home/jboss/welocalize/filestorage, then run Install.sh again without any configuration changes. This will update the wrong directory map to the right one in web.xml.

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 the GlobalSight with superAdmin account
  2. Click Remote IP Filter for Webservices
  3. Click New to add the remote IP address information
    Installubuntu12 update1.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.1.* allows all network IP addresses that begin with 192.168.1 to use GlobalSight Web services.

Configuring Samba (optional)

Configure Samba in order to set up Office 2003/2007 or Adobe InDesign converters.

Pre-requisites:

  • Ensure that Samba has been installed
    • Type: sudo apt-get install samba

To configure Samba:

  1. Switch to the user with sudo privilege
  2. Edit the /etc/samba/smb.conf file:
    [global]
    workgroup=workgroup
    server string=ubuntu server
    security=share
    encrypt passwords=true
    smb passwd file=/etc/samba/smbpasswd
    guest ok=yes

    [<Name>]
    path=<path>
    public=yes
    writable=yes
    create mask=0777
    directory mask=0777
    • < Name> is the name of your shared directory, and the <path> is the directory that you want to share.
    • Note: the jboss user must have the read/write privileges for this folder
    • A sample smb.conf file looks as follows:
      Installubuntu13.jpg

  3. Re-start Samba to make the configuration take effect
    • Type: sudo service smbd restart
  4. Verify your Samba configuration
    • Type the following link in Windows explorer:
      \\<IP address for ubunut>\<Name>
      e.g. \\192.168.29.29\converter
  5. Add the user nobody to the jboss group to make sure that the windows user has the write privilege to the converter file
    • Type: sudo usermod -a -G jboss nobody

Installing the MS Office Converters

For details, see Installing the MS Office Converters.

Installing the Adobe InDesign and Illustrator converter

To run the InDesign CS2/CS3/CS4/CS5 and Illustrator CS2 converter, InDesign CS2/CS3/CS4/CS5 and Illustrator CS2 application need to be installed in the same machine with the corresponding converter.

CS2, CS3, CS4 and CS5 - applications or converters - cannot be installed on the same machine.

To install the converters:

  1. Extract Adobe_CSx_Converter.zip, or 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 the directory that is used in GlobalSight – Optional Packages – Adobe (CS2)/(CS3)/(CS4)/(CS5) Adapter Conversion Directory
  4. Select Illustrator Converter CS2 and Enter or Browse the directory that is used in GlobalSight – Optional Packages – Adobe (CS2) Adapter Conversion Directory
  5. Click Start
  6. Enter the following in your converter dialog:
    • \\<IP address for ubunut>\<Name>
    • For example: \\192.168.29.29\converter\winfiles

Error logs:

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

To uninstall the converters:

  1. Click Stop
  2. Remove the Adobe Converter directory

Installing the FrameMaker 9 Converter

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

Installing the GlobalSight FrameMaker 9 Converter

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

Add 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 un-install the converter:

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


Start and stop procedure

Use this procedure to start GlobalSight. The procedure starts and stops Jboss only, since all other GlobalSight components run as automatic services and are therefore already running when the machine is started.

To start GlobalSight in Service Mode:

  1. Type: sudo service globalsight start
  2. Check the GlobalSight.log in the /home/jboss/GlobalSight/logs directory. If GlobalSight starts successfully, the message below shows in GlobalSight.log:
    GlobalSight is now ready to accept logins.

To stop GlobalSight in Service Mode:

  • Type: sudo service globalsight stop

To start GlobalSight in Console Mode:

  1. Run <GlobalSight Server Directory>/jboss/server/bin/standalone.sh.
  2. Wait for the following message:
    -----------JBOSS -- GlobalSight started ------------

To stop GlobalSight in Console Mode:

Press Ctrl + C in the JBoss Console.

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"
    • Username: gsAdmin
    • GlobalSight Administrator user.
    • Password: password, the password for the GlobalSight Administrator user

Uninstalling GlobalSight

To uninstall the GlobalSight components, follow the steps below in the order listed. All uninstall procedures assume that GlobalSight is not running.

Uninstall the Application Service:

  1. Stop GlobalSight
    • Type: sudo service globalsight stop
  2. Remove the GlobalSight directory
    • Type: sudo update-rc.d globalsight remove


Uninstall JDK:

Remove the directory /usr/local/java

Uninstall MySQL:

  1. Stop MySQL
    • Type: sudo service mysql.server stop
  2. Remove the directory /usr/local/mysql
  3. Remove the configuration file /etc/mysql/my.cnf

Cleanup the system PATH variable:

Edit the file /etc/profile and remove related PATH variable.