FOXMAN‑UN Installation
FOXMAN‑UN Installation Procedure
Please note:
If any error occurs during installation, an error message will be issued in the shell where the installation script is executed.
→ Carefully observe any possible error messages to the stdout during installation.
Steps | Procedures (with sample screen contents) |
1. | 1 Copy the ZIP file (1MRC000087R1800_FOXMAN_R18_NEM.zip) to a folder in the file system with at least 10 GB free space, e.g. /opt/work/installer 2 Unpack the archive, tar.gz or tar (FOXMAN-18.0.0-0.el9.tar.gz) to an appopriate folder. 3 From the extracted file system, execute the installation script as “root” user, e.g., # sudo /opt/work/installer/FOXMAN-18.0.0-0/NEM/install.sh |
2. | LICENSE AGREEMENT is displayed. Press the SPACE key several times until you are prompted with the following question: “Do you agree to the above license terms?” Enter ‘y’ to accept the License Agreement. |
3. | The default NEM custom parameters are shown below (all IP addresses and server names shown here are examples): ############################################# FOXMAN‑UN Installation Utility FOXMAN 18.0.0-0 ############################################# Host: nemsrv (10.21.17.153) Components for FOXMAN‑UN Software: [x] 1. Core + UI [ ] 2. Core only [ ] 3. UI only Environment: Installation directory: [/opt/nem] Database: [NEM_DATABASE] Supported ESW: [DEFAULT] FOXMAN‑UN Security Administrator: <username> |
Enter the number 1-3 to select a component to install Enter ‘s’ to modify supported ESW Enter ‘a’ to configure FOXMAN-UN Security Administrator Enter ‘r’ to reset selection Enter ‘i’ to proceed with the installation Enter ‘q’ to quit Enter : | |
4. | Enter ‘a’ to define the NEM security administrator (this step is mandatory): # a |
5. (optional) | Enter ‘s’ if you need to modify the supported FOX61x ESW: # s Modification of the default is required if you operate legacy ESW on at least one of your managed NEs. |
6. (optional) | Enter ‘h’ if you want to modify the server name. # h |
7. | Enter ‘i’ to install the selected components: # i The FOXMAN-UN application will now be installed. Carefully observe any possible error messages to the stdout during installation. Once the installation is successfully concluded, it is confirmed by the output FOXMAN‑UN Installation done. |
8. | At the end of the installation procedure, the current user will be automatically added to the NEM administrators and offered to log out and log back in for the change to take effect. In case such user chooses not to do so right away, they must still log out and log back in before doing further actions (such as, e.g., attempting to execute nemstart, i.e., to start the FOXMAN-UN services). Do not execute nemstart before having concluded steps 9, 10, and 11 as far as applicable. |
9. | Install a valid, regular FOXMAN-UN license key. This step must be done before installing add-ons since add-ons depend on a valid license key. If you already have a valid FOXMAN-UN license file available in a file system accessible by the FOXMAN-UN server, execute the following bash command: LICENSE_SOURCE_PATH=<path_and_filename_of_license_file> Example: LICENSE_SOURCE_PATH=/opt/work/HitachiEnergyLicense.xml Then paste the following command as is to the same terminal (this assumes that nemsec is the username of the FOXMAN-UN security administrator. If you have chosen a different username in step 4 above, use that username instead of nemsec): LICENSE_DESTINATION_PATH=/opt/nem/etc/license.xml sudo cp -v $LICENSE_SOURCE_PATH $LICENSE_DESTINATION_PATH sudo chmod 640 -v $LICENSE_DESTINATION_PATH sudo chown -v nemadm:nem $LICENSE_DESTINATION_PATH su - nemsec lslicense For additional details see FOXMAN‑UN License Key Ordering, Installation, and Reporting. |
10. | If you need to install any of the add-ons provided in the package, proceed with FOXMAN‑UN Add-on Installation. |
11. | Restore the NEM database backup from the previous installation if applicable. |