Difference between revisions of "Installing GlobalSight on Ubuntu"

From Globalsight
Jump to navigation Jump to search
m (1 revision)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Docset_side}}
 
{{Docset_side}}
 +
 +
This guide describes how to install GlobalSight application server on Ubuntu server. If not specified, the Ubuntu Server is 14.04 LTS version. This guide has been updated to cater for GlobalSight version 8.6.7.
 +
 +
'''Important''': beginning with Ubuntu 15.04 version, system and service manager '''systemd''' is used as default system init daemon. Unfortunately, the GlobalSight daemon '''globalsight''' cannot work properly with '''systemd'''. Installing GlobalSight on Ubuntu Server 15.04 and above version is not recommended.
 +
 
==Prerequisites==
 
==Prerequisites==
* The GlobalSight software package for Ubuntu has been downloaded as described in [[Installing GlobalSight]]
+
* The GlobalSight software package for Ubuntu has been downloaded as described in [[Installing GlobalSight]].
* Third-party components have been installed as described in [[Installing Third-party Components for GlobalSight on Ubuntu]]  
+
* Third-party components have been installed as described in [[Installing Third-party Components for GlobalSight on Ubuntu]].
* The user has '''sudo''' privileges
+
* The current user has '''sudo''' privilege.
* The GlobalSight Software Package for Ubuntu has been downloaded and unzipped
+
* The GlobalSight Software Package for Ubuntu has been downloaded and unzipped.
**Type: unzip GlobalSight_Software_Packages_Linux_8.5.zip
+
*: Type: '''jar xvf''' <i><tt style="background-color:#efffbf; white-space:nowrap;">GlobalSight_Software_Package_Linux_8.6.7.zip</tt></i>
  
 
Unzipping creates the following folders:
 
Unzipping creates the following folders:
*3rd_party_software
+
* 3rd_party_software
*Aligner
+
* Converters
*Converters
+
* DesktopIcon
*DesktopIcon
+
* GlobalSight
*GlobalSight
+
 
 +
Some features in GlobalSight require running Java plugin on browsers, but now they cannot work on lately Google Chrome and Mozilla Firefox versions. We recommend using Microsoft Internet Explorer to perform related jobs. These Java Applet components will be removed from GlobalSight gradually.
  
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 core application==
 +
===Pre-installation procedures===
 +
# Ensure that <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">$JAVA_HOME</code> is in your <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">PATH</code> variable
 +
#: Type:  '''echo $JAVA_HOME'''
 +
#: The expected result should look like below:
 +
#: Example: /usr/local/java/jdk1.8.0_45
 +
#: Type: '''echo $PATH'''
 +
#: The expected result should look like below:
 +
#: Example: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/local/java/jdk1.8.0_45/bin
 +
# Ensure that you can access the GlobalSight database from the MySQL command line tool. The GlobalSight installer uses command 'mysql' to connect to the MySQL database server and to create tables for the GlobalSight application.
 +
#: Type: '''mysql -u''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_user_name></tt></i> '''-p''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_database_name></tt></i> '''-h''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><mysql_hostname_or_ip_ address></tt></i> '''-P''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><mysql_port></tt></i>
 +
#: Example: MySQL -uglobalsight -p globalsight -hlocalhost -P 3306
 +
# Create a user called '''jboss''' for the GlobalSight core application
 +
#: Type: '''sudo useradd -m -s /bin/bash jboss'''
 +
#: Type: '''sudo passwd jboss'''
 +
#: Type: '''sudo adduser jboss sudo'''
 +
# Log in as user jboss
 +
#: Type: '''su -l jboss'''
 +
# Unjar GlobalSight.zip to /home/jboss directory
 +
#: Type: '''mkdir GlobalSight && cd GlobalSight'''
 +
#: Type: '''jar xvf''' <i><tt style="background-color:#efffbf; white-space:nowrap;">/path/to/GlobalSight.zip</tt></i>
 +
# Go to the install script directory and add the executable attribute to script file '''Install.sh'''
 +
#: Type: '''cd''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory>/install</tt></i>
 +
#: Example: cd /home/jboss/GlobalSight/install
 +
#: Type: '''chmod u+x Install.sh'''
 +
#: Note: we will call the GlobalSight core application directory as '''<globalsight_home_directory>''' later.
 +
# Create GlobalSight documents and file storage directory
 +
#: Type: '''mkdir -p''' <i><tt style="background-color:#efffbf; white-space:nowrap;">/path/to/globalsight/docs/and/filestorage/directory</tt></i>
 +
#: Assume that we create two directories named 'docs' and 'filestorage' under directory '/home/jboss/welocalize/', the command will be:
 +
#: Example: mkdir -p /home/jboss/welocalize/{docs,filestorage}
 +
#: If you also need create directory for GlobalSight converters, you can use command like below:
 +
#: Example: mkdir -p /home/jboss/welocalize/{docs,filestorage,winfiles}
 +
#: Note: we will call the documents directory as '''<globalsight_document_directory>''', and file storage directory as '''<globalsight_filestorage_directory>''' later.
 +
# Update GlobalSight daemon template file <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory></tt></i><strong>/jboss/util/bin/service.sh.template</strong>
 +
#: Insert <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;"> -c ${JBOSS_USER} -d ${JBOSS_HOME}</code> between <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">--background</code> and <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">--user</code>
 +
#: Example:  <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff;">start-stop-daemon --start --quiet --background -c ${JBOSS_USER} -d ${JBOSS_HOME} --user ${JBOSS_USER} --exec ${JBOSS_HOME}/bin/standalone.sh</code>
 +
#: Example: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff;">start-stop-daemon --start --quiet --background -c ${JBOSS_USER} -d ${JBOSS_HOME} --user ${JBOSS_USER} --exec ${JBOSS_HOME}/bin/jboss-cli.sh -- --connect command=:shutdown</code>
 +
#: Note: this modification ensures that GlobalSight daemon are always running as user '''jboss'''.
  
==Installing the GlobalSight files==
+
===Installing GlobalSight core application===
'''To install the GlobalSight files:'''
+
# Run the install script
#Ensure that $JAVA_HOME is in your PATH
+
#: Type: '''sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh'''
#*For example:  echo $JAVA_HOME
+
#: Note: you can expand above command to '''sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh | tee globalsight_install.log'''. The command redirects output on the Console to file '''globalsight_install.log'''. It may help you identify errors if GlobalSight installation fails.
#*/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
 
#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
 
#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
 
#Login as user jboss
 
#Copy and unzip GlobalSight.zip to /home/jboss directory
 
#*Type:    sudo unzip GlobalSight.zip –d /home/jboss/GlobalSight
 
#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<br>Type:  sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh
 
  
 
The GlobalSight Installation interface starts.
 
The GlobalSight Installation interface starts.
[[File:installubuntu1_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu1_866.png|500px|thumb|left]]<br style="clear: both" />
  
In the ''Install'' menu, type '''N''' to go to the next page.
+
On the '''Install GlobalSight''' menu screen, type '''N''' to go to the next screen.
[[File:installubuntu2_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu2_866.png|500px|thumb|left]]<br style="clear: both" />
  
===Entering the server settings===
+
====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.
+
On '''Server Settings''' screen, enter the installation parameters as required and then type '''N''' to go to the next screen. Use the table below as a guide.
[[File:installubuntu3_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu3_866.png|500px|thumb|left]]<br style="clear: both" />
 +
: Note: An active internet connection is required to sign code for Java Applet components.
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
 
!width="150"|Parameter
 
!width="150"|Parameter
 
!width="400"|Description
 
!width="400"|Description
 
|-
 
|-
|Java home||The JAVA_HOME to run the application server
+
|Java home||The <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">JAVA_HOME</code> to run the GlobalSight 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
+
|J2EE App Server Hostname or IP Address|| The name of the server on which you installed the GlobalSight application server. Enter the fully qualified name of the host, for example, machine.domain.com or localhost
 
Default:  localhost  
 
Default:  localhost  
 
|-
 
|-
|J2EE App Server HTTP port|| The web server HTTP port for the App Server
+
|J2EE App Server HTTP port|| The web server HTTP port for the application server
Default:    80
+
Default:    80 <br/>
 
Note: Use a port number  higher than 1024   
 
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.
+
On UNIX-type operating systems, only user root can bind to listening 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
+
|Use Public Address||Flag (true or false) to use a public address for the GlobalSight application server to log in
 
Default:    false
 
Default:    false
 
|-
 
|-
|Public Login URL|| The public login URL for the Application Server
+
|Public Login URL|| The public login URL for the GlobalSight application server. It is ignored when above ''Use Public Address'' option is false
 
|-
 
|-
|Enable HTTPS|| Flag (true or false) to enable HTTPS for the Application Server
+
|Enable HTTPS|| Flag (true or false) to enable HTTPS for the GlobalSight application server
 
Default:    false
 
Default:    false
 
|-
 
|-
|J2EE App Server HTTPS port||The web server HTTPS port for the App Server
+
|J2EE App Server HTTPS port||The web server HTTPS port for the App Server. This value is ignored when above ''Enable HTTPS'' option is false
 
Default:    443
 
Default:    443
 
|-
 
|-
|Keystore File for HTTPS(leave empty to use default)||The keystore file for HTTPS authentication
+
|Keystore File for HTTPS(leave empty to use default)||The keystore file for HTTPS authentication. This value is ignored when above ''Enable HTTPS'' option is false
Default:    empty. Default self-signed certificate
+
Default:    empty. <br/>
 +
Using the self-signed certificate be default.
 +
|-
 +
|Keystore Password|| The keystore file's password/passphrase for HTTPS authentication. This value is ignored when above ''Enable HTTPS'' option is false
 +
Default:    empty. <br/>
 +
Default self-signed certificate's password: changeit
 +
|-
 +
|Enable Applet Code Signing|| Flag (true or false) to enable signing code for Java Applet components
 +
Default:    false
 +
|-
 +
|Keystore File|| The keystore file for signing code. This value is ignored when above ''Enable Applet Code Signing'' option is false
 +
Default:    empty
 
|-
 
|-
|Keystore Password|| The keystore file’s password for HTTPS authentication
+
|Keystore Password|| The keystore file's password/passphrase for signing code. This value is ignored when above ''Enable Applet Code Signing'' option is false
Default:    empty. Default self-signed certificate’s password: changeit
+
Default:    empty
 +
|-
 +
|Keystore Alias|| The keystore alias for signing code. This value is ignored when above ''Enable Applet Code Signing'' option is false
 +
Default:   empty
 
|-
 
|-
 
|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.
 
|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.
Line 82: Line 123:
 
|}
 
|}
  
===Entering the application settings===
+
====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.
+
On '''Application Settings''' screen, enter the installation parameters as required and then type '''N''' to go to the next screen. Use the table below as a guide.
[[File:installubuntu4_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu4_866.png|500px|thumb|left]]<br style="clear: both" />
  
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
Line 90: Line 131:
 
!width="400"|Description
 
!width="400"|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
+
|GlobalSight Administrator username||The administrator user used for first login to GlobalSight and for creating all other users initially
 
Default:    gsAdmin
 
Default:    gsAdmin
 
|-
 
|-
|GlobalSight Administrator password||The password of the GlobalSight Administrator username
+
|GlobalSight Administrator password||The password of the GlobalSight Administrator user
 
Default:    password
 
Default:    password
 
|-
 
|-
Line 102: Line 143:
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Document directory || This is directory that localization files are imported from and exported to
 
Note: The jboss user must have the write privilege to the directory you choose
 
Note: The jboss user must have the write privilege to the directory you choose
 
|-
 
|-
|Logging level|| This means the Debugging level.
+
|Logging level|| The information level that logged into files.
 
Default:    INFO
 
Default:    INFO
 
|-
 
|-
Line 111: Line 152:
 
Default:    false
 
Default:    false
 
|-
 
|-
|Enable Job Costing)||Flag (true or false) to enable the Job Costing feature
+
|Enable Job Costing||Flag (true or false) to enable the Job Costing feature
 
Default:    true
 
Default:    true
 
|-
 
|-
|Enable job revenue details|| If this module has been purchased, then answer “true”. Otherwise answer “false
+
|Enable job revenue details|| Flag (true or false) to show detailed revenues
 
Default:    true
 
Default:    true
 
|-
 
|-
Line 122: Line 163:
 
Default:    true
 
Default:    true
 
|-
 
|-
|Enable reporting || Default:    Flag (true or false) to enable the Reporting feature of GlobalSight
+
|Enable reporting || Default:    Flag (true or false) to enable the Reporting feature
 
Default:    true
 
Default:    true
 
|}
 
|}
  
===Entering the MySQL database settings===
+
====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.
+
On '''MySQL Database''' screen, enter the installation parameters as required and then type '''N''' to go to the next screen. Use the table below as a guide.
[[File:installubuntu6_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu5_866.png|500px|thumb|left]]<br style="clear: both" />
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
 
!width="150"|Parameter
 
!width="150"|Parameter
 
!width="400"|Description
 
!width="400"|Description
 
|-
 
|-
|Database server||The server name or the IP where MySQL is installed  
+
|Database server||The server name or the IP address that MySQL database is installed. For example: db_server.domain.com or 192.168.1.29 or localhost
 
Default:  localhost
 
Default:  localhost
For example: db_server.domain.com or 192.168.29.29 or localhost
+
 
 
|-
 
|-
|Database port|| The MySQL port
+
|Database port|| The port of MySQL database server
 
Default:    3306
 
Default:    3306
 
|-
 
|-
|Database name|| The name of the GlobalSight database that you want to connect to
+
|Database name|| The name of the GlobalSight database that you want to connect to
 
Default:    globalsight
 
Default:    globalsight
 
|-
 
|-
|Database username||The GlobalSight database username, for example,  GlobalSight
+
|Database username||The GlobalSight database's username
 
Default:    globalsight
 
Default:    globalsight
 
|-
 
|-
|Database password|| The password for the database user above
+
|Database password|| The password for the above database user
 
Default:    password
 
Default:    password
 
|-
 
|-
|Database logging||Flag (true or false) to enable the logging of SQL statements of hibernate and other database related information
+
|Database logging||Flag (true or false) to enable the logging of Hibernate queries and/or other database related information
 
Default:    false
 
Default:    false
 
|}
 
|}
  
===Entering the email settings===
+
====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.
+
On '''Email Settings''' screen, enter the installation parameters as required and then type ''N'' to go to the next screen. Use the table below as a guide.
[[File:installubuntu7_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu6_866.png|500px|thumb|left]]<br style="clear: both" />
  
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
Line 161: Line 202:
 
!width="400"|Description
 
!width="400"|Description
 
|-
 
|-
|Enable notification service||Flag (true or false) to enable the Email Notification feature of GlobalSight
+
|Enable notification service||Flag (true or false) to enable the Email Notification feature of GlobalSight. All followed options on this screen are ignored when it is false
 
Default:    false
 
Default:    false
 
|-
 
|-
|Mail server||The mail server, for example mail.domain.com
+
|Mail server||The fully qualified hostname of mail server, for example mail.domain.com
 
Default:    mail.domain.com
 
Default:    mail.domain.com
 
|-
 
|-
Line 170: Line 211:
 
Default:    25
 
Default:    25
 
|-
 
|-
|GlobalSight Administrator email||The email address of the GlobalSight administrator. When something goes wrong in the system, this person gets an email
+
|GlobalSight Administrator email||The email address of the GlobalSight administrator user. When something goes wrong in the system, this person gets an notification email
 
Default: WelocalizeAdmin@domain.com
 
Default: WelocalizeAdmin@domain.com
 
|-
 
|-
Line 176: Line 217:
 
Default:    false
 
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
+
|Enable Email Authentication||Flag (true or false) to enable the Email Authentication feature of GlobalSight. This value should be true when the mail server used by GlobalSight requires authentication <br/>
 
Default:    false  
 
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
 
|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
 
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
+
This value is ignored if above ''Enable Email Authentication'' option is false <br/>
 
Default:    nobody
 
Default:    nobody
 
|-
 
|-
 
|Email authentication password||The password for the email authentication user above  
 
|Email authentication password||The password for the email authentication user above  
This parameter is ignored if the Enable Email Authentication parameter above is disabled
+
This value is ignored if above ''Enable Email Authentication'' option is false <br/>
 
Default:    nobody
 
Default:    nobody
 
|-
 
|-
|Enable warning thresholds||This enables Job Acceptance/Completion/ warning thresholds.
+
|Enable warning thresholds||This enables Job Acceptance/Completion warning thresholds
 
Default:    false
 
Default:    false
 
|-
 
|-
Line 194: Line 235:
 
#Job Creation and Acceptance
 
#Job Creation and Acceptance
 
#Job Acceptance and Job Completion
 
#Job Acceptance and Job Completion
This parameter is ignored if the Warning Thresholds parameter above is disabled
+
This value is ignored if above ''Enable warning thresholds'' option is false <br/>
 
Default:    .75
 
Default:    .75
 
|}
 
|}
  
===Entering optional package settings===
+
====Entering optional package settings====
In ''Optional Packages'', click '''D''' to go to the next page.
+
On '''Optional Packages''' screen, type '''D''' to scroll down the screen.
[[File:installubuntu8_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu7_866.png|500px|thumb|left]]<br style="clear: both" />
 
+
: You will see more settings
Enter the installation parameters as required and then type '''N''' to go to the next page. Use the table below as a guide.
+
: [[File:installubuntu8_866.png|500px|thumb|left]]<br style="clear: both" />
[[File:installubuntu9_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: and then type '''D''' to show the left
 +
: [[File:installubuntu9_866.png|500px|thumb|left]]<br style="clear: both" />
  
 +
Enter the installation parameters as required and then type '''N''' to go to the next screen. Use the table below as a guide.
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
 
!width="150"|Parameter
 
!width="150"|Parameter
 
!width="400"|Description
 
!width="400"|Description
 
|-
 
|-
|Web Service||This enables the Web Service capability of GlobalSight. Web Service does  not work if it is false
+
|Web Service||This option enables the Web Service capability of GlobalSight. Web Service API calls will not work if it is false
 
Default:    true
 
Default:    true
 
|-
 
|-
|Alchemy Catalyst Integration||This enables the Alchemy Catalyst Integration capability of GlobalSight. Alchemy Catalyst Integration does  not work if it is false
+
|Alchemy Catalyst Integration||This option enables the Alchemy Catalyst Integration capability of GlobalSight. Alchemy Catalyst Integration does  not work if it is false
 
Default:  false
 
Default:  false
 
|-
 
|-
|Path to Alchemy Catalyst Server||The jboss user must have the write privilege to the directory you choose
+
|Path to Alchemy Catalyst Server||This value is ignored if above ''Alchemy Catalyst Integration'' option is false. 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
+
|Paragraph Editor||This option enables the Paragraph Editor feature of GlobalSight. The Paragraph Editor does not work if it is false
 
Default:    true
 
Default:    true
 
|-
 
|-
|Corpus TM||This enables the Corpus TM capability of GlobalSight. Corpus does not work if it is false
+
|Corpus TM||This option enables the Corpus TM capability of GlobalSight. Corpus TM will be deprecated in future GlobalSight version
 
Default:    true
 
Default:    true
 
|-
 
|-
|Corpus Aligner||This enables the Corpus Aligner capability of GlobalSight. Corpus does not work if it is false.
+
|Corpus Aligner||This option enables the Corpus Aligner capability of GlobalSight. Corpus Aligner does not work if it is false.
 
Default:    true  
 
Default:    true  
 
|-
 
|-
|Calendar component||This enables the Calendar capability of GlobalSight. Calendar does not work if it is false
+
|Calendar component||This option enables the Calendar capability of GlobalSight. Calendar does not work if it is false
 
Default:    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
+
|System's default time zone in GMT format (i.e. GMT-8:00 for US)||This option sets the timezone used by GlobalSight for all time and date calculations. This value is expressed in hours from Greenwich Mean Time. The default timezone is set to GMT-8, which is Pacific Standard Time for the West Coast of the US and Canada
Default:    GMT-8:00
+
Default:    GMT-8:00 <br/>
 +
This value is ignored if above ''Calendar component'' option is false
 
|-
 
|-
|FrameMaker Adapter||This enables GlobalSight to work with FrameMaker 9. The adapter does not work if this is not checked.  Default:    false
+
|FrameMaker Adapter||This option enables GlobalSight to work with Adobe FrameMaker 9. The adapter does not work if this is 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.
+
Default:    false <br/>
 +
If this option is set to true, you need to set up the FrameMaker 9 Converter for it.  For instructions, see the [[Installing_GlobalSight_on_Ubuntu#Installing_the_FrameMaker_9_Converter |Installing the FrameMaker 9 Converter]] section below 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.
+
|FrameMaker 9 Adapter Conversion Directory||The directory that the FrameMaker 9 Converter uses for file processing. This value is ignored if above ''FrameMaker Adapter'' option is false
 
Default:    /home/jboss/welocalize/winfiles
 
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
+
|OpenOffice Preview||This option enables GlobalSight to work with OpenOffice to file preview. The option is not applicable to Ubuntu Server
Default:    false
+
Default:    true <br/>
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
+
|-
 +
|OpenOffice install directory||The directory where OpenOffice3 is installed. The option is not applicable to Ubuntu Server
 +
Default:    /opt/openoffice.org3
 +
|-
 +
|Microsoft Office Word Adapter||This option enables GlobalSight to work with Microsoft Word 2003/2007. The adapter does  not work if it is false
 +
Default:    false <br/>
 +
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see [[Installing_GlobalSight_on_Ubuntu#Installing_the_Microsoft_Office_converters|Installing the Microsoft Office converters]] section below in this document
 
|-
 
|-
|Microsoft Office Excel Adapter||This enables GlobalSight to work with Microsoft Excel. The adapter does  not work if it is false
+
|Microsoft Office Excel Adapter||This option enables GlobalSight to work with Microsoft Excel 2003/2007. The adapter does  not work if it is false
Default:    false
+
Default:    false <br/>
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
+
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see [[Installing_GlobalSight_on_Ubuntu#Installing_the_Microsoft_Office_converters|Installing the Microsoft Office converters]] section below in this document
 
|-
 
|-
|Microsoft Office PowerPoint Adapter||This enables GlobalSight to work with Microsoft PowerPoint. The adapter does not work if it is false
+
|Microsoft Office PowerPoint Adapter||This option enables GlobalSight to work with Microsoft PowerPoint 2003/2007. The adapter does not work if it is false
Default:    false
+
Default:    false <br/>
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
+
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see [[Installing_GlobalSight_on_Ubuntu#Installing_the_Microsoft_Office_converters|Installing the Microsoft Office converters]] section below 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
+
|MS Office 2007 Adapter Conversion Directory||The directory that the GlobalSight MS Office 2007 converter uses for file processing. This value is ignored if none of ''Microsoft Office Word / Excel / PowerPoint Adapter'' is true
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|MS Office 2003 Adapter Conversion Directory||The directory that the GlobalSight MS Office 2003 converter uses for file processing. This value is ignored if none of ''Microsoft Office Word / Excel / PowerPoint Adapter'' is true
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Adobe INDD Adapter||This option enables GlobalSight to work with Adobe InDesign. The adapter does not work if it is false
 
Default:    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
+
If this option is set to true, you need to set up the converter for it. For instructions, see [[Installing_GlobalSight_on_Ubuntu#Installing_the_Adobe_InDesign_and_Illustrator_converters|Installing the Adobe InDesign and Illustrator converters]] section below of this document
 
|-
 
|-
|Adobe Illustrator Adapter||This enables GlobalSight to work with Adobe Illustrator. The adapter does not work if it is false
+
|Adobe Illustrator Adapter||This option enables GlobalSight to work with Adobe Illustrator CS2. The adapter does not work if it is false
 
Default:    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
+
|Adobe(CS2) Adapter Conversion Directory||The directory that the GlobalSight Adobe InDesign CS2 converter uses for file processing. This value is ignored if above ''Adobe INDD Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Adobe(CS3) Adapter Conversion Directory||The directory that the GlobalSight Adobe InDesign CS3 converter uses for file processing. This value is ignored if above ''Adobe INDD Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Adobe(CS4) Adapter Conversion Directory||The directory that the GlobalSight Adobe InDesign CS4 converter uses for file processing. This value is ignored if above ''Adobe INDD Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Adobe(CS5) Adapter Conversion Directory||The directory that the GlobalSight Adobe InDesign CS5 converter uses for file processing. This value is ignored if above ''Adobe INDD Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Adobe(CS5.5) Adapter Conversion Directory||The directory that the GlobalSight Adobe InDesign CS5.5 converter uses for file processing. This value is ignored if above ''Adobe INDD Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|In Context Review Tool||This option enables GlobalSight to work with Adobe InDesign CC 2015 and Microsoft Office 2010 for In-context review feature.
 
Default:    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
+
|In Context Review Conversion Directory (InDesign)||The directory that the GlobalSight Adobe InDesign CC 2015 converter uses for file processing. This value is ignored if above ''In Context Review Tool'' option is false
 +
Note: The jboss user must have the write privilege to the directory you choose
 +
|-
 +
|In Context Review Conversion Directory (Office)||The directory that the GlobalSight MS Office 2010 converter uses for file processing. This value is ignored if above ''In Context Review Tool'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Passolo Adapter||This option enables GlobalSight to work with SDL Passolo 2011. The adapter does not work if it is false
 
Default:    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
+
|Passolo 2011 Adapter Conversion Directory||The directory that the GlobalSight Passolo 2011 converter uses for file processing. This value is ignored if above ''Passolo Adapter'' option is false
 
Note: The jboss user must have the write privilege to the directory you choose
 
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
+
|Windows Portable Executable Adapter||This option 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
 
Default:    false
 
|-
 
|-
|TeamSite Adapter||This enables the TeamSite integration feature of GlobalSight. The adapter does not work if it is false
+
|Windows Portable Executable Adapter Conversion Directory||The directory that the GlobalSight Portable Executable converter uses for file processing. This value is ignored if above ''Windows Portable Executable Adapter'' option is false
 +
Note: The jboss user must have the write privilege to the directory you choose
 +
|-
 +
|SQL Database Adapter||This option enables the Database Integration feature of GlobalSight
 
Default:    false
 
Default:    false
 
|-
 
|-
|Vignette Adapter||This enables the Vignette integration feature of GlobalSight. The adapter does not work if it is false
+
|TeamSite Adapter||This option enables the TeamSite integration feature of GlobalSight
 
Default:    false
 
Default:    false
 
|-
 
|-
|Vendor Management||This enables the Vendor Management capability of GlobalSight. Vendor Management does not work if it is false
+
|Vignette Adapter||This option enables the Vignette integration feature of GlobalSight
 
Default:    false
 
Default:    false
 
|-
 
|-
|ServiceWare Adapter||This enables the ServiceWare integration feature of GlobalSight. The adapter does  not work if it is false
+
|ServiceWare Adapter||This option enables the ServiceWare integration feature of GlobalSight
 
Default:    false
 
Default:    false
 
|-
 
|-
|Documentum Adapter||This enables the Documentum integration feature of GlobalSight. The adapter does  not work if it is false
+
|Documentum Adapter||This option enables the Documentum integration feature of GlobalSight
 
Default:    false
 
Default:    false
 
|}
 
|}
  
===Entering the optional CMS settings===
+
====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.
+
On '''Optional CMS settings''' screen, enter the installation parameters as required and then type '''N''' to go to the next screen. Use the table below as a guide.
[[File:installubuntu10_update1.jpg|left|500px|thumb]]<br style="clear: both" />
+
: [[File:installubuntu10_866.png|500px|thumb|left]]<br style="clear: both" />
  
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
Line 318: Line 374:
 
!width="400"|Description
 
!width="400"|Description
 
|-
 
|-
|CMS Adapter||This enables the CMS integration feature of GlobalSight. The adapter does not work if it is false
+
|CMS Adapter||This option enables the CMS integration feature of GlobalSight. The CMS adapter does not work if this is false
 
Default:    false
 
Default:    false
 
|-
 
|-
|CMS UI host||The hostname of the machine where the CMS UI is running, for example “tempest”
+
|CMS UI host||The hostname of the machine where the CMS UI is running, for example "tempest"
 
Default:    cms_host
 
Default:    cms_host
 
|-
 
|-
Line 327: Line 383:
 
Default:    cms_port
 
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
+
|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
 
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  
+
|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
 
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
+
|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
 
Default:    8080
 
|}
 
|}
  
===Finishing the installation===
+
====Finishing the installation====
'''To finish the installation:'''
 
#In ''Install Options'', set options 1, 3 and 4 above to '''true''' (for a first GlobalSight install)<br>[[File:installubuntu11.jpg|left|500px|thumb]]<br style="clear: both" />
 
#*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.
 
#Type '''I''' to start the installation
 
#Press '''Enter''' after installation to continue
 
  
GlobalSight is now installed.
+
On '''Install Options''' screen, set option 1, 3 and 4 to '''true''' (for a fresh GlobalSight installation).
 +
: [[File:installubuntu11_866.png|500px|thumb|left]]<br style="clear: both" />
 +
:Note: Option 4 creates database tables for the GlobalSight application. The installer will drop and recreate exiting tables for the GlobalSight application. If this is not your first attempt to install GlobalSight, setting option 4 to 'true' will cause data loss.
 +
* Type '''I''' to start the installation
 +
* Press '''Enter''' after installation to exit
  
Check the console for any errors that may have arisen during creation of the database.
+
GlobalSight core application now is installed.
 +
 
 +
Check the console for any errors that may have arisen during creation of the database. If you have appended '''| tee globalsight_install.log''' to command '''sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh''', you can find the log file in current directory to see what fails during installation.
  
 
===Post-installation procedures===
 
===Post-installation procedures===
'''To configure the jboss user:'''
+
'''Change the ownership of GlobalSight application'''
#Make sure the owner of the GlobalSight system is set to jboss, if not change as below
+
# Set '''jboss''' as the owner of GlobalSight application server
#*Type:   sudo chown -R jboss /home/jboss/GlobalSight
+
#: Type: '''sudo chown -R jboss:jboss''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory></tt></i>
#Set the related file executable. For example:
+
#: Example: sudo chown -R jboss:jboss /home/jboss/GlobalSight
#*Type:   sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/standalone.sh
+
# Set '''jboss''' as the owner of GlobalSight documents and file storage directory
#*Type:   sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/jboss-cli.sh
+
#: Type: '''sudo chown -R jboss:jboss''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_document_directory></tt></i>
 +
#: Type: '''sudo chown -R jboss:jboss''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_filestorage_directory></tt></i>
 +
#: Example: sudo chown -R jboss:jboss /home/jboss/welocalize/docs
 +
#: Example: sudo chown -R jboss:jboss /home/jboss/welocalize/filestorage
  
'''To check the docHome location:'''
+
'''Set the start and stop service script executable'''
#Make sure that File storage directory and Document directory specified in '''Entering the server settings''' have been written to web.xml file.
+
: Type: '''sudo chmod u+x''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory>/jboss/server/bin/standalone.sh</tt></i>
#*Type: vi /home/jboss/GlobalSight/jboss/server/standalone/deployments/globalsight.ear/globalsight-web.war/WEB-INF/web.xml
+
: Example: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/standalone.sh
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.
+
: Type: '''sudo chmod u+x''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory>/jboss/server/bin/jboss-cli.sh</tt></i>
 +
: Example: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/jboss-cli.sh
  
 
==Configuring GlobalSight Web Services (optional)==
 
==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.  
+
The Web services API allows any client, regardless of implementation technology or operating system, to connect and exchange data with GlobalSight. Thus you can specify the IP addresses that are allowed to connect to GlobalSight.
 +
 
 +
'''To configure IP filters for Web services'''
 +
# Log in to the GlobalSight as super administrator user
 +
#Click '''Remote IP Filter for Webservices''' on home page
 +
#Click '''New'''  to add the remote IP address information
 +
#: [[File:installubuntu12_866.png|500px|thumb|left]]<br style="clear: both" />
 +
#: Note: You can use an asterisk ('''*''') as a wildcard in IP addresses. For example, the IP address 192.168.1.* allows all network IP addresses that begin with 192.168.1 to use GlobalSight Web services.
 +
# Click '''Save'''
 +
 
 +
When create a new company, make sure that '''Enable IP Filter''' option is enabled. Then IP filters will take effect for that company.
  
'''To configure the Web services:'''
+
==Configuring Samba server (optional)==
#Log in to the GlobalSight with superAdmin account
+
To work with GlobalSight converters installed on Windows system, you may need configure a Samba server to share files on Ubuntu server.
#Click '''Remote IP Filter for Webservices'''
 
#Click '''New'''  to add the remote IP address information<br>[[File:Installubuntu12_update1.jpg|left|500px|thumb]]<br style="clear: both" />
 
#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.
+
'''Prerequisites'''
 +
* Make sure Samba server is installed
 +
*: Type: '''smbd -V'''
 +
*: To install Samba server
 +
*: Type: '''sudo apt-get -y install samba'''
 +
* The current user has '''sudo''' privilege to modify Samba configuration file
  
==Configuring Samba (optional)==
+
'''To configure Samba'''
Configure Samba in order to set up Office 2003/2007 or Adobe InDesign converters.
 
  
'''Pre-requisites:'''
+
The main configuration file for Samba server is '''/etc/samba/smb.conf'''. You need '''sudo''' privilege to edit it.
*Ensure that Samba has been installed
 
**Type:    sudo apt-get install samba
 
  
'''To configure Samba:'''
+
Samba configuration varies as different network and security levels.
#Switch to the user with sudo privilege
 
#Edit the /etc/samba/smb.conf file:<br>[global]<br>workgroup=workgroup<br>server string=ubuntu server<br>security=share<br>encrypt passwords=true<br>smb passwd file=/etc/samba/smbpasswd<br>guest ok=yes<br><br>[<Name>]<br>path=<path><br>public=yes<br>writable=yes<br>create mask=0777<br>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:<br>[[File:installubuntu13.jpg|500px|left|thumb]]<br style="clear: both" />
 
#Re-start Samba to make the configuration take effect
 
#*Type:    sudo service smbd restart
 
#Verify your Samba configuration
 
#*Type the following link in Windows explorer:<br>\\<IP address for ubunut>\<Name><br>e.g. \\192.168.29.29\converter
 
#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==
+
* Below example assume that your GlobalSight application works in a Windows workgroup. And only computers installed the converters can connect to GlobalSight application server.
For details, see [[Installing_GlobalSight_on_Windows#Installing_the_MS_Office_Converters|Installing the MS Office Converters]].
+
*# Update or add below lines under '''[global]''' section
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">workgroup = <your_workgroup_name></code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;"><your_workgroup_name></tt>'' with the real workgroup name
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">netbios name = <hostname></code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;"><hostnamee></tt>'' with the short hostname of Ubuntu server
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">security = user </code>
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">wins server = <wins_server_ip_address></code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;"><wins_server_ip_address></tt>'' with the real ip address of WINS server
 +
*# Set shared directory that GlobalSight converters will use for processing files
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">[&lt;Name&gt;]</code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;">&lt;Name&gt;</tt>'' with a meaningful name of your shared directory
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">path = /path/to/conversion/directory</code>, the absolute path to conversion directory, and it should matches the directory settings when you install GlobalSight
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">browseable = yes</code>
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">writeable = yes</code>
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">guest ok = yes</code>
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">force user = jboss</code>
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">hosts allow = <allowed_ip_addresses></code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;"><allowed_ip_addresses></tt>'' with real ip addresses, for example, 192.168.1.0/24 allows connections from private networks 192.168.1.
 +
*#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">hosts deny = <denied_ip_addresses></code>, replace ''<tt style="background-color:#efffbf; white-space:nowrap;"><denied_ip_addresses></tt>'' with real ip addresses, for example, 0.0.0.0/0 refuses all connections from other computers.
 +
** The whole settings are as follows:
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">[global]</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">workgroup = GLOBALSIGHT</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">netbios name = GSVM1</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">security = user </code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">wins server = 192.168.1.1</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">[converter1]</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">browseable = yes</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">writeable = yes</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">guest ok = yes</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">force user = jboss</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">hosts allow = 127.0.0.1 192.168.1.0/24</code>
 +
**: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">hosts deny = 0.0.0.0/0</code>
 +
**: Note: the '''jboss''' user must have the read/write privileges for the shared directory.
 +
* Another example allows Samba connection with user authentication, only user '''jboss''' allowed.
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">[global]</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">workgroup = GLOBALSIGHT</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">netbios name = GSVM2</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">security = user </code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">encrypt passwords = yes</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">valid users = jboss</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">wins server = 192.168.1.1</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">[converter2]</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">browseable = yes</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">writeable = yes</code>
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">guest ok = no</code>
 +
*: Note: you should set a Samba connection password for user '''jboss''', make sure it differs from the password for system login.
 +
*: Type: '''sudo smbpasswd -d jboss'''
 +
* Verify no errors in the configuration
 +
*: Type: '''testparm /etc/samba/smb.conf'''
 +
* Restart Samba to make the configuration take effect
 +
*: Type:  '''sudo service smbd restart'''
 +
* Verify the shared directory in Windows Explorer
 +
*: Type the following link in Windows Explorer to open the shared folder
 +
*: <tt style="background-color:#efffbf; white-space:nowrap;">\\<ubuntu_server_hotname_or_ip>\<shared_folder_name></tt>
 +
*: Example: \\192.168.1.29\converter
  
==Installing the Adobe InDesign and Illustrator converter==
+
If your GlobalSight application server is a domain member of your organization, read [https://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/domain-member.html#domain-member-server Part II. Server Configuration Basics - Chapter 6. Domain Membership] for the Samba configuration example.
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.
+
==Installing the Microsoft Office Converters==
 +
For details, see [[Installing_GlobalSight_on_Windows#Installing_the_MS_Office_Converters|Installing the Microsoft Office converters]].
  
'''To install the converters:'''
+
==Installing the Adobe InDesign and Illustrator converters==
#Extract Adobe_CSx_Converter.zip, or Adobe_CS4_Converter.zip for InDesign CS4
+
To run the Adobe InDesign CS2/CS3/CS4/CS5/CS5.5/CC 2015 and Illustrator CS2 converter, Adobe InDesign CS2/CS3/CS4/CS5/CS5.5/CC 2015 and Adobe Illustrator CS2 application should be installed in the same machine with the corresponding converter.
# Double-click '''AdobeConverter.exe''' to run the converter
 
#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''
 
#Select '''Illustrator Converter CS2''' and Enter or Browse the directory that is used in ''GlobalSight – Optional Packages – Adobe (CS2) Adapter Conversion Directory''
 
#Click '''Start'''
 
# Enter the following in your converter dialog:
 
#*\\<IP address for ubunut>\<Name>
 
#*For example: \\192.168.29.29\converter\winfiles
 
  
'''Error logs:'''
+
Adobe InDesign CS2, CS3, CS4, CS5, CS5.5 and CC 2015, applications or converters, annot be installed on the same machine.
 +
: Note: Adobe InDesign CC 2015 converter is used for file processing in In-context Review feature, not for extracting localizable content extraction in job creation.
  
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 install the converters'''
 +
# Unzip the converter package to local system, for example, Adobe_CS5_Converter.zip for InDesign CS5
 +
# Double-click '''AdobeConverter.exe''' to run the converter
 +
# Select '''InDesign Converter CS2/CS3/CS4/CS5/CS5.5''' and Enter or Browse the directory that is used in '''Install GlobalSight &gt; Optional Packages &gt; Adobe (CS2)/(CS3)/(CS4)/(CS5)/(CS5.5) Adapter Conversion Directory'''
 +
#: For example: D:\winfiles\CS5 or \\192.168.1.29\winfiles\CS5
 +
# Select '''Illustrator Converter CS2''' and Enter or Browse the directory that is used in '''Install GlobalSight &gt; Optional Packages &gt; Adobe (CS2) Adapter Conversion Directory'''
 +
# Click '''Start'''
  
'''To uninstall the converters:'''
+
'''To uninstall the converters'''
#Click '''Stop'''
+
# Click '''Stop'''
#Remove the Adobe Converter directory
+
# Remove the Adobe Converter directory
  
 
==Installing the FrameMaker 9 Converter==
 
==Installing the FrameMaker 9 Converter==
 
The GlobalSight FrameMaker 9 Converter requires the Adobe FrameMaker 9 software to be installed.  
 
The GlobalSight FrameMaker 9 Converter requires the Adobe FrameMaker 9 software to be installed.  
  
'''Installing the GlobalSight FrameMaker 9 Converter'''
+
'''To install the GlobalSight FrameMaker 9 Converter'''
 
# Extract '''GlobalSight_FrameMaker9_Converter.zip'''
 
# Extract '''GlobalSight_FrameMaker9_Converter.zip'''
 
# Double-click '''setup.exe''' to start the installation  
 
# Double-click '''setup.exe''' to start the installation  
  
'''Add plugin to Adobe FrameMaker 9'''
+
'''To add plugin to Adobe FrameMaker 9'''
 
# Stop FrameMaker 9 application
 
# Stop FrameMaker 9 application
# Copy <FrameMaker 9 Converter>\fmconv.dll to <Adobe FrameMaker9 Installation Path>\fminit\Plugins folder
+
# Copy ''<tt style="background-color:#efffbf; white-space:nowrap;">\path\to\FrameMaker9\Converter>\</tt>''<strong>fmconv.dll</strong> to ''<tt style="background-color:#efffbf; white-space:nowrap;">\path\to\Adobe\FrameMaker9\appliation\fminit\Plugins</tt>'' folder
# Add the following line to <FrameMaker9 Installation Path>\maker.ini [APIClients] section. <br>''fmconv=Standard, GlobalSight FMConvert, fminit\Plugins\fmconv.dll, all''
+
# Add the following line to '''[APIClients]''' section in file <tt style="background-color:#efffbf; white-space:nowrap;">\path\to\Adobe\FrameMaker9\appliation\</tt>''<strong>maker.ini</strong>
 +
#: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">fmconv=Standard, GlobalSight FMConvert, fminit\Plugins\fmconv.dll, all</code>
  
'''To start the converter:'''
+
'''To start the converter'''
 
# Click '''Start->Programs->GlobalSight->FrameMaker 9 Converter'''
 
# Click '''Start->Programs->GlobalSight->FrameMaker 9 Converter'''
# Specify the '''FrameMaker 9 Path'''
+
# Specify the '''FrameMaker 9 Path''', that is the path to FrameMaker 9 application
# Specify the '''Conversion Directory'''<br>This should match the directory that you set in the ''Install Wizard – Optional Packages FrameMaker 9 Adapter Conversion Directory''. For example: d:\WINFILES
+
# Specify the '''Conversion Directory'''
 +
#: This should match the directory that you set in the <tt style="background-color:#efffbf; white-space:nowrap;">Install GlobalSight &gt; Optional Packages &gt; FrameMaker 9 Adapter Conversion Directory</tt>.  
 +
#: For example: D:\winfiles, or \\192.168.1.29\winfiles
 
# Click '''Start'''
 
# Click '''Start'''
  
'''To un-install the converter:'''
+
'''To un-install the converter'''
 
# Stop the '''FrameMaker 9 Converter'''
 
# Stop the '''FrameMaker 9 Converter'''
 +
# Remove '''fmconv.dll''' from FrameMaker 9 installation folder
 +
# Remove line <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">fmconv=Standard, GlobalSight FMConvert, fminit\Plugins\fmconv.dll, all</code> from '''maker.ini''' file
 
# Click '''Control Panel-> Add or Remove Programs''' to remove the '''FrameMaker 9 Converter'''
 
# Click '''Control Panel-> Add or Remove Programs''' to remove the '''FrameMaker 9 Converter'''
  
 
+
==Starting and stopping GlobalSight==
==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.
 
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:'''
+
'''To start GlobalSight in service mode'''
#Type:   sudo service globalsight start
+
* Type: '''sudo service globalsight start'''
#Check the GlobalSight.log in the /home/jboss/GlobalSight/logs directory. If GlobalSight starts successfully, the message below shows in GlobalSight.log:<br>GlobalSight is now ready to accept logins.
+
*: Check the GlobalSight.log in the ''<tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory>/logs</tt>'' directory. If GlobalSight starts successfully, the message below shows in GlobalSight.log:
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">GlobalSight is now ready to accept logins</code>
 +
*: Note: you can use command '''sudo /etc/init.d/globalsight start''' instead.
  
'''To stop GlobalSight in Service Mode:'''
+
'''To stop GlobalSight in service mode'''
* Type:   sudo service globalsight stop
+
* Type: '''sudo service globalsight stop'''
 +
*: Note: you can use command '''sudo /etc/init.d/globalsight stop''' instead.
  
'''To start GlobalSight in Console Mode:'''
+
'''To start GlobalSight in console mode'''
#Run <GlobalSight Server Directory>/jboss/server/bin/standalone.sh.
+
* Run ''<tt style="background-color:#efffbf; white-space:nowrap;"><globalSight_home_directory>/jboss/server/bin/</tt>''<strong>standalone.sh</strong>
#Wait for the following message:<br>-----------JBOSS -- GlobalSight started ------------
+
*: Wait for the following message:
 +
*: <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">-----------JBOSS -- GlobalSight started ------------</code>
  
'''To stop GlobalSight in Console Mode:'''
+
'''To stop GlobalSight in console mode'''
  
Press '''Ctrl + C''' in the JBoss Console.
+
Press '''Ctrl + C''' in the Ubuntu Console.
  
 
==Logging in to GlobalSight==
 
==Logging in to GlobalSight==
#Open Internet Explorer and go to: http://server.domain.com:port/globalsight
+
When GlobalSight is started, you can log in GlobalSight as follows:
#*"server.domain.com" is the value entered for " J2EE App Server Hostname or IP Address"
+
# Open Internet Explorer and go to: ''<tt style="background-color:#efffbf; white-space:nowrap;">http://server.domain.com:port/globalsight</tt>''
#*"port" is the value entered for " J2EE App Server HTTP port"
+
#: "server.domain.com" is the value entered for <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">J2EE App Server Hostname or IP Address</code>
#*Username: gsAdmin
+
#: "port" is the value entered for <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">J2EE App Server HTTP port</code>
#*GlobalSight Administrator user.
+
#: If you have set <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">Public login URL</code>, use it.
#*Password: password, the password for the GlobalSight Administrator user
+
# Log in with GlobalSight administrator account
 +
#: Username: ''<tt style="background-color:#efffbf; white-space:nowrap;">gsAdmin</tt>''
 +
#: The default GlobalSight administrator's username, if you didn't change it during installation.
 +
#: Note: the username is case insensitive, you can also type ''<tt style="background-color:#efffbf; white-space:nowrap;">gsadmin</tt>'' as username.
 +
#: Password: ''<tt style="background-color:#efffbf; white-space:nowrap;">password</tt>''
 +
#: The default password for the GlobalSight administrator user, if you didn't change it during installation.
  
 
==Uninstalling GlobalSight==
 
==Uninstalling GlobalSight==
To uninstall the GlobalSight components, follow the steps below in the order listed. All uninstall procedures assume that GlobalSight is not running.
+
To uninstall the GlobalSight application and the third-party components, follow the steps below in the order listed. All uninstallation procedures assume that GlobalSight is not running.
  
'''Uninstall the Application Service:'''
+
'''To uninstall the core application'''
#Stop GlobalSight
+
# Stop GlobalSight
#*Type:   sudo service globalsight stop
+
#: Type: '''sudo service globalsight stop'''
#Remove the GlobalSight directory
+
#: Note: you can use command '''sudo /etc/init.d/globalsight stop''' instead.
#*Type:   sudo update-rc.d globalsight remove
+
# Remove the GlobalSight service
 
+
#: Type: '''sudo update-rc.d globalsight remove'''
 
+
# Remove the GloabalSight application server
'''Uninstall JDK:'''
+
#: Type <strong>sudo rm -r</strong> <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_home_directory></tt></i>
 +
#: Example: sudo rm -r /home/jboss/GlobalSight
 +
# Remove the GloabalSight documents and file storage directory
 +
#: Type <strong>sudo rm -r</strong> <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_document_directory></tt></i>
 +
#: Type <strong>sudo rm -r</strong> <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_filestorage_directory></tt></i>
 +
#: Example: sudo rm -r /home/jboss/welocalize/docs
 +
#: Example: sudo rm -r /home/jboss/welocalize/filestorage
  
 +
'''To uninstall JDK'''
 
Remove the directory /usr/local/java
 
Remove the directory /usr/local/java
 +
: Type: <strong>sudo rm -r /usr/local/java/</strong><i><tt style="background-color:#efffbf; white-space:nowrap;">jdk_version</tt></i>
 +
: Example: sudo rm -r /usr/local/java/jdk1.8.0_45
  
'''Uninstall MySQL:'''
+
'''To uninstall MySQL generaic binary package'''
#Stop MySQL
+
# Backup GlobalSight database
#*Type:   sudo service mysql.server stop
+
#: Type: '''mysqldump -uroot -p''' <i><tt style="background-color:#efffbf; white-space:nowrap;"><globalsight_database_name></tt></i> <strong>&gt;</strong> <i><tt style="background-color:#efffbf; white-space:nowrap;"><dump_file>.sql</tt></i>
#Remove the directory /usr/local/mysql
+
#: Example: mysqldump -uroot -p globalsight &gt; globalsight-dump-201604.sql
 +
# Stop MySQL
 +
#: Type: '''sudo service mysql stop'''
 +
#: Note 1: depending on your MySQL setup, the service name may be '''mysql.server'''.
 +
# Remove MySQL service
 +
#: Type: '''sudo update-rc.d mysql remove'''
 +
#: Note: depending on your MySQL setup, the service name may be '''mysql.server'''.
 +
# Remove the directory /usr/local/mysql
 +
#: Type: '''sudo rm -rf /usr/local/mysql'''
 
#Remove the configuration file /etc/mysql/my.cnf
 
#Remove the configuration file /etc/mysql/my.cnf
 +
#: Type: '''sudo rm -f /etc/mysql/my.cnf'''
  
'''Cleanup the system PATH variable:'''
+
'''To cleanup the system variables'''
 
 
Edit the file /etc/profile and remove related PATH variable.
 
  
 +
Edit the file /etc/profile and remove <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">JAVA_HOME</code> variable and update <code style="border:1px; border-radius:3px; margin: 0 0px; padding:0px 0px; border:1px solid #bfcfff; background-color:#bfdfff; white-space:nowrap;">PATH</code> variable.
  
  
 
[[Category:Installing GlobalSight]]
 
[[Category:Installing GlobalSight]]

Latest revision as of 00:35, 14 April 2016

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

This guide describes how to install GlobalSight application server on Ubuntu server. If not specified, the Ubuntu Server is 14.04 LTS version. This guide has been updated to cater for GlobalSight version 8.6.7.

Important: beginning with Ubuntu 15.04 version, system and service manager systemd is used as default system init daemon. Unfortunately, the GlobalSight daemon globalsight cannot work properly with systemd. Installing GlobalSight on Ubuntu Server 15.04 and above version is not recommended.

Prerequisites

Unzipping creates the following folders:

  • 3rd_party_software
  • Converters
  • DesktopIcon
  • GlobalSight

Some features in GlobalSight require running Java plugin on browsers, but now they cannot work on lately Google Chrome and Mozilla Firefox versions. We recommend using Microsoft Internet Explorer to perform related jobs. These Java Applet components will be removed from GlobalSight gradually.

Installing the GlobalSight core application

Pre-installation procedures

  1. Ensure that $JAVA_HOME is in your PATH variable
    Type: echo $JAVA_HOME
    The expected result should look like below:
    Example: /usr/local/java/jdk1.8.0_45
    Type: echo $PATH
    The expected result should look like below:
    Example: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/local/java/jdk1.8.0_45/bin
  2. Ensure that you can access the GlobalSight database from the MySQL command line tool. The GlobalSight installer uses command 'mysql' to connect to the MySQL database server and to create tables for the GlobalSight application.
    Type: mysql -u <globalsight_user_name> -p <globalsight_database_name> -h <mysql_hostname_or_ip_ address> -P <mysql_port>
    Example: MySQL -uglobalsight -p globalsight -hlocalhost -P 3306
  3. Create a user called jboss for the GlobalSight core application
    Type: sudo useradd -m -s /bin/bash jboss
    Type: sudo passwd jboss
    Type: sudo adduser jboss sudo
  4. Log in as user jboss
    Type: su -l jboss
  5. Unjar GlobalSight.zip to /home/jboss directory
    Type: mkdir GlobalSight && cd GlobalSight
    Type: jar xvf /path/to/GlobalSight.zip
  6. Go to the install script directory and add the executable attribute to script file Install.sh
    Type: cd <globalsight_home_directory>/install
    Example: cd /home/jboss/GlobalSight/install
    Type: chmod u+x Install.sh
    Note: we will call the GlobalSight core application directory as <globalsight_home_directory> later.
  7. Create GlobalSight documents and file storage directory
    Type: mkdir -p /path/to/globalsight/docs/and/filestorage/directory
    Assume that we create two directories named 'docs' and 'filestorage' under directory '/home/jboss/welocalize/', the command will be:
    Example: mkdir -p /home/jboss/welocalize/{docs,filestorage}
    If you also need create directory for GlobalSight converters, you can use command like below:
    Example: mkdir -p /home/jboss/welocalize/{docs,filestorage,winfiles}
    Note: we will call the documents directory as <globalsight_document_directory>, and file storage directory as <globalsight_filestorage_directory> later.
  8. Update GlobalSight daemon template file <globalsight_home_directory>/jboss/util/bin/service.sh.template
    Insert -c ${JBOSS_USER} -d ${JBOSS_HOME} between --background and --user
    Example: start-stop-daemon --start --quiet --background -c ${JBOSS_USER} -d ${JBOSS_HOME} --user ${JBOSS_USER} --exec ${JBOSS_HOME}/bin/standalone.sh
    Example: start-stop-daemon --start --quiet --background -c ${JBOSS_USER} -d ${JBOSS_HOME} --user ${JBOSS_USER} --exec ${JBOSS_HOME}/bin/jboss-cli.sh -- --connect command=:shutdown
    Note: this modification ensures that GlobalSight daemon are always running as user jboss.

Installing GlobalSight core application

  1. Run the install script
    Type: sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh
    Note: you can expand above command to sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh | tee globalsight_install.log. The command redirects output on the Console to file globalsight_install.log. It may help you identify errors if GlobalSight installation fails.

The GlobalSight Installation interface starts.

Installubuntu1 866.png

On the Install GlobalSight menu screen, type N to go to the next screen.

Installubuntu2 866.png

Entering the server settings

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

Installubuntu3 866.png

Note: An active internet connection is required to sign code for Java Applet components.
Parameter Description
Java home The JAVA_HOME to run the GlobalSight application server
J2EE App Server Hostname or IP Address The name of the server on which you installed the GlobalSight 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 application server

Default: 80
Note: Use a port number higher than 1024 On UNIX-type operating systems, only user root can bind to listening 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 GlobalSight application server to log in

Default: false

Public Login URL The public login URL for the GlobalSight application server. It is ignored when above Use Public Address option is false
Enable HTTPS Flag (true or false) to enable HTTPS for the GlobalSight application server

Default: false

J2EE App Server HTTPS port The web server HTTPS port for the App Server. This value is ignored when above Enable HTTPS option is false

Default: 443

Keystore File for HTTPS(leave empty to use default) The keystore file for HTTPS authentication. This value is ignored when above Enable HTTPS option is false

Default: empty.
Using the self-signed certificate be default.

Keystore Password The keystore file's password/passphrase for HTTPS authentication. This value is ignored when above Enable HTTPS option is false

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

Enable Applet Code Signing Flag (true or false) to enable signing code for Java Applet components

Default: false

Keystore File The keystore file for signing code. This value is ignored when above Enable Applet Code Signing option is false

Default: empty

Keystore Password The keystore file's password/passphrase for signing code. This value is ignored when above Enable Applet Code Signing option is false

Default: empty

Keystore Alias The keystore alias for signing code. This value is ignored when above Enable Applet Code Signing option is false

Default: empty

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

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

Installubuntu4 866.png

Parameter Description
GlobalSight Administrator username The administrator user used for first login to GlobalSight and for creating all other users initially

Default: gsAdmin

GlobalSight Administrator password The password of the GlobalSight Administrator user

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 directory that localization files are imported from and exported to

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

Logging level The information level that logged into files.

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 Flag (true or false) to show detailed revenues

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

Default: true

Entering the MySQL database settings

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

Installubuntu5 866.png

Parameter Description
Database server The server name or the IP address that MySQL database is installed. For example: db_server.domain.com or 192.168.1.29 or localhost

Default: localhost

Database port The port of MySQL database server

Default: 3306

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

Default: globalsight

Database username The GlobalSight database's username

Default: globalsight

Database password The password for the above database user

Default: password

Database logging Flag (true or false) to enable the logging of Hibernate queries and/or other database related information

Default: false

Entering the Email settings

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

Installubuntu6 866.png

Parameter Description
Enable notification service Flag (true or false) to enable the Email Notification feature of GlobalSight. All followed options on this screen are ignored when it is false

Default: false

Mail server The fully qualified hostname of 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 user. When something goes wrong in the system, this person gets an notification 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 value should be true 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 value is ignored if above Enable Email Authentication option is false
Default: nobody

Email authentication password The password for the email authentication user above

This value is ignored if above Enable Email Authentication option is false
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 value is ignored if above Enable warning thresholds option is false
Default: .75

Entering optional package settings

On Optional Packages screen, type D to scroll down the screen.

Installubuntu7 866.png

You will see more settings
Installubuntu8 866.png

and then type D to show the left
Installubuntu9 866.png

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

Parameter Description
Web Service This option enables the Web Service capability of GlobalSight. Web Service API calls will not work if it is false

Default: true

Alchemy Catalyst Integration This option 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 This value is ignored if above Alchemy Catalyst Integration option is false. The jboss user must have the write privilege to the directory you choose
Paragraph Editor This option enables the Paragraph Editor feature of GlobalSight. The Paragraph Editor does not work if it is false

Default: true

Corpus TM This option enables the Corpus TM capability of GlobalSight. Corpus TM will be deprecated in future GlobalSight version

Default: true

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

Default: true

Calendar component This option 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 option sets the timezone used by GlobalSight for all time and date calculations. This value is expressed in hours from Greenwich Mean Time. The default timezone is set to GMT-8, which is Pacific Standard Time for the West Coast of the US and Canada

Default: GMT-8:00
This value is ignored if above Calendar component option is false

FrameMaker Adapter This option enables GlobalSight to work with Adobe FrameMaker 9. The adapter does not work if this is false

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

FrameMaker 9 Adapter Conversion Directory The directory that the FrameMaker 9 Converter uses for file processing. This value is ignored if above FrameMaker Adapter option is false

Default: /home/jboss/welocalize/winfiles

OpenOffice Preview This option enables GlobalSight to work with OpenOffice to file preview. The option is not applicable to Ubuntu Server

Default: true

OpenOffice install directory The directory where OpenOffice3 is installed. The option is not applicable to Ubuntu Server

Default: /opt/openoffice.org3

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

Default: false
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see Installing the Microsoft Office converters section below in this document

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

Default: false
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see Installing the Microsoft Office converters section below in this document

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

Default: false
If this option is set to true, you need to set up the MS Office converters for it. For instructions, see Installing the Microsoft Office converters section below in this document

MS Office 2007 Adapter Conversion Directory The directory that the GlobalSight MS Office 2007 converter uses for file processing. This value is ignored if none of Microsoft Office Word / Excel / PowerPoint Adapter is true

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 converter uses for file processing. This value is ignored if none of Microsoft Office Word / Excel / PowerPoint Adapter is true

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

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

Default: false If this option is set to true, you need to set up the converter for it. For instructions, see Installing the Adobe InDesign and Illustrator converters section below of this document

Adobe Illustrator Adapter This option enables GlobalSight to work with Adobe Illustrator CS2. The adapter does not work if it is false

Default: false

Adobe(CS2) Adapter Conversion Directory The directory that the GlobalSight Adobe InDesign CS2 converter uses for file processing. This value is ignored if above Adobe INDD Adapter option is false

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 converter uses for file processing. This value is ignored if above Adobe INDD Adapter option is false

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 converter uses for file processing. This value is ignored if above Adobe INDD Adapter option is false

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 converter uses for file processing. This value is ignored if above Adobe INDD Adapter option is false

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 converter uses for file processing. This value is ignored if above Adobe INDD Adapter option is false

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

In Context Review Tool This option enables GlobalSight to work with Adobe InDesign CC 2015 and Microsoft Office 2010 for In-context review feature.

Default: false

In Context Review Conversion Directory (InDesign) The directory that the GlobalSight Adobe InDesign CC 2015 converter uses for file processing. This value is ignored if above In Context Review Tool option is false

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

In Context Review Conversion Directory (Office) The directory that the GlobalSight MS Office 2010 converter uses for file processing. This value is ignored if above In Context Review Tool option is false

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

Passolo Adapter This option 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 converter uses for file processing. This value is ignored if above Passolo Adapter option is false

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

Windows Portable Executable Adapter This option 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 Portable Executable converter uses for file processing. This value is ignored if above Windows Portable Executable Adapter option is false

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

SQL Database Adapter This option enables the Database Integration feature of GlobalSight

Default: false

TeamSite Adapter This option enables the TeamSite integration feature of GlobalSight

Default: false

Vignette Adapter This option enables the Vignette integration feature of GlobalSight

Default: false

ServiceWare Adapter This option enables the ServiceWare integration feature of GlobalSight

Default: false

Documentum Adapter This option enables the Documentum integration feature of GlobalSight

Default: false

Entering the optional CMS settings

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

Installubuntu10 866.png

Parameter Description
CMS Adapter This option enables the CMS integration feature of GlobalSight. The CMS adapter does not work if this 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

On Install Options screen, set option 1, 3 and 4 to true (for a fresh GlobalSight installation).

Installubuntu11 866.png

Note: Option 4 creates database tables for the GlobalSight application. The installer will drop and recreate exiting tables for the GlobalSight application. If this is not your first attempt to install GlobalSight, setting option 4 to 'true' will cause data loss.
  • Type I to start the installation
  • Press Enter after installation to exit

GlobalSight core application now is installed.

Check the console for any errors that may have arisen during creation of the database. If you have appended | tee globalsight_install.log to command sudo PATH=$JAVA_HOME/bin:$PATH ./Install.sh, you can find the log file in current directory to see what fails during installation.

Post-installation procedures

Change the ownership of GlobalSight application

  1. Set jboss as the owner of GlobalSight application server
    Type: sudo chown -R jboss:jboss <globalsight_home_directory>
    Example: sudo chown -R jboss:jboss /home/jboss/GlobalSight
  2. Set jboss as the owner of GlobalSight documents and file storage directory
    Type: sudo chown -R jboss:jboss <globalsight_document_directory>
    Type: sudo chown -R jboss:jboss <globalsight_filestorage_directory>
    Example: sudo chown -R jboss:jboss /home/jboss/welocalize/docs
    Example: sudo chown -R jboss:jboss /home/jboss/welocalize/filestorage

Set the start and stop service script executable

Type: sudo chmod u+x <globalsight_home_directory>/jboss/server/bin/standalone.sh
Example: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/standalone.sh
Type: sudo chmod u+x <globalsight_home_directory>/jboss/server/bin/jboss-cli.sh
Example: sudo chmod u+x /home/jboss/GlobalSight/jboss/server/bin/jboss-cli.sh

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. Thus you can specify the IP addresses that are allowed to connect to GlobalSight.

To configure IP filters for Web services

  1. Log in to the GlobalSight as super administrator user
  2. Click Remote IP Filter for Webservices on home page
  3. Click New to add the remote IP address information
    Installubuntu12 866.png

    Note: You can use an asterisk (*) as a wildcard in IP addresses. For example, the IP address 192.168.1.* allows all network IP addresses that begin with 192.168.1 to use GlobalSight Web services.
  4. Click Save

When create a new company, make sure that Enable IP Filter option is enabled. Then IP filters will take effect for that company.

Configuring Samba server (optional)

To work with GlobalSight converters installed on Windows system, you may need configure a Samba server to share files on Ubuntu server.

Prerequisites

  • Make sure Samba server is installed
    Type: smbd -V
    To install Samba server
    Type: sudo apt-get -y install samba
  • The current user has sudo privilege to modify Samba configuration file

To configure Samba

The main configuration file for Samba server is /etc/samba/smb.conf. You need sudo privilege to edit it.

Samba configuration varies as different network and security levels.

  • Below example assume that your GlobalSight application works in a Windows workgroup. And only computers installed the converters can connect to GlobalSight application server.
    1. Update or add below lines under [global] section
      workgroup = <your_workgroup_name>, replace <your_workgroup_name> with the real workgroup name
      netbios name = <hostname>, replace <hostnamee> with the short hostname of Ubuntu server
      security = user
      wins server = <wins_server_ip_address>, replace <wins_server_ip_address> with the real ip address of WINS server
    2. Set shared directory that GlobalSight converters will use for processing files
      [<Name>], replace <Name> with a meaningful name of your shared directory
      path = /path/to/conversion/directory, the absolute path to conversion directory, and it should matches the directory settings when you install GlobalSight
      browseable = yes
      writeable = yes
      guest ok = yes
      force user = jboss
      hosts allow = <allowed_ip_addresses>, replace <allowed_ip_addresses> with real ip addresses, for example, 192.168.1.0/24 allows connections from private networks 192.168.1.
      hosts deny = <denied_ip_addresses>, replace <denied_ip_addresses> with real ip addresses, for example, 0.0.0.0/0 refuses all connections from other computers.
    • The whole settings are as follows:
      [global]
      workgroup = GLOBALSIGHT
      netbios name = GSVM1
      security = user
      wins server = 192.168.1.1
      [converter1]
      browseable = yes
      writeable = yes
      guest ok = yes
      force user = jboss
      hosts allow = 127.0.0.1 192.168.1.0/24
      hosts deny = 0.0.0.0/0
      Note: the jboss user must have the read/write privileges for the shared directory.
  • Another example allows Samba connection with user authentication, only user jboss allowed.
    [global]
    workgroup = GLOBALSIGHT
    netbios name = GSVM2
    security = user
    encrypt passwords = yes
    valid users = jboss
    wins server = 192.168.1.1
    [converter2]
    browseable = yes
    writeable = yes
    guest ok = no
    Note: you should set a Samba connection password for user jboss, make sure it differs from the password for system login.
    Type: sudo smbpasswd -d jboss
  • Verify no errors in the configuration
    Type: testparm /etc/samba/smb.conf
  • Restart Samba to make the configuration take effect
    Type: sudo service smbd restart
  • Verify the shared directory in Windows Explorer
    Type the following link in Windows Explorer to open the shared folder
    \\<ubuntu_server_hotname_or_ip>\<shared_folder_name>
    Example: \\192.168.1.29\converter

If your GlobalSight application server is a domain member of your organization, read Part II. Server Configuration Basics - Chapter 6. Domain Membership for the Samba configuration example.

Installing the Microsoft Office Converters

For details, see Installing the Microsoft Office converters.

Installing the Adobe InDesign and Illustrator converters

To run the Adobe InDesign CS2/CS3/CS4/CS5/CS5.5/CC 2015 and Illustrator CS2 converter, Adobe InDesign CS2/CS3/CS4/CS5/CS5.5/CC 2015 and Adobe Illustrator CS2 application should be installed in the same machine with the corresponding converter.

Adobe InDesign CS2, CS3, CS4, CS5, CS5.5 and CC 2015, applications or converters, annot be installed on the same machine.

Note: Adobe InDesign CC 2015 converter is used for file processing in In-context Review feature, not for extracting localizable content extraction in job creation.

To install the converters

  1. Unzip the converter package to local system, for example, Adobe_CS5_Converter.zip for InDesign CS5
  2. Double-click AdobeConverter.exe to run the converter
  3. Select InDesign Converter CS2/CS3/CS4/CS5/CS5.5 and Enter or Browse the directory that is used in Install GlobalSight > Optional Packages > Adobe (CS2)/(CS3)/(CS4)/(CS5)/(CS5.5) Adapter Conversion Directory
    For example: D:\winfiles\CS5 or \\192.168.1.29\winfiles\CS5
  4. Select Illustrator Converter CS2 and Enter or Browse the directory that is used in Install GlobalSight > Optional Packages > Adobe (CS2) Adapter Conversion Directory
  5. Click Start

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.

To install the GlobalSight FrameMaker 9 Converter

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

To add plugin to Adobe FrameMaker 9

  1. Stop FrameMaker 9 application
  2. Copy \path\to\FrameMaker9\Converter>\fmconv.dll to \path\to\Adobe\FrameMaker9\appliation\fminit\Plugins folder
  3. Add the following line to [APIClients] section in file \path\to\Adobe\FrameMaker9\appliation\maker.ini
    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, that is the path to FrameMaker 9 application
  3. Specify the Conversion Directory
    This should match the directory that you set in the Install GlobalSight > Optional Packages > FrameMaker 9 Adapter Conversion Directory.
    For example: D:\winfiles, or \\192.168.1.29\winfiles
  4. Click Start

To un-install the converter

  1. Stop the FrameMaker 9 Converter
  2. Remove fmconv.dll from FrameMaker 9 installation folder
  3. Remove line fmconv=Standard, GlobalSight FMConvert, fminit\Plugins\fmconv.dll, all from maker.ini file
  4. Click Control Panel-> Add or Remove Programs to remove the FrameMaker 9 Converter

Starting and stopping GlobalSight

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

  • Type: sudo service globalsight start
    Check the GlobalSight.log in the <globalsight_home_directory>/logs directory. If GlobalSight starts successfully, the message below shows in GlobalSight.log:
    GlobalSight is now ready to accept logins
    Note: you can use command sudo /etc/init.d/globalsight start instead.

To stop GlobalSight in service mode

  • Type: sudo service globalsight stop
    Note: you can use command sudo /etc/init.d/globalsight stop instead.

To start GlobalSight in console mode

  • Run <globalSight_home_directory>/jboss/server/bin/standalone.sh
    Wait for the following message:
    -----------JBOSS -- GlobalSight started ------------

To stop GlobalSight in console mode

Press Ctrl + C in the Ubuntu Console.

Logging in to GlobalSight

When GlobalSight is started, you can log in GlobalSight as follows:

  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
    If you have set Public login URL, use it.
  2. Log in with GlobalSight administrator account
    Username: gsAdmin
    The default GlobalSight administrator's username, if you didn't change it during installation.
    Note: the username is case insensitive, you can also type gsadmin as username.
    Password: password
    The default password for the GlobalSight administrator user, if you didn't change it during installation.

Uninstalling GlobalSight

To uninstall the GlobalSight application and the third-party components, follow the steps below in the order listed. All uninstallation procedures assume that GlobalSight is not running.

To uninstall the core application

  1. Stop GlobalSight
    Type: sudo service globalsight stop
    Note: you can use command sudo /etc/init.d/globalsight stop instead.
  2. Remove the GlobalSight service
    Type: sudo update-rc.d globalsight remove
  3. Remove the GloabalSight application server
    Type sudo rm -r <globalsight_home_directory>
    Example: sudo rm -r /home/jboss/GlobalSight
  4. Remove the GloabalSight documents and file storage directory
    Type sudo rm -r <globalsight_document_directory>
    Type sudo rm -r <globalsight_filestorage_directory>
    Example: sudo rm -r /home/jboss/welocalize/docs
    Example: sudo rm -r /home/jboss/welocalize/filestorage

To uninstall JDK Remove the directory /usr/local/java

Type: sudo rm -r /usr/local/java/jdk_version
Example: sudo rm -r /usr/local/java/jdk1.8.0_45

To uninstall MySQL generaic binary package

  1. Backup GlobalSight database
    Type: mysqldump -uroot -p <globalsight_database_name> > <dump_file>.sql
    Example: mysqldump -uroot -p globalsight > globalsight-dump-201604.sql
  2. Stop MySQL
    Type: sudo service mysql stop
    Note 1: depending on your MySQL setup, the service name may be mysql.server.
  3. Remove MySQL service
    Type: sudo update-rc.d mysql remove
    Note: depending on your MySQL setup, the service name may be mysql.server.
  4. Remove the directory /usr/local/mysql
    Type: sudo rm -rf /usr/local/mysql
  5. Remove the configuration file /etc/mysql/my.cnf
    Type: sudo rm -f /etc/mysql/my.cnf

To cleanup the system variables

Edit the file /etc/profile and remove JAVA_HOME variable and update PATH variable.