Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


If you have Centro 7 already installed, use the following steps for upgrading to the next version of Centro 7.

To upgrade from Centro 7.

6.0/

7.

7.

0/7.7.1/7.7.2/7.7.3 to Centro 7.

7

8.

4

1:


Expand
title1. Gather the latest necessary files.
  1. Centro7-ArangoDB-Linux.zip
  2. CentroWebApp.exe
  3. PipelineHostService.exe
  4. PipelineManagerService.exe
  5. ArangoDB 3.x.x Enterprise edition (Enterprise is recommended though the Community version may be used as well). 

    One can download from the following link:
         https://www.arangodb.com/download-arangodb-enterprise/install-enterprise/


Expand
title2. Pause the pipelines.
  1. Navigate to the Pipeline Manager.
  2. Pause each of the running pipelines to allow remaining jobs to complete.


Expand
title3. Wait for any remaining jobs to finish processing.

To ensure, jobs are not cut off mid process, make sure all jobs from each pipeline are no longer running. To do this,

  1. For a given pipeline, go to the Jobs Explorer.
  2. Use the Status Filter for Starting or Started jobs.
  3. Jobs should appear in the results.


Expand
title4. Stop the Web Site

In iiS Manager, stop the website or put up your maintenance window.


Expand
title5. Turn off services
  1. Stop the pipeline host service.
  2. Stop the pipeline manager service.

The pipeline host service and the pipeline manager service are designed to start automatically. Setting them to a disabled mode will ensure they remain off.


Expand
title6. Backup the database

Backup the database to keep as a back up in case of upgrade issues. To dump the database, see Arango Database Backup section of the System Backup help page.

Directory of Arangodump.exe:

C:\Program Files\ArangoDB3e 3.x.x\usr\bin

A typical Windows / Linux command to run is,

Code Block
arangodump --server.database "ActifyDB" --output-directory "dump"

The folder containing the dump of the database should contain a number of .json files. If the directory is empty or only has a few files then an error must have occurred or the procedures was not run properly.



Info
titleBest Practice

It is strongly recommended to follow the System Backup procedures before performing any Centro upgrade as well as doing on a regular basis to back up your Centro system.



Expand
title7. Run the database script
  1. Unzip the files.
  2. Run the setup.sh script. 
    The script automatically upgrades the current database or creates new databases if one doesn't exist.

NOTE: Requires ActifyDB User and Password information

Run ./setup.sh -u MyUser -p MyPassword
Where: MyUser and MyPassword are the ActifyDB values

ArangoDB via SSL

If the ArangoDB database connection prior to this upgrade was configured for SSL as detailed on the SSL Configuration page, the "setup.sh" or "setup.bat" file will require editing based on the ArangoDB server's operating system.

  1. Unzip the files.
  2. Open setup.sh or setup.bat for editing
    Append the ssl server.endpoint information to the setup file. Server "yourserverhostname:8529" used as example below.

    • LINUX - setup.sh edit lines 69 and 76 and append "--server.endpoint ssl://yourserverhostname:8529"

      Code Block
      languagetext
      themeEclipse
      titleOriginal setup.sh
      69	arangosh --server.username $USER --server.password $PWD --javascript.execute install.js db:$DATABASE user:$USER pwd:$PWD
      
      76 	arangosh --server.username $USER --server.password $PWD --javascript.execute setup.js db:$DATABASE force:$FORCE $VERSION

      to:

      Code Block
      languagetext
      themeEclipse
      titleModified setup.sh
      69 	arangosh --server.endpoint ssl://yourserverhostname:8529 --server.password $PWD --javascript.execute install.js db:$DATABASE user:$USER pwd:$PWD
      
      76 	arangosh --server.endpoint ssl://yourserverhostname:8529 --server.username $USER --server.password $PWD --javascript.execute setup.js db:$DATABASE force:$FORCE $VERSION


    1. WINDOWS -setup.bat edit lines and append "LINUX - setup.sh edit lines 46 and 53 and append "--server.endpoint ssl://yourserverhostname:8529"

      Code Block
      languagetext
      themeEclipse
      titleOriginal setup.bat
      46 CALL %ARANGO% --server.username %USER% --server.password %PWD% --javascript.execute install.js db:%DATABASE% %WIPE_ARG% user:%USER% pwd:%PWD%
      
      53 CALL %ARANGO% --server.username %USER% --server.password %PWD% --javascript.execute setup.js db:%DATABASE% %FORCE%

      to:

      Code Block
      languagetext
      themeEclipse
      titleModified setup.bat
      46 CALL %ARANGO% -server.endpoint ssl://yourserverhostname:8529 --server.username %USER% --server.password %PWD% --javascript.execute install.js db:%DATABASE% %WIPE_ARG% user:%USER% pwd:%PWD%
      
      53 CALL %ARANGO% -server.endpoint ssl://yourserverhostname:8529 --server.username %USER% --server.password %PWD% --javascript.execute setup.js db:%DATABASE% %FORCE%

      Remember to use the ArangoDB ssl endpoint information detailed in the ArangoDB 3.x Configuration section of the SSL Configuration  section.


  3. Run the setup.sh script. 
    The script automatically upgrades the database or creates new databases if one doesn't exist.

  4. NOTE: Requires ActifyDB User and Password information

    Run ./setup.sh -u MyUser -p MyPassword
    Where: MyUser and MyPassword are the ActifyDB values



Expand
title8. Note the database user password

It is strongly recommended to use a database user other than the root to connect the application and services to the database. The 7.6 setup.bat can Create a new user from the arango shell (arangosh) or from the web GUI.

When upgrading, an option for a "Centro" user is created and a random password is created. This is done so one does not have to create their own user nor need to use the root user.

Note: If you had a previous user named "Centro", for security reasons the password will be overwritten with the new random one.

Use the user and password for the webapp, pipeline host, and pipeline manager services installations when credentials are asked for.


Expand
title9. To upgrade the web server and services without uninstalling previous versions
  1. Run the following files to perform the upgrade;
  • CentroWebApp.exe
  • PipelineHostService.exe
  • PipelineManagerService.exe

Be sure to use the correct information for the installation steps;

  • IP address of the Arango Database currently being used
  • ArangoDB User Password
    • Use the newly assigned User and/or Password if they weres changed during the Deploy process

The installations automatically upgrade the application and services or installs new if Centro 7 does not already exist.

  1. Restart services and the web app.

Note: Client side browsers may need caches cleared.

NOTE: If the User or Password was changed during the deploy process, and you used the incorrect values, then they must be reset afterwards for the Webapp and both Services to run.

See link below for instructions ;

WebApp fails to connect and services fail to start after DB Update and/or Password change


Expand
title10. Configuraton File Check

After performing a CENTRO update, you must check the following files in case they did not retain their previous settings.

  • C:\inetpub\wwwroot\Centro
    • Web.config
      • Only if Cookies are used
      • Example:
      • Change: <httpCookies httpOnlyCookies="true" requireSSL="false" / >
      • To: <httpCookies domain=".<Your Domain.com>" httpOnlyCookies="true" requireSSL="false" />
      • Substitute "YourDomain.com" with your actual domain
  • C:\Program Files\Actify\Centro\PipelineHostService\Configuration
    • appSettings.config
      • OpenGL setting
      • If running on a VM, set to OpenGL
      • Gets reset back to OpenGL2
        • Change to: <add key="ACT3DGraphicsDriver" value="OpenGL"/>
    • centroSettings.config
      • Activate Features (false to true)
      • Email information for “Email Notification Pipeline”


  • C:\Program Files\Actify\Centro\PipelineManagerService\Configuration
    • centroSettings.config
      • Activate Features (false to true)
      • Can copy from the \PipelineHostService\Configuration folder

 See Centro Upgrade File Check for a summary.