Chat now with support
Chat with Support

SharePlex Manager 3.0 - Installation Guide

Download the SharePlex Manager Installer

Installing SharePlex Manager
To download the SharePlex Manager installer:
1
Depending on your operating system, download one of the following three files to a temporary location (a dedicated, empty directory is preferred):
•
For Windows - SharePlexManager-3_0_0-windows.zip
•
For Linux - SharePlexManager-3_0_0-linux-ia32.tar
2
Depending on your operating system, do one of the following
•
For Windows, open SharePlexManager-3_0_0-windows.zip
•
For Linux, execute the following command:
tar xfv SharePlexManager-3_0_0-linux-ia32.tar
The directory will then contain:
•
The Foglight Server installer
•
The Foglight Server documentation
•
The SharePlex Manager installer
•
SharePlex_Manager_Installation_Guild.pdf
•
SharePlex_Manager_relnotes.html
•
SharePlex_Manager_User_Guild.pdf
•
OpenSource, a directory containing the legally required third-party sources.

Install Foglight 5.9.2

If you are upgrading from SharePlex Manager version 2.2 to version 3.0, it is strongly recommended that you back up your Foglight 5.5.8 server and database before attempting to upgrade it to version 5.9.2. If upgrading from Foglight 5.5.8.3, you must upgrade to Foglight 5.7.5.8 before you can upgrade to Foglight 5.9.2. For upgrade instructions, see “Upgrade Foglight 5.5.8.3 to Foglight 5.7.5.8” on page 3.

To install Foglight 5.9.2:
1
Start the installation process by initiating the appropriate executable file located in the FoglightManagementServer-5.9.2 directory of the SharePlex Manager install media.
Each supported platform includes a separate executable file for 32-bit and 64-bit operating systems.
Windows:
•
Foglight-5_9_2-install_windows-ia32.exe
•
Foglight-5_9_2-install_windows-x86_64.exe
Linux:
•
Foglight-5_9_2-install_linux-ia32.bin
•
Foglight-5_9_2-install_linux-x86_64.bin
2
Follow the installation instructions provided in the appropriate Foglight Installation Guide located in the FoglightServer-5_9_2\Documentation directory of the SharePlex Manager install media.
Caution
When installing Foglight 5.9.2, be aware of the following:
•
During a custom install, the Foglight installer prompts you to add a license file. You can disregard this prompt, because the SharePlex Manager install media includes the current Foglight license file.
•
At the end of a standard install, the Foglight server is started automatically. You must shut down the server before installing SharePlex Manager, either by selecting the Stop Foglight option on the Start Menu (for Windows) or by executing the shutdown script FmsShutdown.sh (for Linux) located in the bin directory,

Install SharePlex Manager 3.0

You can run the SharePlex Manager installer in either GUI mode or in console mode (Linux only). The instructions in this guide are based on a GUI installation. However, since the sequence of steps are the same, you can still perform a console installation by following these instructions. The only differences are operational. For example, in GUI mode you click Cancel, Previous, and Next, while in console mode you type ‘quit’ and ‘back’ and press <Enter>.

To install the SharePlex Manager 3.0:
1
Open one of the executable files included on the SharePlex Manager install media:
•
Windows - SharePlexManager-3_0_0-install-windows.exe
•
Linux - SharePlexManager-3_0_0-install-linux-ia32.bin
Note
To run the installer in console mode, execute one of the following commands:
•
SharePlexManager-3_0_0-install-linux-ia32.bin –i console
The SharePlex Manager Installer opens and displays the Welcome window.
2
Click Next.
The installer prompts you to specify the Foglight 5.9.2 home directory.
3
Specify the Foglight home directory.
Note
If the Installer cannot locate Foglight in the specified directory, it displays an error message and prompts you to specify a different location.
4
Click Next.
The installer prompts you to specify the location where you want to install SharePlex Manager.
5
Specify the location where you want to install SharePlex Manager.
Note
If the directory you specify already contains files, the installer displays a warning message that these files will be overwritten.
6
Click Next.
If installing on Windows, the installer prompts you to specify the location where you want to create product shortcuts, if any.
Note
There are no product shortcuts on Linux.
7
Specify the location where you want to create product shortcuts.
8
Click Next.
Note
At this point, the installer tries to detect if there is an active SharePlex Web Services instance currently running. If so, it displays a warning message that you must shut down the SharePlex Web Services instance before continuing with the installation.
The installer prompts you to specify a dedicated port for SharePlex Manager.
9
Specify the number of the dedicated port (by default, 3000).
10
Click Next.
Note
If the port you specify is currently unavailable, the installer displays a warning message that SharePlex Web Services will not be able to start automatically at the end of the installation. At this point, you can either specify a different port number, or you can continue with the installation. If you continue, you will later need to start SharePlex Web Services manually after the port becomes available.
The installer displays the Pre-Installation Summary window.
11
Do one of the following:
•
Click Install to continue.
Make sure you accept the pre-installation settings before clicking Install. The installer modifies the Foglight server, and these changes cannot be undone even if you click Cancel during the installation process.
•
Click Previous if you want to go back and change an installation setting
Note
If there is not enough disk space, the installer displays a warning message. You must make enough disk space available to continue with the installation.
The installer displays a progress bar as it installs the SharePlex Manager cartridge and SharePlex Web Services.
On Windows, SharePlex Web Services is configured to start automatically when the host machines reboots. On Linux, the installer prompts you to specify how you want to start SharePlex Web Services. The installer can start SharePlex Web Services immediately, or you can start SharePlex Web Services manually at a later time. For more information, see the section, “Starting SharePlex Web Services” on page 16.
12
Do one of the following:
•
Select Start SharePlex Web Services Now to have the installer start SharePlex Web Services immediately
•
Select Not Now to start SharePlex Web Services yourself at a later time
13
Click Next.
Note
If you selected the Start SharePlex Web Services Now option, the installer displays a warning messages if for any reason it is unable to start SharePlex Web Services. This may be because the port number you specified previously is unavailable. When this is the case, you will need to start SharePlex Web Services manually after you complete the installation and make the port available. See the next section for more information on starting SharePlex Web Services manually.
14
In the next window, the installer reports that it has successfully installed SharePlex Manager 3.0.
15
Click Done.
Troubleshooting

If you encounter an “Installer User Interface Mode Not Supported” error when attempting to run the installer in Windows, use one of the following workarounds.

Workaround 1:

1
Open the Windows Command Prompt.
2
Change the directory to the location of the SharePlex Manager installer.
3
Enter "SharePlexManager-<version_number>-install-windows.exe -i GUI" where version_number is the version of SharePlex Manager you are installing.
4
Press ENTER to install in GUI mode.

Workaround 2:

1
Right-click the installer and select Properties.
2
Select the Compatibility tab and select Run this program in compatibility mode for. Then select Windows 7.
3
Click Apply. Then click OK.
4
Double-click the installer to start the installation process.

 

Starting SharePlex Web Services

SharePlex Web Services must be running to monitor your SharePlex instances. On Windows, SharePlex Web Services starts automatically at reboot. On Linux, you can start SharePlex Web Services manually, or you can configure it to start at reboot.

Note
Before starting SharePlex Web Services, be aware of the following:
•
It is not recommended that you start multiple instances of SharePlex Web Services on different ports using the same installation. You should only run one instance of SharePlex Web Services at a time.
•
Occasionally you may receive an error message that SharePlex Web Services is not available at the specified port. This may be because SharePlex Web Services is down, or it may be because SharePlex Web Services is running but not responding. In either case, you should make sure SharePlex Web Services is not running by executing a stop command before executing a start command. If you execute a stop command when SharePlex Web Services is already stopped you will receive an error message which you can safely ignore.
Windows

As a Windows NT service, SharePlex Web Services is configured to start automatically when the machine reboots. However, if it is necessary to start SharePlex Web Services manually (for example, due to a port conflict), you can start it manually in two ways:

•
By going to the Start menu and selecting All Programs>Quest Software>SharePlex Manager>Start SharePlex Web Services.
Note
To stop SharePlex Web Services, select the Stop SharePlex Web Services option.
•
By executing the command web-services start from the web-services.bat file located in the <install_dir>\Webservices\bin directory.
The commands are:
web-services start
Note
To stop SharePlex Web Services, execute the command web-services stop.
Linux

After the installation is complete, you can start SharePlex Web Services manually, or you can configure it to start at reboot.

1
To start SharePlex Web Services manually on Linux, execute the following command:
sh <install_dir>/Webservices/bin/web-services.sh start
Note
To stop SharePlex Web Services for Linux, execute
sh <install_dir>/Webservices/bin/web-services.sh stop. For Windows, close the window it is running in.
If started successfully, SharePlex Web Services writes log entries to stdout that indicate it's running. For example:
$ sh ./bin/web-services.sh start
Activated on port 3000: <process entry from ps>
2
To configure SharePlex Web Services to start at reboot, do the following:
a
Create the file /etc/init.d/spo-web-services with the following content (assumes that Java is installed in the default <install_dir>/jre directory and the SharePlex Web Services is installed in <install_dir>/Webservices/bin):
#!/bin/sh
JAVA_HOME=<install_dir>/jre
PATH=/bin:/usr/bin:/usr/local/bin
export JAVA_HOME PATH
sh <install_dir>/Webservices/bin/web-services.sh "${@}"
#!/bin/bash
#
# SharePlex for Oracle Web Services
#
# chkconfig: 35 <start priority> <stop priority>
# description: SharePlex for Oracle Web Services
JAVA_HOME=<install_dir>/jre
PATH=/bin:/usr/bin:/usr/local/bin
export JAVA_HOME PATH
sh <install_dir>/Webservices/bin/web-services.sh "${@}"
Replace <install_dir> with the directory for the installation of SharePlex Manager.
Note
Unless there is a good reason to the contrary, the <endpriority> should be equal to 100 minus <startpriority>. <startpriority> is the “priority” weight for starting the sevice, while <endpriority> is the “priority” weight for stopping the service. Servcies are started and stopped in numerical order starting at 0, e.g., 90 for <startpriority> and 10 for <endpriority>.
Replace <start priority> and <stop priority> with
b
Use the chkconfig command to configure the script to start at boot
[root@hostname dir]# /sbin/chkconfig --level 35 spo-web-services on
c
Verify the installation with
[root@hostname dir]# service spo-web-services status
SharePlex Web Services is configured to start on next reboot.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating