You can adjust the default behavior of Platform Manager application by editing the Platform Manager configuration file. To do this, create or modify the file /usr/share/tomcat7/bimws.config and add the properties that you want.
You must restart Platform Manager to pick up any changes.
Property | Default | Meaning |
---|---|---|
keep_eventLogs_for_months | 120 | Time to keep event logs, in months (older records are deleted) |
rest_password_token | omitted | Clients requesting resource instances will find that the resource passwords are blank. To populate the password fields, the REST API caller must supply this token. If the token is blank then no token is required and passwords will be supplied to all clients. |
resource_name_prefix | bim | The resource name format is prefix-type-id. This key defines the prefix. |
micollab_confirm_arid | true | If false, will not confirm ARID when the administrator adds or modifies MiCollabMT servers. |
Example: [root@dt4 ~]# cat /usr/share/tomcat7/bimws.config rest_password_token=hello micollab_confirm_arid=false
This software makes use of the MSL PostgreSQL database. When you perform an MSL backup, the Platform Manager database is included.
Configure a daily scheduled MSL backup. A schedule backup is programmed via the MSL Server Manager: Administration > Backup > Configure network backup.
An MSL backup is a complete representation of an MSL server at the time of backup. It includes MSL and application databases. It does not include application software. If you need to restore to a new system you must be prepared to install MSL, the backup file, and the application Blade. You may restore an MSL backup to an existing system without reinstalling MSL or Platform Manager.
Note: Restoring a database that originated on a higher version of Platform Manager than the restore target is not supported.
There are two ways to restore from MSL Backup:
• | At MSL install time:When installing MSL onto a new system you will be prompted with an opportunity to restore MSL from a backup. |
• | From the MSL console: Log into the Linux console as root, type ‘console’ , select menu item ‘Restore from Backup’ and follow the prompts. When the server reboots you will be asked to select the restore method. Choose ‘Restore from network share’. |
WARNING: You will need access to a Linux console, either by sitting directly in front of the computer or using a lights-out management terminal. the server will reboot and you will need to respond to prompts during boot up to complete the restore.
You may restore the Platform Manager database to its original default state.
WARNING: This will delete all data in the system.
WARNING: If the database contains ARIDs, the associated hardware IDs will not be cleared at the AMC.
To delete all data in the database, enter the following in the Linux root shell:
[root@d4 ~]# /opt/dist_oria-bim-setup/scripts/maint/bim_db_delete.sh
Use this procedure if you want to replace an existing server (S1) with a new one (S2). After following this procedure server S1 will be halted and the configuration on server S2 will be a clone of the that on server S1.
Before starting this procedure, perform an MSL backup of server S1.
CAUTION: The IP address of the new server will be replaced with that from server S1.
1. On server S1, follow the MSL database restore procedure, and select Restore from another running server.
2. When prompted, enter the address and credentials of server S1, which is the server that has the database you want.
If the new server does not have the Platform Manager application Blade installed, install it now.
3. If there is an ARID, clear the hardware ID at the AMC.
The following commands are available from the Linux command line.
To start the Platform Manager application: [root@d4 ~]# bimstart -–now
Note: If the Platform Manager is already running, it will be restarted.
To stop the Platform Manager application: [root@d4 ~]# bimstop --now
Note: If the computer reboots, Platform Manager automatically restarts.
A complete set of logs may be retrieved by running the MSL Collect log files function, as follows:
In the MSL server manager: Administration > View Log Files > Collect
This is also sometimes called the "SOS report".
The sosreport.tar.gz file will be generated, containing logs and diagnostic information about your system. A tar.gz file is a compressed archive that may be opened on Windows computers with utilities such as WinRAR and 7-Zip.
On the Linux command line, you can create a Platform Manager backup zip file and perform a restore later.
CAUTION: The backup file produced by this method is not compatible with the file produced by the MSL Backup procedure. This method cannot restore an MSL backup file nor can an MSL Restore procedure restore a file created via this method.
To make a backup, use the command, bimdbzip
.
To restore, use the command bimdbrestore
.
Example
To make a backup:
[root@datest4 ~]# bimdbzip <clipped> pg_dump: reading rewrite rules pg_dump: reading large objects pg_dump: reading dependency data
pg_dump: saving encoding = SQL_ASCII
zip file is /tmp/bimdb_20160404165835.zip
The example command above is verbose. On the last line you will see the backup file.
name. In the case above, it is /tmp/bimdb_20160404165835.zip
. Store this file in a safe place.
To restore the file:
Note: The Platform manager will reboot.
bimdbrestore --file /tmp/bimdb_20160404165835.zip --dbname zip --reboot
This full command must be entered on one line.
For more information on the usage of these commands, type:
[root@datest4 ~]# bimdbzip -–help
[root@datest4 ~]# bimdbrestore --help