How to Deploy Customizations to On-premise Installations

Version 8

    Below are instructions for installing custom artifacts delivered by Jive Professional Services in Jive 4, 5, 6 and 7+ installations. Each section is self contained. If Jive has delivered more than one type of artifact you may want to read through the steps for each type of artifact and combine them into a single stoppage of the application server instead of stoping and starting the server for every type of artifact deployment.

     

    WAR File

    1. On all web application nodes
      1. Copy the war file to the node
      2. Stop the application on the web nodes by running "jive stop" as the Jive user, or "appstop" for pre-7.0 versions of Jive
      3. Ensure ~/applications/sbs/application is an empty directory
        1. If it is a symbolic link then remove it and create a directory in its place
        2. If the directory is not empty remove the contents, e.g., rm -rf ~/applications/sbs/application/*
      4. Extract the war file to ~/applications/sbs/application using the "~/java/bin/jar -xvf" command
      5. If the war contains custom images ensure that ~/var/www/images is a link to ~/applications/sbs/application/images
      6. If the war contains custom css resources ensure that ~/var/www/styles is a link to ~/applications/sbs/application/styles
      7. Verify that all extracted files are owned by the jive user and group (chown -R jive:jive ~/applications/sbs/application)
    2. Start the application on one web node by running "jive start" as the Jive user, or "appstart" for pre-7.0 versions of Jive
    3. After the application has been started use a web browser to navigate to it. Depending on the customization you may be presented with an upgrade console. Follow instructions in the upgrade console. Restart the application when prompted.
    4. Start the application on the remaining web nodes

     

    Theme Archive

    1. On all web application nodes
      1. Copy the themes.zip file to the node
      2. Stop the application on the web nodes by running "jive stop" as the Jive user, or "appstop" for pre-7.0 versions of Jive
      3. Extract the contents of the themes.zip file to ~/applications/sbs/home/themes/
      4. Verify that all extracted files are owned by the jive user and group
      5. Start the application on one web node by running "jive start" as the Jive user, or "appstart" for pre-7.0 versions of Jive
      6. Start the application on the remaining web nodes

     

    etc.zip

    1. On all web application nodes
      1. Copy the etc.zip file to the node
      2. Stop the application on the web nodes by running "jive stop" as the Jive user, or "appstop" for pre-7.0 versions of Jive
      3. Extract the contents of the etc.zip file to ~/applications/sbs/home/etc/
      4. Verify that all extracted files are owned by the jive user and group
      5. Start the application on one web node by running "jive start" as the Jive user, or "appstart" for pre-7.0 versions of Jive
      6. Start the application on the remaining web nodes

     

    Plugin

    1. You only have to install a plugin on one node. The application will automatically copy the plugin to all nodes.
    2. Navigate to the Admin Console -> System -> Plugins -> Add Plugin
    3. Use the form to upload and install the plugin file.
    4. Restart every web application node by running "jive restart" as the Jive user.