Professional Documents
Culture Documents
Expertise X3
Index Home
This document explains how to upgrade an existing Sage X3 solution to the latest version release.
Caution: Before you perform the upgrade, make sure you:
Contact your local Sage Sales office in order to get your new license.
Perform a full backup of your system.
1. Run the runtime-91.3.5.12.jar file located in the X3Installs\Runtime folder of the V12 DVD-ROM.
2. Select Modify installation.
3. Select the installation path of the existing runtime component.
On platforms running the Windows Operating System, the update mode detects all existing
runtime components and it lists them in a display panel with their corresponding paths. Select the
runtime component you want to upgrade and follow the rest of the process.
https://lvexpertisex3.com/x3help/FRA/V7DEV/getting-started_quick-upgrade-guide.html 1/5
12/10/2022 12:11 Upgrading an Existing Sage X3 Solution @ L.V. Expertise X3
1. Run the java-bridge-2.23.2.jar file located in the X3Installs\JavaBridge folder of the V12 DVD-
ROM.
2. Select Modify installation.
3. Select the installation path of the existing Java Bridge component.
The update mode detects the correct repository and finishes the update process.
Caution: You need to specify a user/password with rights to create and modify a service, as well as the
passphrase that was initially used during the first installation of the component.
Updating Elasticsearch
Elasticsearch is an open source, distributed real-time search and analytics engine. Sage X3 is now
compatible with Elasticsearch version 6.8. You can download it from the Elasticsearch website.
Note: It is important to click the links given inside version 6.8 procedures. If you go directly on Elastic's
download center you will only be able to download their latest release that is not yet certified with Sage
X3.
Although Sage X3 is still compatible with previous releases, it is strongly recommended to upgrade to
version 6.8 as Elasticsearch 2.4.4 is no longer maintained by Elastic. It is highly recommended to host
Elasticsearch on a dedicated server.
Make sure you write down the Elasticsearch host name and its corresponding http service port number.
These two parameters are defined in the elasticsearch.yml file. You will need to set these hostname and
port parameters in the nodelocal configuration file. These parameters are equivalent to network.host and
http.port in the elasticsearch.yml file.
Note: For network.host, 0.0.0.0 will bind to all network interfaces. The value 0 has the same effect as
0.0.0.0. For further information, consult Elasticsearch's network settings documentation.
For information on upgrading Elasticsearch, consult the installation and upgrade guides available in
their online documentation.
Up to version 7.1 of Sage X3, there is no automatic installer for MongoDB server. Download it
from the MongoDB website and install it manually.
From update 8 of Sage X3, the installation of MongoDB can be done automatically.
Caution: You need to specify a user/password with rights to create and modify a service, as well as the
passphrase that was initially used during the first installation of the component.
Note: The update process launches a series of scripts that initialize the MongoDB database with the
data required for the administration of Sage X3, as well as the administration of the menu pages by the
Sage X3 Syracuse Server. The component update can take up to 30 minutes.
You can then update the license by following the steps detailed below.
3. Option 2
When leaving the function opened before launching the license update, the message Supervisor
update is displayed, meaning that the Supervisor update is done. ## Personalizing and initializing the
menus
https://lvexpertisex3.com/x3help/FRA/V7DEV/getting-started_quick-upgrade-guide.html 3/5
12/10/2022 12:11 Upgrading an Existing Sage X3 Solution @ L.V. Expertise X3
Updating the privileges of the ADX_SYS role (Only for upgrades from V7, or U8
patch 3 or lower)
For Unix-Oracle
1. Connect as a user who has DBA rights on the concerned database using a command line.
2. Go to the Runtime directory of the solution:
"cd /Patch_Runtime/runtime" (with "Patch_Runtime" corresponding to the Runtime installation
complete path)
3. Run the .profile command to get the available environment variables: ". ./.profile"
4. Go to the ebin runtime directory: "cd ebin"
5. Run the update command:
"sqlplus system/manager @update_SYS_role_17R301.sql X3
>$ADXDIR/tmp/update_SYS_role_17R301.log"
6. Check the content of the log file to make sure there are no errors:
"cat $ADXDIR/tmp/update_SYS_role_17R301.log"
For Windows-Oracle
8. Option 3:
i. If all folders have already been saved as stated in Option 2, go to Usage > Batch server >
Query management (AREQUETE).
ii. Locate the queries with task code "VALDOS".
iii. Select the date and time, and click Validation on the right-hand panel.
iv. Select the folders that have to be revalidated.
https://lvexpertisex3.com/x3help/FRA/V7DEV/getting-started_quick-upgrade-guide.html 4/5
12/10/2022 12:11 Upgrading an Existing Sage X3 Solution @ L.V. Expertise X3
After revalidation, the folders are up to date in V12, and are ready to use.
1. Go to Administration > Utilities > Update > Updates and click Add an update.
2. Upload the zip file located in the Patch directory.
Refer to Updates Management for more information.
1. Keep the existing Seed folder and install the V12 Seed folder:
i. Unzip the V12 Seed folder directories in a folder with a different name.
ii. Copy these directories in the appropriate directories of the application.
iii. Import the V12 new Seed folder with the console.
iv. Make sure you revalidate the existing Seed folder.
2. Delete the existing Seed folder and install the V12 Seed folder:
i. Delete all existing database objects related to the Seed user (tables, indexes, sequences,
etc.) with a database management tool.
ii. Delete the Seed and X3_PUB directories located in the application folder directory.
iii. Delete the Seed folder definition in Setup > General Parameters > Folders (GESADS).
Reinstall the Seed folder from the V12 DVD-ROM, following the standard procedure.
Note: It is technically possible to overwrite the Seed folder but this method is not certified by Sage
because it could cause unexpected issues in the usage of the folder.
https://lvexpertisex3.com/x3help/FRA/V7DEV/getting-started_quick-upgrade-guide.html 5/5